Toplu Dosya Şeması
Toplu şema, toplu API ile indirilmesi veya karşıya yüklenmesi için dosyanın içeriğini tanımlar. Hem indirme hem de karşıya yükleme için, Toplu hizmet DownloadEntity değer kümesindeki dosya türlerini ve ilgili şemaları destekler.
Kampanyalarınızı yönetmek için Toplu hizmeti kullanma hakkında daha fazla bilgi için bkz. Toplu İndirme ve Karşıya Yükleme. Veri dosyası içeriğini anlama hakkında daha fazla bilgi için aşağıdaki bölümlere bakın.
- Dosya Şeması
- Sürümleri Biçimlendir
- Kayıt Türleri
- Tür Hiyerarşisi
- Başvuru Anahtarları
- İstemci Tanımlayıcıları
- Hata
Dosya Şeması
Sekme veya virgülle ayrılmış kayıt (satırlar) ve alanlar (sütunlar) kümesini indirmeyi seçebilirsiniz. İlk sütun üst bilgisi Tür olarak adlandırılır. Sütun adlarının geri kalanı, ilgili kayıt türü içindeki veya ilişkili özelliklerle eşlenir.
Önemli
Yeni kayıt türleri (satırlar) ve alanlar (sütunlar) her zaman eklenebilir ve toplu indirme veya toplu karşıya yükleme sonuçları dosyasındaki kayıt veya alan sırasına bağlı olmamalıdır. Benzer şekilde, başvuru belgelerinde aksi belirtilmedikçe, her alanda döndürülen sabit bir değer kümesine bağımlı olmamalıdır.
Benzer şekilde, karşıya yükleme sırasında alanları herhangi bir sırayla gönderebilirsiniz. Karşıya yükleme kaydı sırası, aşağıda Tür Hiyerarşisi'nin içinde açıklandığı gibi yeni varlıklar oluşturulurken önemlidir.
Sürümleri Biçimlendir
Toplu biçim sürümü Bing Ads API sürümünden ayrıdır. Biçim sürümü, uygulamanızı bozmadan desteklenen en son özellikleri benimsemek için esnek bir yükseltme yolu sağlar. En iyi yöntem olarak her zaman en son biçim sürümüne yükseltmeniz gerekir. Şu anda desteklenen tek biçim sürümü 6.0'dır.
Toplu indirme kullanarak dosya biçimi sürümünü belirtmek için, DownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds isteğinde FormatVersion'ı 6.0 olarak ayarlayın.
Sürümü toplu karşıya yükleme kullanarak belirtmek için Sürümü Biçimlendir kaydının Ad alanını 6.0 olarak ayarlayın.
Kayıt Türleri
Biçim Sürümü 6.0 kullanılarak karşıya yükleme ve indirme için kullanılabilen kayıtlar aşağıdaki tabloda ayrıntılı olarak yer almaktadır.
Önemli
Yeni kayıt türleri (satırlar) ve alanlar (sütunlar) her zaman eklenebilir ve toplu indirme veya toplu karşıya yükleme sonuçları dosyasındaki kayıt veya alan sırasına bağlı olmamalıdır.
Tür Hiyerarşisi
İndirme dosyası her zaman Biçim Sürümü ve Hesap kayıt türleri için bir kayıt içerir. Karşıya yükleme için Biçim Sürümü gereklidir ve toplu dosyadaki diğer tüm kayıt türlerinden önce olmalıdır.
Aynı dosyada bir üst varlık oluşturulursa, toplu dosyadaki bağımlı alt kayıtların önünde olmalıdır. Örneğin, aşağıdaki diyagramda gösterildiği gibi, bir site bağlantısı reklam uzantısını bir kampanyayla ilişkilendirirken, Hem Kampanya hem de SiteLink Ad Uzantısı kaydından sonra Kampanya Sitesi Bağlantısı Ad Uzantısı kaydı dosyaya eklenmelidir. Kampanya Sitesi Bağlantısı Ad Uzantısı kaydının Kimlik ve Üst Kimlik alanları sırasıyla SiteLink Ad Uzantısı ve Kampanya kayıtlarının tanımlayıcısına ayarlanmalıdır. SiteLink Ad Uzantısı ve Kampanya kayıtları da yeniyse ve henüz Microsoft Advertising tanımlayıcıları atamadıysa, Başvuru Anahtarları'nı kullanmanız gerekir.
Geçerli bir Microsoft Advertising tanımlayıcısı atanmış olan bir üst varlığın kaydının eklenmesi gerekmez.
Toplu dosya kayıtlarını eklerken, güncelleştirirken ve silerken kısmi başarı desteklenir. Örneğin, üç kampanya eklemeyi denerseniz ve dosyada yalnızca ikisi doğru şekilde belirtilirse, iki kampanya eklenir. Sonuç dosyası hem başarılı Kampanya kayıtlarının, hem bir denenen Kampanya kaydının hem de bir Kampanya Hatası kaydının ayrıntılarını içerir.
Yeni kampanya tanımlayıcısı henüz bilinmiyorsa (örneğin, aynı dosyaya bir kampanya, reklam grubu, metin reklamı ve anahtar sözcük eklerken) Kampanya adını tüm alt kayıtlar için Mantıksal Başvuru Anahtarı olarak belirtin. Karşıya yüklemede var olan bir üst öğe belirtmek gerekli değildir.
Kısmi güncelleştirmeler, negatif anahtar sözcükler, negatif siteler ve hedef ölçütler de dahil olmak üzere toplu kayıtlar için desteklenir. Örneğin, tek bir konum ölçütünün teklifini güncelleştirebilirsiniz ve kampanya veya reklam grubu için hedef ölçüt kümesinin tamamını indirip yüklemeniz gerekmez.
Kaydı güncelleştirirken, güncelleştirilmiş kaydın Kimlik alanı gereklidir. Üst kayıt için Üst Kimlik veya Başvuru Anahtarları da gereklidir.
Kampanyayı veya reklam grubu adını güncelleştirirken, doğru Ebeveyn Kimliği sağlanmışsa alt kayıtlar için yeni ad belirtmek isteğe bağlıdır.
Bir kayıt kümesini başka bir kümeyle değiştiriyorsanız, yeni kümeden önce silinen kayıtları belirtmeniz gerekir. Örneğin, belirli bir kampanyanın tüm mevcut Kampanya Negatif Anahtar Sözcüğünü değiştirmek için önce Durumu Silinmiş ve Üst Kimliği kampanya kimliği olarak ayarlanmış bir Kampanya Negatif Anahtar Sözcüğü ekleyin. Herhangi bir kimlik belirtmezseniz, örneğin belirli bir camapaign negatif anahtar sözcüğünü silmeye çalışmazsanız, bu işlem söz konusu kampanyanın tüm Kampanya Negatif Anahtar Sözcüğünü etkili bir şekilde siler. "Tümünü sil" kaydının altında, karşıya yükleme ekleme işlemi için gerekli tüm özelliklere sahip bir veya daha fazla yeni Kampanya Negatif Anahtar Sözcük kaydı ekleyebilirsiniz.
Mevcut bir kaydı aynı benzersiz özelliklere sahip yeni bir kayıtla değiştiriyorsanız, silinen kaydı yeni kayıt öncesinde belirtmeniz gerekir. Örneğin, belirli bir reklam grubu için mevcut Bir Ad Grubu Dinamik Arama Reklam Hedefi'ni değiştirmek için, önce Durum Silinmiş, Kimlik mevcut dinamik reklam hedefi (web sayfası ölçütü) kimliğine ayarlanmış bir Ad Grubu Dinamik Arama Reklam Hedefi ve reklam grubu kimliği olarak ayarlanmış Bir Üst Kimlik ekleyin. Silinen kaydın altına yeni bir Ad Grubu Dinamik Arama Reklam Hedefi kaydı (muhtemelen yeni web sayfası koşullarıyla) ekleyebilirsiniz.
Not
Çoğu durumda, ayrı silme işlemi göndermek ve kayıt eklemek yerine mevcut kaydı güncelleştirebilirsiniz. Örneğin, mevcut Kampanya Cinsiyet ÖlçütününTeklif Ayarlaması alanını güncelleştirebilirsiniz.
Bir kaydı silerken Kimlik alanı gereklidir. Değerin Microsoft Advertising tarafından atanan bir sistem tanımlayıcısı veya üst kayıt için Başvuru Anahtarları olması fark eder, üst varlığa başvuru da gereklidir. Örneğin, bir reklam grubunu silerken, Reklam Grubu kaydının Üst Kimlik alanı Kampanya kaydındaki Kimlik alanıyla eşleşmelidir veya Reklam Grubu kaydının Kampanya alanı, Kampanya kaydındaki Kampanya alanıyla eşleşmelidir. Her ikisi de sağlanmışsa, Ad Grubu kaydının Üst Kimlik alanı (Başvuru Anahtarları) yoksayılır.
Birkaç özel durum dışında sonuç dosyası yalnızca karşıya yüklediğiniz sütunları içerir. Örneğin, Kimlik sütun başlığı olmadan yeni bir Ad Grubu Negatif Anahtar Sözcüğü yüklerseniz, sonuç dosyası yeni negatif anahtar sözcük için atanan tanımlayıcıyı içermez. Toplu dosya Kimlik sütununu içermelidir; ancak, her yeni Ad Grubu Negatif Anahtar Sözcüğü için Kimliği boş bırakmalısınız. Bu kuralın istisnaları kampanyalar, reklam grupları, reklamlar ve anahtar sözcüklerdir. Bu durumda, sonuç dosyası karşıya yüklenen sütunlardan bağımsız olarak tüm sütunları içerir.
delete_value ile güncelleştirme
Mevcut bir ayarı kaldırmak için Toplu dosyaya boş bir dize ("") yazmamalısınız çünkü bu tür dizeler Toplu hizmeti tarafından yoksayılır. İsteğe bağlı bir alanın değerini silmek veya sıfırlamak için ayrılmış "delete_value" dizesini kullanın.
- İsteğe bağlı bir alanda ayrılmış "delete_value" dizesini kullanırsanız, önceki ayar silinir. Örneğin, Ad Grubu kaydının Özel Parametre alanını "delete_value" olarak ayarlarsanız, önceki tüm özel parametreler reklam grubundan silinir. Benzer şekilde, Reklam Grubu kaydının İzleme Şablonu alanını "delete_value" olarak ayarlarsanız, önceki izleme şablonu reklam grubundan silinir.
- .NET, Java ve Python için Bing Ads SDK'ları uygun olduğunda otomatik olarak "delete_value" yazar. Daha fazla ayrıntı için bkz . Bulk Service Manager - delete_value ile güncelleştirme.
Gerekli alanlarda "delete_value" kullanıyorsanız lütfen aşağıdakileri not edin.
- Gerekli bir ilkel değer yerine ayrılmış "delete_value" dizesini kullanırsanız, yoksayılır. Alan güncelleştirilmemiş olsa da, "delete_value" dizesi karşıya yükleme sonuçları dosyası aracılığıyla geçirilir. Örneğin , Ad Grubu kaydının Ad Grubu alanını (ad grubu adı) "delete_value" olarak ayarlarsanız, reklam grubunun adı güncelleştirilmez.
- Gerekli bir değer kümesi yerine ayrılmış "delete_value" dizesini kullanırsanız, alan varsayılan değere güncelleştirilir ve sonuç dosyası bu değişikliği yansıtır. Örneğin, Ad Grubu kaydının Ağ Dağıtımı alanını "delete_value" olarak ayarlarsanız, reklam grubunun ağ dağıtımı OwnedAndOperatedAndSyndicatedSearch olarak ayarlanır ve karşıya yükleme sonuçları dosyası da aynı şekilde yansıtılır.
Başvuru Anahtarları
Toplu dosyada henüz atanmış bir Microsoft Advertising tanımlayıcısı olmayan önceki bir kayda başvururken, kayıt türüne bağlı olarak mantıksal başvuru anahtarı veya negatif başvuru anahtarı kullanabilirsiniz.
Not
Üst varlık aynı dosyada oluşturulduysa, toplu dosyadaki bağımlı alt kayıtların önünde olmalıdır.
Negatif Başvuru Anahtarı
Toplu dosyada henüz atanmış bir Microsoft Advertising tanımlayıcısı olmayan önceki bir kayda başvururken, uzantının Kimlik alanını seçtiğiniz negatif bir sayıya ayarlayabilirsiniz. Bu özel kimlik, negatif başvuru anahtarı olarak bilinir. Ardından, bağımlı bir kaydın Kimlik alanında negatif başvuru anahtarını kullanabilirsiniz.
İlk örnekte yeni kampanya için Nasıl Reklam Grubu oluşturulacağı gösterilmektedir. Reklam Grubu kaydındaki Üst Kimlik alanını Kampanyanın negatif başvuru anahtarına (-111) ayarlayın. Aynı dosyaya Ad Grubu'nun üst öğesi olarak olması gereken başka kayıtlar da eklerseniz (örneğin Anahtar Sözcük veya Reklam Grubu Belirtme Çizgisi Ad Uzantısı), Ad GrubundakiKimlik alanını alt kayıtlardan başvurulabilen -1111 gibi negatif bir değere de ayarlamanız gerekir.
| Tür | Kimlik | Üst Kimlik |
|---|---|---|
| Kampanya | -111 | |
| Reklam Grubu | -1111 | -111 |
İkinci örnekte, yeni bir Kampanya ve yeni bir Belirtme Çizgisi Reklam Uzantısı için Kampanya Belirtme Çizgisi Reklam Uzantısının nasıl oluşturulacağı gösterilmektedir. Örnekte, yeni bir Ad Grubu ve başka bir yeni Belirtme Çizgisi Reklam Uzantısı için Ad Grubu Belirtme Çizgisi Reklam Uzantısının nasıl oluşturulacağı da gösterilmektedir.
- Kampanya Belirtme Çizgisi Ad Uzantısı kaydındaki Üst Kimlik alanını Kampanyanın negatif başvuru anahtarına (-111) ayarlayın ve Kampanya Belirtme Çizgisi Ad Uzantısı kaydındaki Kimlik alanını Belirtme Çizgisi Ad Uzantısı'nın (-11) negatif başvuru anahtarına ayarlayın.
- Ad Grubu Belirtme Çizgisi Ad Uzantısı kaydındaki Üst Kimlik alanını Ad Grubunun negatif başvuru anahtarına (-1111) ayarlayın ve Ad Grubu Belirtme Çizgisi Ad Uzantısı kaydındaki Kimlik alanını Belirtme Çizgisi Ad Uzantısı'nın negatif başvuru anahtarına (-12) ayarlayın.
| Tür | Kimlik | Üst Kimlik |
|---|---|---|
| Belirtme Çizgisi Reklam Uzantısı | -11 | |
| Belirtme Çizgisi Reklam Uzantısı | -12 | |
| Kampanya | -111 | |
| Reklam Grubu | -1111 | -111 |
| Kampanya Açıklama Balonu Reklam Uzantısı | -11 | -111 |
| Ad Grubu Belirtme Çizgisi Reklam Uzantısı | -12 | -1111 |
Mantıksal Başvuru Anahtarı
Yeni bir Kampanya veya Reklam Grubu kaydına başvururken , Üst Kimlik alanını alt kayıt içinde Negatif Başvuru Anahtarı olarak ayarlamak yerine kampanyayı ve reklam grubu adını kullanabilirsiniz. Örneğin, yeni bir kampanyaya yeni bir reklam grubu eklemek ve yeni reklam grubuna yeni bir anahtar sözcük eklemek için, aşağıdaki örnekte gösterildiği gibi alt kayıtlardaki Kampanya ve Reklam Grubu alanlarını ayarlayın.
| Tür | Kampanya | Reklam Grubu |
|---|---|---|
| Kampanya | Kadın Ayakkabıları | |
| Reklam Grubu | Kadın Ayakkabıları | Kadın Kırmızı Ayakkabı Satışı |
İstemci Tanımlayıcıları
İstemci tanımlayıcıları, toplu karşıya yükleme dosyasındaki giriş kayıtlarını sonuç dosyasındaki çıkış kayıtlarıyla ilişkilendirmek için kullanılabilir. Örneğin, yeni kayıtlar eklerken İstemci Kimliği alanını seçtiğiniz bir dize değerine ayarlayabilirsiniz. Microsoft Advertising sistemi, istemci tanımlayıcılarınızda hiçbir değişiklik yapar ve bunları ilgili kaydın sonuç dosyasına iletir.
Hata
Toplu indirme dosyası veya toplu karşıya yükleme sonuçları dosyası, karşılık gelen Tür alanının Hata son ekini içerdiği kayıtları içerebilir. Örneğin , Ürün Reklam Hatası kayıt türü bir ürün reklam hatasını temsil eder. Hata ve Hata Numarası sütunları hatayla ilgili ayrıntıları içerir.
Not
Karşıya yükleme sonuçları dosyası, karşıya yüklenen bir kayda karşılık gelen birden çok hata kaydı içerebilir.
Son URL'ler gibi yeni özelliklerle ilgili hatalar , hatanın Alan Yolu sütununda nerede oluştuğu hakkında ek ayrıntılar içerir. Her alan yolu adı , Kampanya Yönetimi Hizmeti veri nesnelerinden birinin öğesine karşılık gelir. Örneğin, Kampanya kaydının İzleme Şablonu alanı http:// veya https://, {lpurl} veya {unescapedlpurl} ile başlamazsa, bu Alan Yolu değerinin değeri TrackingTemplate olur. TrackingUrlTemplate, Kampanya Yönetimi Hizmeti ile kullanılabilen Kampanya veri nesnesinin bir öğesidir.
| Tür | İzleme Şablonu | Error | Hata Numarası | Alan Yolu |
|---|---|---|---|---|
| Kampanya Hatası | tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} | InvalidUrlScheme | 4600 | TrackingTemplate |
| Kampanya Hatası | tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} | CampaignServiceInvalidUrl | 2611 | TrackingTemplate |
Önemli
Alan Yolu değeri değiştirilebilir, bu nedenle geçerli dize biçimine bağımlılık almamalısınız. Alan Yolu tüm hatalar için desteklenmez. İlgili Kampanya, Reklam Grubu, Genişletilmiş Metin Reklamı, Ürün Reklamı, Ad Grubu Ürün Bölümü, Anahtar Sözcük ve SiteLink Ad Uzantısı kayıtlarının Mobil Son Url, Son Url, İzleme Şablonu ve Özel Parametre alanları için desteklenir. Ayrıca Açıklama Balonu Reklam Uzantısı ve Ad Uzantısı kayıtlarını gözden geçirme alanlarının tüm alanlarıyla ilgili hatalar için de desteklenir.
Sorun bir editoryal hatayla ilgiliyse Editoryal Konum, Editoryal Terim, Editoryal Neden Kodu ve Yayımcı Ülkeleri sütunları da hata hakkında daha fazla bilgi içerebilir.