通过

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

  • 项目

定义一个 对象，该对象指定要包含在文本广告中的点击呼叫电话号码。

可以将呼叫广告扩展插件与帐户中的市场活动相关联。 (市场活动) 的每个实体都可以与一个呼叫广告分机相关联。

语法

<xs:complexType name="CallAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="CountryCode" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="IsCallOnly" nillable="true" type="xs:boolean" />
        <xs:element minOccurs="0" name="IsCallTrackingEnabled" nillable="true" type="xs:boolean" />
        <xs:element minOccurs="0" name="PhoneNumber" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="RequireTollFreeTrackingNumber" nillable="true" type="xs:boolean" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

CallAdExtension 对象具有以下元素：CountryCode、IsCallOnly、IsCallTrackingEnabled、PhoneNumber、RequireTollFreeTrackingNumber。

元素 说明 数据类型
CountryCode 注册电话号码的国家/地区代码。 国家/地区代码必须包含 2 个字符的国家/地区代码。 支持的国家/地区代码值包括 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。

加： 必填
更新： 必填		 string
IsCallOnly 向在智能手机上看到你的广告的用户同时显示你的电话号码和网站或仅显示你的电话号码的选项。 如果你的业务要求你与每个客户交谈，则你可能希望仅显示你的电话号码。

如果希望广告扩展仅显示电话号码而不显示指向您的网站的链接，则此属性设置为 true ;如果希望广告扩展插件包含指向您的网站的链接以及电话号码设置为 false，请将此属性设置为 true。

加： 自选。 如果未指定此元素或将其留空，则将设置默认值 false ，并且除电话号码外，广告扩展还将包含指向您的网站的链接。
更新： 自选		 boolean
IsCallTrackingEnabled 确定是否为呼叫广告分机启用呼叫跟踪。

仅美国和英国支持呼叫跟踪。

将此属性设置为 true 以启用呼叫跟踪，否则将其设置为 false。

加： 自选。 如果未指定此元素或将其留空，则将设置默认值 false 。
更新： 自选		 boolean
PhoneNumber 要包含在广告中的可点击电话号码。

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

如果市场活动包括呼叫和位置广告扩展，则此电话号码将覆盖位置广告扩展中指定的电话号码。

请注意，电话号码可能已重新格式化。 例如，如果将电话号码设置为 4255551212，则会将其重新格式化为 (425) 555-1212。

加： 必填
更新： 必填		 string
RequireTollFreeTrackingNumber 可以使用自己的电话号码，也可以使用Microsoft广告转发电话号码。 Microsoft广告转发电话号码是路由到企业电话号码的唯一电话号码。 使用Microsoft广告转接号码，可以跟踪来自广告的所有调用，以便分析广告的性能。 此元素确定是否应为呼叫跟踪创建免费Microsoft广告转接电话号码。 仅当 IsCallTrackingEnabled 也为 true 时，才能设置此元素。

在 2017 年 8 月之前，如果应为呼叫跟踪创建Microsoft Advertising 转接电话号码，则客户端可以将此属性设置为 true 。 自 2017 年 8 月起，客户无法再创建新的免费Microsoft广告转发电话号码。 如果将此值设置为 true ，则操作将成功;但是，不会创建免费号码，并且检索呼叫广告分机时，此属性将设置为 false。 如果在 2017 年 8 月之前预配了免费转接号码，则在检索呼叫广告分机时，如果该号码仍然处于活动状态，则此属性为 true 。

加： 自选。 如果未指定此元素或将其留空，则将设置默认值 false 。
更新： 自选		 boolean

CallAdExtension 对象具有 Inherited Elements。

继承的元素

从 AdExtension 继承的元素

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

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

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

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

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

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

加： 只读
更新： 只读		 AdExtensionStatus
类型 广告扩展的类型。 检索呼叫广告分机时，此值为 CallAdExtension 。

加： 只读
更新： 只读

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

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

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

要求

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