Aracılığıyla paylaş

Varlık Grubu Listeleme Grubu Kaydı - Toplu

  • Makale

Toplu bir dosyaya yüklenip indirilebilen bir varlık grubu listeleme grubu tanımlar.

Doğrulama kuralları aşağıda açıklandığı gibi karşılandığı sürece, aynı toplu dosyada birden çok reklam grubu için Varlık Grubu Listeleme Grubu kayıtlarını karşıya yükleyebilirsiniz.

  • En azından, ürün bölümü grubu ağaç yapısı için en az kök düğümü belirtmeniz gerekir. Ürün bölümü grubunun kök düğümünde Ürün Koşulu 1 alanı "Tümü" ve Ürün Değeri 1 null veya boş olarak ayarlanmalıdır. Katalogdaki tüm ürünlere eşit şekilde teklif verirseniz , Alt Tür alanını Birim olarak ayarlayın. Teklifleri daha belirli ürün koşullarına göre bölümlediyseniz, Alt Tür alanını Alt Bölüm, Üst Ölçüt Kimliği'ni null veya boş, Kimliği ise negatif bir değer olarak ayarlayın. Alt düğümler için Üst Ölçüt Kimliği olarak negatif değeri kullanacaksınız.

  • Kök düğüm düzey 0 olarak kabul edilir ve bir ağaç 7 düzey derine kadar dallara sahip olabilir.

  • Karşıya yükleme isteği başına reklam grubu başına en fazla 20.000 ürün bölümü ağacı düğümü ekleyebilirsiniz. Bir reklam grubunun tüm ürün bölüm ağacı düğüm sayısı 20.000'i aşamaz.

  • Aynı ağaç (aynı reklam grubu) için ürün bölümü ağacı düğümlerinin dosyada birlikte gruplanması gerekir.

  • ürün bölümü düğümlerinin sırası indirme sırasında garanti edilemez ve alt düğümlerden sonra üst düğümler sağlanabilir; ancak, aynı reklam grubu için tüm düğümler dosyada birlikte gruplandırılır.

  • Ağaç yapısını oluşturuyor veya değiştiriyorsanız, üst ürün bölümü ağaç düğümleri alt ürün bölümü ağaç düğümlerinden önce sıralanmalıdır; ancak siparişin, teklifin güncelleştirilmesi gibi yapısal olmayan değişiklikler için önemi yoktur. Örneğin, ağaç yapısını eklemeden, silmeden veya güncelleştirmeden teklifleri güncelleştirmek istiyorsanız, yalnızca Kimlik ve Üst Kimlik alanlarını karşıya yüklemeniz gerekir.

  • Ürün Koşulu 1, Ürün Değeri 1 veya Dışlandı alanını güncelleştirmek için mevcut ürün bölümü ağacı düğümünü silmeniz ve yeni bir tanımlayıcı alacak yeni bir ürün bölümü ağacı düğümü yüklemeniz gerekir.

  • Herhangi bir eylem başarısız olursa, aksi takdirde başarılı olabilecek kalan tüm eylemler de başarısız olur.

  • Tüm ürün bölümü düğümü ekleme ve silme eylemleri tam bir ağaç yapısına neden olmalıdır.

  • Kök düğümden dalın sonuna kadar olan her yol bir yaprak düğümle sonlandırılmalıdır (Sub Type=Unit). Dışlandı alanı TRUE olmadığı sürece, düğümün negatif bir reklam grubu ölçütü olduğu anlamına gelmediği sürece her Birimin bir teklifi olmalıdır.

  • Her alt bölüm, alt bölüm koşullarının geri kalanında teklif veren en az bir yaprak düğüme sahip olmalıdır; örneğin eşdüzey birimleriyle aynı işleneni kullanın ve Ürün Değerini 1 null veya boş olarak ayarlayın.

  • Üst veya alt öğe olmayan birden çok düzeye sahip bölümler ekliyorsanız, üst öğeyi tanımlamak için başvuru olarak negatif bir int değeri kullanın. Örneğin hem üst kimliği hem de alt öğe Üst Ölçüt Kimliği alanını aynı negatif değere ayarlayın. Negatif kimlikler yalnızca çağrı süresi boyunca geçerlidir. Başarıyla eklenen her reklam grubu ölçütü için benzersiz sistem tanımlayıcıları karşıya yükleme sonuç dosyasında döndürülür.

  • Herhangi bir ürün bölümünü duraklatmak için, Reklam Grubunun Durum alanını Duraklatıldı olarak güncelleştirerek reklam grubunun tamamını duraklatmalısınız. Kampanyanın Durum alanını Duraklatıldı olarak güncelleştirerek kampanyanın tamamını duraklatabilirsiniz.

  • Silinmiş eylem için yalnızca Kimlik ve Üst Kimlik belirtmeniz gerekir.

  • Bir üst ürün bölümünü silerseniz, tüm alt öğeleri ve alt öğeleri de silinir.

  • Dalda yinelenen ürün koşulları belirtemeyebilirsiniz.

DownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds hizmet isteğine AssetGroupListingGroups'unDownloadEntity değerini ekleyerek hesaptaki tüm Varlık Grubu Listeleme Grubu 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.

.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 BulkAssetGroupListingGroup nesnesini karşıya yükleyip indirebilirsiniz.

Varlık Grubu Listeleme Grubu kaydı için, Toplu Dosya Şeması'nda aşağıdaki öznitelik alanları kullanılabilir.

Varlık Grubu

Varlık grubu listeleme grubunun ait olduğu varlık grubunun adı.

Ekleme, güncelleştirme ve silme için Üst Kimlik veya Varlık Grubu ve Kampanya alanını belirtmeniz gerekir.

Eklemek: Salt okunur ve Gerekli
Güncelleştirmek: Salt okunur ve Gerekli
Silmek: Salt okunur ve Gerekli

Kampanya

Varlık grubunu ve listeleme grubunu içeren kampanyanın adı.

Ekleme, güncelleştirme ve silme için Üst Kimlik veya Varlık Grubu ve Kampanya alanını belirtmeniz gerekir.

Eklemek: Salt okunur ve Gerekli
Güncelleştirmek: Salt okunur ve Gerekli
Silmek: Salt okunur ve Gerekli

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

Eklemek: Opsiyonel
Güncelleştirmek: Opsiyonel
Silmek: Salt okunur

Kimlik

Varlık grubu listeleme grubunun sistem tarafından oluşturulan tanımlayıcısı.

Eklemek: Opsiyonel. Bu alanı boş bırakmanız veya negatif bir tanımlayıcı belirtmeniz gerekir. Daha sonra reklam, anahtar sözcük veya ölçüt gibi bağımlı kayıt türlerinin Üst Kimlik alanında varlık grubu listeleme grubu için negatif bir tanımlayıcı kümesine başvurulabilir. Aynı Toplu dosyaya grupları ve yeni bağımlı kayıtları listeleyen yeni varlık grubu ekliyorsanız bu önerilir. Daha fazla bilgi için bkz. Toplu Dosya Şeması Başvuru Anahtarları.
Güncelleştirmek: Salt okunur ve Gerekli
Silmek: Salt okunur ve Gerekli

Dışlandı

Sunum sırasında ürünlerin liste grubuna ait olup olmadığını belirler.

True olarak ayarlanırsa bu negatif bir ölçüt, aksi takdirde false ise pozitif bir ölçüt olur.

Eklemek: Gerekli
Güncelleştirmek: Salt okunur
Silmek: Salt okunur

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.

Eklemek: Salt okunur
Güncelleştirmek: Salt okunur
Silmek: Salt okunur

Üst Kimlik

Listeleme grubunu içeren varlık grubunun kimliği.

Ekleme, güncelleştirme ve silme için Üst Kimlik veya Varlık Grubu ve Kampanya alanını belirtmeniz gerekir.

Eklemek: Salt okunur ve Gerekli
Güncelleştirmek: Salt okunur ve Gerekli
Silmek: Salt okunur ve Gerekli

Üst Listeleme Grubu Kimliği

En azından ağaç yapısı için en az kök düğümü belirtmeniz gerekir.

Listeleme grubunun kök düğümünde Ürün Koşulu 1 alanının Tümü ve Ürün Değeri 1 null veya boş olarak ayarlanmış olması gerekir.

Katalogdaki tüm ürünlere eşit şekilde teklif verirseniz, Alt Tür alanını Birim olarak ayarlayın.

Ürünleri daha belirli ürün koşullarına göre bölümlediyseniz, Alt Tür alanını Alt Bölüm, Üst Listeleme Grubu Kimliği'ni null veya boş, Kimliği ise negatif bir değer olarak ayarlayın. Alt düğümler için Üst Listeleme Grubu Kimliği olarak negatif değeri kullanacaksınız.

Eklemek: Gerekli
Güncelleştirmek: Salt okunur ve Gerekli
Silmek: Salt okunur ve Gerekli

Ürün Koşulu 1

Koşulun işleneni. İşlenenler örtük olarak eşittir işlecini içerir. Örneğin Brand as Brand='ı okuyabilirsiniz.

Ürün Değeri 1'in işleneni olarak Ürün Koşulu 1'i kullanın.

Her Microsoft Performance Max varlık grubu için birden çok ürün koşulu belirtilebilir. Ürünün öznitelik değeri işlenenin öznitelik değerine eşitse her koşul karşılanır. Örneğin, işlenen Marka ve öznitelik Contoso olarak ayarlanırsa, ürün kataloğunun Brand özniteliğinin değeri Contoso'ya eşitse koşul karşılanır.

En Yüksek Performans kampanyalarında ürün koşulları yalnızca varlık grubu düzeyinde ayarlanabilir. Aşağıdaki tabloda AssetGroupListingGroup nesneleri varlık grubu için Ürün Koşulu (işlenen) ve Ürün Değeri (öznitelik) iş kuralları açıklanmaktadır.

Ürün Koşulu (İşlenen) Ürün Değeri (Öznitelik) Açıklaması Varlık Grubu Ürün Bölümü Kuralları
Tüm Null olmalıdır. Bir varlık grubunun ürün bölümleri için kök düğümün işleneni Tümü , özniteliği ise null veya boş olarak ayarlanmış olmalıdır.
Dağlamak Ürünün üreticisi, markası veya yayımcısı.

En fazla 1.000 karakter.		 Bir varlık grubunun ürün bölümleri için kök düğümün işleneni Tümü , özniteliği ise null veya boş olarak ayarlanmış olmalıdır.
CategoryL1-5

CategoryL1, CategoryL2, CategoryL3, CategoryL4 ve CategoryL5 gibi beş kategori işlenen değeri kullanılabilir.		 Microsoft Merchant Center mağazası tarafından tanımlanan bir ürün kategorisi. Geçerli kategori değerleri ve taksonomi için lütfen Bing Kategori Taksonomisi bölümüne bakın.

CategoryL0 en üst düzey kategori, CategoryL4 ise en düşük düzey veya en ayrıntılı kategoridir.

En fazla 100 karakter.		 CategoryL işlenenlerinin her biri birden çok dalda kullanılabilir.

CategoryL işlenenlerinin her biri birden çok dalda kullanılabilir, ancak dal başına yalnızca bir kez belirtilebilir. Örneğin, bir dal CategoryL1 ve CategoryL2 içerebilir, ancak CategoryL2 işleneni olan başka bir düğüm içermeyebilir.

İşleneni 1 ile 5 arasında bir ürün kategorisine ayarlarsanız, bunların artan sırada belirtilmesi gerekir. Örneğin, üst düzey bir ürün bölümünde Hayvanlar & Evcil Hayvan Malzemeleri özniteliğine sahip işlenen CategoryL1 varsa işlenen, Pet Malzemeleri özniteliğiyle CategoryL2 olarak ayarlanabilir.

Önceki düzey ürün kategorisi işleneninin hemen üst bölümde belirtilmesi gerekmez. Örneğin, üst öğesinin üst öğesi bir CategoryL1 koşulu belirttiyse, ürün bölümü için bir CategoryL2 koşulu belirtilebilir.
Kanal Yerel Envanter Reklamları (LIA) kanalı.

Olası değerler arasında "Yerel Mağazalar" ve "Çevrimiçi" yer alır.

Kampanya Yerel Envanter Reklamları'nı kabul etmediyse, tüm teklifler varsayılan olarak Yalnızca Çevrimiçi (Channel=Online) ve Tek kanallı (ChannelExclusivity=Single-channel) şeklindedir. Daha fazla bilgi için Yerel Envanter Reklamları yardım sayfasına bakın.		 Kanal işleneni birden çok dalda kullanılabilir, ancak dal başına yalnızca bir kez belirtilebilir.
ChannelExclusivity Yerel Envanter Reklamları (LIA) kanalı münhasırlığı.

Olası değerler arasında "Tek kanallı" ve "Çok kanallı" yer alır.

Kampanya Yerel Envanter Reklamları'nı kabul etmediyse, tüm teklifler varsayılan olarak Yalnızca Çevrimiçi (Channel=Online) ve Tek kanallı (ChannelExclusivity=Single-channel) şeklindedir. Daha fazla bilgi için Yerel Envanter Reklamları yardım sayfasına bakın.		 ChannelExclusivity işleneni birden çok dalda kullanılabilir, ancak dal başına yalnızca bir kez belirtilebilir.
Koşul Ürünün koşulu.

İşlenen Koşul olarak ayarlanırsa, belirtebileceğiniz desteklenen öznitelik değerleri Yeni, Kullanılan ve Onarıldı'dır.		 Koşul işleneni birden çok dalda kullanılabilir, ancak dal başına yalnızca bir kez belirtilebilir.
CustomLabel0-4

CustomLabel0, CustomLabel1, CustomLabel2, CustomLabel3 ve CustomLabel4 gibi beş özel etiket işlenen değeri kullanılabilir.		 Satıcı tarafından tanımlanan özel bir etiket.

CustomLabel0 ve CustomLabel4 gibi özel etiketler herhangi bir hiyerarşiye göre doğrulanmaz.

En fazla 100 karakter.		 CustomLabel işlenenlerinin her biri birden çok dalda kullanılabilir, ancak dal başına yalnızca bir kez belirtilebilir. Örneğin, bir dal CustomLabel0 ve CustomLabel1 içerebilir, ancak CustomLabel1 işleneni olan başka bir düğüm içermeyebilir.
Kimlik Satıcı tarafından tanımlanan ürün tanımlayıcısı.

En fazla 1.000 karakter.		 Kimlik işleneni birden çok dalda kullanılabilir, ancak dal başına yalnızca bir kez belirtilebilir.
ProductType1-5

ProductType1, ProductType2, ProductType3, ProductType4 ve ProductType5 gibi beş ürün türü işlenen değeri mevcuttur.		 Satıcı tarafından tanımlanan bir ürün türü veya kategori.

ProductType1 en üst düzey ürün türüdür ve ProductType5 en düşük düzey veya en ayrıntılı ürün türüdür.

En fazla 100 karakter.		 ProductType işlenenlerinin her biri birden çok dalda kullanılabilir, ancak dal başına yalnızca bir kez belirtilebilir. Örneğin, bir dal ProductType1 ve ProductType2 içerebilir, ancak ProductType2 işleneni olan başka bir düğüm içermeyebilir.

İşleneni 1 ile 5 arasında bir ürün türüne ayarlarsanız, bunların artan sırada belirtilmesi gerekir. Örneğin, üst düzey bir ürün bölümünde Hayvanlar & Evcil Hayvan Malzemeleri özniteliğine sahip işlenen ProductType1 varsa işlenen, Evcil Hayvan Kaynakları özniteliğiyle ProductType2 olarak ayarlanabilir.

Önceki düzey ürün türü işleneninin hemen üst bölümde belirtilmesi gerekmez. Örneğin, üst öğesinin üst öğesi bir ProductType1 koşulu belirttiyse, ürün bölümü için bir ProductType2 koşulu belirtilebilir.

Eklemek: Gerekli
Güncelleştirmek: Salt okunur. Koşul veya değer alanlarını güncelleştiremezsiniz. Koşulları güncelleştirmek için ürün bölümünü silmeniz ve yenisini eklemeniz gerekir.
Silmek: Salt okunur

Ürün Değeri 1

Koşulun öznitelik değeri.

Özniteliğin değeri, müşterinin Microsoft Merchant Center katalog dosyasında belirtilen değerle tam olarak eşleşmelidir.

Eklemek: Gerekli
Güncelleştirmek: Salt okunur. Koşul veya değer alanlarını güncelleştiremezsiniz. Koşulları güncelleştirmek için ürün bölümünü silmeniz ve yenisini eklemeniz gerekir.
Silmek: Salt okunur

Durum

Varlık grubu listeleme grubunun durumu.

Olası değerler Etkin, Silinmiş değerleridir.

Eklemek: Opsiyonel.
Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Gerekli. Durum, Silinmiş olarak ayarlanmalıdır.

Alt Tür

Varlık grubu listeleme grubunun türü.

Olası değerler Alt Bölüm ve Birim'dir.

Eklemek: Gerekli
Güncelleştirmek: Salt okunur
Silmek: Salt okunur