共用方式為

廣告數據物件 - 行銷活動管理

  • 發行項

定義廣告的基底物件。

請勿嘗試具現化 廣告。 您可以建立一或多個衍生自它的下列物件。

語法

<xs:complexType name="Ad" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AdFormatPreference" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="DevicePreference" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:AdEditorialStatus" />
    <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
    <xs:element xmlns:q1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q1:ArrayOfstring" />
    <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
    <xs:element xmlns:q2="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q2:ArrayOfstring" />
    <xs:element xmlns:q3="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q3:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:AdStatus" />
    <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="tns:AdType" />
    <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
  </xs:sequence>
</xs:complexType>

元素

Ad 物件具有下列元素：AdFormatPreference、DevicePreference、ApprovalStatus、FinalAppUrls、FinalMobileUrls、FinalUrls、FinalUrlSuffix、ForwardCompatibilityMap、Id、Status、TrackingUrlTemplate、Type、UrlCustomParameters。

元素 描述 資料類型
AdFormatPreference [廣告格式喜好設定] 可用來指出您是否偏好將廣告復本顯示給使用者做為搜尋或對象廣告。 搜尋廣告通常會撰寫為動作的呼叫，而對象廣告應該以更多資訊樣式撰寫。 雖然您可以選擇使用搜尋廣告作為對象廣告，但將廣告指定為對象廣告慣用格式可讓您優化其傳訊以進行原生傳遞。

可能的值為 AudienceAd 和 All。 如果設定為 [全部]，廣告將符合搜尋和對象廣告格式的資格。 如果設定為 AudienceAd，則廣告將僅符合物件廣告格式的資格。

只有 ExpandedTextAd 和 TextAd 物件才支援廣告格式喜好設定。		 string
DevicePreference 決定顯示廣告的裝置喜好設定。

只有 AppInstallAd 和 TextAd 物件才支援裝置喜好設定。		 長
編輯狀態 廣告的編輯檢閱狀態，指出廣告是否擱置檢閱、已核准或已取消核准。 AdEditorialStatus
FinalAppUrls 供日後使用。 AppUrl 陣 列
FinalMobileUrls 行動登陸頁面 URL。

只有 ExpandedTextAd、 ResponsiveAd、 ResponsiveSearchAd 和 TextAd 物件才支援此元素。 AppInstallAd、DynamicSearchAd 和 ProductAd 物件不支援它。		 字串陣列
FinalUrls 最終取得用戶的最後一個或最後一個URL，不論按下至最終URL路徑是否包含任何重新導向。

此元素僅支援 AppInstallAd、 ExpandedTextAd、 ResponsiveAd、 ResponsiveSearchAd 和 TextAd 物件。 DynamicSearchAd 和 ProductAd 物件不支援它。		 字串陣列
FinalUrlSuffix 最終的 URL 後綴可以包含將附加至登陸頁面 URL 結尾的追蹤參數。 建議您在最後的 URL 後綴中放置登陸頁面所需的追蹤參數，讓您的客戶一律傳送至您的登陸頁面。 如需詳細資訊和驗證規則，請參閱技術指南中的 最終 URL 後綴 。

此元素僅支援 AppInstallAd、 DynamicSearchAd、 ExpandedTextAd、 ResponsiveAd 和 ResponsiveSearchAd 物件。 ProductAd 和 TextAd 物件不支援它。		 string
ForwardCompatibilityMap 用於向前相容性的索引鍵和值字串清單，以避免在目前 API 版本中新增新元素時中斷變更。

未來的版本中將會記下向前相容性變更。 此物件目前沒有向前相容性變更。		 KeyValuePairOfstringstring 陣 列
標識碼 廣告的唯Microsoft標識符。 長
地位 廣告的狀態。

您可以將廣告狀態設定為 [作用中] 或 [已暫停]。		 AdStatus
TrackingUrlTemplate 要作為所有登陸頁面 URL 預設值的追蹤範本。

此元素僅支援 AppInstallAd、 DynamicSearchAd、 ExpandedTextAd、 ResponsiveAd、 ResponsiveSearchAd 和 TextAd 物件。 ProductAd 物件不支援它。		 string
類型 廣告的類型。

如需廣告類型的詳細資訊，請參閱。		 AdType
UrlCustomParameters 用於 URL 追蹤的自訂索引鍵和值參數集合。

此元素僅支援 AppInstallAd、 DynamicSearchAd、 ExpandedTextAd、 ResponsiveAd、 ResponsiveSearchAd 和 TextAd 物件。 ProductAd 物件不支援它。		 CustomParameters

註解

針對 Java 和 .NET 語言，請勿設定 Type 元素，因為值取決於您要具現化展開的文字廣告還是另一個廣告類型。

如果您手動產生 SOAP，請使用節點 (的<Ad>類型屬性，如下列範例所示) 指定廣告類型。

<Ads xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Ad i:type="ExpandedTextAd">
    <DevicePreference i:nil="true" />
    <EditorialStatus i:nil="true" />
    <ForwardCompatibilityMap i:nil="true" />
    <Id i:nil="true" />
    <Status i:nil="true" />
    <FinalUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <a:string>https://www.contoso.com/womenshoesale</a:string>
    </FinalUrls>
    <Path1>seattle</Path1>
    <Path2>shoe sale</Path2>
    <Text>Find New Customers & Increase Sales!</Text>
    <TextPart2>Start Advertising on Contoso Today.</TextPart2>
    <TitlePart1>Contoso</TitlePart1>
    <TitlePart2>Fast & Easy Setup</TitlePart2>
    <TitlePart3>Top Rated</TitlePart3>
  </Ad>
</Ads>

需求

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

消費者

AddAds
GetAdsByAdGroupId
GetAdsByEditorialStatus
GetAdsByIds
UpdateAds