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

定义一个条件,该条件可用于在特定地理位置半径内向用户显示广告。

使用半径条件,可以选择在邮政编码、坐标、地标或区域周围指定半径的页面中向潜在客户显示广告、搜索或查看页面。

每个半径条件都为随附的条件出价调整定义了半径、纬度和经度。

可为每个市场活动或广告组指定的最大半径条件数为 2,000。

注意

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

RadiusCriterion 条件可以包含在 BiddableAdGroupCriterionBiddableCampaignCriterion 对象中。 如果指定了广告组级别半径条件,则忽略该广告组的市场活动级别半径条件。 换句话说,广告组半径条件会覆盖市场活动半径条件,并且不作为联合应用。

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

语法

<xs:complexType name="RadiusCriterion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Criterion">
      <xs:sequence>
        <xs:element minOccurs="0" name="LatitudeDegrees" nillable="true" type="xs:double" />
        <xs:element minOccurs="0" name="LongitudeDegrees" nillable="true" type="xs:double" />
        <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Radius" nillable="true" type="xs:long" />
        <xs:element minOccurs="0" name="RadiusUnit" nillable="true" type="tns:DistanceUnit" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

RadiusCriterion 对象具有以下元素:LatitudeDegreesLongitudeDegreesNameRadiusRadiusUnit

元素 说明 数据类型
LatitudeDegrees 目标位置的纬度(以度为单位)。

纬度必须大于或等于 -85.0 且小于或等于 +85.0。

加: 必填
更新: 不允许。 如果指定此元素,它必须与现有设置匹配。
LongitudeDegrees 目标位置的经度(以度为单位)。

经度必须大于或等于 -180.0 且小于或等于 +180.0。

加: 必填
更新: 不允许。 如果指定此元素,它必须与现有设置匹配。
名称 目标地理位置的名称。 名称最多可以包含 50 个字符。

加: 自选
更新: 只读
string
半径 指定要定位的地理位置周围区域的半径。

如果 RadiusUnit 设置为 Miles,则接受从 1 到 500 的正整数值。

如果 RadiusUnit 设置为“公里”,则接受从 1 到 800 的正整数值。

数据类型为 double,在将来的版本中可能受支持。 目前,服务仅接受并返回整数值。

加: 必填
更新: 不允许。 如果指定此元素,它必须与现有设置匹配。
long
RadiusUnit 指定半径的度量单位,例如千米或英里。

加: 必填
更新: 不允许。 如果指定此元素,它必须与现有设置匹配。
DistanceUnit

RadiusCriterion 对象具有 Inherited Elements

继承的元素

从 Criterion 继承的元素

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

元素 说明 数据类型
类型 条件的类型。 检索 半径 条件时,此值为 Radius。 有关条件类型的详细信息,请参阅 Criterion Data Object Remarks

加: 只读
更新: 只读
string

要求

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