type GeoTargeting (v202411)

  • GeoTargeting allows line items to target or exclude specific geographical locations like countries, regions, and cities.

  • By default, all locations are targeted unless specific targeting or exclusions are applied.

  • There are rules for geographical targeting to prevent conflicts, such as not targeting and excluding the same location or targeting a child of an excluded parent.

  • You should avoid redundant targeting, like including a location and its parent simultaneously.

  • The targetedLocations and excludedLocations fields define the included and excluded locations respectively.

Provides line items the ability to target geographical locations. By default, line items target all countries and their subdivisions. With geographical targeting, you can target line items to specific countries, regions, metro areas, and cities. You can also exclude the same.

The following rules apply for geographical targeting:

  • You cannot target and exclude the same location.
  • You cannot target a child whose parent has been excluded. For example, if the state of Illinois has been excluded, then you cannot target Chicago.
  • You must not target a location if you are also targeting its parent. For example, if you are targeting New York City, you must not have the state of New York as one of the targeted locations.
  • You cannot explicitly define inclusions or exclusions that are already implicit. For example, if you explicitly include California, you implicitly exclude all other states. You therefore cannot explicitly exclude Florida, because it is already implicitly excluded. Conversely if you explicitly exclude Florida, you cannot explicitly include California.

Namespace
https://www.google.com/apis/ads/publisher/v202411

Field

targetedLocations

Location[]

The geographical locations being targeted by the LineItem.

excludedLocations

Location[]

The geographical locations being excluded by the LineItem.