LocationIntentCriterion Data Object - Campaign Management

Article
05/01/2024

Defines a criterion that determines the intent option for all location and radius criterions of the campaign or ad group. There isn't any accompanying criterion bid adjustment.

The maximum number of location intent criterions that you can specify per campaign or ad group is one.

Note

You can only have one LocationIntentCriterion per campaign or ad group to determine the location intent option that applies for all of the campaign or ad group's geographical criterions (location, negative location, and location intent criterions). When you create the campaign or ad group's first criterion, a LocationIntentCriterion will also be added automatically with the default IntentOption set to PeopleInOrSearchingForOrViewingPages. You can add or update a campaign or ad group's LocationIntentCriterion, whether or not the campaign or ad group has any other criterions. You cannot delete a LocationIntentCriterion, although it has no purpose without location or location intent criterions.

PeopleSearchingForOrViewingPages is deprecated as of April 2024. If you try to set IntentOption to PeopleSearchingForOrViewingPages, it will be set to PeopleInOrSearchingForOrViewingPages instead. We will automatically convert existing campaigns with this setting to PeopleInOrSearchingForOrViewingPages.

The LocationIntentCriterion criterion can be included within BiddableAdGroupCriterion andBiddableCampaignCriterion objects.

Also note that you must consider the location, negative location, and radius criterions as a set of geo criterions. If the ad group has any geo criterions, then none of the campaign's geo criterions are inherited. If the ad group doesn't have any geo criterions, then all of the campaign's geo criterions are inherited. The geo criterions can be inherited from the campaign even if the ad group has a location intent criterion. If the ad group's geo criterions are used, then the ad group's location intent criterion is used; if the campaign's geo criterions are inherited, then the campaign's location intent criterion is used and the ad group's location intent criterion is ignored. You cannot delete a campaign or ad group's location intent criterion, although it has no purpose without location or radius criterions.

Syntax

<xs:complexType name="LocationIntentCriterion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Criterion">
      <xs:sequence>
        <xs:element minOccurs="0" name="IntentOption" nillable="true" type="tns:IntentOption" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elements

The LocationIntentCriterion object has the following elements: IntentOption.

Element	Description	Data Type
IntentOption	Determines whether a person must be physically located in the targeted location in order for the ad to display. The following values are supported. The default value is PeopleInOrSearchingForOrViewingPages. - Use PeopleInOrSearchingForOrViewingPages if you want to show ads to people in, searching for, or viewing pages about your targeted location. - Use PeopleIn if you want to show ads to people in your targeted location. Add: Optional. If no value is specified the default value is PeopleInOrSearchingForOrViewingPages. Update: Optional. If no value is set for the update, this setting is not changed.	IntentOption

The LocationIntentCriterion object has Inherited Elements.

Inherited Elements

Inherited Elements from Criterion

The LocationIntentCriterion object derives from the Criterion object, and inherits the following elements: Type. The descriptions below are specific to LocationIntentCriterion, and might not apply to other objects that inherit the same elements from the Criterion object.

Element	Description	Data Type
Type	The type of the criterion. This value is LocationIntent when you retrieve a location intent criterion. For more information about criterion types, see the Criterion Data Object Remarks. Add: Read-only Update: Read-only	string

Requirements

Service: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Share via