Share your feedback about the Google Ads (AdWords) API. Take the 2021 AdWords API and Google Ads API Annual Survey.
The AdWords API will sunset on April 27, 2022. Migrate to the Google Ads API to take advantage of the latest Google Ads features.

type Proximity (v201809)

Service
CampaignCriterionService
Inheritance
Criterion
▼
AdSchedule AgeRange Carrier ContentLabel CriterionUserInterest CriterionUserList Gender IncomeRange IpBlock Keyword Language Location LocationGroups MobileAppCategory MobileApplication MobileDevice OperatingSystemVersion Parent Placement Platform ProductScope Proximity Vertical Webpage YouTubeChannel YouTubeVideo

Represents a Proximity Criterion. A proximity is an area within a certain radius of a point with the center point being described by a lat/long pair. The caller may also alternatively provide address fields which will be geocoded into a lat/long pair. Note: If a geoPoint value is provided, the address is not used for calculating the lat/long to target.

A criterion of this type is only targetable.

Namespace
https://adwords.google.com/api/adwords/cm/v201809

Field
Criterion (inherited)

id

xsd:long

ID of this criterion.

This field can be selected using the value "Id".
This field can be filtered on.
This field is required and should not be null when it is contained within Operators : SET, REMOVE.

type

Criterion.Type

Indicates that this instance is a subtype of Criterion. Although this field is returned in the response, it is ignored on input and cannot be selected. Specify xsi:type instead.

Enumerations
CONTENT_LABEL
Content label for exclusion.
KEYWORD
Keyword. e.g. 'mars cruise'
PLACEMENT
Placement. aka Website. e.g. 'www.flowers4sale.com'
VERTICAL
Vertical, e.g. 'category::Animals>Pets' This is for vertical targeting on the content network.
USER_LIST
User lists, are links to sets of users defined by the advertiser.
USER_INTEREST
User interests, categories of interests the user is interested in.
MOBILE_APPLICATION
Mobile applications to target.
MOBILE_APP_CATEGORY
Mobile application categories to target.
PRODUCT_PARTITION
Product partition (product group) in a shopping campaign.
IP_BLOCK
IP addresses to exclude.
WEBPAGE
Webpages of an advertiser's website to target.
LANGUAGE
Languages to target.
LOCATION
Geographic regions to target.
AGE_RANGE
Age Range to exclude.
CARRIER
Mobile carriers to target.
OPERATING_SYSTEM_VERSION
Mobile operating system versions to target.
MOBILE_DEVICE
Mobile devices to target.
GENDER
Gender to exclude.
PARENT
Parent to target and exclude.
PROXIMITY
Proximity (area within a radius) to target.
PLATFORM
Platforms to target.
PREFERRED_CONTENT
Representing preferred content bid modifier.
AD_SCHEDULE
AdSchedule or specific days and time intervals to target.
LOCATION_GROUPS
Targeting based on location groups.
PRODUCT_SCOPE
Scope of products. Contains a list of product dimensions, all of which a product has to match to be included in the campaign.
CUSTOM_AFFINITY
Custom Affinity, a criterion used for custom audience targeting.
CUSTOM_INTENT
Custom Intent, a criterion used for custom audience targeting.
YOUTUBE_VIDEO
YouTube video to target.
YOUTUBE_CHANNEL
YouTube channel to target.
APP_PAYMENT_MODEL
Enables advertisers to target paid apps.
INCOME_RANGE
Income range to target and exclude.
INTERACTION_TYPE
Interaction type to bid modify.
UNKNOWN

This field can be selected using the value "CriteriaType".
This field can be filtered on.
This field is read only and will be ignored when sent to the API.

Criterion.Type

xsd:string

Indicates that this instance is a subtype of Criterion. Although this field is returned in the response, it is ignored on input and cannot be selected. Specify xsi:type instead.

Proximity

geoPoint

GeoPoint

Latitude and longitude.

This field can be selected using the value "GeoPoint".

radiusDistanceUnits

Proximity.DistanceUnits

Radius distance units.

Enumerations
KILOMETERS
The unit of distance is kilometer.
MILES
The unit of distance is mile.

This field can be selected using the value "RadiusDistanceUnits".
This field is required and should not be null when it is contained within Operators : ADD.

radiusInUnits

xsd:double

Radius expressed in distance units.

This field can be selected using the value "RadiusInUnits".
This field is required and should not be null when it is contained within Operators : ADD.

address

Address

Full address; null if unknonwn.

This field can be selected using the value "Address".