通过

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

  • 项目

定义展开的文本广告。

此广告格式可在移动设备、平板电脑和桌面设备上无缝使用，因此你可以更加专注于制作较长的广告副本并优化广告文本，以便在客户点击广告之前更好地吸引客户。

注意

  • 在 2023 年 2 月 1 日之前，将展开的文本广告升级到响应式搜索广告。 在此日期之后，你将无法再创建新的或编辑现有的扩展文本广告。 有关详细信息，请参阅 关于响应式搜索广告。
  • 现有的扩展文本广告将继续投放，你将能够查看其性能报告。
  • 你仍然可以暂停、启用或删除展开的文本广告。 否则，尝试添加或更新展开的文本广告将导致 CampaignServiceAdTypeInvalid 错误。
  • 详细了解此更改。

注意

展开的文本广告只能在 AdGroupType 设置为“SearchStandard”的搜索市场活动中创建。 如果 AdGroupType 设置为“SearchDynamic”，则广告组不支持展开的文本广告。

FinalUrls、Path1、Path2、Text、TextPart2、TitlePart1、TitlePart2 和 TitlePart3 元素的组合使展开的文本广告是唯一的。

语法

<xs:complexType name="ExpandedTextAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="Domain" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Path1" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Path2" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="TextPart2" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="TitlePart1" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="TitlePart2" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="TitlePart3" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

ExpandedTextAd 对象具有以下元素：Domain、Path1、Path2、Text、TextPart2、TitlePart1、TitlePart2、TitlePart3。

元素 说明 数据类型
域 将显示的 URL，而不是最终 URL。 最终 URL 仍将用于登陆页 URL。

保留给有限的试点使用，例如制药客户。

URL 的域部分与路径 1 和路径 2 字符串组合不能超过 67 个字符。

加： 自选
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。 如果将此元素设置为空字符串 (“ ”) ，则会删除以前的设置。		 string
Path1 将追加到显示 URL 的域部分的可选路径的第一部分。 显示 URL 的域部分（例如 https://www.contoso.com ）将从 Final URL (FinalUrls 元素) 的域生成。 如果为 Path1 指定了值，则会将其追加到显示 URL。 如果还为 Path2 指定了一个值，则该值也将追加到 Path1 后面的显示 URL。 例如，如果 FinalUrl 包含https://www.contoso.com， 则 Path1 设置为 subdirectory1， 将 Path2 设置为 subdirectory2，则显示的 URL 将为 https://www.contoso.com/subdirectory1/subdirectory2。

路径可以包含 IF 和 倒计时 函数。 无论所有未替换倒计时参数的总长度如何，最终显示的倒计时将始终使用可用字符总数中的 8 个字符。 有关详细信息，请参阅 倒计时自定义工具。

路径可以包含动态参数，例如 {MatchType}。 有关支持的参数列表，请参阅Microsoft广告帮助文章 我可以使用哪些跟踪或 URL 参数？。

如果包含动态文本字符串，则最大输入长度为 1,000 个字符。 不能输入超过 15 个最终 (不能输入) 字符的动态文本。 如果最终 URL 域的长度和路径组合超过 67 个字符，广告将无法显示，或者将使用 默认文本 。

对于具有双角字符的语言（例如繁体中文），如果包含动态文本字符串，则最大输入长度为 1,000 个字符。 不能输入超过 7 个最终 (不能输入) 字符的动态文本。 如果最终 URL 域和路径的总长度超过 33 个字符，广告将无法显示，或者将使用 默认文本 。 双角字符由你使用的字符而不是市场活动或广告组语言设置的字符集决定。 双角字符包括韩语、日语和中文字符以及表情符号。

路径不能包含正斜杠 (/) 或换行 (\n) 字符。

如果路径包含空格，则会在显示广告时将其替换为下划线 (_) 。

加： 自选
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。 如果将此元素设置为空字符串 (“ ”) ，则会删除以前的设置。		 string
Path2 将追加到显示 URL 的域部分的可选路径的第二部分。 显示 URL 的域部分（例如 https://www.contoso.com ）将从 Final URL (FinalUrls 元素) 的域生成。 如果为 Path1 指定了值，则会将其追加到显示 URL。 如果还为 Path2 指定了一个值，则该值也将追加到 Path1 后面的显示 URL。 例如，如果 FinalUrl 包含https://www.contoso.com， 则 Path1 设置为 subdirectory1， 将 Path2 设置为 subdirectory2，则显示的 URL 将为 https://www.contoso.com/subdirectory1/subdirectory2。

如果还设置了 Path1 ，则只能指定 Path2 。

路径可以包含 IF 和 倒计时 函数。 无论所有未替换倒计时参数的总长度如何，最终显示的倒计时将始终使用可用字符总数中的 8 个字符。 有关详细信息，请参阅 倒计时自定义工具。

路径可以包含动态参数，例如 {MatchType}。 有关支持的参数列表，请参阅Microsoft广告帮助文章 我可以使用哪些跟踪或 URL 参数？。

如果包含动态文本字符串，则最大输入长度为 1,000 个字符。 不能输入超过 15 个最终 (不能输入) 字符的动态文本。 如果最终 URL 域的长度和路径组合超过 67 个字符，广告将无法显示，或者将使用 默认文本 。

对于具有双角字符的语言（例如繁体中文），如果包含动态文本字符串，则最大输入长度为 1,000 个字符。 不能输入超过 7 个最终 (不能输入) 字符的动态文本。 如果最终 URL 域和路径的总长度超过 33 个字符，广告将无法显示，或者将使用 默认文本 。 双角字符由你使用的字符而不是市场活动或广告组语言设置的字符集决定。 双角字符包括韩语、日语和中文字符以及表情符号。

路径不能包含正斜杠 (/) 或换行 (\n) 字符。

如果路径包含空格，则会在显示广告时将其替换为下划线 (_) 。

加： 自选
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。 如果将此元素设置为空字符串 (“ ”) ，则会删除以前的设置。		 string
发短信 可以在广告中显示的广告说明的第一部分。

为了在所有广告格式中最大化展示，说明可能并不总是显示在广告中。

文本必须至少包含一个单词。 为了有效地使用资源，建议使用动态文本字符串（如 {关键字 (keyword) }），而不是为每个关键字 (keyword) 创建新的广告副本。 有关详细信息，请参阅Microsoft广告帮助文章 使用动态文本参数自动自定义广告。

文本可以包含 IF 和 倒计时 函数。 无论所有未替换倒计时参数的总长度如何，最终显示的倒计时将始终使用可用字符总数中的 8 个字符。 有关详细信息，请参阅 倒计时自定义工具。

如果包含动态文本字符串，则最大输入长度为 1,000 个字符。 不能输入超过 90 个最终 (不能输入动态文本) 字符。 如果两个文本部分的长度在动态文本替换发生后超过 180 个字符，广告将无法显示，或者 将使用默认 文本。

对于具有双角字符的语言（例如繁体中文），如果包含动态文本字符串，则最大输入长度为 500 个字符。 不超过 45 个最终 (不能输入动态文本) 字符。 如果两个文本部分的长度在动态文本替换发生后超过 90 个字符，广告将无法显示，或者 将使用默认 文本。 双角字符由你使用的字符而不是市场活动或广告组语言设置的字符集决定。 双角字符包括韩语、日语和中文字符以及表情符号。

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

加： 必填
更新： 自选		 string
TextPart2 可以在广告中显示的广告说明的第二部分。

为了在所有广告格式中最大化展示，说明可能并不总是显示在广告中。

文本必须至少包含一个单词。 为了有效地使用资源，建议使用动态文本字符串（如 {关键字 (keyword) }），而不是为每个关键字 (keyword) 创建新的广告副本。 有关详细信息，请参阅Microsoft广告帮助文章 使用动态文本参数自动自定义广告。

文本可以包含 IF 和 倒计时 函数。 无论所有未替换倒计时参数的总长度如何，最终显示的倒计时将始终使用可用字符总数中的 8 个字符。 有关详细信息，请参阅 倒计时自定义工具。

如果包含动态文本字符串，则最大输入长度为 1,000 个字符。 不能输入超过 90 个最终 (不能输入动态文本) 字符。 如果两个文本部分的长度在动态文本替换发生后超过 180 个字符，广告将无法显示，或者 将使用默认 文本。

对于具有双角字符的语言（例如繁体中文），如果包含动态文本字符串，则最大输入长度为 500 个字符。 不超过 45 个最终 (不能输入动态文本) 字符。 如果两个文本部分的长度在动态文本替换发生后超过 90 个字符，广告将无法显示，或者 将使用默认 文本。 双角字符由你使用的字符而不是市场活动或广告组语言设置的字符集决定。 双角字符包括韩语、日语和中文字符以及表情符号。

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

加： 自选
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。 如果将此元素设置为空字符串 (“ ”) ，则会删除以前的设置。		 string
TitlePart1 广告标题的第一部分。 三个标题部分将自动由空格、垂直条和空格 ( 分隔“ |“) 显示广告时。 标题的每个部分必须至少包含一个单词。 为了有效地使用资源，建议使用动态文本字符串（如 {关键字 (keyword) }），而不是为每个关键字 (keyword) 创建新的广告副本。 有关详细信息，请参阅Microsoft广告帮助文章 使用动态文本参数自动自定义广告。

游戏可以包含 IF 和 倒计时 函数。 无论所有未替换倒计时参数的总长度如何，最终显示的倒计时将始终使用可用字符总数中的 8 个字符。 有关详细信息，请参阅 倒计时自定义工具。

如果包含动态文本字符串，则最大输入长度为 1,000 个字符。 不能输入超过 30 个最终 (不能输入) 字符的动态文本。 如果发生动态文本替换后所有三个标题部分的长度超过 90 个字符，广告将无法显示，或者将使用 默认 文本。

对于具有双角字符的语言（例如繁体中文），如果包含动态文本字符串，则最大输入长度为 500 个字符。 不能输入超过 15 个最终 (不能输入) 字符的动态文本。 如果动态文本替换发生后所有三个标题部分的长度超过 45 个字符，广告将无法显示，或者将使用 默认 文本。 双角字符由你使用的字符而不是市场活动或广告组语言设置的字符集决定。 双角字符包括韩语、日语和中文字符以及表情符号。

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

加： 必填
更新： 自选		 string
TitlePart2 广告标题的第二部分。 三个标题部分将自动由空格、垂直条和空格 ( 分隔“ |“) 显示广告时。 标题的每个部分必须至少包含一个单词。 为了有效地使用资源，建议使用动态文本字符串（如 {关键字 (keyword) }），而不是为每个关键字 (keyword) 创建新的广告副本。 有关详细信息，请参阅Microsoft广告帮助文章 使用动态文本参数自动自定义广告。

游戏可以包含 IF 和 倒计时 函数。 无论所有未替换倒计时参数的总长度如何，最终显示的倒计时将始终使用可用字符总数中的 8 个字符。 有关详细信息，请参阅 倒计时自定义工具。

如果包含动态文本字符串，则最大输入长度为 1,000 个字符。 不能输入超过 30 个最终 (不能输入) 字符的动态文本。 如果发生动态文本替换后所有三个标题部分的长度超过 90 个字符，广告将无法显示，或者将使用 默认 文本。

对于具有双角字符的语言（例如繁体中文），如果包含动态文本字符串，则最大输入长度为 500 个字符。 不能输入超过 15 个最终 (不能输入) 字符的动态文本。 如果动态文本替换发生后所有三个标题部分的长度超过 45 个字符，广告将无法显示，或者将使用 默认 文本。 双角字符由你使用的字符而不是市场活动或广告组语言设置的字符集决定。 双角字符包括韩语、日语和中文字符以及表情符号。

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

加： 必填
更新： 自选		 string
TitlePart3 广告标题的第三部分。 三个标题部分将自动由空格、垂直条和空格 ( 分隔“ |“) 显示广告时。 标题的每个部分必须至少包含一个单词。 为了有效地使用资源，建议使用动态文本字符串（如 {关键字 (keyword) }），而不是为每个关键字 (keyword) 创建新的广告副本。 有关详细信息，请参阅Microsoft广告帮助文章 使用动态文本参数自动自定义广告。

游戏可以包含 IF 和 倒计时 函数。 无论所有未替换倒计时参数的总长度如何，最终显示的倒计时将始终使用可用字符总数中的 8 个字符。 有关详细信息，请参阅 倒计时自定义工具。

如果包含动态文本字符串，则最大输入长度为 1,000 个字符。 不能输入超过 30 个最终 (不能输入) 字符的动态文本。 如果发生动态文本替换后所有三个标题部分的长度超过 90 个字符，广告将无法显示，或者将使用 默认 文本。

对于具有双角字符的语言（例如繁体中文），如果包含动态文本字符串，则最大输入长度为 500 个字符。 不能输入超过 15 个最终 (不能输入) 字符的动态文本。 如果动态文本替换发生后所有三个标题部分的长度超过 45 个字符，广告将无法显示，或者将使用 默认 文本。 双角字符由你使用的字符而不是市场活动或广告组语言设置的字符集决定。 双角字符包括韩语、日语和中文字符以及表情符号。

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

加： 自选
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。 如果将此元素设置为空字符串 (“ ”) ，则会删除以前的设置。		 string

ExpandedTextAd 对象具有 Inherited Elements。

继承的元素

从 Ad 继承的元素

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

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

重要： 您必须为每个广告组定义至少一个不喜欢受众广告的扩展文本广告，否则所有扩展文本广告的广告副本将同时适用于搜索广告和受众广告。

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

加： 自选。 如果未设置此元素，则默认情况下，广告格式首选项将设置为 “全部”。
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 string
DevicePreference 此广告类型不支持。 long
编辑状态 广告的编辑评审状态，指示广告是等待评审、已批准还是已遭拒批。

加： 只读
更新： 只读		 AdEditorialStatus
FinalAppUrls 此广告类型不支持。 AppUrl 数组
FinalMobileUrls 移动登陆页 URL。

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

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

加： 自选
更新： 自选		 字符串 数组
FinalUrls 登陆页 URL。

URL 的域部分与路径 1 和路径 2 字符串组合不能超过 67 个字符。

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

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

加： 必填
更新： 自选		 字符串 数组
FinalUrlSuffix 最终 URL 后缀可以包括跟踪参数，这些参数将追加到登陆页 URL 的末尾。 建议将登陆页面所需的跟踪参数放在最终 URL 后缀中，以便始终将客户发送到登陆页面。 有关更多详细信息和验证规则，请参阅技术指南中的 最终 URL 后缀 。

加： 自选
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。 如果将此元素设置为空字符串 (“ ”) ，则会删除以前的设置。		 string
ForwardCompatibilityMap 用于向前兼容性的键和值字符串列表，以避免在当前 API 版本中添加新元素时发生重大更改。

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

加： 只读
更新： 必需和 Read-Only		 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
类型 广告的类型。 检索展开的文本广告时，此值为 ExpandedText 。 有关广告类型的详细信息，请参阅 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