Update Geo-Targeting

Why Update Geo-Targeting?

You may find it necessary at some point to change existing geo-targeting settings for a flight to make updates, or alter a flight's performance in a campaign. The Kevel API enables you to update these geo-targeting settings using the Update Geo-Targeting API endpoint. When you use this API endpoint, you can then make changes to the geo-targeting settings for a specified flight.

📘

Note

You can update any field except for FlightID and LocationID.

API Syntax

When using the Update Geo-Targeting API endpoint, it is important to understand the syntax required to make the request. Because the Kevel API is a RESTful API, there is a specific request format that must be followed to ensure the endpoint can process the request. The format is:

PUT https://api.kevel.co/v1/flight/{FlightID}/geotargeting/{LocationID}

Where:

  • PUT - the type of API request being made.
  • https://api.kevel.co - the URL for the request.
  • v1 - the API version.
  • flight - the API endpoint being called.
  • FlightID - the ID associated with the flight.
  • geotargeting - the geo-targeting settings for the flight.
  • LocationID - The ID associated with the geographical location where the flight is being served.
Path Params
int32
required

ID of the Flight

int32
required

ID from the Geo-Targeting Endpoint

Body Params
string

The 2-3 character string that denotes the country you want to target

string

The 2-3 character string that denotes the region (or state) that you want to target

int32

The 3 digit number that denotes the metropolitan area you want to target. US only.

string

The name of the city you want to target

int32

The numeric geoname ID that denotes the city you want to target. This is the value matched for city targeting. Retrieve valid IDs from the List Cities in Region endpoint.

boolean
Defaults to false

If true, this will exclude the country from targeting. Defaults to false/null

Response

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/json