Aracılığıyla paylaş

FlyerAdExtension Veri Nesnesi - Kampanya Yönetimi

  • Makale

El Ilanı Uzantıları, reklamverenlerin ürün veya mağaza kataloglarını (el ilanları) potansiyel müşterilere dağıtmasını sağlar.

"Haftalık fırsatlar" veya "haftalık satışlar" gibi geniş sorgularda belirgin bir şekilde görüntülenebilir ve böylece alışveriş yapanları yarışma yerine reklamınızı tıklamaya teşvik ederler. Doğası gereği, arama yapanları daha iyi bilgilendirmeye yardımcı olur ve sonuç olarak kullanıcı katılımını artırır; örneğin, hıza tıklama.

Not

El Ilanı Uzantıları özellik pilotundaki müşteriler tarafından kullanılabilir (GetCustomerPilotFeatures 802 döndürür).

Sözdizimi

<xs:complexType name="FlyerAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="Description" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
        <xs:element xmlns:q61="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q61:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q62="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q62:ArrayOfstring" />
        <xs:element minOccurs="0" name="FlyerName" nillable="true" type="xs:string" />
        <xs:element xmlns:q63="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="ImageMediaIds" nillable="true" type="q63:ArrayOflong" />
        <xs:element xmlns:q64="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="ImageMediaUrls" nillable="true" type="q64:ArrayOfstring" />
        <xs:element minOccurs="0" name="StoreId" nillable="true" type="xs:long" />
        <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

FlyerAdExtension nesnesi şu öğelere sahiptir: Description, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, FlyerName, ImageMediaIds, ImageMediaUrls, StoreId, TrackingUrlTemplate, UrlCustomParameters.

Öğe Açıklama Veri Türü
Açıklama Reklam veren, ajans veya hesap yöneticisi tarafından el ilanı uzantılarını izlemek, etiketlemek veya yönetmek için kullanılabilecek açıklama.

Bu açıklama reklam veya resimle birlikte görüntülenmez.

Bu öğe için uzunluk üst sınırı 1.024 karakterdir.

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.		 Dize
FinalAppUrls Gelecekte kullanılmak üzere ayrılmıştır. AppUrl dizisi
FinalMobileUrls Mobil cihazlar için giriş sayfası URL'si.

Son URL'ler ve Son Mobil URL'ler için aşağıdaki doğrulama kuralları geçerlidir.
- URL'nin uzunluğu 2.048 karakterle sınırlıdır. HTTP veya HTTPS protokol dizesi 2.048 karakter sınırına doğru sayılır.
- Hem FinalUrls hem de FinalMobileUrls için en fazla 10 liste öğesi belirtebilirsiniz; ancak, teslimat için her listedeki yalnızca ilk öğe kullanılır. Hizmet, olası ileriye dönük uyumluluk için en fazla 10 liste öğesine izin verir.
- '{' ve '}' kullanımının yalnızca etiketleri (örneğin {lpurl}) belirtmesine izin verilir.
- Son URL'lerin her biri http:// veya https:// ile başlayan iyi biçimlendirilmiş bir URL olmalıdır.
- FinalMobileUrls değerini belirtirseniz FinalUrls değerini de belirtmeniz gerekir.

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. Bu öğeyi boş bir listeye ayarlarsanız, önceki ayar silinir.		 dize dizisi
FinalUrls Giriş sayfası URL'si.

Son URL'ler ve Son Mobil URL'ler için aşağıdaki doğrulama kuralları geçerlidir.
- URL'nin uzunluğu 2.048 karakterle sınırlıdır. HTTP veya HTTPS protokol dizesi 2.048 karakter sınırına doğru sayılır.
- Hem FinalUrls hem de FinalMobileUrls için en fazla 10 liste öğesi belirtebilirsiniz; ancak, teslimat için her listedeki yalnızca ilk öğe kullanılır. Hizmet, olası ileriye dönük uyumluluk için en fazla 10 liste öğesine izin verir.
- '{' ve '}' kullanımının yalnızca etiketleri (örneğin {lpurl}) belirtmesine izin verilir.
- Son URL'lerin her biri http:// veya https:// ile başlayan iyi biçimlendirilmiş bir URL olmalıdır.
- FinalMobileUrls değerini belirtirseniz FinalUrls değerini de belirtmeniz gerekir.

Ekle: Gerekli
Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.		 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 özellik yalnızca Son URL Soneki 3. Aşama pilotundaki müşteriler tarafından kullanılabilir (GetCustomerPilotFeatures 636 döndürür). Pilotta değilseniz bu özellik yoksayılır ve hata döndürülür.

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.		 Dize
El İlanıAdı El ilanı adı.

Bu öğe için uzunluk üst sınırı 150 karakterdir.

Ekle: Gerekli
Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.		 Dize
ImageMediaIds Reklama eklenecek resmin tanımlayıcısı.

Yalnızca bir medya kimliği ayarlayabilirsiniz. Veri türü, daha sonra birden çok görüntü desteği eklenmesi durumunda uzun değerlerin bir listesidir.

Her medya kimliği, "GenericImage" Medya alt türünün görüntüsüne karşılık gelir.

AddMedia işlemini çağırarak görüntü kitaplığına eklediğinizde her Görüntünün tanımlayıcısını alabilirsiniz. Aksi takdirde medya görüntü kitaplığınıza eklendikten sonra GetMediaMetaDataByAccountId işlemiyle medya tanımlayıcılarını alabilirsiniz. Görüntünün en az genişliği ve yüksekliği 220 piksel, dosya boyutu üst sınırı ise 3,9 MB olmalıdır.

Ekle: Gerekli
Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.		 uzun dizi
ImageMediaUrls Zaten eklediğiniz medyanın URL'si.

Ekle: Salt okunur
Güncelleştirme: Salt okunur		 dize dizisi
Storeıd Ürün reklamları için kullanılan bir Microsoft Merchant Center mağazasının benzersiz tanımlayıcısı.

Ekle: Isteğe bağlı
Güncelleştirme: Salt okunur. Mağaza kimliği ayarlandıktan sonra güncelleştirilemez.		 Uzun
TrackingUrlTemplate Tüm FinalUrls ve FinalMobileUrls için varsayılan olarak kullanılacak izleme şablonu.

Aşağıdaki doğrulama kuralları, izleme şablonları için geçerlidir. Desteklenen şablonlar ve parametreler hakkında daha fazla ayrıntı için Hangi izleme veya URL parametrelerini kullanabilirim? Microsoft Advertising yardım makalesine bakın.
- Daha düşük düzeyli varlıklar için tanımlanan izleme şablonları (ör. reklamlar, kampanya gibi daha üst düzey varlıklar için bu kümeleri geçersiz kılar). Daha fazla bilgi için bkz . Varlık Sınırları.
- İzleme şablonunun uzunluğu 2.048 karakterle sınırlıdır. HTTP veya HTTPS protokol dizesi 2.048 karakter sınırına doğru sayılır.
- İzleme şablonu aşağıdakilerden biriyle başlayan iyi biçimlendirilmiş bir URL olmalıdır: http://, https://, {lpurl} veya {unescapedlpurl}.
- Microsoft Advertising, özel parametrelerin mevcut olup olmadığını doğrulamaz. İzleme şablonunuzda özel parametreler kullanıyorsanız ve bunlar yoksa, giriş sayfası URL'si değiştirme olmadan özel parametrelerinizin anahtar ve değer yer tutucularını içerir. Örneğin, izleme şablonunuz kampanya https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} , reklam grubu, ölçüt, anahtar sözcük veya reklam düzeyinde tanımlanmamışsa ve {_season} veya {_promocode} tanımlanmamışsa, giriş sayfası URL'si aynı 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. Bu öğeyi boş bir dize (""" olarak ayarlarsanız, önceki ayar silinir.		 Dize
UrlCustomParameters URL izleme için özel anahtar ve değer parametreleri koleksiyonunuz.

Microsoft Advertising, CustomParameters nesnesine eklediğiniz ilk 3 CustomParameter nesnesini kabul eder ve ek özel parametreler yoksayılır. Her CustomParameterAnahtar ve Değer öğelerini içerir. Özel Parametreler Sınırı Artış Aşaması 3 pilotundaki müşteriler için (GetCustomerPilotFeatures 635 döndürür), Microsoft Advertising dahil ettiğiniz ilk 8 özel parametre anahtarını ve değer çiftini kabul eder ve 8'den fazla özel parametre eklerseniz hata döndürülür.

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. Mevcut özel parametreleri korumak için UrlCustomParameters öğesini null veya boş olarak ayarlayın. Tüm özel parametreleri kaldırmak için CustomParameters nesnesinin Parameters öğesini null veya boş olarak ayarlayın. Özel parametrelerin bir alt kümesini kaldırmak için, CustomParameters nesnesinin Parameters öğesinde tutmak istediğiniz özel parametreleri belirtin.		 CustomParameters

FlyerAdExtension nesnesininDevralınan Öğeleri vardır.

Devralınan Öğeler

AdExtension'dan Devralınan Öğeler

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

Öğe Açıklama Veri Türü
DevicePreference Bu reklam uzantısı türü için desteklenmez. 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. EndDate, StartDate tarihinden itibaren 30 gün içinde olmalıdır.

Ekle: El ilanı reklam uzantıları için StartDate ve EndDate zamanlamaları gereklidir.
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. Bu öğeyi boş bir Schedule nesnesine ayarlayamazsınız çünkü bu, tüm zamanlamayı silmeyi etkili bir şekilde dener. Bu hataya neden olur çünkü el ilanı reklam uzantıları için StartDate ve EndDate gereklidir.		 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, el ilanı reklam uzantısını aldığınızda FlyerAdExtension 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