Geography targeting

Geography targeting directs ads to customers in and around given locations. Manage this with five targeting types:

• TARGETING_TYPE_GEO_REGION
• TARGETING_TYPE_POI
• TARGETING_TYPE_BUSINESS_CHAIN
• TARGETING_TYPE_REGIONAL_LOCATION_LIST
• TARGETING_TYPE_PROXIMITY_LOCATION_LIST

Region targeting

TARGETING_TYPE_GEO_REGION targets regions. Such regions include countries, states, cities, or postal codes.

Get regions as TargetingOption resources:

• Use the list method to get a list of regions. This method supports filtering by region type.
• Use the search method to get a region based on a search query. Search is based on the region display name.

Points of interest targeting

TARGETING_TYPE_POI targets points of interest (POIs). This targets a radial area around a location. A location can be a named point of interest. Named POIs include locations such as cultural sites, airports, and street addresses. A location can also be defined by latitude and longitude coordinates.

Retrieve existing POIs

Get POIs as TargetingOption resources. Use the search method to get POIs based on a search query. Search is based on the display name, street address, or coordinates.

Define a POI using coordinates

You can also build a targeting option ID using coordinates. To build a targeting option ID:

• Get latitude and longitude coordinates. (40.7414691, -74.003387)
• Round values to the sixth decimal place. (40.741469, -74.003387)
• Remove the decimal from the values. (40741469, -74003387)
• Concatenate the values with a semicolon separator. (40741469;-74003387)

Note: When using a built ID, the resulting assigned targeting option will have updated ID values. The updated values will append a semicolon and alphanumeric hash.

Set targeting radii

Provide a radius around the targeted POI. The minimum radius is 1 KM. A radius must encompass a population of at least 1,000 people to meet the privacy standards. A larger radius will be used in practice if needed.

Business Chain targeting

TARGETING_TYPE_BUSINESS_CHAIN targets business chains. This targets the area around all chain stores of a business in a region.

Get business chain and region combinations as TargetingOption resources. Use the search method to get a business chain based on a search query. Search is based on the business name and region display name.

Set targeting radii

Provide a radius around the targeted stores. The minimum radius is 1 KM. A radius must have a population of at least 1,000 to meet the privacy standards. A larger radius will be used in practice if needed.

Location list targeting

TARGETING_TYPE_REGIONAL_LOCATION_LIST and TARGETING_TYPE_PROXIMITY_LOCATION_LIST target lists of locations. A location list targets either a list of regions or radial areas around a list of POIs.

The location type of a list dictates the proper targeting type.

Get location lists as LocationList resources. Use the list method to get a list of location lists.

Note: See the Location Lists concept guide for how to manage list content.

Set targeting radii

Provide a radius around the locations when setting proximity location list targeting. The minimum radius is 1 KM. A radius must have a population of at least 1,000 to meet the privacy standards. A larger radius will be used in practice if needed.