通过

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

  • 项目

定义动态搜索广告。

使用动态搜索广告时，会根据要面向的网站域和语言自动生成标题和显示 URL。 Path1、Path2 和 Text 元素的组合使动态搜索广告是唯一的。 （可选）可以使用 页面源提供静态标题。

注意

此功能目前在以下国家或地区可用：阿尔巴尼亚 (AL) 、 (AD) 、 阿根廷 (AR) 、阿鲁巴、澳大利亚 (非盟) 、奥地利 (AT) 、巴哈马 (BS) 、孟加拉国 (BD) 、比利时 (BE) 、玻利维亚 (BO) 、波斯尼亚和黑塞哥维那 (BA) 、巴西 (BR) ， 文莱 (BN) 、保加利亚 (BG) 、加拿大 (CA) 、开曼群岛 (KY) ， 智利 (CL) 、哥伦比亚 (CO) 、哥斯达黎加 (CR) 、克罗地亚 (HR) 、塞浦路斯 (CY) 、捷克共和国 (CZ) 、丹麦 (DK) 、多米尼加 (DM) 、多米尼加共和国 (DO) ， 厄瓜多尔 (欧共体) 、萨尔瓦多 (SV) 、爱沙尼亚 (EE) 、斐济 (FJ) 、芬兰 (FI) 、法国 (FR) 、 法属圭亚那 (GF) 、法属波利尼西亚 (PF) 、德国 (DE) 、希腊 (GR) 、关岛 (GU) 、危地马拉 (GT) 、圭亚那 (GY) 、海地 (HT) ， 洪都拉斯 (HN) 、匈牙利 (胡) 、冰岛 (是) 、印度 (IN) 、印度尼西亚 (ID) 、 爱尔兰 (IE) 、意大利 (IT) 、拉脱维亚 (LV) 、列支敦斯登 (LI) 、立陶宛 (LT) 、卢森堡 (LU) 、马来西亚 (MY) 、马尔代夫 (MV) 、马耳他 (MT) ， 马提尼克 (MQ) 、墨西哥 (MX) 、摩纳哥 (MC) 、蒙古 (MN) 、黑山 (ME) 、 蒙特塞拉特 () ，尼泊尔 (NP) ，荷兰 (NL) ，新喀里多尼亚 (NC) ，新西兰 (新西兰) ，北马其顿共和国 (MK) ，挪威 (NO) ，巴拿马 (PA) ， 巴拉圭 (PY) 、巴布亚新几内亚 (PG) 、秘鲁 (PE) 、菲律宾 (PH) ， 波兰 (PO) 、葡萄牙 (PT) 、波多黎各、罗马尼亚 (RO) 、圣马力诺 (SM) 、塞尔维亚 (RS) 、新加坡 (SG) 、斯洛伐克 (SK) 、斯洛文尼亚 (SI) 、南非 (ZA) ， 西班牙 (ES) 、西班牙 (ES) 、斯里兰卡 (LK) 、瑞典 (SE) ， 瑞士 (CH) 、泰国 (TH) 、特立尼达和多巴哥 (TT) 、土耳其 (TR) 、梵蒂冈城 (VA) 、越南 (VN) 、英国 (英国) 、美国 (US) 、乌拉圭 (UY) ， 和委内瑞拉 (VE) 。

动态搜索广告只能在具有 DynamicSearchAdsSetting 的搜索市场活动中创建。 无法设置市场活动的 ExperimentId 元素，并且 AdGroupType 必须设置为“SearchDynamic”。

注意

不能再添加、更新或检索仅支持动态搜索广告的市场活动。 现有市场活动的市场活动类型已从“DynamicSearchAds”更新为“搜索”。 广告组现在被视为“动态”广告组，但没有任何结构性更改，即它们包含与以前相同的自动目标和动态搜索广告。

语法

<xs:complexType name="DynamicSearchAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <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:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

DynamicSearchAd 对象具有以下元素：Path1、Path2、Text、TextPart2。

元素 说明 数据类型
Path1 将追加到显示 URL 的域部分的可选路径的第一部分。 显示 URL（例如 ，www.contoso.com ）将从显示 URL 的域生成。 如果为 路径 1 指定了值，则会将其追加到显示 URL。 如果还为 路径 2 指定了一个值，则该值也将追加到 路径 1 后的显示 URL。 例如，如果域 contoso.com， 路径 1 设置为 subdirectory1， 路径 2 设置为 subdirectory2，则显示的 URL 将 www.contoso.com/subdirectory1/subdirectory2。

路径的最大输入长度为 15 个字符。 请注意，对于具有双角字符的语言（例如繁体中文），路径的最大输入长度为 7 个字符。

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

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

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

加： 自选
更新： 自选		 string
Path2 将追加到显示 URL 的域部分的可选路径的第二部分。 显示 URL（例如 ，www.contoso.com ）将从动态搜索广告市场活动级别设置的域生成。 如果为 路径 1 指定了值，则会将其追加到显示 URL。 如果还为 路径 2 指定了一个值，则该值也将追加到 路径 1 后的显示 URL。 例如，如果域 contoso.com， 路径 1 设置为 subdirectory1， 路径 2 设置为 subdirectory2，则显示的 URL 将 www.contoso.com/subdirectory1/subdirectory2。

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

路径的最大输入长度为 15 个字符。 请注意，对于具有双角字符的语言（例如繁体中文），路径的最大输入长度为 7 个字符。

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

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

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

加： 自选
更新： 自选		 string
发短信 广告说明的第一部分。

文本必须至少包含一个单词。

副本的最大输入长度为 90 个字符。 请注意，对于使用繁体中文的广告组，副本的最大输入长度为 45 个字符。

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

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

加： 必填
更新： 自选		 string
TextPart2 广告说明的第二部分。

文本必须至少包含一个单词。

副本的最大输入长度为 90 个字符。 请注意，对于使用繁体中文的广告组，副本的最大输入长度为 45 个字符。

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

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

加： 自选
更新： 自选		 string

DynamicSearchAd 对象具有 Inherited Elements。

继承的元素

从 Ad 继承的元素

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

元素 说明 数据类型
AdFormatPreference 此广告类型不支持。 string
DevicePreference 此广告类型不支持。 long
编辑状态 广告的编辑评审状态，指示广告是等待评审、已批准还是已遭拒批。

加： 只读
更新： 只读		 AdEditorialStatus
FinalAppUrls 此广告类型不支持。 AppUrl 数组
FinalMobileUrls 此广告类型不支持。 字符串 数组
FinalUrls 此广告类型不支持。 字符串 数组
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
类型 广告的类型。 检索动态搜索广告时，此值为 DynamicSearch 。 有关广告类型的详细信息，请参阅 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