Export (0) Print
Expand All
Ad
Bid
Expand Minimize

LocationTarget Data Object

Defines an object that can contain different types of geographical targets, for example lists of city and state targets.

System_CLiX_note Note

For information on location codes to use for each target bid value, see Geographical Location Codes.


<xs:complexType name="LocationTarget">
  <xs:sequence>
    <xs:element minOccurs="0" name="CityTarget" nillable="true" type="tns:CityTarget" />
    <xs:element minOccurs="0" name="CountryTarget" nillable="true" type="tns:CountryTarget" />
    <xs:element minOccurs="0" name="HasPhysicalIntent" nillable="true" type="xs:boolean" />
    <xs:element minOccurs="0" name="MetroAreaTarget" nillable="true" type="tns:MetroAreaTarget" />
    <xs:element minOccurs="0" name="RadiusTarget" nillable="true" type="tns:RadiusTarget" />
    <xs:element minOccurs="0" name="StateTarget" nillable="true" type="tns:StateTarget" />
  </xs:sequence>
</xs:complexType>

Elements

Element

Description

Data Type

Add

Update

CityTarget

The cities to target.

CityTarget

Optional

Optional

CountryTarget

The countries/regions to target.

CountryTarget

Optional

Optional

HasPhysicalIntent

Determines whether the audience must be physically located in the targeted location in order for the ad to display. The default value is false.

To show ads to people in, searching for, or viewing pages about your targeted location, the value should be false.

To show ads to people in your targeted location, set the value to true.

System_CLiX_importantImportant

The LocationTarget2 object provides three intent options, effectively adding the option to show ads to people searching for or viewing pages about your targeted location - and not necessarily people in the location. Each of the three intent options can also be set using the Bing Ads web application. When retrieving the LocationTarget object, the value of the HasPhysicalIntent element depends on which value you or another application set for the IntentOption element of the LocationTarget2 object - or the equivalent value applied using the Bing Ads web application.

  • If IntentOption is set to PeopleInOrSearchingForOrViewingPages, then HasPhysicalIntent will be false.

  • If IntentOption is set to PeopleIn, then HasPhysicalIntent will be true.

  • If IntentOption is set to PeopleSearchingForOrViewingPages, then HasPhysicalIntent will be nil.

System_CLiX_noteNote

You may exclude one or more locations by setting the corresponding IsExcluded element to true within the following objects.

If you are excluding all specified locations within this location target, please note the following.

  • Your physical intent setting will be ignored for ad delivery.

  • When retrieving the target, this element will be null.

  • The value that you set for this element will be stored by Bing Ads.

If you add or update this target to include one or more locations, the most recent physical intent preference will be honored by delivery and returned when retrieving the target.

boolean

Optional

Optional

MetroAreaTarget

The metropolitan areas to target.

MetroAreaTarget

Optional

Optional

RadiusTarget

The geographical locations to target.

RadiusTarget

Optional

Optional

StateTarget

The states, provinces, or territories to target.

StateTarget

Optional

Optional

The maximum combination of city, country, metro area, and state targets that you can specify in a LocationTarget object is 10,000. For example, you may specify a maximum of 10,000 city targets or 1,000 state targets and 9,000 city targets.

This limit applies whether the geographic targets are included or excluded. In other words, the target object limit of 10,000 applies to all city, country, metro area, and state targets regardless of whether the value for each corresponding target bid's IsExcluded element is set to true or false.

The maximum number of radius targets allowed per target is 2,000.

DMA® is a registered service mark of The Nielsen Company. Used under License.

Requirements

CampaignManagementService.svc v9

Namespace: https://bingads.microsoft.com/CampaignManagement/v9

Community Additions

ADD
Show:
© 2014 Microsoft