ResponsiveAd Veri Nesnesi - Kampanya Yönetimi
İzleyici reklamları ve multimedya reklamları için esnek bir reklam biçimi.
ResponsiveAd nesnesi hem arama ağındaki Multimedya reklamları hem de Microsoft Audience Network'teki Hedef Kitle reklamları için kullanılır. Anahtar ayırıcıları hakkında ayrıntılı bilgi için aşağıdaki açıklamalar bölümüne bakın.
Not
Aynı reklam grubunda yinelenen duyarlı reklamlara izin verilir.
Sözdizimi
<xs:complexType name="ResponsiveAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:complexContent mixed="false">
<xs:extension base="tns:Ad">
<xs:sequence>
<xs:element minOccurs="0" name="AdSubType" nillable="true" type="tns:AdSubType">
<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="BusinessName" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="CallToAction" nillable="true" type="tns:CallToAction" />
<xs:element minOccurs="0" name="CallToActionLanguage" nillable="true" type="tns:LanguageName" />
<xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
<xs:element minOccurs="0" name="Headline" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
<xs:element minOccurs="0" name="Images" nillable="true" type="tns:ArrayOfAssetLink" />
<xs:element xmlns:q4="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="ImpressionTrackingUrls" nillable="true" type="q4: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="LongHeadline" nillable="true" type="tns:AssetLink" />
<xs:element minOccurs="0" name="LongHeadlineString" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="LongHeadlines" 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 minOccurs="0" name="Text" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="VerifiedTrackingSettings" nillable="true" type="tns:VerifiedTrackingSetting">
<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="Videos" 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:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
Öğe
ResponsiveAd nesnesi şu öğelere sahiptir: AdSubType, BusinessName, CallToAction, CallToActionLanguage, Descriptions, Headline, Headlines, Images, ImpressionTrackingUrls, LongHeadline, LongHeadlines, LongHeadlineString, Text, VerifiedTrackingSettings, Videos.
| Öğe | Açıklama | Veri Türü |
|---|---|---|
| AdSubType | Olası reklam alt türleri. | AdSubType |
| BusinessName | İşletmenin adı. reklam yerleşiminize bağlı olarak işletmenizin adı reklamınızın içinde görünebilir. Dizenin uzunluğu 25 karakterle sınırlıdır. Eklemek: Gerekli Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. |
dize |
| CallToAction | Müşterilerin şu anda reklamınızı tıklaması için kısa ve yumruklu bir neden. Bu, eylem çağrısı düğmenizde görüntülenir. Eklemek: Hedef kitle reklamları için geçerli değildir; Multimedya reklamları için gereklidir Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. |
CallToAction |
| CallToActionLanguage | Eylem çağrısının sunulduğu dil. Kampanyanın dil ayarları ne olursa olsun eylem çağrısı her zaman bu dilde sunulur. Eklemek: Hedef kitle reklamları için geçerli değildir; Multimedya reklamları için gereklidir Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. |
LanguageName |
| Açıklama | Reklamınızın yolunun altında gösterilen açıklamalar. Tüm reklam biçimlerindeki gösterimleri en üst düzeye çıkarmak için, açıklamalar her zaman reklamınızda gösterilmeyebilir. Tüm reklam biçimlerindeki gösterimleri en üst düzeye çıkarmak için, açıklamalar her zaman reklamınızda gösterilmeyebilir. Açıklamalardan birini belirli bir konuma sabitlemediğiniz sürece, Bing reklam düzenini kullanıcının arama sorgusu için en iyi başlıklar ve açıklamalarla dinamik olarak iyileştirir. Veri modeli açısından bakıldığında, yinelenenleri ve başlıkların her biri metin varlıkları olarak depolanır; örneğin, AssetLink başına bir TextAsset. Aynı varlık birden çok reklam tarafından kullanılabilir. Örneğin, "Sorunsuz Tümleştirme" bir metin varlığıysa, aynı Microsoft Advertising hesabındaki tüm reklamlarda aynı varlık tanımlayıcısı olur. 1-5 açıklama arasında ayarlamanız gerekir. Her açıklamanın Metni en az bir sözcük içermelidir. Kaynakların verimli bir şekilde kullanılması için her anahtar sözcük için yeni reklam kopyası oluşturmak yerine {keyword} gibi dinamik metin dizeleri kullanmanızı öneririz. Daha fazla bilgi için Reklamlarınızı dinamik metin parametreleriyle otomatik olarak özelleştirme Microsoft Advertising yardım makalesine bakın. Her açıklamanın Metni'nin giriş uzunluğu üst sınırı, dinamik metin dizeleri de dahil olmak üzere 1.000 karakterdir ve değiştirmeden sonra bu 1.000 karakterden en fazla 90 son karaktere izin verilmez. Dinamik metin değişimi gerçekleştikten sonra uzunluk 90 karakteri aşarsa reklam görüntülenemez veya varsayılan metin kullanılır. Çift genişlikli karakterlere sahip diller (ör. Geleneksel Çince) için maksimum giriş uzunluğu dinamik metin dizeleri de dahil olmak üzere 500 karakterdir ve değiştirmeden sonra bu 500 karakterden en fazla 45 son karaktere izin verilir. Dinamik metin değişimi gerçekleştikten sonra uzunluk 45 karakteri aşarsa reklam görüntülenemez veya varsayılan metin kullanılır. Çift genişlikli karakterler, kampanya veya reklam grubu dil ayarlarının karakter kümesi yerine kullandığınız karakterler tarafından belirlenir. Çift genişlikli karakterler Arasında Korece, Japonca ve Çince dil karakterlerinin yanı sıra Emojiler bulunur. Metin, yeni satır (\n) karakterini içeremez. Eklemek: Multimedya reklamları ve hedef kitle reklamları için gereklidir. Video reklamları için geçerli değildir. Güncelleştirmek: Opsiyonel. Var olan tüm varlık bağlantılarını korumak için bu öğeyi sıfır olarak ayarlayın veya bırakın. Bu öğeyi ayarlarsanız, daha önce bu reklama bağlı olan tüm açıklamalar değiştirilir. |
AssetLink dizisi |
| Başlık | Başlıklar, reklamınızda görünen en belirgin metindir, bu nedenle kullanılabilir karakterlerden en iyi şekilde yararlanmalısınız. Reklamın çeşitli yayıncılar ve yerleşimler arasında esnek bir şekilde görüntülenebilmesi için birden çok başlık gerekir. Dizenin uzunluğu 30 karakterle sınırlıdır. Eklemek: Video reklamları için gereklidir. Multimedya reklamları ve hedef kitle reklamları için geçerli değildir. Güncelleştirmek: Opsiyonel. Multimedya ve hedef kitle reklamları için kullanım dışıdır. Bunun yerine Başlıklar'a bakın. |
dize |
| Başlık | Başlıklar, reklamınızda görünen en belirgin metindir, bu nedenle kullanılabilir karakterlerden en iyi şekilde yararlanmalısınız. Reklamın çeşitli yayıncılar ve yerleşimler arasında esnek bir şekilde görüntülenebilmesi için birden çok başlık gerekir. Başlıklardan birini belirli bir konuma sabitlemediğiniz sürece, Bing reklam düzenini kullanıcının arama sorgusu için en iyi başlıklar ve açıklamalarla dinamik olarak en iyi duruma getirecektir. Veri modeli açısından bakıldığında, yinelenenleri ve başlıkların her biri metin varlıkları olarak depolanır; örneğin, AssetLink başına bir TextAsset. Aynı varlık birden çok reklam tarafından kullanılabilir. Örneğin, "Sorunsuz Tümleştirme" bir metin varlığıysa, aynı Microsoft Advertising hesabındaki tüm reklamlarda aynı varlık tanımlayıcısı olur. 1-15 başlık arasında ayarlamanız gerekir. Her başlığın Metni en az bir sözcük içermelidir. Kaynakların verimli bir şekilde kullanılması için her anahtar sözcük için yeni reklam kopyası oluşturmak yerine {keyword} gibi dinamik metin dizeleri kullanmanızı öneririz. Daha fazla bilgi için Reklamlarınızı dinamik metin parametreleriyle otomatik olarak özelleştirme Microsoft Advertising yardım makalesine bakın. Her başlığın Metni'nin giriş uzunluğu üst sınırı, dinamik metin dizeleri de dahil olmak üzere 1.000 karakterdir ve değiştirmeden sonra bu 1.000 karakterden en fazla 30 son karaktere izin verilir. Dinamik metin değişimi gerçekleştikten sonra uzunluk 30 karakteri aşarsa reklam görüntülenemez veya varsayılan metin kullanılır. Çift genişlikli karakterlere sahip diller için (ör. Geleneksel Çince) maksimum giriş uzunluğu dinamik metin dizeleri de dahil olmak üzere 500 karakterdir ve değiştirmeden sonra bu 500 karakterden en fazla 15 son karaktere izin verilir. Dinamik metin değişimi gerçekleştikten sonra uzunluk 15 karakteri aşarsa reklam görüntülenemez veya varsayılan metin kullanılır. Çift genişlikli karakterler, kampanya veya reklam grubu dil ayarlarının karakter kümesi yerine kullandığınız karakterler tarafından belirlenir. Çift genişlikli karakterler Arasında Korece, Japonca ve Çince dil karakterlerinin yanı sıra Emojiler bulunur. Metin, yeni satır (\n) karakterini içeremez. Eklemek: Multimedya reklamları ve hedef kitle reklamları için gereklidir. Video reklamları için geçerli değildir. Güncelleştirmek: Opsiyonel. Var olan tüm varlık bağlantılarını korumak için bu öğeyi sıfır olarak ayarlayın veya bırakın. Bu öğeyi ayarlarsanız, daha önce bu reklama bağlı olan tüm başlıklar değiştirilir. |
AssetLink dizisi |
| 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. Daha fazla bilgi için aşağıdaki açıklamalara bakın. 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 |
| ImpressionTrackingUrls | 1x1 gösterim izleme pikselleri için URL'ler. Her piksel, Microsoft Audience Network gösterimlerini üçüncü taraf reklam raporlama aracınıza bildirir. Her duyarlı reklam için en fazla 2 gösterim izleme URL'sini ekleyebilirsiniz. Her URL'nin erişilebilir olması gerekir. 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. Microsoft, her Microsoft Audience Network gösterimi için URL'ye ping atarak üçüncü taraf reklam raporlama aracınızda gösterim izlemeyi etkinleştirir. Tanımlama bilgilerine veya IP adreslerine göre dönüştürme izleme veya izleme gibi ileri düzey kullanıcı izleme desteklenmez. Bu öğe varsayılan olarak döndürülmedi. Bu öğeyi almak için GetAdsByAdGroupId, GetAdsByEditorialStatus ve GetAdsByIds hizmet işlemlerini çağırdığınızda ReturnAdditionalFields öğesine ImpressionTrackingUrls değerini ekleyin. Eklemek: Opsiyonel Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. gösterim izleme URL'lerini kaldırmak için bu öğeyi boş bir dize dizisine ayarlayın. |
dize dizisi |
| LongHeadline | İzleyici kampanyaları için LongHeadline , iki olası duyarlı reklam başlığından daha uzundur. | AssetLink |
| LongHeadlines | 1-5 uzun başlık arasında ayarlamanız gerekir. Her başlığın Metni en az bir sözcük içermelidir. Metin yeni satır (\n) karakterini içeremez. Üst kampanya bir mağazayla ilişkilendirildiyse ve LongHeadlines belirtirseniz Başlıklar, Açıklamalar ve Görüntüler de belirtmeniz gerekir. Ekle: Üst kampanya bir mağazayla ilişkilendirildiyse isteğe bağlı olarak, ana kampanyası bir mağazayla ilişkilendirilmiyorsa gereklidir. Boşsa LongHeadlineString kullanır. Güncelleştirme: İsteğe bağlı. Var olan tüm varlık bağlantılarını korumak için bu öğeyi sıfır olarak ayarlayın veya bırakın. Bu öğe için bir değer ayarlarsanız, daha önce bu varlık grubuna bağlı olan tüm başlıklar değiştirilir. Üst kampanya bir mağazayla ilişkilendirildiyse ve bu öğeyi boş bir listeye ayarlarsanız, önceki ayar silinir. |
AssetLink dizisi |
| LongHeadlineString | Başlıklar, reklamınızda görünen en belirgin metindir, bu nedenle kullanılabilir karakterlerden en iyi şekilde yararlanmalısınız. Reklamın çeşitli yayıncılar ve yerleşimler arasında esnek bir şekilde görüntülenebilmesi için birden çok başlık gerekir. Dizenin uzunluğu 90 karakterle sınırlıdır. Eklemek: Opsiyonel. LongHeadlines sağlandığında yoksayılır. LongHeadlines boşsa LongHeadlines alanını LongHeadlineString ile doldururuz. Multimedya reklamları için geçerli değildir. Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. |
dize |
| Metin | Bu metin, reklam yerleşimine bağlı olarak reklamınızın uzun veya kısa başlığı altında veya yanında görünür. Reklam metninde çalışmak için başlıktan daha fazla karakter alanınız vardır. Bu nedenle, görüntü ve başlık potansiyel bir müşterinin dikkatini çektikten sonra reklam metninin onu tıklamaya ikna etmesi gerekir. Ürününüzü veya hizmetinizi birbirinden ayıran nedir? Metin en az bir sözcük içermelidir. Dizenin uzunluğu 90 karakterle sınırlıdır. Metin yeni satır (\n) karakterini içeremez. Eklemek: Video reklamları için gereklidir. Multimedya reklamları ve hedef kitle reklamları için geçerli değildir. Güncelleştirmek: Video reklamları için isteğe bağlı. İzleyici reklamları veya multimedya reklamları (kullanım dışı) için bunun yerine Açıklamalar'ı kullanın. |
dize |
| VerifiedTrackingSettings | VerifiedTrackingSetting, üçüncü taraf ölçüm ayarlarıyla ilgilidir. Bu sayede Integral Ad Science gibi üçüncü taraf doğrulama sağlayıcısı aracılığıyla görüntülenebilirlik, marka güvenliği ve geçersiz trafik ölçümlerini izleyebilirsiniz. Bu özellik CPM teklif stratejisini kullanarak yerel, görüntülü ve çevrimiçi video reklamlarda kullanılabilir. Not: Şu anda, IAS desteklenen tek satıcıdır (vendorName), ancak diğer doğrulama sağlayıcıları yakında kullanıma sunulacaktır. Aşağıdaki örnek IAS ile ilgili. IAS için 3 anahtar-değer çifti vardır:
|
VerifiedTrackingSetting |
| Videolar | Farklı boyutlara ve en boy oranlarına sahip video varlıkları, çeşitli yayımcılar ve yerleşimler arasında esnek bir şekilde görüntülenebilir. Her biri Alt Türe sahip bir VideoAsset içeren bir veya daha fazla AssetLink nesnesi ekleyin. Eklemek: Video reklamları için gereklidir Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Bir güncelleştirme sırasında video eklerseniz, önceden ayarlanmış videolar değiştirilir. |
AssetLink dizisi |
ResponsiveAd nesnesinin Devralınan Öğeleri vardır.
Devralınan Öğeler
Ad'dan Devralınan Öğeler
ResponsiveAd nesnesi Ad nesnesinden türetilir ve şu öğeleri devralır: AdFormatPreference, DevicePreference, EditorStatus, FinalAppUrls, FinalMobileUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters. Aşağıdaki açıklamalar ResponsiveAd'e özeldir ve Ad nesnesinden aynı öğeleri devralan diğer nesneler için geçerli olmayabilir.
| Öğe | Açıklama | Veri Türü |
|---|---|---|
| AdFormatPreference | Bu reklam türü için desteklenmez. | dize |
| DevicePreference | Bu reklam türü için desteklenmez. | uzun |
| EditoryalStatus | Reklamın gözden geçirmeyi beklemede olduğunu, onaylandığını veya onaylanmadığını gösteren, reklamın editoryal inceleme durumu. Eklemek: Salt okunur Güncelleştirmek: Salt okunur |
AdEditorialStatus |
| FinalAppUrls | Bu reklam türü için desteklenmez. | AppUrl dizisi |
| FinalMobileUrls | Mobil 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 öğe 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'a kadar 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. - Cihaz tercihi mobil olarak ayarlandıysa FinalMobileUrls belirtemeyebilirsiniz. Bu URL yalnızca anahtar sözcüğü son mobil URL'yi belirtmiyorsa kullanılır. Eklemek: Opsiyonel Güncelleştirmek: Opsiyonel. 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. URL'nin etki alanı bölümü, yol 1 ve yol 2 dizeleriyle birlikte 67 karakteri aşamaz. 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 öğe 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'a kadar 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. - Cihaz tercihi mobil olarak ayarlandıysa FinalMobileUrls belirtemeyebilirsiniz. Ayrıca, bu reklamın TrackingUrlTemplate veya UrlCustomParameters öğesi ayarlanırsa en az bir son URL gerektiğini unutmayın. Bu URL yalnızca anahtar sözcüğü son URL'yi belirtmiyorsa kullanılır. Eklemek: Gerekli Güncelleştirmek: Opsiyonel |
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. Eklemek: Opsiyonel Güncelleştirmek: Opsiyonel. 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 |
| İ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. İleriye dönük uyumluluk değişiklikleri gelecek sürümlerde burada not alınacaktır. Şu anda bu nesne için ileriye dönük uyumluluk değişikliği yok. |
KeyValuePairOfstringstring dizisi |
| Kimliği | Reklamın benzersiz Microsoft Advertising tanımlayıcısı. Eklemek: Salt okunur Güncelleştirmek: Gerekli ve Read-Only |
uzun |
| Durum | Reklamın durumu. Reklam durumunu Etkin veya Duraklatıldı olarak ayarlayabilirsiniz. Eklemek: Opsiyonel Güncelleştirmek: Opsiyonel |
AdStatus |
| 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.Eklemek: Opsiyonel Güncelleştirmek: Opsiyonel. 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 |
| Tür | Reklamın türü. Duyarlı bir reklam aldığınızda bu değer ResponsiveAd değeridir. Reklam türleri hakkında daha fazla bilgi için bkz. Reklam Verileri Nesnesi Açıklamaları. Eklemek: Salt okunur Güncelleştirmek: Salt okunur |
AdType |
| UrlCustomParameters | URL izleme için özel anahtar ve değer parametreleri koleksiyonunuz. Microsoft Advertising, CustomParameters nesnesine eklediğiniz ilk 8 CustomParameter nesnesini kabul eder ve 8'den fazla özel parametre eklerseniz bir hata döndürülür. Her CustomParameterAnahtar ve Değer öğelerini içerir. Eklemek: Opsiyonel Güncelleştirmek: Opsiyonel. 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 |
Açıklamalar
ResponsiveAd nesnesi, arama ağındaki Multimedya reklamları ve Microsoft Audience Network'teki Hedef Kitle reklamları için kullanılır.
Desteklenen özelliklerin çoğu aynıdır, ancak bazı önemli farklar aşağıdadır.
- İzleyici reklamları için BusinessName, Headlines, Images, ImpressionTrackingUrls, LongHeadlines ve Descriptions değerlerini ayarlarsınız.
- Multimedya reklamları için BusinessName, CallToAction, CallToActionLanguage, Descriptions, Headlines, Images ve LongHeadlines değerlerini ayarlarsınız.
Not
Görüntüler için veriler AddMedia işlemi aracılığıyla sağlanır. GIF, JPEG veya PNG MIME türlerini kullanabilirsiniz. Animasyonlu görüntüler desteklenmez. AddMedia işlemiyle yalnızca birkaç en boy oranına sahip medya ekleyebilirsiniz ancak imageAsset kırpma ayarlarını kullanarak her duyarlı reklam AssetLink bağlamında etkili en boy oranını belirleyebilirsiniz. Depolanan görüntünün en boy oranı hesap düzeyinde medya kitaplığında değiştirilmez.
Dosya boyutu üst sınırı 5 MB'tır. Piksel cinsinden maksimum genişlik ve yükseklik 2592 ve 2048'tir ve desteklenen en boy oranlarından birini korumanız gerekir. Örneğin, LandscapeImageMedia alt türüne sahip görüntü varlığı 2592 genişlikteyse, yükseklik 1357 olmalıdır.
Multimedya reklam görüntüleri
Multimedya reklamları için farklı boyutlara ve en boy oranlarına sahip birden fazla görüntü varlığı oluşturacaksınız. En boy oranı 1,91:1 olan en az 1 resim ve en boy oranı 1:1 olan 1 resim eklemeniz gerekir.
Images öğesinde bir veya daha fazla AssetLink nesnesi bulunur. Her varlık bağlantısı, aşağıdaki tabloda yer alan dize değerlerinden birine ayarlanmış Alt Türü olan bir ImageAsset içerir.
| Alt Tür | En boy oranı | Piksel cinsinden minimum boyutlar |
|---|---|---|
| LandscapeImageMedia | 1.91:1 | 703 genişlik x 368 yükseklik |
| ImageMedia4x1 | 4:1 | 608 genişlik x 152 yükseklik |
| SquareImageMedia | 1:1 | 470 genişlik x 470 yükseklik |
| ImageMedia1x2 | 1:2 | 470 genişlik x 940 yükseklik |
Multimedya reklam logoları
Multimedya reklamları için, küçük resim listesinde esnek bir şekilde görüntülenebilmeleri için farklı boyutlara, en boy oranlarına ve kırpma ayarlarına sahip birden çok logo varlığı oluşturacaksınız.
Resim bir reklamla "LandscapeLogoMedia" veya "SquareLogoMedia" olarak ilişkilendirilmişse alt türü "Logo" olarak ayarlanmalıdır.
| Alt Tür | En boy oranı | Piksel cinsinden minimum boyutlar |
|---|---|---|
| LandscapeLogoMedia | 4:1 | 512 genişlik x 128 yükseklik |
| SquareLogoMedia | 1:1 | 128 genişlik x 128 yükseklik |
Hedef kitle reklam görüntüleri
Hedef kitle reklamları için farklı boyutlara, en boy oranlarına ve kırpma ayarlarına sahip birden çok görüntü varlığı oluşturarak çeşitli yayıncılar ve yerleşimlerde esnek bir şekilde görüntülemelerini sağlarsınız.
Images öğesinde bir veya daha fazla AssetLink nesnesi bulunur. Her varlık bağlantısı, aşağıdaki tabloda yer alan dize değerlerinden birine ayarlanmış Alt Türü olan bir ImageAsset içerir.
Not
İzleyici reklamları sürüm 2 için aşağıdaki tabloda yer alan resim alt türleri ve şu anda pilot aşamasındadır.
| Alt Tür | En boy oranı | Piksel cinsinden minimum boyutlar |
|---|---|---|
| OriginalImage | Yok | 703 genişlik x 368 yükseklik |
| LandscapeImageMedia | 1.91:1 | 300 genişlik x 157 yükseklik |
| SquareImageMedia | 1:1 | 114 genişlik x 114 yükseklik |
| ImageMedia201X100 | 2.01:1 | 612 genişlik x 304 yükseklik |
| ImageMedia120X100 | 1.2:1 | 300 genişlik x 250 yükseklik |
| ImageMedia200X100 | 2:1 | 200 genişlik x 100 yükseklik |
| ImageMedia169X100 | 1.69:1 | 628 genişlik x 372 yükseklik |
| ImageMedia124X100 | 1.24:1 | 104 genişlik x 84 yükseklik |
| ImageMedia153X100 | 1.53:1 | 306 genişlik x 200 yükseklik |
Not
Aşağıdaki tabloda yer alan resim alt türleri, Audience ads sürüm 1'e yönelik.
| Alt Tür | Piksel cinsinden minimum boyutlar |
|---|---|
| LandscapeImageMedia | 703 genişlik x 368 yükseklik En boy radyo 1.91:1 |
| SquareImageMedia | 300 genişlik x 300 yükseklik En boy radyo 1:1 |
| ImageMedia169X100 | 622 genişlik x 368 yükseklik En boy radyo 1.69:1 |
| ImageMedia93X100 | 311 genişlik x 333 yükseklik En boy radyo 0.93:1 |
| ImageMedia15X10 | 300 genişlik x 200 yükseklik En boy radyo 1.5:1 |
| ImageMedia155X100 | 300 genişlik x 194 yükseklik En boy radyo 1.55:1 |
| ImageMedia133X100 | 100 genişlik x 75 yükseklik En boy radyo 1.33:1 |
| ImageMedia178X100 | 624 genişlik x 350 yükseklik En boy radyo 1.78:1 |
| ImageMedia172X100 | 300 genişlik x 174 yükseklik En boy radyo 1.72:1 |
Yalnızca bir varsayılan görüntü OriginalImage görüntü varlığı sağlamanız gerekir (varsayılan görüntü önceden LandscapeImageMedia idi). Images öğesinde, SubType değeri OriginalImage olarak ayarlanmış bir ImageAsset içeren bir AssetLink bulunur. OriginalImage için önerilen boyutlar 1200 genişlik x 628 yüksekliktir. İsteğe bağlı olarak, desteklenen her alt tür için bir görüntü varlığı gibi ek varlık bağlantıları ekleyebilirsiniz. Açıkça ayarlamadığınız tüm görüntü varlığı alt türleri için Microsoft Advertising, OriginalImage'ı kırparak otomatik olarak görüntü varlığı bağlantıları oluşturur.
Aşağıdaki GetAdsByAdGroupId yanıt örneğine göre lütfen aşağıdakileri not alın:
- Otomatik olarak oluşturulan tüm görüntü varlığı alt türleri için aynı görüntü varlığı tanımlayıcısı (örneğin, 1234567890000) kullanılır. Kırpılan görüntüleri Microsoft Advertising'in otomatik olarak oluşturmasına izin verseniz de, kimliğin aynı reklama bağlı görüntü varlıkları arasında benzersiz olması gerekmez.
- Bu örnekteki reklam OriginalImage görüntü varlığı alt türü için kırpma ayarları olmadan oluşturulduğundan, OriginalImage ile ilişkili görüntü dışında tüm görüntü varlıkları kırpılır.
- Microsoft Advertising, tüm varsayılan kırpma ayarları için OriginalImage'ın kırpma ayarlarını kullanır. Bu örnekte, sistem tarafından oluşturulan tüm görüntü varlıkları için kırpma yüksekliği 628'dir ve 1,91:1 en boy oranına sahip OriginalImage (OriginalImage alt türü) genişliğinin ve yüksekliğinin 1200x628 olduğunu çıkarabiliriz. Otomatik olarak oluşturulan görüntü varlıklarının kırpma ayarları, OriginalImage varlık bağlantısının kırpma ayarlarını temel alır.
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:TrackingId xmlns:h="https://bingads.microsoft.com/CampaignManagement/v12">3acf4989-d6a3-405f-9fd1-a2e8dd1b09f8</h:TrackingId>
</s:Header>
<s:Body>
<GetAdsByAdGroupIdResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v12">
<Ads xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<Ad i:type="ResponsiveAd">
<AdFormatPreference i:nil="true"/>
<DevicePreference>0</DevicePreference>
<EditorialStatus>Inactive</EditorialStatus>
<FinalAppUrls i:nil="true"/>
<FinalMobileUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a:string>https://mobile.contoso.com/womenshoesale</a:string>
</FinalMobileUrls>
<FinalUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a:string>https://www.contoso.com/womenshoesale</a:string>
</FinalUrls>
<ForwardCompatibilityMap xmlns:a="http://schemas.datacontract.org/2004/07/System.Collections.Generic"/>
<Id>9876543210000</Id>
<Status>Active</Status>
<TrackingUrlTemplate i:nil="true"/>
<Type>ResponsiveAd</Type>
<UrlCustomParameters i:nil="true"/>
<BusinessName>Contoso</BusinessName>
<CallToAction>AddToCart</CallToAction>
<Headline>Fast & Easy Setup</Headline>
<Images>
<AssetLink>
<Asset i:type="ImageAsset">
<Id>1234567890000</Id>
<Name i:nil="true"/>
<Type>ImageAsset</Type>
<CropHeight i:nil="true"/>
<CropWidth i:nil="true"/>
<CropX i:nil="true"/>
<CropY i:nil="true"/>
<SubType>OriginalImage</SubType>
</Asset>
<AssetPerformanceLabel i:nil="true"/>
<EditorialStatus i:nil="true"/>
<PinnedField i:nil="true"/>
</AssetLink>
<AssetLink>
<Asset i:type="ImageAsset">
<Id>1234567890000</Id>
<Name i:nil="true"/>
<Type>ImageAsset</Type>
<CropHeight>628</CropHeight>
<CropWidth>628</CropWidth>
<CropX>286</CropX>
<CropY>0</CropY>
<SubType>SquareImageMedia</SubType>
</Asset>
<AssetPerformanceLabel i:nil="true"/>
<EditorialStatus i:nil="true"/>
<PinnedField i:nil="true"/>
</AssetLink>
<AssetLink>
<Asset i:type="ImageAsset">
<Id>1234567890000</Id>
<Name i:nil="true"/>
<Type>ImageAsset</Type>
<CropHeight>628</CropHeight>
<CropWidth>942</CropWidth>
<CropX>129</CropX>
<CropY>0</CropY>
<SubType>ImageMedia15X10</SubType>
</Asset>
<AssetPerformanceLabel i:nil="true"/>
<EditorialStatus i:nil="true"/>
<PinnedField i:nil="true"/>
</AssetLink>
<AssetLink>
<Asset i:type="ImageAsset">
<Id>1234567890000</Id>
<Name i:nil="true"/>
<Type>ImageAsset</Type>
<CropHeight>628</CropHeight>
<CropWidth>835</CropWidth>
<CropX>183</CropX>
<CropY>0</CropY>
<SubType>ImageMedia133X100</SubType>
</Asset>
<AssetPerformanceLabel i:nil="true"/>
<EditorialStatus i:nil="true"/>
<PinnedField i:nil="true"/>
</AssetLink>
<AssetLink>
<Asset i:type="ImageAsset">
<Id>1234567890000</Id>
<Name i:nil="true"/>
<Type>ImageAsset</Type>
<CropHeight>628</CropHeight>
<CropWidth>1118</CropWidth>
<CropX>41</CropX>
<CropY>0</CropY>
<SubType>ImageMedia178X100</SubType>
</Asset>
<AssetPerformanceLabel i:nil="true"/>
<EditorialStatus i:nil="true"/>
<PinnedField i:nil="true"/>
</AssetLink>
</Images>
<LandscapeImageMediaId>1234567890000</LandscapeImageMediaId>
<LandscapeLogoMediaId i:nil="true"/>
<LongHeadline>Find New Customers & Increase Sales!</LongHeadline>
<SquareImageMediaId>1234567890000</SquareImageMediaId>
<SquareLogoMediaId i:nil="true"/>
<Text>Find New Customers & Increase Sales! Start Advertising on Contoso Today.</Text>
</Ad>
</Ads>
</GetAdsByAdGroupIdResponse>
</s:Body>
</s:Envelope>
Gereksinimler
Hizmet: CampaignManagementService.svc v13
Ad alanı: https://bingads.microsoft.com/CampaignManagement/v13