Geotargeting

Geotargeting enables advertisers to direct campaigns to users in specific geographic locations, such as states, subregions, or cities.

How it Works

1. Pre-Configuration

The client provides a JSON file mapping their geolocations, including an id and name for each location. This geolocation data is uploaded by Topsort early in the integration process, making it available for testing with the first campaigns.

2. Campaign Setup

Advertisers can select multiple regions in the Admin/Vendor Dashboard when creating their campaigns.

3. Auction Process

During an auction, the geolocation can be provided in the body of the request, using the geoTargeting.location field. The following auction request can be used to retrieve winners for clients in a specific location:

{
  "auctions": [
    {
      "type": "listings",
      "slots": 2,
      "category": {
        "id": "category"
      },
      "geoTargeting": {
        "location": "new-york"
      }
    }
  ]
}

Key Considerations

1. Campaigns can target multiple geographic locations. If a campaign is associated with location1 and location2, its products are eligible for auctions where the geoTargeting.location field is either location1 or location2.
2. An auction request accepts only one location in the geoTargeting.location field.
3. If a campaign has no locations defined, it participates in all auctions (regardless of location information in the auction request).
4. If a campaign has locations defined, it only participates in auctions where the geoTargeting.location field matches one of its specified locations.