通过

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

  • 项目

定义文本广告。

重要

从 2020 年 4 月开始，不支持 (STA) 提供独立文本广告。

Standard文本广告已被弃用，转而改用扩展文本广告 (EXTA) 。 ) 2017 年 7 月 31 日终止了 (STA 添加和更新标准文本广告的支持。 现在，广告客户可以获取和删除，但无法再添加新的 STA 或更新现有的标准文本广告。 规则的一个例外是，你仍然可以将 STA 状态更新，例如从 “活动” 更改为 “已暂停”。 否则，尝试添加或更新 STA 将导致 CampaignServiceAdTypeInvalid 错误。

语法

<xs:complexType name="TextAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="DisplayUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Title" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

TextAd 对象具有以下元素：DestinationUrl、DisplayUrl、Text、Title。

元素 说明 数据类型
DestinationUrl 用户在单击广告时要访问的网页的 URL。

URL 可以包含动态参数，例如 {MatchType}。

有关支持的参数列表，请参阅Microsoft广告帮助文章 我可以使用哪些跟踪或 URL 参数？。

URL 最多可以包含 1,024 个字符。 如果 URL 未指定协议，则当用户单击广告时，系统会使用 HTTP 协议。 如果在添加广告时 URL 指定了 HTTP 协议，则服务将删除 http:// 协议字符串， (HTTP 协议字符串不计入 1,024 个字符限制) ;但是，该服务不会从 URL 中删除 HTTPS 协议字符串 (https：//) 。

重要： 如果当前使用的是目标 URL，则必须将它们替换为最终 URL。 有关详细信息，请参阅 使用已升级 URL 进行 URL 跟踪。

仅当关键字 (keyword) 未指定目标 URL 时，才使用此 URL。

加： 不支持
更新： 不支持		 string
DisplayUrl 要显示在广告中的 URL。

显示 URL 的子目录可以包含动态文本字符串，例如 {关键字 (keyword) };但是，URL 主机名不能包含动态文本。 有关详细信息，请参阅Microsoft广告帮助文章 使用动态文本参数自动自定义广告。

URL 的最大输入长度为 200 个字符，可以包含动态文本字符串。 如果动态文本替换发生后长度超过 35 个字符，广告将无法显示，或者将使用 默认 文本。

加： 不支持
更新： 不支持		 string
发短信 广告副本。 副本必须至少包含一个单词。 广告的副本和标题组合在一起必须至少三个字。

文本可以包含动态文本字符串，例如 {关键字 (keyword) }。 有关详细信息，请参阅Microsoft广告帮助文章 使用动态文本参数自动自定义广告。

副本的最大输入长度为 300 个字符，可以包含动态文本字符串。 如果动态文本替换发生后长度超过 71 个字符，广告将无法显示，或者将使用 默认 文本。 请注意，对于使用繁体中文的广告组，替换后文本限制为 38 个字符。

文本不能包含换行符 (\n) 。

加： 不支持
更新： 不支持		 string
标题 广告的标题。 标题必须至少包含一个单词。 广告的副本和标题组合在一起必须至少三个字。

标题可以包含动态文本字符串，例如 {关键字 (keyword) }。 有关详细信息，请参阅Microsoft广告帮助文章 使用动态文本参数自动自定义广告。

标题的最大输入长度为 80 个字符，可以包含动态文本字符串。 如果动态文本替换发生后长度超过 25 个字符，广告将无法显示，或使用 默认 文本。 请注意，对于使用繁体中文的广告组，替换后的标题限制为 15 个字符。

标题不能包含换行符 (\n) 。

加： 不支持
更新： 不支持		 string

TextAd 对象具有 Inherited Elements。

继承的元素

从 Ad 继承的元素

TextAd 对象派生自 Ad 对象，并继承以下元素：AdFormatPreference、DevicePreference、EditorialStatus、FinalAppUrls、FinalMobileUrls、FinalUrls、FinalUrls、FinalUrlSuffix、ForwardCompatibilityMap、Id、Status、TrackingUrlTemplate、Type、UrlCustomParameters。 以下说明特定于 TextAd，可能不适用于从 Ad 对象继承相同元素的其他对象。

元素 说明 数据类型
AdFormatPreference 广告格式首选项用于指示你是否希望将广告副本作为搜索广告或受众广告显示给用户。 搜索广告倾向于编写为行动号召，而受众广告应以更多的信息风格编写。 虽然可以选择将搜索文本广告用作受众广告，但将广告指定为受众广告首选格式可让你优化其消息传送，以便进行本机传递。

重要： 您必须为每个广告组定义至少一个不喜欢受众广告的文本广告，否则所有文本广告的广告副本都有资格获得搜索广告和受众广告。

可能的值为 AudienceAd 和 All。 如果设置为 “全部”，则广告将符合搜索和受众广告格式的条件。 如果设置为 AudienceAd，则广告将仅符合受众广告格式的条件。

加： 不支持
更新： 不支持		 string
DevicePreference 此元素确定首选项是在移动设备上还是所有设备上显示文本广告。

若要指定移动设备的首选项，请将此元素设置为 30001。

若要指定所有设备，请将此元素设置为 0 (零) 或将元素保留为 nil。 默认情况下，此元素将为 nil。 必须为每个广告组定义至少一个非移动首选的文本广告，否则该广告将适用于所有设备。

加： 不支持
更新： 不支持		 long
编辑状态 广告的编辑评审状态，指示广告是等待评审、已批准还是已遭拒批。

加： 不支持
更新： 不支持		 AdEditorialStatus
FinalAppUrls 不支持文本广告。 AppUrl 数组
FinalMobileUrls 移动登陆页 URL。

仅当关键字 (keyword) 未指定最终移动 URL 时，才使用此 URL。

以下验证规则适用于最终 URL 和最终移动 URL。
- URL 的长度限制为 2,048 个字符。 HTTP 或 HTTPS 协议字符串计入 2,048 个字符限制。
- 最多可为 FinalUrls 和 FinalMobileUrls 指定 10 个项目;但是，每个列表中的第一项仅用于传递。 该服务最多允许 10 个，以确保潜在的向前兼容性。
- 仅允许使用“{”和“}”来描述标记，例如 {lpurl}。
- 最终 URL 必须是格式正确的 URL，以 http:// 或 https:// 开头。
- 如果指定 FinalMobileUrls，还必须指定 FinalUrls。
- 如果设备首选项设置为移动，则不能指定 FinalMobileUrls 。 另请注意，对于 TextAd 对象，如果 DevicePreference 设置为 30001 (移动) ，则不能指定 FinalMobileUrls。

加： 不支持
更新： 不支持		 字符串 数组
FinalUrls 登陆页 URL。

仅当关键字 (keyword) 未指定最终 URL 时，才使用此 URL。

以下验证规则适用于最终 URL 和最终移动 URL。
- URL 的长度限制为 2,048 个字符。 HTTP 或 HTTPS 协议字符串计入 2,048 个字符限制。
- 最多可为 FinalUrls 和 FinalMobileUrls 指定 10 个项目;但是，每个列表中的第一项仅用于传递。 该服务最多允许 10 个，以确保潜在的向前兼容性。
- 仅允许使用“{”和“}”来描述标记，例如 {lpurl}。
- 最终 URL 必须是格式正确的 URL，以 http:// 或 https:// 开头。
- 如果指定 FinalMobileUrls，还必须指定 FinalUrls。
- 如果设备首选项设置为移动，则不能指定 FinalMobileUrls 。 另请注意，如果设置了此广告的 TrackingUrlTemplate 或 UrlCustomParameters 元素，则至少需要一个最终 URL。

加： 不支持
更新： 不支持		 字符串 数组
FinalUrlSuffix 不支持文本广告。 string
ForwardCompatibilityMap 用于向前兼容性的键和值字符串列表，以避免在当前 API 版本中添加新元素时发生重大更改。

将来的版本中将在此处记录向前兼容性更改。 此对象当前没有向前兼容性更改。		 KeyValuePairOfstringstring 数组
ID 广告的唯一Microsoft广告标识符。

加： 不支持
更新： 必需和只读		 long
状态 广告的状态。

可以将广告状态设置为“活动”或“已暂停”。

加： 不支持
更新： 自选		 AdStatus
TrackingUrlTemplate 要用作所有登陆页 URL 的默认值的跟踪模板。

以下验证规则适用于跟踪模板。 有关支持的模板和参数的更多详细信息，请参阅Microsoft广告帮助文章 可以使用哪些跟踪或 URL 参数？
- 为较低级别的实体（例如广告）定义的跟踪模板将覆盖为较高级别的实体（例如市场活动）设置的模板。 有关详细信息，请参阅 实体限制。
- 跟踪模板的长度限制为 2,048 个字符。 HTTP 或 HTTPS 协议字符串计入 2,048 个字符限制。
- 跟踪模板必须是格式正确的 URL，以下列项之一开头： http://、 https://、 {lpurl}或 {unescapedlpurl}。
- Microsoft广告不验证自定义参数是否存在。 如果在跟踪模板中使用自定义参数，并且这些参数不存在，则登陆页 URL 将包含自定义参数的键和值占位符，而不进行替换。 例如，如果您的跟踪模板为 https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} ，并且未在市场活动、广告组、条件、关键字 (keyword) 或广告级别定义 {_season} 或 {_promocode}，则登陆页 URL 将相同。

加： 不支持
更新： 不支持		 string
类型 广告的类型。 检索 文本 广告时，此值为 Text。 有关广告类型的详细信息，请参阅 Ad 数据对象备注。

加： 不支持
更新： 不支持		 AdType
UrlCustomParameters 用于 URL 跟踪的键和值参数的自定义集合。

Microsoft Advertising 将接受在 CustomParameters 对象中包含的前 8 个 CustomParameter 对象 ，如果包含 8 个以上的自定义参数，则会返回错误。 每个 CustomParameter 都包含 键 和 值 元素。

加： 自选
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。 将 UrlCustomParameters 元素设置为 null 或空，以保留任何现有自定义参数。 若要删除所有自定义参数，请将 CustomParameters 对象的 Parameters 元素设置为 null 或空。 若要删除自定义参数的子集，请指定要保留在 CustomParameters 对象的 Parameters 元素中的自定义参数。		 CustomParameters

要求

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