Aracılığıyla paylaş

ResponsiveSearchAd Veri Nesnesi - Kampanya Yönetimi

  • Makale

Arama ağındaki metin reklamları için duyarlı bir reklam biçimi.

Not

Aynı reklam grubunda yinelenen duyarlı arama reklamlarına izin verilir.

Duyarlı arama reklamları, tek bir reklam içinde 3-15 benzersiz reklam başlığı (diğer bir ifadeyle "başlıklar") ve 2-4 reklam açıklaması ayarlamanıza olanak sağlar. Buradan Bing, verilen her sorgu ve ilgili arama kullanıcısı için en uygun başlık ve açıklama bileşimini seçer. Bing AI her sorgu için en uygun başlığı ve açıklamayı seçmesine izin vererek olası müşterilerinizin her biri için doğru mesajın tüm olası amaç sinyallerinde doğru zamanda ulaşmasını sağlarız.

Kullanıcılara gösterilen duyarlı reklamlar, genişletilmiş metin reklamlarıyla aynı görünür; örneğin, 3 başlık (genişletilmiş metin reklamları aracılığıyla başlık bölümleri) ve 2 açıklama (genişletilmiş metin reklamları aracılığıyla metin bölümleri). Tüm reklam biçimlerindeki gösterimleri en üst düzeye çıkarmak için, açıklamalar her zaman reklamınızda gösterilmeyebilir.

Duyarlı arama reklamları oluşturduğunuzda Açıklamalar ve Başlıklar listeleri, hesaptaki herhangi bir duyarlı arama reklamı tarafından paylaşılabilen metin varlıkları olarak depolanır. Örneğin, "Sorunsuz Tümleştirme" bir metin varlığıysa, aynı Microsoft Advertising hesabındaki "Sorunsuz Tümleştirme"ye bağlanan tüm reklamlarda aynı varlık tanımlayıcısına sahip olduğunu göreceksiniz. Varlık tanımlayıcıları AddAds veya UpdateAds yanıtına dahil değildir. Kampanya Yönetimi hizmetiyle varlık tanımlayıcılarını almanın tek yolu oluşturduğunuz reklamları almaktır. Açıklamaların ve başlıkların varlık tanımlayıcılarını, sonraki bir hizmet aramasında (örneğin, GetAdsByAdGroupId aracılığıyla) alarak alabilirsiniz. Toplu hizmet ile varlık tanımlayıcıları toplu karşıya yükleme sonuç dosyasına eklenir.

Not

Duyarlı arama reklamları yalnızca AdGroupType'ın "SearchStandard" olarak ayarlandığı Arama kampanyalarında oluşturulabilir. AdGroupType "SearchDynamic" olarak ayarlandıysa, reklam grubu duyarlı arama reklamlarını desteklemez.

Sözdizimi

<xs:complexType name="ResponsiveSearchAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Domain" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Path1" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Path2" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Öğe

ResponsiveSearchAd nesnesi şu öğelere sahiptir: Açıklamalar, Etki Alanı, Başlıklar, Yol1, Yol2.

Öğe Açıklama Veri Türü
Açıklama Bing'in reklam düzenini iyileştirmek için kullanabileceği açıklamaların listesi.

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.

2-4 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.

Metin , EĞER işlevlerini içerebilir.

Ekle: Gerekli
Güncelleştirme: Isteğ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 öğeyi ayarlarsanız, daha önce bu reklama bağlı olan tüm açıklamalar değiştirilir.		 AssetLink dizisi
Etki alanı Son URL yerine görüntülenecek URL. Son URL, giriş sayfası URL'si için kullanılmaya devam eder.

İlaç müşterileri gibi sınırlı pilot kullanım için ayrılmıştır.

URL'nin etki alanı bölümü, yol 1 ve yol 2 dizeleriyle birlikte 67 karakteri aşamaz.

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
Başlık Bing'in reklam düzenini iyileştirmek için kullanabileceği reklam başlıklarının listesi.

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.

3-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.

Metin , EĞER işlevlerini içerebilir.

Ekle: Gerekli
Güncelleştirme: Isteğ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 öğeyi ayarlarsanız, daha önce bu reklama bağlı olan tüm başlıklar değiştirilir.		 AssetLink dizisi
Yol1 İsteğe bağlı yolun, görüntüleme URL'nizin etki alanı bölümüne eklenecek ilk bölümü. Görünen URL'nizin etki alanı bölümü( örneğin, https://www.contoso.com Son URL'nizin (FinalUrls öğesi) etki alanından oluşturulur. Ardından Path1 için bir değer belirttiyseniz, bu değer görünen URL'ye eklenir. Path2 için de bir değer belirttiyseniz, bu değer Path1'in ardından görünen URL'ye de eklenir. Örneğin, FinalUrls'ınız içeriyorsahttps://www.contoso.com, Yol1alt dizin1, Yol2ise alt dizin2 olarak ayarlanırsa, görüntülenen URL olurhttps://www.contoso.com/subdirectory1/subdirectory2.

Yol {MatchType} gibi dinamik parametreler içerebilir. Desteklenen parametrelerin listesi için Microsoft Advertising yardım makalesine bakın . Hangi izleme veya URL parametrelerini kullanabilirim?.

Dinamik metin dizeleri eklerseniz maksimum giriş uzunluğu 1.000 karakterdir. En fazla 15 son karakter (dinamik metin değil) giriş yapılabilir. Son URL etki alanının uzunluğu ve birleştirilen yollar 67 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, dinamik metin dizeleri eklerseniz maksimum giriş uzunluğu 1.000 karakterdir. En fazla 7 son karakter (dinamik metin değil) giriş yapılabilir. Son URL etki alanının uzunluğu ve birleştirilen yollar 33 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.

Yol eğik çizgi (/) veya yeni satır (\n) karakterlerini içeremez.

Yol bir boşluk içeriyorsa, reklam gösterildiğinde bir alt çizgi (_) ile değiştirilir.

Yol , EĞER işlevlerini içerebilir.

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
Yol2 İsteğe bağlı yolun, görüntüleme URL'nizin etki alanı bölümüne eklenecek ikinci bölümü. Görünen URL'nizin etki alanı bölümü( örneğin, https://www.contoso.com Son URL'nizin (FinalUrls öğesi) etki alanından oluşturulur. Ardından Path1 için bir değer belirttiyseniz, bu değer görünen URL'ye eklenir. Path2 için de bir değer belirttiyseniz, bu değer Path1'in ardından görünen URL'ye de eklenir. Örneğin, FinalUrls'ınız içeriyorsahttps://www.contoso.com, Yol1alt dizin1, Yol2ise alt dizin2 olarak ayarlanırsa, görüntülenen URL olurhttps://www.contoso.com/subdirectory1/subdirectory2.

Yol2'nin belirtilmesi için Yol1'in de ayarlanmış olması gerekir.

Yol {MatchType} gibi dinamik parametreler içerebilir. Desteklenen parametrelerin listesi için Microsoft Advertising yardım makalesine bakın . Hangi izleme veya URL parametrelerini kullanabilirim?.

Dinamik metin dizeleri eklerseniz maksimum giriş uzunluğu 1.000 karakterdir. En fazla 15 son karakter (dinamik metin değil) giriş yapılabilir. Son URL etki alanının uzunluğu ve birleştirilen yollar 67 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, dinamik metin dizeleri eklerseniz maksimum giriş uzunluğu 1.000 karakterdir. En fazla 7 son karakter (dinamik metin değil) giriş yapılabilir. Son URL etki alanının uzunluğu ve birleştirilen yollar 33 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.

Yol eğik çizgi (/) veya yeni satır (\n) karakterlerini içeremez.

Yol bir boşluk içeriyorsa, reklam gösterildiğinde bir alt çizgi (_) ile değiştirilir.

Yol , EĞER işlevlerini içerebilir.

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

ResponsiveSearchAd nesnesinin Devralınan Öğeleri vardır.

Devralınan Öğeler

Ad'dan Devralınan Öğeler

ResponsiveSearchAd nesnesi Ad nesnesinden türetilir ve şu öğeleri devralır: AdFormatPreference, DevicePreference, EditorStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters. Aşağıdaki açıklamalar ResponsiveSearchAd'a ö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.

Ekle: Salt okunur
Güncelleştirme: 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.

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı		 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.

Ekle: Gerekli
Güncelleştirme: Isteğe bağlı		 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.

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
İ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
Kimlik Reklamın benzersiz Microsoft Advertising tanımlayıcısı.

Ekle: Salt okunur
Güncelleştirme: Gerekli ve Read-Only		 Uzun
Durum Reklamın durumu.

Reklam durumunu Etkin veya Duraklatıldı olarak ayarlayabilirsiniz.

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı		 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.

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
Tür Reklamın türü. Duyarlı arama reklamı aldığınızda bu değer ResponsiveSearch değeridir. Reklam türleri hakkında daha fazla bilgi için bkz. Reklam Verileri Nesnesi Açıklamaları.

Ekle: Salt okunur
Güncelleştirme: 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.

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

Gereksinimler

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