LocationTarget
Collapse the table of content
Expand the table of content

LocationTarget Data Object

 

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

System_CAPS_ICON_important.jpg Important


When you update a target using UpdateTargetsInLibrary, the Target object that you specify overwrites any existing sub target (e.g. location) and intent option settings. In order to retain any existing target types upon update to an existing Target, you would retrieve the current targeting settings via GetTargetsInfoFromLibrary and then call the GetTargetsByIds service operation. Make the changes to the existing Target as appropriate and leave unchanged values intact before using the UpdateTargetsInLibrary operation. In other words, you should re-specify every target type and bid that you want to keep at the same time you make the changes or updates. For more information, see Updating Targets.

Note that the HasPhysicalIntent element of the Bing Ads API Version 9 LocationTarget object is an exception to the rule stated above within the Bing Ads API Version 9 Target object only. If you leave this element null when calling the version 9 UpdateTargetsInLibrary operation, your existing setting will not be overwritten. With the Bing Ads API Version 9 Target2 object, or Bing Ads API Version 10, if you leave the IntentOption element null during update, then your settings will be reset to the default value of PeopleInOrSearchingForOrViewingPages.

System_CAPS_ICON_note.jpg 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="IntentOption" type="tns:IntentOption" />
    <xs:element minOccurs="0" name="MetroAreaTarget" nillable="true" type="tns:MetroAreaTarget" />
    <xs:element minOccurs="0" name="PostalCodeTarget" nillable="true" type="tns:PostalCodeTarget" />
    <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>

ElementDescriptionData TypeAddUpdate
CityTargetThe cities to target.CityTargetOptionalOptional

Important: The UpdateTargetsInLibrary operation will not fail if you do not specify this element; however, it is required if you want to keep the most recent settings. Any optional elements which are not sent with the update request will in effect be deleted from the target. For more information, see Updating Targets.
CountryTargetThe countries/regions to target.CountryTargetOptionalOptional

Important: The UpdateTargetsInLibrary operation will not fail if you do not specify this element; however, it is required if you want to keep the most recent settings. Any optional elements which are not sent with the update request will in effect be deleted from the target. For more information, see Updating Targets.
IntentOptionDetermines whether the audience must be physically located in the targeted location in order for the ad to display.

To show ads to people in, searching for, or viewing pages about your targeted location, the value should be PeopleInOrSearchingForOrViewingPages. This is the default value, if not otherwise specified in the add or update request.

To show ads to people searching for or viewing pages about your targeted location, set the value to PeopleSearchingForOrViewingPages.

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

You may exclude one or more locations by setting the corresponding IsExcluded element to true within the CityTargetBid, CountryTargetBid, MetroAreaTargetBid, PostalCodeTargetBid, and StateTargetBid objects.

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

- Your 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 the target to include one or more locations, the most recent intent option will be honored by delivery and returned when retrieving the target.
IntentOptionOptional

If not specified, the default value is PeopleInOrSearchingForOrViewingPages.
Optional

If not specified, the default value is PeopleInOrSearchingForOrViewingPages.

Important: The UpdateTargetsInLibrary operation will not fail if you do not specify this element; however, it is required if you want to keep the most recent settings. Any optional elements which are not sent with the update request will in effect be deleted from the target. For more information, see Updating Targets.
Note that the HasPhysicalIntent element of the Bing Ads API Version 9 LocationTarget object is an exception to the rule stated above within the Bing Ads API Version 9 Target object only. If you leave this element null when calling the version 9 UpdateTargetsInLibrary operation, your existing setting will not be overwritten. With the Bing Ads API Version 9 Target2 object, or Bing Ads API Version 10, if you leave the IntentOption element null during update, then your settings will be reset to the default value of PeopleInOrSearchingForOrViewingPages.
MetroAreaTargetThe metropolitan areas to target.MetroAreaTargetOptionalOptional

Important: The UpdateTargetsInLibrary operation will not fail if you do not specify this element; however, it is required if you want to keep the most recent settings. Any optional elements which are not sent with the update request will in effect be deleted from the target. For more information, see Updating Targets.
PostalCodeTargetThe postal codes to target.

The format must be specified as Postal, State Country. For example to target postal code 98052 in the state of Washington, you would specify "98052, WA US".

Important: The UpdateTargetsInLibrary operation will not fail if you do not specify this element; however, it is required if you want to keep the most recent settings. Any optional elements which are not sent with the update request will in effect be deleted from the target. For more information, see Updating Targets.
PostalCodeTargetOptionalOptional

Important: The UpdateTargetsInLibrary operation will not fail if you do not specify this element; however, it is required if you want to keep the most recent settings. Any optional elements which are not sent with the update request will in effect be deleted from the target. For more information, see Updating Targets.
RadiusTargetThe geographical locations to target.RadiusTargetOptionalOptional

Important: The UpdateTargetsInLibrary operation will not fail if you do not specify this element; however, it is required if you want to keep the most recent settings. Any optional elements which are not sent with the update request will in effect be deleted from the target. For more information, see Updating Targets.
StateTargetThe states, provinces, or territories to target.StateTargetOptionalOptional

Important: The UpdateTargetsInLibrary operation will not fail if you do not specify this element; however, it is required if you want to keep the most recent settings. Any optional elements which are not sent with the update request will in effect be deleted from the target. For more information, see Updating Targets.

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.

The maximum 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.

CampaignManagementService.svc v10

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

Target

Community Additions

ADD
Show:
© 2016 Microsoft