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、ApprovalStatus、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 或空白。 PinnedField 不應設定為 Performance Max AssetGroup，因為它不適用。 加： 自選 更新： 自選	string

需求

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

消費者

AdRecommendationImageSuggestion
AdRecommendationTextRefineResult
AssetGroup
ImageAdExtension
ResponsiveAd
ResponsiveSearchAd