Knowledge Base
Geotargeting
Geotargeting enables advertisers to direct campaigns to users in specific geographic locations, such as states, subregions, or cities.
How it Works
-
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.
-
Campaign Setup
Advertisers can select multiple regions in the Admin/Vendor Dashboard when creating their campaigns.
-
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
- Campaigns can target multiple geographic locations. If a campaign is associated with
location1
andlocation2
, its products are eligible for auctions where thegeoTargeting.location
field is eitherlocation1
orlocation2
. - An auction request accepts only one location in the
geoTargeting.location
field. - If a campaign has no locations defined, it participates in all auctions (regardless of location information in the auction request).
- If a campaign has locations defined, it only participates in auctions where the
geoTargeting.location
field matches one of its specified locations.