Dinamik Arama Reklam Kaydı - Toplu
Toplu dosyada indirilebilen ve karşıya yüklenebilecek dinamik bir arama reklamı 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 ülkelerde 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), Hollanda (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 Reklamı kaydı yalnızca geçerli dinamik arama reklamları ayarlarına sahip arama kampanyalarında oluşturulabilir ( Etki Alanı Dili, Dinamik Açıklama Etkin, Sayfa Akışı Kimlikleri, Kaynak ve Web Sitesi alanlarından oluşur). Kampanyanın Deneme Kimliği ve Reklam Grubu Türü "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.
DownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds hizmet isteğine DynamicSearchAds'inDownloadEntity değerini ekleyerek hesaptaki tüm Dinamik Arama Reklam kayıtlarını indirebilirsiniz. Ayrıca indirme isteğinin EntityData kapsamını içermesi gerekir. En iyi yöntemler de dahil olmak üzere Toplu hizmet hakkında daha fazla ayrıntı için bkz. Toplu İndirme ve Karşıya Yükleme.
Aşağıdaki Toplu CSV örneği, geçerli bir Ebeveyn Kimliği değeri sağlanırsa yeni bir dinamik arama reklamı ekler.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Title,Text,Display Url,Destination Url,Promotion,Device Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Final Url Suffix,Custom Parameter,Title Part 1,Title Part 2,Path 1,Path 2
Format Version,,,,,,,,,,,,,,6.0,,,,,,,,,,,
Dynamic Search Ad,Active,,-1113,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,Find New Customers & Increase Sales! Start Advertising on Contoso Today.,,,,,,,,,,,,{_promoCode}=PROMO1; {_season}=summer,,,seattle,shoe sale
.NET, Java veya Python için Bing Ads SDK'larını kullanıyorsanız, hizmet işlemlerini doğrudan çağırmak ve toplu dosyadaki her alanı ayrıştırmak için özel kod yazmak yerine BulkServiceManager kullanarak BulkDynamicSearchAd nesnesini karşıya yükleyip indirebilirsiniz.
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkDynamicSearchAd
var bulkDynamicSearchAd = new BulkDynamicSearchAd
{
// 'Parent Id' column header in the Bulk file
AdGroupId = adGroupIdKey,
// 'Ad Group' column header in the Bulk file
AdGroupName = "AdGroupNameGoesHere",
// 'Campaign' column header in the Bulk file
CampaignName = "ParentCampaignNameGoesHere",
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// DynamicSearchAd object of the Campaign Management service.
DynamicSearchAd = new DynamicSearchAd
{
// 'Id' column header in the Bulk file
Id = null,
// 'Path 1' column header in the Bulk file
Path1 = "seattle",
// 'Path 2' column header in the Bulk file
Path2 = "shoe sale",
// 'Status' column header in the Bulk file
Status = AdStatus.Active,
// 'Text' column header in the Bulk file
Text = "Find New Customers & Increase Sales! Start Advertising on Contoso Today.",
// 'Tracking Template' column header in the Bulk file
TrackingUrlTemplate = null,
// 'Custom Parameter' column header in the Bulk file
UrlCustomParameters = new CustomParameters
{
// Each custom parameter is delimited by a semicolon (;) in the Bulk file
Parameters = new[] {
new CustomParameter(){
Key = "promoCode",
Value = "PROMO1"
},
new CustomParameter(){
Key = "season",
Value = "summer"
},
}
},
},
};
uploadEntities.Add(bulkDynamicSearchAd);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
Dinamik Arama Reklam kaydı için Toplu Dosya Şeması'nda aşağıdaki öznitelik alanları bulunur. Yol 1, Yol 2 ve Metin alanlarının birleşimi dinamik arama reklamını benzersiz hale getirir.
- Reklam Grubu
- Kampanya
- İstemci Kimliği
- Özel Parametre
- Editoryal İtiraz Durumu
- Editoryal Konum
- Editoryal Neden Kodu
- Editoryal Durum
- Editoryal Terim
- Son Url Soneki
- Kimlik
- Değiştirme Zamanı
- Üst Kimlik
- Yol 1
- Yol 2
- Yayımcı Ülkeleri
- Durum
- Metin
- İzleme Şablonu
Reklam Grubu
Reklamı içeren reklam grubunun adı.
Ekle: Salt okunur ve Gerekli
Güncelleştirme: Salt okunur ve Gerekli
Silmek: Salt okunur ve Gerekli
Not
Ekleme, güncelleştirme ve silme için Üst Kimlik veya Ad Grubu alanını belirtmeniz gerekir.
Kampanya
Reklam grubunu ve reklamı içeren kampanyanın adı.
Ekle: Salt okunur
Güncelleştirme: Salt okunur
Silmek: Salt okunur
İstemci Kimliği
Toplu karşıya yükleme dosyasındaki kayıtları sonuç dosyasındaki kayıtlarla ilişkilendirmek için kullanılır. Bu alanın değeri sunucu tarafından kullanılmaz veya depolanmaz; yalnızca karşıya yüklenen kayıttan ilgili sonuç kaydına kopyalanır. Uzunluğu 100'e kadar olan geçerli bir dize olabilir.
Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı
Silmek: Salt okunur
Özel Parametre
URL izleme için özel anahtar ve değer parametreleri koleksiyonunuz.
Toplu bir dosyada, özel parametrelerin listesi aşağıdaki gibi biçimlendirilir.
Her özel parametre çiftini Key=Value olarak biçimlendirin, örneğin {_promoCode}=PROMO1.
Microsoft Advertising, dahil ettiğiniz ilk 8 özel parametre anahtarı ve değer çiftini kabul eder ve 8'den fazla özel parametre eklerseniz hata döndürülür. Her anahtar ve değer çifti noktalı virgül ve boşlukla ("; "), örneğin {_promoCode}=PROMO1; {_season}=summer.
Anahtar noktalı virgül içeremez. Bir Değer noktalı virgül içeriyorsa , '\;' olarak kaçış olmalıdır. Buna ek olarak, Değer ters eğik çizgi içeriyorsa , '\' olarak da kaçılmalıdır.
Anahtar 16 UTF-8 bayt'ı ve Değer 250 UTF-8 bayt'ı aşamaz. Anahtar gereklidir ve Değer isteğe bağlıdır. Anahtarın en büyük boyutu ayraçları ve alt çizgiyi (örneğin, '{', '_' ve '}' içermez.
Not
Toplu hizmet ile Anahtar çevresindeki küme ayraçlarıyla ve baştaki bir alt çizgiyle biçimlendirilmelidir; örneğin Anahtar promoCode ise {_promoCode} olarak biçimlendirilmelidir. Kampanya Yönetimi hizmetiyle, çevresindeki ayraçları ve alt çizgiyi belirtemezsiniz.
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. Tüm özel parametreleri kaldırmak için bu alanı delete_value olarak ayarlayın.
delete_value anahtar sözcüğü önceki ayarı kaldırır. Özel parametrelerin bir alt kümesini kaldırmak için, saklamak istediğiniz özel parametreleri belirtin ve saklamak istemediğiniz parametreleri atlarsınız. Yeni özel parametre kümesi, önceki özel parametre kümelerinin yerini alır.
Silmek: Salt okunur
Editoryal İtiraz Durumu
Editör incelemesinde bulunan sorunlara itiraz edip etmeyeceğinizi belirler.
Olası değerler aşağıdaki tabloda açıklanmıştır.
| Değer | Açıklama |
|---|---|
| Çekici | Editörlük sorunu caziptir. |
| AppealPending | Editörlük sorunu itiraz edilebilir ve bir itirazda bulundu. |
| NotAppealable | Editörlük sorunu cazip değildir. |
Ekle: Salt okunur
Güncelleştirme: Salt okunur
Silmek: Salt okunur
Editoryal Konum
Editoryal incelemede başarısız olan reklamın bileşeni veya özelliği.
Ekle: Salt okunur
Güncelleştirme: Salt okunur
Silmek: Salt okunur
Editoryal Neden Kodu
Hatanın nedenini tanımlayan bir kod. Olası neden kodlarının listesi için bkz . Editoryal Neden Kodları.
Ekle: Salt okunur
Güncelleştirme: Salt okunur
Silmek: Salt okunur
Editoryal Durum
Reklamın editoryal durumu.
Olası değerler aşağıdaki tabloda açıklanmıştır.
Ekle: Salt okunur
Güncelleştirme: Salt okunur
Silmek: Salt okunur
Editoryal Terim
Editoryal incelemede başarısız olan terim.
Hataya bir terim birleşimi neden olursa veya hata bir ilke ihlaline dayandıysa bu alan ayarlanmaz.
Ekle: Salt okunur
Güncelleştirme: Salt okunur
Silmek: Salt okunur
Son Url Soneki
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 alanı delete_value dizesi olarak ayarlarsanız, önceki ayar kaldırılır.
Silmek: Salt okunur
Kimlik
Reklamın sistem tarafından oluşturulan tanımlayıcısı.
Ekle: Isteğe bağlı. Bu alanı boş bırakmanız veya negatif bir tanımlayıcı belirtmeniz gerekir. Ardından, dinamik arama reklam etiketi gibi bağımlı kayıt türlerinin Üst Kimlik alanında reklam için negatif tanımlayıcı kümesine başvurulabilir. Aynı Toplu dosyaya yeni reklamlar ve yeni bağımlı kayıtlar ekliyorsanız bu önerilir. Daha fazla bilgi için bkz. Toplu Dosya Şeması Başvuru Anahtarları.
Güncelleştirme: Salt okunur ve Gerekli
Silmek: Salt okunur ve Gerekli
Değiştirme Zamanı
Varlığın son güncelleştirildiği tarih ve saat. Değer Eşgüdümlü Evrensel Saat (UTC) içindedir.
Not
Tarih ve saat değeri, istemcide değil sunucudaki tarih ve saati yansıtır. Tarih ve saatin biçimi hakkında bilgi için temel XML Veri Türleri'ndeki dateTime girdisine bakın.
Ekle: Salt okunur
Güncelleştirme: Salt okunur
Silmek: Salt okunur
Üst Kimlik
Reklamı içeren reklam grubunun sistem tarafından oluşturulan tanımlayıcısı.
Bu toplu alan, Ad Grubu kaydının Kimlik alanına eşler.
Ekle: Salt okunur ve Gerekli. Mevcut bir reklam grubu tanımlayıcısı belirtmeniz veya üst Ad Grubu kaydının Kimlik alanına eşit bir negatif tanımlayıcı belirtmeniz gerekir. Aynı Toplu dosyadaki yeni bir reklam grubuna yeni reklamlar ekliyorsanız bu önerilir. Daha fazla bilgi için bkz. Toplu Dosya Şeması Başvuru Anahtarları.
Güncelleştirme: Salt okunur
Silmek: Salt okunur
Not
Ekleme, güncelleştirme ve silme için Üst Kimlik veya Ad Grubu alanını belirtmeniz gerekir.
Yol 1
İ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ı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Bu alanı delete_value dizesi olarak ayarlarsanız, önceki ayar kaldırılır.
Silmek: Salt okunur
Yol 2
İ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.
Yol 2'nin belirtilmesi için Yol 1'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ı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Bu alanı delete_value dizesi olarak ayarlarsanız, önceki ayar kaldırılır.
Silmek: Salt okunur
Yayımcı Ülkeleri
Editör yönergeleri belirtilen terime izin verilmeyen yayımcı ülkelerinin veya bölgelerinin listesi.
Toplu dosyada, yayımcı ülke veya bölge listesi noktalı virgülle (;)) sınırlandırılır.
Ekle: Salt okunur
Güncelleştirme: Salt okunur
Silmek: Salt okunur
Durum
Reklamın durumu.
Olası değerler Etkin, Duraklatılmış veya Silinmiş olabilir.
Ekle: Isteğe bağlı. Varsayılan değer Etkin'dir.
Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Gerekli. Durum , Silinmiş olarak ayarlanmalıdır.
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ı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Salt okunur
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ı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Salt okunur
İzleme Şablonu
FinalUrls ile belirtilen URL 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.
Düşük düzeyli varlıklar için tanımlanan izleme şablonları(ör. reklamlar, kampanya gibi daha üst düzey varlıklar için ayarlananları 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
https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}ise ve kampanya, reklam grubu, ölçüt, anahtar sözcük veya reklam düzeyinde {_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 alanı delete_value dizesi olarak ayarlarsanız, önceki ayar kaldırılır.
Silmek: Salt okunur