AdExtension 數據物件 - 行銷活動管理
定義廣告延伸模組的基底物件。
請勿嘗試具現化 AdExtension。 您可以建立一或多個衍生自它的下列物件。
- ActionAdExtension
- AppAdExtension
- CallAdExtension
- CalloutAdExtension
- FilterLinkAdExtension
- FlyerAdExtension
- ImageAdExtension
- LocationAdExtension
- LogoAdExtension
- PriceAdExtension
- PromotionAdExtension
- ReviewAdExtension
- SitelinkAdExtension
- StructuredSnippetAdExtension
語法
<xs:complexType name="AdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="DevicePreference" nillable="true" type="xs:long" />
<xs:element xmlns:q43="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q43:ArrayOfKeyValuePairOfstringstring" />
<xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="Scheduling" nillable="true" type="tns:Schedule" />
<xs:element minOccurs="0" name="Status" nillable="true" type="tns:AdExtensionStatus" />
<xs:element minOccurs="0" name="Type" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Version" nillable="true" type="xs:int" />
</xs:sequence>
</xs:complexType>
元素
AdExtension 物件具有下列元素:DevicePreference、ForwardCompatibilityMap、Id、Scheduling、Status、Type、Version。
元素 | 描述 | 資料類型 |
---|---|---|
DevicePreference | 此元素會決定廣告延伸模組的喜好設定是否要顯示在行動裝置或所有裝置上。 若要指定行動裝置的喜好設定,請將此元素設定為 30001。 若要指定所有裝置,請將此元素設定為 0 (零) 或保留元素 nil。 根據預設,此元素會是 nil。 此元素僅適用於 AppAdExtension 和 SitelinkAdExtension 類型。 |
長 |
ForwardCompatibilityMap | 用於向前相容性的索引鍵和值字串清單,以避免在目前 API 版本中新增新元素時中斷變更。 未來的版本中將會記下向前相容性變更。 此物件目前沒有向前相容性變更。 |
KeyValuePairOfstringstring 陣 列 |
識別碼 | 廣告延伸模組的唯一 Microsoft Advertising 識別碼。 | 長 |
排程 | 決定廣告延伸模組符合廣告顯示資格的行事曆日期和時間範圍。 | Schedule |
狀態 | 廣告延伸模組的狀態。 此值一律為 [作用 中],因為營銷活動管理服務不會傳回已刪除的廣告延伸模組。 | AdExtensionStatus |
類型 | 廣告延伸模組的類型。 如需詳細資訊,請參閱。 |
string |
版本 | 追蹤廣告延伸模組更新的次數。 建立廣告延伸模組時,版本會設定為 1 ,並在每次更新之後遞增一。 |
int |
註解
如果您手動產生 SOAP,請使用節點的<AdExtension>
類型屬性,如下列範例所示,指定廣告延伸模組的類型。
<AdExtension i:type="ReviewAdExtension" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<Id i:nil="true" />
<Status i:nil="true" />
. . .
</AdExtension>
需求
服務: CampaignManagementService.svc v13
命名空間: https://bingads.microsoft.com/CampaignManagement/v13
消費者
AddAdExtensions
AdExtensionAssociation
GetAdExtensionsByIds
UpdateAdExtensions