type GeoTargeting (v202405)
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/v202405
Field
|
targetedLocations
|
Location[]
The geographical locations being targeted by the LineItem.
|
excludedLocations
|
Location[]
The geographical locations being excluded by the LineItem.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-05-15 UTC.
[null,null,["Last updated 2024-05-15 UTC."],[[["GeoTargeting allows line items to target or exclude specific geographical locations like countries, regions, metro areas, and cities."],["By default, all countries and their subdivisions are targeted."],["There are specific rules for geographical targeting including avoiding redundant targeting/exclusion and conflicts between parent and child locations."],["You cannot target and exclude the same location or target a child location if its parent is excluded."],["GeoTargeting uses `targetedLocations` and `excludedLocations` fields to specify included and excluded locations respectively."]]],["GeoTargeting enables line items to target or exclude specific geographical locations, including countries, regions, metro areas, and cities. Key rules include: locations cannot be both targeted and excluded; children of excluded locations cannot be targeted; targeting a child location prohibits targeting its parent; and explicit inclusions or exclusions must not be redundant with implicit ones. The fields `targetedLocations` and `excludedLocations` are used to specify these geographical areas for a LineItem. Several services such as AdRuleService and YieldGroupService leverage this functionality.\n"]]