Setting Up Geotargeting

Yespo lets you target users based on their location. The location is defined from their IP address.

Send personalized information to people from different regions. Bet on quality rather than on quantity.

Use our dynamic segments for geotargeted campaigns.

📘

Note

Currently, IPv4 addresses are supported.

How Geo-tracking Works In Yespo

Yespo receives contact location data when

  • A contact clicks a link in any marketing email message
  • Web push message is delivered
  • A contact uses a mobile application
  • Our script sends the following widget-related events:
    • View
    • Click
    • Subscribe
    • Submit (for request forms)
  • The contact is identified from the webcontact web tracking event; data about the language can be obtained from the headers of this event if the Language field is empty in the card of such a contact.

Each time one of the above actions is performed, the contact's location data is updated (except the web tracking event, which does not update, but only records the relevant data if it is not in the contact card).

Contact card with the Location section highlighted, showing City, Region, Country, and Updated date fields

Also, you can import location user data to our system. The principle of its updating will be the same.

📘

Note

Location data can't be updated through the API, and it is not returned by the Get contact resource. The contact's time zone and language are available through the API — see Tracking User Time Zone and Language.

Creating Dynamic Segment for Geotargeting

  1. Go to Contacts → Segments → Add Segment → Dynamic.
Contact segments page with the Add segment dropdown open and the Dynamic option highlighted
  1. Fill in the general properties:
  • Segment name: it will be displayed in the general segments list.
  • Segment purpose: for example, for regular promo campaigns, etc.
  • Tags: they'll help find and filter the segments in the general list.
Add dynamic segment General Properties form with Name, Purpose, and Tags fields filled in
  1. Click Next.
❗️

Note

For geotargeting, carefully select conditions from the Location section. In the segment, field names are shown with a clarification in parentheses, for example, City (Location) or City (Address).

Fields marked as Address belong to the contact's postal address, which is passed through import or API, and are not geolocation data determined by IP.

  1. Click Add condition and create Include card.
Add dynamic segment Conditions tab with the Include Add condition button highlighted

In the left sidebar, go to Location → Country/Region/City → one of → Specify value.

After you select a condition, the segment shows which data the field belongs to, for example, City (Location).

Condition builder columns showing Location, City, and the one of operator selected

Select the values you want to apply to the targeted segment. Click Done to save settings.

City selection dialog with three cities checked and the Done button highlighted

To select a regional center and the whole region, choose the condition Contact matches any of the conditions.

If you need to exclude a city from the region, click Add condition and create a corresponding Exclude card:

You may set geotargeting within one country:

Or within the selected regions/cities in different countries:

  1. Click Done.
📘

Note

When you choose several conditions in one card, pay attention to the operator.

  • AND – the segment will include contacts that match all conditions in the card.
  • OR – the segment will include contacts that match of any conditions in the card.

Did this page help you?