Geotargeting

Many advertisers seek to target users based on specific geographic locations such as states, subregions, or cities. This capability allows advertisers to deliver highly localized campaigns that align with their business objectives and reach relevant audiences within specific areas.

Use Case

Advertisers often work with geolocations to segment campaigns meant to different geographic zones. When creating Sponsored Listing or Sponsored Banners campaigns, advertisers may want to target multiple regions, or states to ensure their ads are shown to users in relevant areas.

For instance, a retailer could create a campaign targeting customers in cities A and B, ensuring that the ads are shown only to users in that area.

Solution: Geolocation Targeting

To support geolocation-based targeting, a solution has been developed that allows advertisers to select specific regions when creating campaigns. Then, when running an auction you can provide a location id, ensuring that ads are displayed to users within the defined geographic area.

Functionality Overview

• The client shares a json file with their geolocation mapping. Sharing `id` and `name` for every location.
• The geolocations are uploaded early on the integration process to ensure that the location data is available for tests when creating the first campaigns.
• Advertisers can select multiple regions when creating campaigns in the Admin/Vendor Dashboard.
• The geolocation information is sent as part of every auction request, allowing for dynamic targeting based on the user’s location.

Auction Request

curl --request POST \
  --url https://api.topsort.com/v2/auctions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "auctions": [
    {
      "type": "listings",
      "slots": 2,
      "category": {
        "id": "category"
      },
      "geoTargeting": {
        "location": "campo-limpo"
      }
    }
  ]
}'

Key Considerations

• Multiple locations: Advertisers can target campaigns to multiple geographic locations. So if a campaign has location1 and location2 associated to, then the eligible products of that campaign will only participate in auctions if it contains the location1 or location2 in the `geoTargeting.location` field. In the other hand, an auction only allows only location, as it doesn’t make sense that a user should be able to see campaigns from more than one location.
• Providing no location: If the campaign is created with no location targeting option selected, then it will participate in all auctions (with and without locations). If a campaign does have locations selected, then it will only participate in auctions that have as `geoTargeting.location` field any of the locations associated to it.

By offering geolocation-based targeting, advertisers can deliver more relevant and effective Sponsored Listings campaigns, ensuring that their ads are seen by users in the most appropriate geographic locations.