The new Search Ads 360 Reporting API is now available. Join the
searchads-api-announcements Google group to stay up to date on upcoming enhancements and releases.
geo_target_constant
Stay organized with collections
Save and categorize content based on your preferences.
A geo target constant is a unique identifier for a geographical region that can
be targeted by a campaign. Each targetable location is uniquely identified by a
Criterion ID.
The resource_name of each geo_target_constant
is of the form geoTargetConstants/{Criterion ID}.
For example, the resource_name value of New York state is
geoTargetConstants/21167.
Columns
- Criterion ID
- Unique and persistent assigned ID.
- Name
- Best available English name of the geo target.
- Canonical Name
- The constructed fully qualified English name consisting of the target's own
name, and that of its parent and country. This field is meant only for
disambiguating similar target names.
- Parent Geo Target
- The resource name of the parent geo target constant. This field is included
only for legacy support, so Ids might not be consistent across datasets.
- Country Code
- The ISO-3166-1 alpha-2 country code that is associated with the target.
- Target Type
Allowable values:
- Airport
- Autonomous Community
- Borough
- Canton
- City
- City Region
- Congressional District
- Country
- County
- Department
- District
- DMA Region
- Governorate
- Municipality
- National Park
- Neighborhood
- Okrug
- Postal Code
- Prefecture
- Province
- Region
- State
- Territory
- TV Region
- Union Territory
- University
- Status
Allowable values:
Enabled: Location is valid.Removal Planned: Location is obsolete and will be removed in the next
version.
Non-targetable locations
Some countries or territories are not targetable in Search Ads 360 but might
appear in reports based on the user's location of interest or physical location.
Check the list of restricted countries
DMA regions
Contact The Nielsen
Company
directly for DMA data.
See also
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 2025-08-28 UTC.
[null,null,["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eGeo target constants are unique identifiers for geographical regions targetable in campaigns, each with a specific Criterion ID.\u003c/p\u003e\n"],["\u003cp\u003eEach geo target constant has properties like name, canonical name, parent, country code, target type, and status, aiding in precise targeting.\u003c/p\u003e\n"],["\u003cp\u003eWhile most locations are targetable, some countries or territories might be restricted, and users should refer to the provided link for details.\u003c/p\u003e\n"],["\u003cp\u003eDMA data is available through Nielsen, and users can find further information on \u003ccode\u003egeo_target_constant\u003c/code\u003e and sample queries via the provided links.\u003c/p\u003e\n"]]],["Geo target constants are unique identifiers (Criterion IDs) for targetable geographical regions in campaigns. Each region has a `resource_name` (e.g., `geoTargetConstants/21167` for New York). Key attributes include: Name, Canonical Name, Parent Geo Target, Country Code, Target Type (e.g., City, State), and Status (Enabled, Removal Planned). Some locations are non-targetable. DMA region data is available directly from The Nielsen Company. The list of restricted countries is provided in the documentation.\n"],null,["# geo_target_constant\n\nA geo target constant is a unique identifier for a geographical region that can\nbe targeted by a campaign. Each targetable location is uniquely identified by a\nCriterion ID.\n\nThe `resource_name` of each [`geo_target_constant`](/search-ads/reporting/api/reference/fields/v0/geo_target_constant)\nis of the form `geoTargetConstants/{Criterion ID}`.\n\nFor example, the resource_name value of New York state is\n`geoTargetConstants/21167`.\n\nColumns\n-------\n\nCriterion ID\n: Unique and persistent assigned ID.\n\nName\n: Best available English name of the geo target.\n\nCanonical Name\n: The constructed fully qualified English name consisting of the target's own\n name, and that of its parent and country. This field is meant only for\n disambiguating similar target names.\n\nParent Geo Target\n: The resource name of the parent geo target constant. This field is included\n only for legacy support, so Ids might not be consistent across datasets.\n\nCountry Code\n: The ISO-3166-1 alpha-2 country code that is associated with the target.\n\nTarget Type\n\n: Allowable values:\n\n - Airport\n - Autonomous Community\n - Borough\n - Canton\n - City\n - City Region\n - Congressional District\n - Country\n - County\n - Department\n - District\n - DMA Region\n - Governorate\n - Municipality\n - National Park\n - Neighborhood\n - Okrug\n - Postal Code\n - Prefecture\n - Province\n - Region\n - State\n - Territory\n - TV Region\n - Union Territory\n - University\n\nStatus\n\n: Allowable values:\n\n- `Enabled`: Location is valid.\n- `Removal Planned`: Location is obsolete and will be removed in the next version.\n\nNon-targetable locations\n------------------------\n\nSome countries or territories are not targetable in Search Ads 360 but might\nappear in reports based on the user's location of interest or physical location.\n\n[Check the list of restricted countries](//support.google.com/google-ads/answer/6163740)\n\nDMA regions\n-----------\n\nContact [The Nielsen\nCompany](//markets.nielsen.com/us/en/contact-us/intl-campaigns/dma-maps/)\ndirectly for DMA data.\n\nSee also\n--------\n\n- geo_target_constant field [details](/search-ads/reporting/api/reference/fields/v0/geo_target_constant)\n- How to lookup geo constant [sample query](/search-ads/reporting/query/sample-queries#how_to_look_up_geo_constants)"]]
