通过

ResponsiveAd Data 对象 - 市场活动管理

  • 项目

受众广告和多媒体广告的响应式广告格式。

ResponsiveAd 对象用于搜索网络中的 多媒体广告 和Microsoft受众网络中的受众 广告 。 有关关键差异的详细信息，请参阅下面的 备注 部分。

注意

同一广告组中允许重复的响应式广告。

语法

<xs:complexType name="ResponsiveAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="AdSubType" nillable="true" type="tns:AdSubType">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="BusinessName" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="CallToAction" nillable="true" type="tns:CallToAction" />
        <xs:element minOccurs="0" name="CallToActionLanguage" nillable="true" type="tns:LanguageName" />
        <xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Headline" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Images" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element xmlns:q4="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="ImpressionTrackingUrls" nillable="true" type="q4:ArrayOfstring">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="LongHeadline" nillable="true" type="tns:AssetLink" />
        <xs:element minOccurs="0" name="LongHeadlineString" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="LongHeadlines" nillable="true" type="tns:ArrayOfAssetLink">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="VerifiedTrackingSettings" nillable="true" type="tns:VerifiedTrackingSetting">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="Videos" nillable="true" type="tns:ArrayOfAssetLink">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

元素

ResponsiveAd 对象具有以下元素：AdSubType、BusinessName、CallToAction、CallToActionLanguage、Descriptions、Headline、Headlines、Images、ImpressionTrackingUrls、LongHeadline、LongHeadlines、LongHeadlines、LongHeadlineString、Text、VerifiedTrackingSettings、Videos。

元素 说明 数据类型
AdSubType 可能的广告子类型。 AdSubType
BusinessName 企业名称。

你的企业名称可能会显示在广告中，具体取决于广告位置。

字符串的长度限制为 25 个字符。

加： 必填
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 string
CallToAction 客户立即点击广告的简短而有力的理由。

此操作显示在“行动号召”按钮上。

加： 不适用于受众广告;多媒体广告需要
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 CallToAction
CallToActionLanguage 将用于提供行动号召的语言。

无论市场活动的语言设置如何，行动号召都将始终以此语言提供。

加： 不适用于受众广告;多媒体广告需要
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 LanguageName
说明 广告中路径下方显示的说明。 为了在所有广告格式中最大化展示，广告中可能不会始终显示说明。

为了在所有广告格式中最大化展示，广告中可能不会始终显示说明。

除非将其中一个描述 固定 到特定位置，否则必应将使用用户搜索查询的最佳标题和说明动态优化广告布局。

从数据模型的角度来看，删除和标题都存储为文本资产，即每个 AssetLink 一个 TextAsset。 同一资产可由多个广告使用。 例如，如果“无缝集成”是文本资产，它将在同一Microsoft广告帐户中的所有广告中具有相同的资产标识符。

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

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

Text 不能包含换行符 (\n) 字符。

加： 多媒体广告和受众广告是必需的。 不适用于视频广告。
更新： 自选。 若要保留所有现有资产链接，请设置或保留此元素为 nil。 如果设置此元素，将替换以前链接到此广告的任何说明。		 AssetLink 数组
标题 标题是广告中显示的最醒目的文本，因此应充分利用可用字符。 我们需要多个标题，以便广告可以在各种发布者和位置上灵活显示。

字符串的长度限制为 30 个字符。

加： 对于视频广告是必需的。 不适用于多媒体广告和受众广告。
更新： 自选。 已弃用多媒体和受众广告。 请改用标题。		 string
标题 标题是广告中显示的最醒目的文本，因此应充分利用可用字符。 我们需要多个标题，以便广告可以在各种发布者和位置上灵活显示。

除非将其中一个标题 固定 到特定位置，否则必应将使用用户搜索查询的最佳标题和说明动态优化广告布局。

从数据模型的角度来看，删除和标题都存储为文本资产，即每个 AssetLink 一个 TextAsset。 同一资产可由多个广告使用。 例如，如果“无缝集成”是文本资产，它将在同一Microsoft广告帐户中的所有广告中具有相同的资产标识符。

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

每个标题 的文本 的最大输入长度为 1,000 个字符（包括动态文本字符串），替换后允许的 1,000 个字符中不超过 30 个。 如果动态文本替换发生后长度超过 30 个字符，广告将无法显示，或者将使用 默认 文本。

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

Text 不能包含换行符 (\n) 字符。

加： 多媒体广告和受众广告是必需的。 不适用于视频广告。
更新： 自选。 若要保留所有现有资产链接，请设置或保留此元素为 nil。 如果设置此元素，则会替换以前链接到此广告的所有标题。		 AssetLink 数组
Images 具有不同大小和纵横比的图像资产，因此它们可以在各种发布者和位置之间灵活显示。

包括一个或多个 AssetLink 对象，每个对象都包含一个具有 SubType 的 ImageAsset 和与所需纵横比匹配的裁剪设置。 有关详细信息，请参阅下面的 说明 。

加： 必填
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。 如果在更新期间包含映像，则会替换以前设置的任何映像。		 AssetLink 数组
ImpressionTrackingUrls 1x1 展示跟踪像素的 URL。 每个像素将向第三方广告报告工具Microsoft受众网络印象。

每个响应式广告最多可以包含 2 个展示跟踪 URL。

每个 URL 都必须可访问。 URL 的长度限制为 2,048 个字符。 HTTP 或 HTTPS 协议字符串计入 2,048 个字符限制。

对于每个Microsoft受众网络印象，Microsoft将对 URL 执行 ping 操作，以便在第三方广告报告工具中启用印象跟踪。 不支持高级用户跟踪，例如转换跟踪或基于 Cookie 或 IP 地址的跟踪。

默认情况下不返回此元素。 若要获取此元素，请在调用 GetAdsByAdGroupId、 GetAdsByEditorialStatus 和 GetAdsByIds 服务操作时，在 ReturnAdditionalFields 元素中包含 ImpressionTrackingUrls 值。

加： 自选
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。 若要删除印象跟踪 URL，请将此元素设置为空字符串数组。		 字符串 数组
LongHeadline 对于受众市场活动， LongHeadline 是两个可能的响应式广告标题中的较长时间。 AssetLink
LongHeadlines 必须设置 1-5 个长标题。 每个标题的文本必须至少包含一个单词。 Text 不能包含换行符 (\n) 。

如果父市场活动关联到某个商店，并且你指定了 LongHeadlines，则还必须指定标题、说明和图像。

添加：如果父市场活动关联到商店，则为可选;如果父市场活动未关联到商店，则为必需项。 如果为空，将使用 LongHeadlineString 。
更新：可选。 若要保留所有现有资产链接，请设置或保留此元素为 nil。 如果为此元素设置值，则会替换以前链接到此资产组的所有标题。 如果父市场活动关联到某个商店，并且你将此元素设置为空列表，则会删除以前的设置。		 AssetLink 数组
LongHeadlineString 标题是广告中显示的最醒目的文本，因此应充分利用可用字符。 我们需要多个标题，以便广告可以在各种发布者和位置上灵活显示。

字符串的长度限制为 90 个字符。

加： 自选。 提供 LongHeadlines 时忽略。 如果 LongHeadlines 为空，我们将使用 LongHeadlineString 填充 LongHeadlines 。 不适用于多媒体广告。
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 string
发短信 此文本将出现在广告的长标题或短标题下方或旁边，具体取决于广告位置。

与标题相比，在广告文本中可以处理更多的字符空间。 因此，一旦图像和标题引起了潜在客户的关注，广告文本需要说服他们点击它。 是什么让你的产品或服务与众不同？

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

字符串的长度限制为 90 个字符。

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

加： 对于视频广告是必需的。 不适用于多媒体广告和受众广告。
更新： 视频广告可选。 请改为对已弃用) (受众广告或多媒体广告使用说明。		 string
VerifiedTrackingSettings VerifiedTrackingSetting 与第三方度量设置相关。 这允许你通过第三方验证提供程序（例如 Integral Ad Science）跟踪可查看性、品牌安全性和无效流量指标。 此功能适用于使用 CPM 出价策略的本机广告、显示广告和在线视频广告。

注意：目前，IAS 是唯一受支持的供应商 (vendorName) ，但其他验证提供程序即将推出。 以下示例与 IAS 相关。

IAS 有 3 个键值对：
  • “vendorName”
  • “advertiserEntityID” (验证提供商的客户端 ID)
  • “publisherEntityID” (验证提供程序的报告 ID)
IAS) 所需的示例 (：
  • vendorName：“IAS”
  • advertiserEntityID ： “12345678”
  • publisherEntityID：“12345678”
 VerifiedTrackingSetting
视频 具有不同大小和纵横比的视频资产，因此它们可以在各种发布者和位置之间灵活显示。

包括一个或多个 AssetLink 对象，每个对象包含带有 SubType的 VideoAsset。

加： 视频广告需要
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。 如果在更新期间包含视频，则会替换以前设置的所有视频。		 AssetLink 数组

ResponsiveAd 对象具有 Inherited Elements。

继承的元素

从 Ad 继承的元素

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

元素 说明 数据类型
AdFormatPreference 此广告类型不支持。 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
类型 广告的类型。 检索响应式广告时，此值为 ResponsiveAd 。 有关广告类型的详细信息，请参阅 Ad 数据对象备注。

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

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

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

备注

ResponsiveAd 对象用于搜索网络中的 多媒体广告 和Microsoft受众网络中的受众 广告 。

大多数支持的属性都相同，但以下是一些关键区别。

注意

图像的数据是通过 AddMedia 操作预配的。 可以使用 GIF、JPEG 或 PNG MIME 类型。 不支持具有动画的图像。 虽然只能通过 AddMedia 操作添加具有少量纵横比的媒体，但可以使用 ImageAsset 裁剪设置来确定每个响应式广告 AssetLink 上下文中的有效纵横比。 帐户级别媒体库中存储的图像的纵横比将保持不变。

最大文件大小为 5 MB。 最大宽度和高度（以像素为单位）分别为 2592 和 2048，并且仍必须保持受支持的纵横比之一。 例如，如果子类型为 LandscapeImageMedia 的图像资产宽度为 2592，则高度必须为 1357。

多媒体广告图像

对于多媒体广告，你将创建具有不同大小和纵横比的多个图像资产。 至少需要添加 1 张纵横比为 1.91：1 的图像和 1 张纵横比为 1：1 的图像。

在 Images 元素中，包括一个或多个 AssetLink 对象。 每个资产链接都包含一个 ImageAsset，其中 SubType 设置为下表中的一个字符串值。

子类型 纵横比 最小尺寸（以像素为单位）
LandscapeImageMedia 1.91:1 703 宽 x 368 高
ImageMedia4x1 4:1 608 宽 x 152 高
SquareImageMedia 1:1 470 宽 x 470 高
ImageMedia1x2 1:2 470 宽 x 940 高

多媒体广告徽标

对于多媒体广告，你将创建具有不同大小、纵横比和裁剪设置的多个徽标资产，以便它们可以灵活地显示在缩略图列表中。

如果图像与广告关联为“LandscapeLogoMedia”或“SquareLogoMedia”，则必须将子类型设置为“徽标”。

子类型 纵横比 最小尺寸（以像素为单位）
LandscapeLogoMedia 4:1 512 宽 x 128 高
SquareLogoMedia 1:1 128 宽 x 128 高

受众广告图像

对于受众广告，你将创建具有不同大小、纵横比和裁剪设置的多个图像资产，以便它们可以跨各种发布者和位置灵活显示。

在 Images 元素中，包括一个或多个 AssetLink 对象。 每个资产链接都包含一个 ImageAsset，其中 SubType 设置为下表中的一个字符串值。

注意

受众广告版本 2 的图像子类型和下表中，目前处于试点阶段。

子类型 纵横比 最小尺寸（以像素为单位）
OriginalImage 不适用 703 宽 x 368 高
LandscapeImageMedia 1.91:1 300 宽 x 157 高
SquareImageMedia 1:1 114 宽 x 114 高
ImageMedia201X100 2.01:1 612 宽 x 304 高
ImageMedia120X100 1.2:1 300 宽 x 250 高
ImageMedia200X100 2:1 200 宽 x 100 高度
ImageMedia169X100 1.69:1 628 宽 x 372 高
ImageMedia124X100 1.24:1 104 宽 x 84 高
ImageMedia153X100 1.53:1 306 宽 x 200 高

注意

下表中的图像子类型适用于受众广告版本 1。

子类型 最小尺寸（以像素为单位）
LandscapeImageMedia 703 宽 x 368 高
方面无线电 1.91：1
SquareImageMedia 300 宽度 x 300 高度
方面无线电 1：1
ImageMedia169X100 622 宽 x 368 高
方面无线电 1.69：1
ImageMedia93X100 311 宽 x 333 高
方面无线电 0.93：1
ImageMedia15X10 300 宽度 x 200 高度
方面无线电 1.5：1
ImageMedia155X100 300 宽 x 194 高
方面无线电 1.55：1
ImageMedia133X100 100 宽 x 75 高
方面无线电 1.33：1
ImageMedia178X100 624 宽 x 350 高
方面无线电 1.78：1
ImageMedia172X100 300 宽 x 174 高
方面无线电 1.72：1

只需提供默认图像 OriginalImage 图像资产， (默认图像以前是 LandscapeImageMedia) 。 在 Images 元素中，包括一个 AssetLink，其中包含一个将 SubType 设置为 OriginalImage 的 ImageAsset。 OriginalImage 的建议尺寸为 1200 宽 x 628 高。 （可选）可以包括其他资产链接，即每个受支持的子类型的一个图像资产。 对于未显式设置的任何图像资产子类型，Microsoft广告将通过裁剪 OriginalImage 自动创建图像资产链接。

鉴于下面的 GetAdsByAdGroupId 响应示例，请注意以下事项：

  • 相同的图像资产标识符 (例如，1234567890000) 用于所有自动生成的图像资产子类型。 无论你是否让Microsoft广告自动生成裁剪的图像， ID 在链接到同一广告的图像资产中不需要是唯一的。
  • 由于此示例中的广告是在没有为 OriginalImage 图像资产子类型裁剪设置的情况下创建的，因此除 OriginalImage 关联的图像之外，所有图像资产都会被裁剪。
  • Microsoft广告将对所有默认裁剪设置使用 OriginalImage 的裁剪设置。 在此示例中，所有系统生成图像资源的裁剪高度为 628，我们可以推断出具有 1.91：1 纵横比的 OriginalImage (OriginalImage 子类型) 宽度和高度为 1200x628。 自动生成的图像资源的裁剪设置基于 OriginalImage 资产链接的裁剪设置。
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
	<s:Header>
		<h:TrackingId xmlns:h="https://bingads.microsoft.com/CampaignManagement/v12">3acf4989-d6a3-405f-9fd1-a2e8dd1b09f8</h:TrackingId>
	</s:Header>
	<s:Body>
		<GetAdsByAdGroupIdResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v12">
			<Ads xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
				<Ad i:type="ResponsiveAd">
					<AdFormatPreference i:nil="true"/>
					<DevicePreference>0</DevicePreference>
					<EditorialStatus>Inactive</EditorialStatus>
					<FinalAppUrls i:nil="true"/>
					<FinalMobileUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
						<a:string>https://mobile.contoso.com/womenshoesale</a:string>
					</FinalMobileUrls>
					<FinalUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
						<a:string>https://www.contoso.com/womenshoesale</a:string>
					</FinalUrls>
					<ForwardCompatibilityMap xmlns:a="http://schemas.datacontract.org/2004/07/System.Collections.Generic"/>
					<Id>9876543210000</Id>
					<Status>Active</Status>
					<TrackingUrlTemplate i:nil="true"/>
					<Type>ResponsiveAd</Type>
					<UrlCustomParameters i:nil="true"/>
					<BusinessName>Contoso</BusinessName>
					<CallToAction>AddToCart</CallToAction>
					<Headline>Fast &amp; Easy Setup</Headline>
					<Images>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight i:nil="true"/>
								<CropWidth i:nil="true"/>
								<CropX i:nil="true"/>
								<CropY i:nil="true"/>
								<SubType>OriginalImage</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>628</CropWidth>
								<CropX>286</CropX>
								<CropY>0</CropY>
								<SubType>SquareImageMedia</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>942</CropWidth>
								<CropX>129</CropX>
								<CropY>0</CropY>
								<SubType>ImageMedia15X10</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>835</CropWidth>
								<CropX>183</CropX>
								<CropY>0</CropY>
								<SubType>ImageMedia133X100</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
						<AssetLink>
							<Asset i:type="ImageAsset">
								<Id>1234567890000</Id>
								<Name i:nil="true"/>
								<Type>ImageAsset</Type>
								<CropHeight>628</CropHeight>
								<CropWidth>1118</CropWidth>
								<CropX>41</CropX>
								<CropY>0</CropY>
								<SubType>ImageMedia178X100</SubType>
							</Asset>
							<AssetPerformanceLabel i:nil="true"/>
							<EditorialStatus i:nil="true"/>
							<PinnedField i:nil="true"/>
						</AssetLink>
					</Images>
					<LandscapeImageMediaId>1234567890000</LandscapeImageMediaId>
					<LandscapeLogoMediaId i:nil="true"/>
					<LongHeadline>Find New Customers &amp; Increase Sales!</LongHeadline>
					<SquareImageMediaId>1234567890000</SquareImageMediaId>
					<SquareLogoMediaId i:nil="true"/>
					<Text>Find New Customers &amp; Increase Sales! Start Advertising on Contoso Today.</Text>
				</Ad>
			</Ads>
		</GetAdsByAdGroupIdResponse>
	</s:Body>
</s:Envelope>

要求

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

使用者

CreateResponsiveAdRecommendation
RefineResponsiveAdRecommendation