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

定义资产与广告的关系。

例如， 在 ResponsiveSearchAd 中，有一个资产链接数组，每个链接都包含 一个 TextAsset。

语法

XML

<xs:complexType name="AssetLink" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Asset" nillable="true" type="tns:Asset" />
    <xs:element minOccurs="0" name="AssetPerformanceLabel" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:AssetLinkEditorialStatus" />
    <xs:element minOccurs="0" name="PinnedField" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

JSON

{
  "Asset": {
    "Id": "LongValueHere",
    "Name": "ValueHere",
    "Type": "ImageAsset",
    "CropHeight": IntValueHere,
    "CropWidth": IntValueHere,
    "CropX": IntValueHere,
    "CropY": IntValueHere,
    "SubType": "ValueHere",
    "TargetHeight": IntValueHere,
    "TargetWidth": IntValueHere
  },
  "AssetPerformanceLabel": "ValueHere",
  "EditorialStatus": "ValueHere",
  "PinnedField": "ValueHere"
}

元素

AssetLink 对象具有以下元素：Asset、AssetPerformanceLabel、EditorialStatus、PinnedField。

元素	说明	数据类型
资产	具有唯一Microsoft广告标识符的资产，可跨多个广告重复使用。 对于响应式搜索广告的 标题 和 说明 列表中包含的资产链接，资产必须是 TextAsset。 加： 必填 更新： 必填	资产
AssetPerformanceLabel	这可让你了解资产的性能。 可能的分级包括： - 低：此资产的性能较低，建议替换此资产以提高广告性能。 - 良好：此资产性能良好。 建议保留此资产并添加更多资产以提高广告性能。 - 最佳：此资产的性能是最佳资产之一，建议添加更多类似的资产。 - 未评级：此资产没有任何性能评级。 这可能是由于资产处于非活动状态，没有足够的信息来确定其性能，或者没有足够的类似资产与之进行比较。 - 学习：正在积极评估资产的性能。 评估完成后，资产评级将为“低”、“良好”、“最佳”或“未评级”。 加： 只读。 如果设置此值，服务将忽略此值。 更新： 只读。 如果设置此值，服务将忽略此值。	string
编辑状态	资产链接的编辑评审状态，指示资产是等待评审、已批准还是已遭拒批。 加： 只读 更新： 只读	AssetLinkEditorialStatus
PinnedField	确定资产是应仅用于特定广告组件，还是要Bing AI优化此资产的布局。 除非对资产有特定要求，否则不要固定资产，让Bing AI优化放置。 如果 资产 是 TextAsset 且包含在响应式搜索广告的 “说明 ”列表中，则有效的固定字段值为 Description1 和 Description2。 每个说明位置必须至少有一个符合条件的 TextAsset 可用，因此不能将所有资产固定到同一位置。 例如，可以将 3 个文本资产固定到 Description1，前提是响应式搜索广告的 “说明 ”列表中至少有一个未固定或固定到 Description2 的文本资产。 如果 资产 是 TextAsset 且包含在响应式搜索广告的 “标题 ”列表中，则有效的固定字段值为 “标题1”、“ 标题2”和“ 标题3”。 每个标题位置必须至少有一个符合条件的 TextAsset 可用，因此不能将所有资产固定到同一位置。 例如，你可以将 3 个文本资产固定到 标题 1,3 个文本资产固定到 标题 2，前提是响应式搜索广告的 “标题 ”列表中至少有一个未固定或固定到 标题 3 的文本资产。 如果之前已将资产固定到广告组件，但后来想要删除该固定，则需要使用现有资产更新广告，并将固定字段元素留空，用于要取消固定的资产或资产。 检索未固定的资产时，字符串值为 nil 或空。 不应为 Performance Max AssetGroup 设置 PinnedField，因为它不适用。 加： 自选 更新： 自选	string

要求

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

使用者

AdRecommendationImageSuggestion
AssetGroup
ImageAdExtension
ResponsiveAd
ResponsiveSearchAd