PromotionAdExtension Veri Nesnesi - Kampanya Yönetimi

Promosyon Uzantıları, metin reklamlarınızda özel satışları ve teklifleri vurgular. Teklifleri öne çıkararak potansiyel müşterilerin reklamınıza tıklama olasılığı daha yüksektir ve sizin için daha fazla satış oluşturmanıza yardımcı olur.

Bir promosyon reklam uzantısını hesapla veya hesaptaki kampanyalar ve reklam gruplarıyla ilişkilendirebilirsiniz. Her varlık (hesap, kampanya veya reklam grubu) en fazla 20 promosyon reklam uzantısıyla ilişkilendirilebilir.

Not

Promosyon Uzantıları AU, CA, DE, FR, ABD ve Birleşik Krallık'taki müşteriler tarafından kullanılabilir.

Sözdizimi

<xs:complexType name="PromotionAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="CurrencyCode" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="DiscountModifier" nillable="true" type="tns:PromotionDiscountModifier" />
        <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
        <xs:element xmlns:q56="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q56:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q57="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q57:ArrayOfstring" />
        <xs:element minOccurs="0" name="Language" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="MoneyAmountOff" nillable="true" type="xs:double" />
        <xs:element minOccurs="0" name="OrdersOverAmount" nillable="true" type="xs:double" />
        <xs:element minOccurs="0" name="PercentOff" nillable="true" type="xs:double" />
        <xs:element minOccurs="0" name="PromotionCode" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="PromotionEndDate" nillable="true" type="tns:Date" />
        <xs:element minOccurs="0" name="PromotionItem" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="PromotionOccasion" nillable="true" type="tns:PromotionOccasion" />
        <xs:element minOccurs="0" name="PromotionStartDate" nillable="true" type="tns:Date" />
        <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

PromotionAdExtension nesnesi şu öğelere sahiptir: CurrencyCode, DiscountModifier, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, Language, MoneyAmountOff, OrdersOverAmount, PercentOff, PromotionCode, PromotionEndDate, PromotionItem, PromotionOccasion, PromotionStartDate, TrackingUrlTemplate, UrlCustomParameters.

Öğe	Açıklama	Veri Türü
CurrencyCode	Promosyon fiyatı veya indirimi için para birimi kodu. Bu alan yalnızca MoneyAmountOff veya OrdersOverAmount ayarlarsanız geçerlidir. Desteklenen para birimi kodları ARS, AUD, BRL, CAD, CHF, CLP, CNY, COP, DKK, EUR, GBP, HKD, INR, MXN, NZD, PEN, PHP, PLN, SEK, SGD, USD, TWD ve VEF'dir. Ekle:MoneyAmountOff veya OrdersOverAmount ayarlandıysa gereklidir. Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. PercentOff veya PromotionCode ayarlarsanız, bu ayar artık geçerli değildir ve silinir.	Dize
DiscountModifier	Promosyon indirim değiştiricisi. Örneğin, indirim değiştiricisinin UpTo olarak ayarlandığını düşünelim. Ardından, değiştirilmemiş promosyon indirimi "20 ABD doları ayakkabı indirimi" olacaksa, değiştirilen promosyon "20 ABD dolarına kadar ayakkabı indirimi" olur. Ekle: Isteğe bağlı. Bu öğeyi belirtmezseniz veya boş bırakırsanız, Varsayılan Yok değeri ayarlanır. Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.	PromotionDiscountModifier
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. Bu öğeyi boş bir dize (""" olarak ayarlarsanız, önceki ayar silinir.	Dize
Dil	Reklam uzantısının sunulduğu dil. Kampanya veya reklam grubunun dil ayarları ne olursa olsun uzantı her zaman bu dilde sunulur. Desteklenen dil dizeleri şunlardır: Danca, Felemenkçe, İngilizce, Fince, Fransızca, Almanca, İtalyanca, Norveççe, Portekizce, İspanyolca, İsveççe ve TraditionalChinese. 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
MoneyAmountOff	Promosyon değerinden gelen para. Örneğin, "$20 off shoes - On orders on $100" değerini yükseltmek için PromotionItem değerini "shoes" olarak ayarlayın, CurrencyCode değerini "USD" olarak ayarlayın, MoneyAmountOff değerini 20 olarak ayarlayın ve OrdersOverAmount değerini 100 olarak ayarlayın. Ekle: Gerekli. MoneyAmountOff veya PercentOff ayarlamanız gerekir, ancak her ikisini de ayarlayamazsınız. Güncelleştirme: Isteğe bağlı. MoneyAmountOff veya PercentOff ayarlayabilirsiniz, ancak ikisini de ayarlayamazsınız.	Çift
OrdersOverAmount	Promosyon hedefine eklenen tutar üzerinden sipariş değeri. Örneğin, "$20 off shoes - On orders on $100" değerini yükseltmek için PromotionItem değerini "shoes" olarak ayarlayın, CurrencyCode değerini "USD" olarak ayarlayın, MoneyAmountOff değerini 20 olarak ayarlayın ve OrdersOverAmount değerini 100 olarak ayarlayın. Ekle: Isteğe bağlı. Hem OrdersOverAmount hem de PromotionCode ayarlayamazsınız. Güncelleştirme: Isteğe bağlı. Hem OrdersOverAmount hem de PromotionCode ayarlayamazsınız. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Bu öğeyi '0' (sıfır) olarak ayarlarsanız, önceki ayar silinir.	Çift
YüzdeOff	Yükseltme değeri kapalı yüzdesi. Örneğin, 10,0 %10 indirimi temsil eder. Ekle: Gerekli. MoneyAmountOff veya PercentOff ayarlamanız gerekir, ancak her ikisini de ayarlayamazsınız. Güncelleştirme: Isteğe bağlı. MoneyAmountOff veya PercentOff ayarlayabilirsiniz, ancak ikisini de ayarlayamazsınız. Bu özelliği ayarlarsanız CurrencyCode ayarı artık geçerli değildir ve önceden ayarlanmışsa silinir.	Çift
PromotionCode	Yükseltme hedefine eklenen yükseltme kodu. Örneğin, "$20 off shoes - Promocode SAVE20" değerini yükseltmek için PromotionItem değerini "shoes" olarak ayarlayın, CurrencyCode değerini "USD" olarak ayarlayın, MoneyAmountOff değerini 20 olarak ayarlayın ve PromotionCode değerini "SAVE20" olarak ayarlayın. Dize en fazla 15 karakter içerebilir. Ekle: Isteğe bağlı. Hem OrdersOverAmount hem de PromotionCode ayarlayamazsınız. Güncelleştirme: Isteğe bağlı. Hem OrdersOverAmount hem de PromotionCode ayarlayamazsınız. 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. Bu özelliği ayarlarsanız CurrencyCode ayarı artık geçerli değildir ve önceden ayarlanmışsa silinir.	Dize
PromotionEndDate	Bitiş tarihi, reklamda görüntülenecek promosyon tarihini veya tarihleri bilgilendirmeye yardımcı olur. Örneğin , PromotionStartDate ve PromotionEndDate tarihlerinin her ikisi de 14 Şubat olarak ayarlanırsa, görüntülenen yükseltmeye "Geçerli 14 Şubat" metni eklenebilir. PromotionStartDate tarihi, PromotionEndDate tarihinden önce veya buna eşit olmalıdır. Bu özellik, bir yükseltme için doğal teslim aralığını geçersiz kılmaz. Promosyon PromosyonuOccasion ve Zamanlama, promosyonu reklamlarda gösterilmeye ne zaman uygun olduğunu belirler. Geçerli yıl için bitiş tarihi zaten geçtiyse, sonraki yıldaki tarihler için her başlangıç ve bitiş tarihi ayarlanmalıdı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. Geçerli bitiş tarihini silmek ve geçerli bitiş tarihini etkili bir şekilde ayarlamak için Gün, Ay ve Yıl'ı '0' (sıfır) olarak ayarlayın. Bir dahaki sefere promosyon reklam uzantısını aldığınızda, bu öğe ayarlanmaz.	Tarih
PromotionItem	Yükseltme hedefi veya öğesi. Örneğin, "ayakkabı" için %20 veya %20 indirimle bir promosyon çalıştırabilirsiniz. "20 ABD dolarına kadar ayakkabı" promosyonu çalıştırmak için PromotionItem değerini "shoes" olarak ayarlayın, DiscountModifier değerini UpTo olarak ayarlayın, CurrencyCode değerini "USD" olarak ayarlayın ve MoneyAmountOff değerini 20 olarak ayarlayın. Dize en fazla 20 karakter içerebilir. 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
PromotionOccasion	Terfi günü. PromosyonUygunlama ve Zamanlama öğeleri, promosyonların reklamlarda gösterilmeye ne zaman uygun olduğunu belirler. PromotionOccasion, her yıl 15 Şubat ile 31 Mart arasında WomensDay gibi zaman aralığını veya mevsimselliği belirler. Yükseltme yalnızca ayarladığınız duruma karşılık gelen tarihler içinde çalışır. Her durum için tanımlanan tarih aralığı hakkındaki ayrıntılar için bkz . PromotionOccasion . Zamanlama, promosyonu etkinlik tarih aralığında daha kısa bir zaman çerçevesiyle sınırlandırabilir; örneğin, promosyonu 20 Şubat ile 8 Mart arasında çalışacak şekilde sınırlandırabilir. Zamanlama aynı promosyonu birden çok yıl çalıştırmak için de kullanılabilir; örneğin, 15 Şubat ile 31 Mart arasında her yıl WomensDay promosyonunu çalıştırın. Ekle: Isteğe bağlı. Bu öğeyi belirtmezseniz veya boş bırakırsanız, Varsayılan Yok değeri ayarlanır. 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 ayarlarsanız, Önceki ayarları korumak veya güncelleştirmek için PromotionStartDate ve PromotionEndDate da ayarlanmalıdır.	PromotionOccasion
PromotionStartDate	Başlangıç tarihi, reklamda görüntülenecek promosyon tarihini veya tarihleri bilgilendirmeye yardımcı olur. Örneğin , PromotionStartDate ve PromotionEndDate tarihlerinin her ikisi de 14 Şubat olarak ayarlanırsa, görüntülenen yükseltmeye "Geçerli 14 Şubat" metni eklenebilir. PromotionStartDate tarihi, PromotionEndDate tarihinden önce veya buna eşit olmalıdır. Bu özellik, bir yükseltme için doğal teslim aralığını geçersiz kılmaz. Promosyon PromosyonuOccasion ve Zamanlama, promosyonu reklamlarda gösterilmeye ne zaman uygun olduğunu belirler. Geçerli yıl için bitiş tarihi zaten geçtiyse, sonraki yıldaki tarihler için her başlangıç ve bitiş tarihi ayarlanmalıdı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. Geçerli bitiş tarihini silmek ve geçerli bitiş tarihini etkili bir şekilde ayarlamak için Gün, Ay ve Yıl'ı '0' (sıfır) olarak ayarlayın. Bir dahaki sefere promosyon reklam uzantısını aldığınızda, bu öğe ayarlanmaz.	Tarih
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

PromotionAdExtension nesnesininDevralınan Öğeleri vardır.

Devralınan Öğeler

AdExtension'dan Devralınan Öğeler

PromotionAdExtension nesnesi AdExtension nesnesinden türetilir ve şu öğeleri devralır: DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version. Aşağıdaki açıklamalar PromotionAdExtension'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. 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, promosyon reklam uzantısını aldığınızda PromotionAdExtension 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