通过

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

  • 项目

定义一个广告扩展插件，该扩展指定要包含在文本广告中的公司地址和电话号码。

可以将位置广告扩展插件与帐户或该帐户中的市场活动相关联。 每个实体 (帐户或市场活动) 可以与你决定的任意数量的位置广告扩展相关联，最多与帐户中的位置广告扩展的总数相关联。

语法

<xs:complexType name="LocationAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="Address" nillable="true" type="tns:Address" />
        <xs:element minOccurs="0" name="CompanyName" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="GeoCodeStatus" nillable="true" type="tns:BusinessGeoCodeStatus" />
        <xs:element minOccurs="0" name="GeoPoint" nillable="true" type="tns:GeoPoint" />
        <xs:element minOccurs="0" name="PhoneNumber" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

LocationAdExtension 对象具有以下元素：Address、CompanyName、GeoCodeStatus、GeoPoint、PhoneNumber。

元素 说明 数据类型
地址 公司地址。

支持的国家/地区代码值包括 AR、AT、AU、BR、CA、CH、CL、CO、DE、DK、ES、FI、FR、GB、HK、ID、IE、IN、IT、MX、MY、NL、NZ、NO、PE、PH、SE、SG、TH、TW、US、VE 和 VN。

加： 必填
更新： 必填		 地址
CompanyName 企业名称。 名称最多可以包含 80 个字符。

加： 必填
更新： 必填		 string
GeoCodeStatus 一个状态值，该值指示是否已确定业务纬度和经度坐标。

如果提供坐标，状态将设置为“完成”;否则，状态将指示确定指定业务地址坐标的进度。

加： 不允许
更新： 不允许		 BusinessGeoCodeStatus
GeoPoint 指定 Address 元素的纬度和经度坐标。 当用户单击广告上的地址时，坐标用于标记必应地图的业务位置。 如果指定的坐标不在有效值的范围内，则服务将根据地址确定坐标。

如果指定已知坐标，则服务不会确认指定的坐标是否与指定的业务地址匹配。 如果未提供坐标， 则 AddAdExtensions 操作使用业务地址来确定坐标。

添加超过 10 个位置广告扩展时，服务将脱机解析坐标，并在执行服务操作期间提前解析坐标。 在确定坐标之前，不会在广告中使用位置，这可能需要几秒钟到几分钟的时间，具体取决于要添加的位置广告扩展的数量和当前需求。

若要确定是否已解析坐标，请调用 GetAdExtensionsByIds 操作并访问 GeoCodeStatus 元素。 有关可能的状态值的列表，请参阅 BusinessGeoCodeStatus。

加： 自选
更新： 自选		 GeoPoint
PhoneNumber 要包含在广告中的商务电话号码。 可在高保真移动设备上单击电话号码。

电话号码最多可以包含 35 个字符，并且必须对指定的国家或地区有效。

如果市场活动还包括呼叫分机，则分机中的电话号码将覆盖此电话号码。

加： 自选
更新： 自选。 如果将此元素设置为 null，则会删除以前的设置。		 string

LocationAdExtension 对象具有 Inherited Elements。

继承的元素

从 AdExtension 继承的元素

LocationAdExtension 对象派生自 AdExtension 对象，并继承以下元素：DevicePreference、ForwardCompatibilityMap、Id、Schedule、Status、Type、Version。 以下说明特定于 LocationAdExtension，可能不适用于从 AdExtension 对象继承相同元素的其他对象。

元素 说明 数据类型
DevicePreference 此广告扩展类型不支持。 long
ForwardCompatibilityMap 用于向前兼容性的键和值字符串列表，以避免在当前 API 版本中添加新元素时发生重大更改。

AdExtension 对象当前没有向前兼容性更改。

加： 只读
更新： 只读		 KeyValuePairOfstringstring 数组
ID 广告扩展的唯一Microsoft广告标识符。

加： 只读
更新： 只读和必需		 long
计划 确定广告扩展插件有资格显示在广告中的日历日期和时间范围。

加： 自选
更新： 自选。 如果将此元素设置为 null，则广告扩展的任何现有计划集都将保持不变。 如果将此设置为任何非 null Schedule 对象，则实际上将替换广告扩展的现有计划设置。 若要删除所有计划，请将此元素设置为空 Schedule 对象。		 Schedule
状态 广告扩展的状态。 该值将始终为 “活动” ，因为市场活动管理服务不会返回已删除的广告扩展。

加： 只读
更新： 只读		 AdExtensionStatus
类型 广告扩展的类型。 检索位置广告扩展时，此值为 LocationAdExtension 。

加： 只读
更新： 只读

有关广告扩展插件类型的详细信息，请参阅 Ad 扩展插件数据对象备注。		 string
版本 跟踪广告扩展已更新的次数。

创建广告扩展时，版本设置为 1，并在每次更新后递增 1 。

加： 不允许
更新： 不允许		 int

要求

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