ImageAdExtension Veri Nesnesi - Kampanya Yönetimi

Genişletilmiş metin reklamına eklenecek alternatif metin içeren bir görüntüyü belirten bir reklam uzantısı tanımlar.

Bir resim reklam uzantısını hesapla veya hesaptaki kampanyalar ve reklam gruplarıyla ilişkilendirebilirsiniz. Her hesap için yalnızca 1.000 kampanya ve 1.000 reklam grubu resim reklam uzantılarıyla ilişkilendirilebilir. Her varlık (hesap, kampanya veya reklam grubu) en fazla 6 resimli reklam uzantısıyla ilişkilendirilebilir.

Sözdizimi

<xs:complexType name="ImageAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="AlternativeText" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Description" 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:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
        <xs:element xmlns:q43="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q43:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q44="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q44:ArrayOfstring" />
        <xs:element xmlns:q45="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="ImageMediaIds" nillable="true" type="q45:ArrayOflong" />
        <xs:element minOccurs="0" name="Images" nillable="true" type="tns:ArrayOfAssetLink">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element xmlns:q46="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="Layouts" nillable="true" type="q46:ArrayOfstring">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="SourceType" nillable="true" type="xs:string">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <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

ImageAdExtension nesnesi şu öğelere sahiptir: AlternativeText, Description, DestinationUrl, DisplayText, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, ImageMediaIds, Images, Layouts, SourceType, TrackingUrlTemplate, UrlCustomParameters.

Öğe	Açıklama	Veri Türü
Alternatif Metin	Kullanılabilirlik için görüntü medyasının alternatif açıklaması. Resim görüntülenemediyse bunun yerine alternatif metin kullanılır. Bu öğe için uzunluk üst sınırı 35 karakterdir. Eklemek: Gerekli Güncelleştirmek: Gerekli	dize
Açıklama	Reklam veren, ajans veya hesap yöneticisi tarafından görüntü medyası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ı 100 karakterdir. Eklemek: Opsiyonel Güncelleştirmek: Opsiyonel. Bu öğeyi null ayarlarsanız, önceki ayar silinir.	dize
DestinationUrl	Kullanıcıyı resme tıkladığında götürecek web sayfasının URL'si. URL, {keyword} gibi dinamik metin dizeleri içerebilir. Daha fazla bilgi için bkz . 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 göre sayılmaz); ancak, hizmet URL'den bir HTTPS protokol dizesini (https://) kaldırmaz. Resim reklam uzantısı için URL belirtilmezse, reklamın URL'si kullanılır. Eklemek: Opsiyonel Güncelleştirmek: Opsiyonel. Bu öğeyi null ayarlarsanız, önceki ayar silinir.	dize
DisplayText	Görüntü uzantınızın görüntüleme metni. Bu öğe için uzunluk üst sınırı 35 karakterdir. Eklemek:DüzenlerSearchMultiple içerdiğinde gereklidir, aksi taktirde İsteğe bağlı. Güncelleştirmek:DüzenlerSearchMultiple içerdiğinde gereklidir, aksi taktirde İsteğe bağlı. Bu öğeyi null ayarlarsanız, önceki ayar silinir.	dize
FinalAppUrls	Gelecekte kullanmak için.	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. - DevicePreference30001 (mobil) olarak ayarlandıysa FinalMobileUrls belirtemeyebilirsiniz. Eklemek: Opsiyonel Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, önceki ayar kaldırılır.	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. - DevicePreference30001 (mobil) olarak ayarlandıysa FinalMobileUrls belirtemeyebilirsiniz. Eklemek: Opsiyonel Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, önceki ayar kaldırılır.	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. Eklemek: Opsiyonel Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, önceki ayar kaldırılır.	dize
ImageMediaIds	Reklama eklenecek görüntülerin tanımlayıcıları. Aynı en boy oranına sahip birden fazla görüntü için medya tanımlayıcıları belirtemeyebilirsiniz. Başka bir deyişle, başvuruda bulunan görüntülerin her birinin farklı en boy oranları olmalıdır. En fazla dört (4) görüntü medyası tanımlayıcısı belirtebilirsiniz. Gereken en düşük değer bir resim medya kimliği olsa da, tüm reklam yerleşimlerine hak kazanmak için dört görüntü medyası tanımlayıcısı sağlamanız gerekir; burada her kimlik desteklenen dört Medya türünden birinin görüntüsüne (en boy oranları) karşılık gelir. İzleyici reklamları için desteklenen en boy oranları 16:9, 1,5:1, 4:3 ve 1,2:1'tir. Daha fazla bilgi için Görüntü verileri nesnesi başvuru belgelerine bakın. 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. Eklemek: Gerekli Güncelleştirmek: Gerekli	uzun dizi
Görüntü	Farklı boyutlara ve en boy oranlarına sahip görüntü varlıkları, çeşitli yayımcılar ve yerleştirmeler arasında esnek bir şekilde görüntülenebilir. Her biri SubType içeren bir ImageAsset ve istenen en boy oranıyla eşleşen kırpma ayarları içeren bir veya daha fazla AssetLink nesnesi ekleyin. Eklemek: Gerekli Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Güncelleştirme sırasında görüntü eklerseniz, önceden ayarlanmış tüm görüntüler değiştirilir.	AssetLink dizisi
Düzen	Uygun görüntü düzenlerinin listesi. Desteklenen değerler SearchSingle ve SearchMultiple'dır. Gelecekte yeni düzenler eklenebilir, bu nedenle sabit bir değer kümesine bağımlılık almamalısınız. Eklemek: Gerekli Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Güncelleştirme sırasında düzenler eklerseniz, önceden ayarlanmış düzenler değiştirilir.	dize dizisi
SourceType	Kaynak türü.	dize
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. Eklemek: Opsiyonel Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, önceki ayar kaldırılır.	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. Eklemek: Opsiyonel Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, önceki ayar kaldırılır.	CustomParameters

ImageAdExtension nesnesininDevralınan Öğeleri vardır.

Devralınan Öğeler

AdExtension'dan Devralınan Öğeler

ImageAdExtension nesnesi AdExtension nesnesinden türetilir ve şu öğeleri devralır: DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version. Aşağıdaki açıklamalar ImageAdExtension'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. Eklemek: Salt okunur Güncelleştirmek: Salt okunur	KeyValuePairOfstringstring dizisi
Kimliği	Reklam uzantısının benzersiz Microsoft Advertising tanımlayıcısı. Eklemek: Salt okunur Güncelleştirmek: 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. Eklemek: Opsiyonel Güncelleştirmek: Opsiyonel. 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.	Tarife
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. Eklemek: Salt okunur Güncelleştirmek: Salt okunur	AdExtensionStatus
Tür	Reklam uzantısının türü. Bu değer, resim reklam uzantısını aldığınızda ImageAdExtension değeridir. Eklemek: Salt okunur Güncelleştirmek: 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. Eklemek: İzin verilmiyor Güncelleştirmek: İzin verilmiyor	Int

Gereksinimler

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