通过

LocationCriterion 数据对象 - 市场活动管理

  • 项目

定义可用于向特定位置的用户显示广告的条件。

使用位置条件，可以选择向潜在客户显示广告，搜索或查看有关以下内容的页面：

  • 所有可用的国家/地区
  • 美国) 、县、州/省和国家/地区的所选城市、邮政编码、大都市区Microsoft市场区

每个位置条件定义附带条件出价调整的位置代码。

可为每个市场活动或广告组指定的合并位置和负位置条件的最大数目为 10,000。

注意

每个市场活动或广告组只能有一个 LocationIntentCriterion ，以确定适用于市场活动或广告组的所有地理条件的位置意向选项， (位置、负位置和半径条件) 。 创建市场活动或广告组的第一个条件时，还会自动添加 LocationIntentCriterion， 默认 IntentOption 设置为 PeopleInOrSearchingForOrViewingPages。 无论市场活动或广告组是否具有任何其他条件，都可以添加或更新市场活动或广告组的 LocationIntentCriterion。 不能删除 LocationIntentCriterion，尽管没有位置或半径条件，它没有任何用途。

LocationCriterion 可以包含在 BiddableAdGroupCriterion、NegativeAdGroupCriterion、BiddableCampaignCriterion 和 NegativeCampaignCriterion 对象中。 如果) 指定广告组级别位置条件 (正面或负面，则忽略该广告组的市场活动级别位置条件。 换句话说，广告组位置条件会覆盖市场活动位置条件，并且不作为联合应用。

另请注意，必须将位置、负位置和半径条件视为一组 地理条件。 如果广告组具有任何地理条件，则不会继承任何市场活动的地理条件。 如果广告组没有任何地理条件，则会继承市场活动的所有地理位置条件。 即使广告组具有位置意向条件，也可以从市场活动继承地理条件。 如果使用广告组的地理条件，则使用广告组的位置意向条件;如果继承了市场活动的地理位置条件，则使用市场活动的位置意向条件，并忽略广告组的位置意向条件。 不能删除市场活动或广告组的位置意向条件，尽管没有位置或半径条件，它没有任何目的。

语法

<xs:complexType name="LocationCriterion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Criterion">
      <xs:sequence>
        <xs:element minOccurs="0" name="DisplayName" nillable="true" type="xs:string" />
        <xs:element xmlns:q81="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="EnclosedLocationIds" nillable="true" type="q81:ArrayOflong" />
        <xs:element minOccurs="0" name="LocationId" nillable="true" type="xs:long" />
        <xs:element minOccurs="0" name="LocationType" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

LocationCriterion 对象具有以下元素：DisplayName、EnclosedLocationIds、LocationId、LocationType。

元素 说明 数据类型
DisplayName 位置显示名称。

加： 只读
更新： 只读		 string
EnclosedLocationIds 仅供内部使用。

加： 只读
更新： 只读		 long 数组
LocationId 要在其中显示广告的位置的唯一Microsoft广告标识符。

有关可能的值，请参阅地理位置文件的“位置ID”字段。 可以调用 GetGeoLocationsFileUrl 操作来下载文件。

重要：在添加或更新位置条件之前，请在地理位置文件中检查“状态”字段。 如果状态为 PendingDeprecation，则位置条件不再用于定位或排除。 仍可检索已弃用的位置条件，但无法添加或更新已弃用的位置条件。

加： 必填
更新： 不允许。 如果指定此元素，它必须与现有设置匹配。		 long
LocationType 位置类型。

可能的值包括但不限于 City、 Country、 MetroArea、 Neighborhood、 PostalCode 和 State。

随时可以添加新的位置子类型。 给定位置 ID 的位置类型很少发生更改。

加： 只读
更新： 只读		 string

LocationCriterion 对象具有 Inherited Elements。

继承的元素

从 Criterion 继承的元素

LocationCriterion 对象派生自 Criterion 对象，并继承以下元素：类型。 以下说明特定于 LocationCriterion，可能不适用于从 Criterion 对象继承相同元素的其他对象。

元素 说明 数据类型
类型 条件的类型。 检索位置条件时，此值为 “位置 ”。 有关条件类型的详细信息，请参阅 Criterion Data Object Remarks。

加： 只读
更新： 只读		 string

要求

服务： CampaignManagementService.svc v13
Namespace： https://bingads.microsoft.com/CampaignManagement/v13