Targeting

General targeting

For both Onsite surveys and Embedded surveys, you can use PollHero’s general targeting.

Here you can add rules for where and to whom your survey is displayed on your website, or whether Embedded surveys should be loaded.

If you don’t set a rule, the survey will be displayed on all pages, as the default rule is Seiten-URL entspricht RegEx .*.

Page Targeting

You can decide whether page targeting should follow an AND logic or an OR logic.

Overview of page targeting options

Page targeting can be applied to different pages:

Page URL: Select specific URLs, such as a particular product, the order confirmation page, or a thank-you page.

Page language: Target by page language if your website can be displayed in different languages.

Page hostname: You can target the survey by hostname.

Referrer domain: You can specifically include or exclude users who arrived via a particular referral (social, direct, ads, etc.) on a domain basis.

Referrer hostname: You can specifically include or exclude users who arrived via a particular referral (social, direct, ads, etc.) on a hostname basis.

SettingPollHero readsExpected value / exampleOperators
Page URLwindow.location.href, without trailing /Full URL, e.g., https://shop.example.com/products/shoe?color=redcontains, does not contain, equals, does not equal, RegEx
Page languagedocument.documentElement.langThe exact value of <html lang="…">, e.g., de or de-DEequals, does not equal, RegEx
Page hostnamewindow.location.hostnameHostname without protocol and path, e.g., shop.example.comequals, does not equal, contains, does not contain, RegEx
Referrer domainRegistrable domain from the hostname of document.referrerDomain without subdomain, e.g., google.de (for www.google.de) or example.co.uk (for shop.example.co.uk); empty if no referrerequals, does not equal, contains, does not contain, RegEx
Referrer hostnamenew URL(document.referrer).hostnameFull hostname of the referrer without protocol and path, e.g., www.google.de; empty if no referrerequals, does not equal, contains, does not contain, RegEx

For pages, you have the following options:

contains: The URL contains certain slugs, so you can, for example, display the survey only on category pages. The survey will then be displayed on all pages that follow the format www.yourwebsite.com/category/, including www.yourwebsite.com/category/product1/.

does not contain: If you want to display the survey on most pages but not on all pages, you can enter the relevant slugs here. For example, you can exclude your About Us page, your privacy policy page, or your blog. Here too, all URLs that contain the slug will be excluded.

matches exactly: Enter a URL here on which you want to display the survey.

does not match: Enter a URL here on which you do not want to display the survey.

matches RegEx: The field expects a regular expression (RegEx).

Device

Target users based on their device or screen width.

You can target Mobile, Desktop, Tablet, and SmartTV.

SettingPollHero readsExpected valueOperators
Device typeScreen width and user agentMobile, Tablet, Desktop, or SmartTVcontains, does not contain
Screen widthwindow.innerWidthInteger in CSS pixels, e.g., 768>, <, ≥, ≤, between

If no specific device type is selected, the survey will be loaded on all devices.

E-commerce

Target based on different e-commerce features:

You send the purchase data with purchase tracking. You don't need any other integration for this.

E-commerce rules evaluate the data of the browser's PollHero user ID. PollHero determines order count, total number of purchases, total revenue and average order value from the orders reported for this user ID via purchase tracking. You send the customer type via identify (user attributes) for the same user ID. Monetary values are processed as numbers with a dot as the decimal separator, for example 1249.99 (not 1.249,99).

Options in PollHeroField/originExpected valueOperators
Order countNumber of orders reported for this user ID via purchase tracking (ordersCount)Non-negative integer, e.g., 3equals, does not equal, >, <, ≥, ≤, between
Total number of purchasesCustomer metric total_purchases, calculated from the ordersNon-negative integer, e.g., 8equals, does not equal, >, <, ≥, ≤, between
Total revenueCustomer metric total_revenue, calculated from the ordersNumber, e.g., 1249.99>, <, ≥, ≤, between
Average order valueCustomer metric total_aov, calculated from the ordersNumber, e.g., 156.25>, <, ≥, ≤, between
Customer typecustomer_type from identifynew or returningequals, does not equal
Order item SKUsitems[].sku or items[].item_idSKU/item ID as string, e.g., SKU-456equals, does not equal, contains, does not contain
Item brandsitems[].item_brand or items[].brandBrand name as string, e.g., Nikeequals, does not equal, contains, does not contain
Categoryitems[].category or items[].item_categoryCategory name as string, e.g., Shoesequals, does not equal
Category 2–5e.g., for Category 2: items[].category2, items[].item_category2 or items[].item_category_2 (Category 3–5 accordingly)String, e.g., Menequals, does not equal
Coupon codecoupon of the purchase or items[].item_coupon, items[].coupon, items[].coupon_codeCode as string, e.g., WELCOME10equals, does not equal, contains

For between, exactly two numbers are entered as comma-separated lower and upper limits, e.g., 5,10 (without spaces). The limits are inclusive.

Important regarding equals vs. contains for items, brands, and coupons: PollHero internally aggregates SKUs, brands, coupons, and categories of all of a customer’s orders into comma-separated lists (e.g., SKU-1,SKU-2). A rule with equals checks for an exact match of the entire list and therefore only applies if the customer has exactly this one value in total. As soon as a customer has purchased multiple items, brands, or coupons, equals will fail. For reliable matching of SKUs, brands, and coupons, always use the contains operator.

For all category options (Category to Category 5), only the operators equals and does not equal are available. If a customer has purchased items from multiple categories, equals will fail.

Which field names PollHero accepts in the items is described in the purchase tracking article.

Targeting right after a purchase

If you report a purchase to PollHero with the purchase tracking script (event: "purchase"), PollHero immediately adds it to the user's metrics (order count and total number of purchases +1, total revenue + order value, average order value recalculated, plus items and coupon code). PollHero then checks the surveys on the page again. A survey that should only appear from the first purchase onwards, for example, can therefore already be shown on the order confirmation page.

The same order (same transaction_id) is only counted once within 60 minutes. If someone reloads the order confirmation page, the purchase is not recorded twice.

Users

In the Users section, you can specifically target certain users or user groups. You have access to the user’s country and language, as well as custom attributes (user attributes).

If a user is missing an attribute (for example because they are not identified or no country was transmitted), no rule that checks a value applies. This also applies to negated rules such as does not contain or does not equal: the rule Country does not contain DE therefore does not show the survey to users without a country. If you want to target users without a specific attribute, use is not set for custom attributes.

Country

PollHero currently does not validate the country code against a fixed list of countries, but compares the passed text. ISO Alpha-2 codes in uppercase are therefore the binding integration convention. Do not use Germany, DEU, or de if the rule is configured for DE.

Note on the contains operator for country: Even though the operator is called contains in the interface, PollHero internally checks whether the user’s country code contains the entered rule value. Therefore, only store a single country code (e.g., DE) per rule – comma-separated lists like DE, AT will cause the rule not to apply.

SettingExpected formatRecommended valuesOperators
CountryString in countryISO 3166-1 Alpha-2 code in uppercase, e.g., DE, AT, CH, UScontains, does not contain

Language

For targeting by user language, exactly the five values in the following table are provided in the PollHero interface. Do not transmit regional codes like de-DE or en-GB for language; for example, de must be sent for the user rule. This is independent of the page language, which is read directly from the lang attribute and can therefore also contain a regional code.

SettingExpected formatAllowed valuesOperators
LanguageLowercase language code in languagede, en, fr, es, itequals, does not equal

Custom attributes

Custom attributes are passed directly as flat properties in the second argument to PH1.identify (no nested object). equals and does not equal compare the string value; is set and is not set check whether the key exists in the profile.

SettingExpected formatAllowed valuesOperators
Custom attributesAdditional flat key-value pairs in the attribute object, e.g., has_subscription: trueFor equals / does not equal: attribute name and value (e.g., key has_subscription, value true); for is set / is not set: only the attribute nameequals, does not equal, is set, is not set

On this page