Aracılığıyla paylaş

Reklam Verileri Nesnesi - Kampanya Yönetimi

  • Makale

Bir reklamın temel nesnesini tanımlar.

Reklam örneği oluşturmaya çalışmayın. Bu nesneden türetilen aşağıdaki nesnelerden birini veya daha fazlasını oluşturabilirsiniz.

Sözdizimi

<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>

Öğe

Ad nesnesi şu öğelere sahiptir: AdFormatPreference, DevicePreference, EditorStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters.

Öğe Açıklama Veri Türü
AdFormatPreference Reklam Biçimi Tercihi, reklam kopyasının kullanıcılara arama veya hedef kitle reklamı olarak gösterilmesini isteyip istemediğinizi belirtmek için kullanılır. Arama reklamları eylem çağrısı olarak yazılırken, hedef kitle reklamları daha bilgilendirici bir stilde yazılmalıdır. Arama reklamlarını hedef kitle reklamları olarak kullanma seçeneğiniz olsa da, bir reklamı hedef kitle reklamları tercih edilen biçim olarak belirleyerek mesajlaşmasını yerel dağıtım için iyileştirebilirsiniz.

Olası değerler AudienceAd ve Tümü'dür. Tümü olarak ayarlanırsa, reklam hem arama hem de hedef kitle reklam biçimleri için uygun olacaktır. AudienceAd olarak ayarlanırsa, reklam yalnızca hedef kitle reklam biçimi için uygun olur.

Reklam Biçimi Tercihi yalnızca ExpandedTextAd ve TextAd nesneleri için desteklenir.		 dize
DevicePreference Reklamı göstermek için cihaz tercihini belirler.

Cihaz tercihi yalnızca AppInstallAd ve TextAd nesneleri için desteklenir.		 uzun
EditoryalStatus Reklamın gözden geçirmeyi beklemede olduğunu, onaylandığını veya onaylanmadığını gösteren, reklamın editoryal inceleme durumu. AdEditorialStatus
FinalAppUrls Gelecekte kullanmak için. AppUrl dizisi
FinalMobileUrls Mobil giriş sayfası URL'si.

Bu öğe yalnızca ExpandedTextAd, ResponsiveAd, ResponsiveSearchAd ve TextAd nesneleri için desteklenir. AppInstallAd, DynamicSearchAd ve ProductAd nesneleriyle desteklenmez.		 dize dizisi
FinalUrls Son URL yoluna tıklamanın herhangi bir yeniden yönlendirmeyi içerip eklemediği, kullanıcının nihai olarak alındığı son veya son URL.

Bu öğe yalnızca AppInstallAd, ExpandedTextAd, ResponsiveAd, ResponsiveSearchAd ve TextAd nesneleri için desteklenir. DynamicSearchAd ve ProductAd nesneleriyle desteklenmez.		 dize dizisi
FinalUrlSuffix Son URL soneki, giriş sayfası URL'nizin sonuna eklenecek izleme parametrelerini içerebilir. Müşterilerinizin her zaman giriş sayfanıza gönderilmesi için giriş sayfanızın gerektirdiği izleme parametrelerini son URL son ekine yerleştirmenizi öneririz. Daha fazla ayrıntı ve doğrulama kuralları için teknik kılavuzlardaki Son URL Son Eki'ne bakın.

Bu öğe yalnızca AppInstallAd, DynamicSearchAd, ExpandedTextAd, ResponsiveAd ve ResponsiveSearchAd nesneleri için desteklenir. ProductAd ve TextAd nesneleriyle desteklenmez.		 dize
İletme Uyumluluğu Haritası Geçerli API sürümüne yeni öğeler eklendiğinde başka değişikliklerden kaçınmak için ileriye dönük uyumluluk için anahtar ve değer dizelerinin listesi.

İleriye dönük uyumluluk değişiklikleri gelecek sürümlerde burada not alınacaktır. Şu anda bu nesne için ileriye dönük uyumluluk değişikliği yok.		 KeyValuePairOfstringstring dizisi
Kimliği Reklam için benzersiz Microsoft Advertising tanımlayıcısı. uzun
Durum Reklamın durumu.

Reklam durumunu Etkin veya Duraklatıldı olarak ayarlayabilirsiniz.		 AdStatus
TrackingUrlTemplate Tüm giriş sayfası URL'leri için varsayılan olarak kullanılacak izleme şablonu.

Bu öğe yalnızca AppInstallAd, DynamicSearchAd, ExpandedTextAd, ResponsiveAd, ResponsiveSearchAd ve TextAd nesneleri için desteklenir. ProductAd nesnesiyle desteklenmez.		 dize
Tür Reklamın türü.

Reklam türleri hakkında daha fazla bilgi için bkz. Açıklamalar.		 AdType
UrlCustomParameters URL izleme için özel anahtar ve değer parametreleri koleksiyonunuz.

Bu öğe yalnızca AppInstallAd, DynamicSearchAd, ExpandedTextAd, ResponsiveAd, ResponsiveSearchAd ve TextAd nesneleri için desteklenir. ProductAd nesnesiyle desteklenmez.		 CustomParameters

Açıklamalar

Java ve .NET dilleri için Type öğesini ayarlamayın çünkü değer genişletilmiş metin reklamını mı yoksa başka bir reklam türünü mü oluşturup oluşturmadığınıza göre belirlenir.

SOAP'yi el ile oluşturursanız, reklamın türünü belirtmek için düğümün <Ad> type özniteliğini kullanın (aşağıdaki örnekte gösterildiği gibi).

<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>

Gereksinimler

Hizmet: CampaignManagementService.svc v13
Ad alanı: https://bingads.microsoft.com/CampaignManagement/v13

Kullanan

AddAds
GetAdsByAdGroupId
GetAdsByEditorialStatus
GetAdsByIds
UpdateAds