PriceAdExtension Veri Nesnesi - Kampanya Yönetimi

3 ile 8 fiyat tablosu satırı içeren bir reklam uzantısı tanımlar.

Bir fiyat 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 fiyat reklam uzantısıyla ilişkilendirilebilir.

Sözdizimi

<xs:complexType name="PriceAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Language" nillable="true" type="xs:string" />
        <xs:element name="PriceExtensionType" type="tns:PriceExtensionType" />
        <xs:element minOccurs="0" name="TableRows" nillable="true" type="tns:ArrayOfPriceTableRow" />
        <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

PriceAdExtension nesnesi şu öğelere sahiptir: FinalUrlSuffix, Language, PriceExtensionType, TableRows, TrackingUrlTemplate, UrlCustomParameters.

Öğe	Açıklama	Veri Türü
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
Dil	Fiyat reklam uzantınızın reklam kopyası için dil. Olası değerler için bkz. Reklam Dilleri. Ekle: Gerekli Güncelleştirme: Gerekli	Dize
PriceExtensionType	Fiyat reklamı uzantısının türü. Olası değerler şunlardır: Markalar, Olaylar, Konumlar, Mahalleler, Ürün Kategorileri, ProductTiers, Hizmet Kategorileri, Hizmetler, ServiceTiers ve Bilinmiyor. Ekle: Gerekli Güncelleştirme: Gerekli	PriceExtensionType
TableRows	Fiyat tablosu satırları. 3 ile 8 arasında fiyat tablosu satırınız olmalıdır. Bunları oluşturduğunuz sipariş, reklamdaki beklenen sipariştir ancak sipariş garanti değildir. Ekle: Gerekli Güncelleştirme: Gerekli	PriceTableRow dizisi
TrackingUrlTemplate	Tüm giriş sayfası URL'leri 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ı. Bu öğeyi null 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ı. Bu öğeyi null ayarlarsanız, önceki ayar silinir.	CustomParameters

PriceAdExtension nesnesininDevralınan Öğeleri vardır.

Devralınan Öğeler

AdExtension'dan Devralınan Öğeler

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