Aracılığıyla paylaş

DynamicSearchAd Veri Nesnesi - Kampanya Yönetimi

  • Makale

Dinamik arama reklamlarını tanımlar.

Dinamik arama reklamlarında başlık ve görüntüleme URL'si, hedeflemek istediğiniz web sitesi etki alanına ve dile göre otomatik olarak oluşturulur. Path1, Path2 ve Text öğelerinin birleşimi dinamik arama reklamını benzersiz hale getirir. İsteğe bağlı olarak , sayfa akışlarını kullanarak statik bir başlık sağlayabilirsiniz.

Not

Bu özellik şu anda şu ülke veya bölgelerde kullanılabilir: Arnavutluk (AL), Andorra (AD), Arjantin (AR), Aruba, Avustralya (AU), Avusturya (AT), Bahamalar (BS), Bangladeş(BD), Belçika (BE), Bolivya(BO), Bosna-Hersek (BA), Brezilya (BR), Brunei(BN), Bulgaristan (BG), Kanada (CA), Cayman Adaları(KY), Şili(CL), Kolombiya(CO), Kosta Rika(CR), Hırvatistan (İk), Kıbrıs (CY), Çek Cumhuriyeti (CZ), Danimarka (DK), Dominika(DM), Dominik Cumhuriyeti(DO), Ekvador(EC), El Salvador(SV), Estonya (EE), Fiji (FJ), Finlandiya (FI), Fransa (FR), Fransız Guyanası(GF), Fransız Polinezyası (PF), Almanya (DE), Yunanistan (GR), Guam (GU), Guatemala (GT), Guyana (GY), Haiti (HT), Honduras (HN), Macaristan (HU), İzlanda (IS), Hindistan (IN), Endonezya (ID), İrlanda (IE), İtalya (BT), Letonya (LV), Liechtenstein (LI), Litvanya (LT), Lüksemburg (LU), Malezya (MY), Maldivler (MV), Malta (MT), Martinik (MQ), Meksika (MX), Monako (MC), Moğolistan (MN), Karadağ (ME), Montserrat (MS), Nepal (NP), Hollandas (NL), Yeni Kaledonya (NC), Yeni Zelanda (NZ), Kuzey Makedonya Cumhuriyeti (MK), Norveç (NO), Panama (PA), Paraguay (PY), Papua Yeni Gine (PG), Peru (PE), Filipinler (PH), Polonya (PO), Portekiz (PT), Porto Riko, Romanya (RO), San Marino (SM), Sırbistan (RS), Singapur(SG), Slovakya (SK), Slovenya (SI), Güney Afrika (ZA), İspanya (ES), İspanya(ES), Sri Lanka(LK), İsveç (SE), İsviçre (CH), Tayland(TH), Trinidad ve Tobago(TT), Türkiye (TR), Vatikan (VA), Vietnam(VN), Birleşik Krallık (birleşik krallık), Birleşik Devletler (ABD), Uruguay (UY) ve Venezuela(VE).

Dinamik arama reklamları yalnızca DynamicSearchAdsSetting içeren arama kampanyalarında oluşturulabilir. Kampanyanın ExperimentId öğesi ayarlanamaz ve AdGroupType değeri "SearchDynamic" olarak ayarlanmalıdır.

Not

Artık yalnızca dinamik arama reklamlarını destekleyen kampanyalar ekleyemez, güncelleştiremez veya alamazsınız. Mevcut kampanyalarınızın kampanya türü "DynamicSearchAds" olan "Search" olarak güncelleştirildi. Reklam grupları artık "dinamik" reklam grupları olarak kabul edilir, ancak yapısal bir değişiklik yoktur; bunlar daha önce olduğu gibi aynı otomatik hedefleri ve dinamik arama reklamlarını içerir.

Sözdizimi

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

Öğe

DynamicSearchAd nesnesi şu öğelere sahiptir: Path1, Path2, Text, TextPart2.

Öğe Açıklama Veri Türü
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 örneğin www.contoso.com , görüntüleme URL'nizin etki alanından oluşturulur. Ardından , Yol 1 için bir değer belirttiyseniz, görüntü URL'sine eklenir. Yol 2 için de bir değer belirttiyseniz, bu değer Yol 1'in ardından görünen URL'ye de eklenir. Örneğin, etki alanınız contoso.com, Yol 1alt dizin1 ve Yol 2alt dizin2 olarak ayarlanırsa, görüntülenen URL www.contoso.com/subdirectory1/subdirectory2.

Yolun giriş uzunluğu üst sınırı 15 karakterdir. Çift genişlikli karakterlere sahip diller için (ör. Geleneksel Çince) yolun giriş uzunluğu üst sınırının 7 karakter olduğunu unutmayın.

Yol , EĞER ve geri sayım işlevlerini içerebilir. Yayımlanmamış tüm geri sayım parametrelerinin toplam uzunluğu ne olursa olsun, görüntülenen son geri sayım her zaman kullanılabilir toplam karakterden 8 karakter kullanır. Daha fazla ayrıntı için bkz. Geri Sayım Özelleştiricileri.

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.

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı		 Dize
Yol2 İsteğe bağlı yolun, görüntüleme URL'nizin etki alanı bölümüne eklenecek ikinci bölümü. Www.contoso.com gibi görünen URL, dinamik arama reklamları kampanya düzeyi ayarlarınızın etki alanından oluşturulur. Ardından , Yol 1 için bir değer belirttiyseniz, görüntü URL'sine eklenir. Yol 2 için de bir değer belirttiyseniz, bu değer Yol 1'in ardından görünen URL'ye de eklenir. Örneğin, etki alanınız contoso.com, Yol 1alt dizin1 ve Yol 2alt dizin2 olarak ayarlanırsa, görüntülenen URL www.contoso.com/subdirectory1/subdirectory2.

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

Yolun giriş uzunluğu üst sınırı 15 karakterdir. Çift genişlikli karakterlere sahip diller için (ör. Geleneksel Çince) yolun giriş uzunluğu üst sınırının 7 karakter olduğunu unutmayın.

Yol , EĞER ve geri sayım işlevlerini içerebilir. Yayımlanmamış tüm geri sayım parametrelerinin toplam uzunluğu ne olursa olsun, görüntülenen son geri sayım her zaman kullanılabilir toplam karakterden 8 karakter kullanır. Daha fazla ayrıntı için bkz. Geri Sayım Özelleştiricileri.

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.

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı		 Dize
Metin Reklam açıklamasının ilk bölümü.

Metin en az bir sözcük içermelidir.

Kopyanın giriş uzunluğu üst sınırı 90 karakterdir. Geleneksel Çince kullanan reklam grupları için kopyanın maksimum giriş uzunluğunun 45 karakter olduğunu unutmayın.

Metin , EĞER ve geri sayım işlevlerini içerebilir. Yayımlanmamış tüm geri sayım parametrelerinin toplam uzunluğu ne olursa olsun, görüntülenen son geri sayım her zaman kullanılabilir toplam karakterden 8 karakter kullanır. Daha fazla ayrıntı için bkz. Geri Sayım Özelleştiricileri.

Metin yeni satır (\n) karakterini içeremez.

Ekle: Gerekli
Güncelleştirme: Isteğe bağlı		 Dize
Metin Bölümü2 Reklam açıklamasının ikinci bölümü.

Metin en az bir sözcük içermelidir.

Kopyanın giriş uzunluğu üst sınırı 90 karakterdir. Geleneksel Çince kullanan reklam grupları için kopyanın maksimum giriş uzunluğunun 45 karakter olduğunu unutmayın.

Metin , EĞER ve geri sayım işlevlerini içerebilir. Yayımlanmamış tüm geri sayım parametrelerinin toplam uzunluğu ne olursa olsun, görüntülenen son geri sayım her zaman kullanılabilir toplam karakterden 8 karakter kullanır. Daha fazla ayrıntı için bkz. Geri Sayım Özelleştiricileri.

Metin yeni satır (\n) karakterini içeremez.

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı		 Dize

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

Devralınan Öğeler

Ad'dan Devralınan Öğeler

DynamicSearchAd 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 DynamicSearchAd'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 Bu reklam türü için desteklenmez. dize dizisi
FinalUrls Bu reklam türü için desteklenmez. 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.

Şu anda dinamik arama reklamları için desteklenen ileriye dönük uyumluluk haritası anahtarı ve değer çiftleri yoktur.		 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ü. Dinamik arama reklamı aldığınızda bu değer DynamicSearch 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