GeoTarget (AdWords API Developer's Guide)

GeoTarget

Geotargeting options for a Campaign.

A Campaign may be targeted at users in zero or more geographic locations. The locations may be:

countries and territories
regions, metropolitan areas, and cities

A campaign may not use two different types of targeting options. For example, it cannot be targeted at both a country and a city. It can, however, be targeted at:

multiple countries and territories OR
a combination of one or more regions, metropolitan areas, and cities within a single country or territory

Other geoTargeting rules are:

All regions, metros, and cities must be in the same country or territory. For example, California US (region) and Queensland AU (region) are not allowed together.
A campaign can't have one target encompassing another target. For example, California US (region) and Los Angeles (city) are not allowed together. Note: some metros span multiple regions. For those metros, a violation occurs only when all the regions that the metro touches are selected.
The total number of regions, metros and cities in a campaign must not exceed 100. For example, 50 cities and 50 metros and 1 region exceeds the allowed number.
Region targets must be inside a country that supports regional targeting.
City targets must be inside a country that supports city targeting.

For more details of geotargeting values, see Language and Geotargeting Codes.

NOTE: Clearing fields - In v10, you can clear a field by passing in an empty target data object. For example, you can clear cityTargets by passing in a CityTargets object with all fields empty.
Prior to v10, you can clear all fields by passing in an empty GeoTarget object (create a new object without setting its fields). In general, fields cannot be cleared by passing in an empty array. For example, if you set up a campaign using cities and later try to update the campaign so that it uses metros instead of cities, the cities field cannot be cleared. The workaround is to clear regional targeting with a call to clear all fields, then make a separate call with all metros and no cities.

Fields

cityTargets
countryTargets
metroTargets
proximityTargets
regionTargets
targetAll

Field name	Field type	Field description
`cityTargets`	`CityTargets`	Targeting by city.
`countryTargets`	`CountryTargets`	Targeting by country.
`metroTargets`	`MetroTargets`	Targeting by metropolitan area.
`proximityTargets`	`ProximityTargets`	Targeting by map coordinates and the surrounding circular area.
`regionTargets`	`RegionTargets`	Targeting by region.
`targetAll`	`boolean`	When true, the campaign does not have any specific targeting -- that is, it is targeting "all countries" (the target fields are all ignored.) When false, at least one target field must be set. If a GeoTarget object is returned with `targetAll` false, that means either: 1) one or more of the targeting objects is set (if AdWords API supports the targeting), or 2) the campaign is using some targeting that AdWords API does not support (such as polygon targeting) which is available only through the AdWords website.