Language, Geotargeting, Currency and Time Zone Codes (AdWords API Developer's Guide)

Language, Geotargeting, Currency and Time Zone Codes

You can target campaigns by specific languages and by geographical regions.

Targeting by Language

To target a campaign by specific language(s), define the languageTargeting field of the campaign data to have the languages field whose value is one or more languages.

Note: For statically typed languages such as Java, the value of the languageTargeting field is a LanguageTarget object, that in turn has a languages field.

For the list of accepted language values, see:

Language Codes

Targeting by Geographical Location

You can target campaigns by cities, countries, metros, and regions. However, a single campaign can only target one geographic area. For example, you can target a campaign by countries or regions, but not both. You can specify multiple values within a single type of geographic area. For example, you could target a campaign by more than one country.

You can target by language in addition to targeting by one kind of geographic region.

To target a campaign by specific geographic type, define the geoTargeting field of the campaign data to have one of the cities, countries, metros, or regions fields.

Note: For statically typed languages such as Java, the value of the geoTargeting field is a GeoTarget object, which in turn has cities, countries, metros, or regions fields.

For the list of accepted geography values, see:

Currency Codes

A currency can be set only when creating an account. You can get the value from currencyCode field in AccountInfo. (You cannot target by currency.)

For the list of accepted currency codes, see:

Currency Codes

Time Zone Codes

A time zone can be set only when creating an account. You can get the value from timeZoneIdfield in AccountInfo. (You cannot target by time zone.)

For the list of accepted time zone values, see:

Time Zone Codes

Sample XML

Here is sample XML for the definition of a campaign that includes language targeting and geo-targeting.

   <campaign>
     <languageTargeting>
       <languages>en</languages>
       <languages>fr</languages>
       <languages>es</languages>
     </languageTargeting>
     <geoTargeting>
       <countries>FR</countries>
       <countries>ES</countries>
     </geoTargeting>
     ... rest of campaign data
   </campaign>