AppAdExtension Veri Nesnesi - Kampanya Yönetimi

Makale
07/19/2024

Bir reklama dahil edilebilecek bir uygulama reklam uzantısını tanımlar.

Bir uygulama reklam uzantısını hesapla veya hesaptaki kampanyalar ve reklam gruplarıyla ilişkilendirebilirsiniz. Her varlık (hesap, kampanya veya reklam grubu), karar verdikçe hesabınızdaki toplam uygulama reklamı uzantısı sayısına kadar birçok uygulama reklamı uzantısıyla ilişkilendirilebilir.

Sözdizimi

<xs:complexType name="AppAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="AppPlatform" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="AppStoreId" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="DisplayText" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
        <xs:element xmlns:q47="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q47:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q48="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q48:ArrayOfstring" />
        <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Öğe

AppAdExtension nesnesi şu öğelere sahiptir: AppPlatform, AppStoreId, DestinationUrl, DisplayText, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, TrackingUrlTemplate, UrlCustomParameters.

Öğe	Açıklama	Veri Türü
AppPlatform	Uygulama platformu. Olası değerler arasında iOS, Android ve Windows yer alır. Ekle: Gerekli Güncelleştirme: Gerekli	Dize
AppStoreId	Uygulama mağazası tarafından sağlanan uygulama tanımlayıcısı. Uygulama yeniyse, reklamın teslim edilmeye uygun hale gelmesi için lütfen 4-7 gün beklemeyi bekleyin. Ekle: Gerekli Güncelleştirme: Gerekli	Dize
DestinationUrl	Kullanıcıların uygulama uzantısı bağlantısına tıkladığında götürülecekleri uygulama mağazası indirme web sayfasının URL'si. URL, {keyword} gibi dinamik metin dizeleri içerebilir. Desteklenen parametrelerin listesi için Microsoft Advertising yardım makalesinin Kullanılabilir parametreler bölümüne bakın . Hangi izleme veya URL parametrelerini kullanabilirim?. URL en fazla 1.024 karakter içerebilir. URL bir protokol belirtmezse, kullanıcı reklama tıkladığında sistem HTTP protokolunu kullanır. Bir reklam eklediğinizde URL HTTP protokolunu belirtirse, hizmet http:// protokol dizesini kaldırır (HTTP protokol dizesi 1.024 karakter sınırına karşı sayılmaz); ancak, hizmet URL'den bir HTTPS protokol dizesini (https://) kaldırmaz. Ekle: Gerekli Güncelleştirme: Isteğe bağlı	Dize
DisplayText	Uygulama reklam uzantısında görüntülenen metin. Metin en fazla 35 karakter içerebilir. Ekle: Gerekli Güncelleştirme: Isteğe bağlı	Dize
FinalAppUrls	Gelecekte kullanılmak üzere ayrılmıştır.	AppUrl dizisi
FinalMobileUrls	Gelecekte kullanılmak üzere ayrılmıştır.	dize dizisi
FinalUrls	Gelecekte kullanılmak üzere ayrılmıştır.	dize dizisi
FinalUrlSuffix	Gelecekte kullanılmak üzere ayrılmıştır.	Dize
TrackingUrlTemplate	Gelecekte kullanılmak üzere ayrılmıştır.	Dize
UrlCustomParameters	Gelecekte kullanılmak üzere ayrılmıştır.	CustomParameters

AppAdExtension nesnesinin Devralınan Öğeleri vardır.

Devralınan Öğeler

AdExtension'dan Devralınan Öğeler

AppAdExtension nesnesi AdExtension nesnesinden türetilir ve şu öğeleri devralır: DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version. Aşağıdaki açıklamalar AppAdExtension'a özeldir ve AdExtension nesnesinden aynı öğeleri devralan diğer nesneler için geçerli olmayabilir.

Öğe	Açıklama	Veri Türü
DevicePreference	Bu öğe, tercihin reklam uzantısının mobil cihazlarda mı yoksa tüm cihazlarda mı görüntüleneceğini belirler. Mobil cihazlar için bir tercih belirtmek için bu öğeyi 30001 olarak ayarlayın. Tüm cihazları belirtmek için bu öğeyi 0 (sıfır) olarak ayarlayın veya öğesini sıfır olarak bırakın. Varsayılan olarak, bu öğe sıfır olur. Ekle: Isteğe bağlı Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.	Uzun
İ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. Şu anda AdExtension nesnesi için ileriye dönük uyumluluk değişikliği yoktur. Ekle: Salt okunur Güncelleştirme: Salt okunur	KeyValuePairOfstringstring dizisi
Kimlik	Reklam uzantısının benzersiz Microsoft Advertising tanımlayıcısı. Ekle: Salt okunur Güncelleştirme: Salt okunur ve Gerekli	Uzun
Zamanlama	Reklam uzantısının reklamlarda gösterilmeye uygun olduğu takvim gününü ve zaman aralıklarını belirler. Ekle: Isteğe bağlı Güncelleştirme: Isteğe bağlı. Bu öğeyi null olarak ayarlarsanız, reklam uzantısı için mevcut zamanlama kümeleri değişmeden kalır. Bunu null olmayan bir Schedule nesnesine ayarlarsanız, reklam uzantısı için mevcut zamanlama ayarlarını etkili bir şekilde değiştirirsiniz. Tüm zamanlamaları kaldırmak için bu öğeyi boş bir Schedule nesnesine ayarlayın.	Zamanlama
Durum	Reklam uzantısının durumu. Kampanya Yönetimi hizmeti silinen reklam uzantılarını döndürmediğinden değer her zaman Etkin olur. Ekle: Salt okunur Güncelleştirme: Salt okunur	AdExtensionStatus
Tür	Reklam uzantısının türü. Bu değer, uygulama reklam uzantısını aldığınızda AppAdExtension değeridir. Ekle: Salt okunur Güncelleştirme: Salt okunur Reklam uzantısı türleri hakkında daha fazla bilgi için bkz. Ad Uzantısı Veri Nesnesi Açıklamaları.	Dize
Sürüm	Reklam uzantısının kaç kez güncelleştirildiğini izler. Reklam uzantısı oluşturulduğunda sürüm 1 olarak ayarlanır ve her güncelleştirmeden sonra bir artırılır. Ekle: İzin verilmiyor Güncelleştirme: İzin verilmiyor	Int

Gereksinimler

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

Aracılığıyla paylaş