Kampanya Ürün Kapsamı Kaydı - Toplu

Makale
12/21/2023

Kataloğunuzdan hangi öğelerin kampanyaya ekleneceğini belirlemeye yardımcı olan koşulların listesiyle (örneğin, markaya veya koşula göre filtreleme) bir kampanya düzeyi ürün kapsamı tanımlar.

Kampanya ürün kapsamlarını hem Alışveriş kampanyalarıyla hem de akış tabanlı Hedef Kitle kampanyalarıyla kullanabilirsiniz; örneğin, Microsoft Merchant Center mağaza kimliğinden yararlanan kampanyalar. Ürün kapsamı, kataloğunuzdan hangi öğelerin kampanyaya dahil edilmesini istediğinizi (örneğin, markaya veya koşula göre filtreleme) seçmenize olanak tanır.

İpucu

Microsoft alışveriş kampanyaları hakkında genel bakış ve daha fazla bilgi için Ürün Reklamları teknik kılavuzuna bakın.

Not

Akıllı Alışveriş Kampanyaları ile kampanya düzeyi ürün kapsamı koşulları desteklenmez; örneğin, Kampanya Türü Alışveriş ve Alt TürüShoppingSmartAds olarak ayarlanmış kampanyalar.

DownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds hizmet isteğine CampaignProductScopes'unDownloadEntity değerini ekleyerek hesaptaki tüm Kampanya Ürün Kapsamı 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 Üst Kimlik değeri sağlanırsa yeni bir kampanya ürün kapsamı ekler.

Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Client Id,Modified Time,Bid,Name,Product Condition 1,Product Value 1,Product Condition 2,Product Value 2,Product Condition 3,Product Value 3,Product Condition 4,Product Value 4,Product Condition 5,Product Value 5,Product Condition 6,Product Value 6,Product Condition 7,Product Value 7,Is Excluded,Parent Criterion Id,Tracking Template,Custom Parameter
Format Version,,,,,,,,,,6.0,,,,,,,,,,,,,,,,,,
Campaign Product Scope,Active,,-113,,,,ClientIdGoesHere,,,,Condition,New,CustomLabel0,MerchantDefinedCustomLabel,,,,,,,,,,,,,,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignProductScope
var bulkCampaignProductScope = new BulkCampaignProductScope
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
                
    // Map properties in the Bulk file to the 
    // SharedEntityAssociation object of the Campaign Management service.
    CampaignCriterion = new CampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,
        Criterion = new ProductScope
        {
            // Conditions are mapped to Product Value 1..7 and Product Condition 1..7 columns
            Conditions = new []
            {
                new ProductCondition
                {
                    // 'Product Value 1' column header in the Bulk file
                    Attribute = "New",
                    // 'Product Condition 1' column header in the Bulk file
                    Operand = "Condition",
                    // 'Product Operator 1' column header in the Bulk file
                    Operator = "Operator",
                },
                new ProductCondition
                {
                    // 'Product Value 2' column header in the Bulk file
                    Attribute = "MerchantDefinedCustomLabel",
                    // 'Product Condition 2' column header in the Bulk file
                    Operand = "CustomLabel0",
                    // 'Product Operator 2' column header in the Bulk file
                    Operator = "Operator",
                },
            },
        },
        // 'Id' column header in the Bulk file
        Id = null,
    },

    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkCampaignProductScope);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

Kampanya Ürün Kapsamı kaydı için Toplu Dosya Şeması'nda aşağıdaki öznitelik alanları bulunur.

Kampanya
İstemci Kimliği
Kimlik
Değiştirme Zamanı
Üst Kimlik
Ürün Koşulu 1
Ürün Koşulu 2
Ürün Koşulu 3
Ürün Koşulu 4
Ürün Koşulu 5
Ürün Koşulu 6
Ürün Koşulu 7
Ürün Operatörü 1
Ürün Operatörü 2
Ürün Operatörü 3
Ürün Operatörü 4
Ürün Operatörü 5
Ürün Operatörü 6
Ürün Operatörü 7
Ürün Değeri 1
Ürün Değeri 2
Ürün Değeri 3
Ürün Değeri 4
Ürün Değeri 5
Ürün Değeri 6
Ürün Değeri 7
Durum

Kampanya

Ürün kapsamını içeren kampanyanın 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 Kampanya alanını belirtmeniz gerekir.

İ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

Kimlik

Ürün kapsamının sistem tarafından oluşturulan tanımlayıcısı.

Ekle: Salt okunur
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

Ürün kapsamını içeren kampanyanın sistem tarafından oluşturulan tanımlayıcısı.

Bu toplu alan, Kampanya kaydının Kimlik alanına eşler.

Ekle: Salt okunur ve Gerekli. Mevcut bir kampanya tanımlayıcısı belirtmeniz veya üst Kampanya kaydının Kimlik alanına eşit bir negatif tanımlayıcı belirtmeniz gerekir. Aynı Toplu dosyada yeni bir kampanyaya yeni ürün kapsamları 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 Kampanya alanını belirtmeniz gerekir.

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

Her ürün koşulunu ilgili ürün değeri için işlenen olarak kullanın.

Ürün Koşulu (İşlenen)	Ürün Değeri (Öznitelik)	Ürün İşleci (İşleç)
Ürün Koşulu 1	Ürün Değeri 1	Ürün Operatörü 1
Ürün Koşulu 2	Ürün Değeri 2	Ürün Operatörü 2
Ürün Koşulu 3	Ürün Değeri 3	Ürün Operatörü 3
Ürün Koşulu 4	Ürün Değeri 4	Ürün Operatörü 4
Ürün Koşulu 5	Ürün Değeri 5	Ürün Operatörü 5
Ürün Koşulu 6	Ürün Değeri 6	Ürün Operatörü 6
Ürün Koşulu 7	Ürün Değeri 7	Ürün Operatörü 7

Ürünün öznitelik değeri işlenenin öznitelik değerine eşitse her koşul karşılanır. Örneğin, işlenen Brand ve özniteliği Contoso olarak ayarlandıysa, ürün kataloğunun Brand özniteliğinin değeri Contoso'ya eşitse koşul karşılanır.

Not

Ekleme ve güncelleştirme için en az bir ürün koşulu ve değer çifti gereklidir ve dizin numarasının ilgisi yoktur. Örneğin , Ürün Koşulu 2 ve Ürün Değeri 2 için geçerli değerler belirtebilir ve kalan koşul ve değer alanlarını boş bırakabilirsiniz.

Ekle: Isteğe bağlı
Güncelleştirme: Salt okunur. Koşul veya değer alanlarını güncelleştiremezsiniz. Koşulları güncelleştirmek için ürün kapsamını silmeniz ve yenisini eklemeniz gerekir.
Silmek: Salt okunur

Kampanya türü başına desteklenen Ürün Koşulu (işlenen) ve Ürün Değeri (öznitelik) için aşağıdaki tablolara bakın.

Feed-Based Hedef Kitle Kampanyaları için Ürün Koşulları

Her akış tabanlı Hedef Kitle kampanyası 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 Brand ve özniteliği Contoso olarak ayarlandıysa, ürün kataloğunun Brand özniteliğinin değeri Contoso'ya eşitse koşul karşılanır.

Ürün Koşulu (İşlenen)	Ürün Değeri (Öznitelik) Açıklaması	İş Kuralları
Marka	Ürünün üreticisi, markası veya yayımcısı. En fazla 1.000 karakter.	Marka işleneni, kampanya ürün kapsamı filtresi başına yalnızca bir kez belirtilebilir.
Durum	Ü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, kampanya ürün kapsamı filtresi 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.	Ürün türü işlenenlerinin her biri kampanya ürün kapsamı filtresi başına bir kez kullanılabilir. İşleneni 1 ile 5 arasında bir ürün türüne ayarlarsanız, bunların artan sırada belirtilmesi gerekir. Örneğin, daha üst düzey bir ürün bölümünde "Hayvanlar & Evcil Hayvan Malzemeleri" özniteliğine sahip "ProductType1" işleneni varsa, işlenen "Evcil Hayvan Kaynakları" özniteliğiyle "ProductType2" olarak ayarlanabilir.
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 kampanya ürün kapsamı filtresi başına bir kez kullanılabilir.

Alışveriş Kampanyaları için Ürün Koşulları

Her Microsoft Alışveriş kampanyası ve reklam 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.

Alışveriş kampanyalarında ürün koşulları kampanya ve reklam grubu düzeyinde ayarlanabilir. Aşağıdaki tabloda Kampanya Ürün Kapsamı ve Reklam Grubu Ürün Bölümü kayıtları 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ı	Kampanya Ürün Kapsamı Kuralları	Ad Grubu Ürün Bölümü Kuralları
Tüm	Null olmalıdır.	Geçerli değildir.	Bir reklam grubunun ürün bölümleri için kök düğümün işleneninin "Tümü" ve özniteliğinin null veya boş olarak ayarlanmış olması gerekir.
Marka	Ürünün üreticisi, markası veya yayımcısı. En fazla 1.000 karakter.	Marka işleneni, kampanya ürün kapsamı filtresi başına yalnızca bir kez belirtilebilir.	Marka işleneni birden çok dalda kullanılabilir, ancak dal başına yalnızca bir kez belirtilebilir.
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 kampanya ürün kapsamı filtresi başına bir kez kullanılabilir. İşlenenin 1 ile 5 arasında bir ürün kategorisine ayarlandığı bir ürün koşulu belirtirseniz, artan düzende belirtilmelidir. Örneğin, önceki bir ürün koşulunda "Hayvanlar & Evcil Hayvan Malzemeleri" özniteliğine sahip işlenen "CategoryL1" varsa, işleneni "Pet Sarf Malzemeleri" özniteliğiyle "CategoryL2" olarak ayarlayabilirsiniz.	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, daha üst düzey bir ürün bölümünde "Hayvanlar & Evcil Hayvan Malzemeleri" özniteliğine sahip "CategoryL1" işleneni varsa, işlenen "Pet Sarf 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, bir ü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, kampanya ürün kapsamı filtresi başına yalnızca bir kez belirtilebilir.	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, kampanya ürün kapsamı filtresi başına yalnızca bir kez belirtilebilir.	ChannelExclusivity işleneni birden çok dalda kullanılabilir, ancak dal başına yalnızca bir kez belirtilebilir.
Durum	Ü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, kampanya ürün kapsamı filtresi başına yalnızca bir kez belirtilebilir.	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. Bu işlenen Sponsorlu Ürünler için geçerli değildir.	CustomLabel işlenenlerinin her biri kampanya ürün kapsamı filtresi başına bir kez kullanılabilir.	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.
GTIN	Satıcı tarafından tanımlanan Global Ticaret Madde Numarası. GTIN alanı 50 karakterlik bir sınıra sahiptir ve her GTIN değerinin en fazla 14 basamağı vardır. Bu işlenen yalnızca Sponsorlu Ürünler ile geçerlidir.	GTIN işleneni, kampanya ürün kapsamı filtresi başına yalnızca bir kez belirtilebilir.	GTIN işleneni birden çok dalda kullanılabilir, ancak dal başına yalnızca bir kez belirtilebilir.
Kimlik	Satıcı tarafından tanımlanan ürün tanımlayıcısı. En fazla 1.000 karakter.	Kimlik işleneni, kampanya ürün kapsamı filtresi başına yalnızca bir kez belirtilebilir.	Kimlik işleneni birden çok dalda kullanılabilir, ancak dal başına yalnızca bir kez belirtilebilir.
MPN	Satıcı tarafından tanımlanan Global Ticaret Madde Numarası. En fazla 70 karakter. Bu işlenen yalnızca Sponsorlu Ürünler ile geçerlidir.	MPN işleneni, kampanya ürün kapsamı filtresi başına yalnızca bir kez belirtilebilir.	MPN 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. Bu işlenen Sponsorlu Ürünler için geçerli değildir.	Ürün türü işlenenlerinin her biri kampanya ürün kapsamı filtresi başına bir kez kullanılabilir. İşlenenin 1 ile 5 arasında bir ürün türüne ayarlandığı bir ürün koşulu belirtirseniz, artan düzende belirtilmelidir. Örneğin, önceki bir ürün koşulunda "Hayvanlar & Evcil Hayvan Malzemeleri" özniteliğine sahip "ProductType1" işleneni varsa, işleneni "Evcil Hayvan Kaynakları" özniteliğiyle "ProductType2" olarak ayarlayabilirsiniz.	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, daha üst düzey bir ürün bölümünde "Hayvanlar & Evcil Hayvan Malzemeleri" özniteliğine sahip "ProductType1" işleneni 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, bir ürün bölümü için bir ProductType2 koşulu belirtilebilir.

Ürün Koşulu 2

Ürün Koşulu 1 ile aynı değerleri ve kuralları destekler.

Ürün Koşulu 3

Ürün Koşulu 1 ile aynı değerleri ve kuralları destekler.

Ürün Koşulu 4

Ürün Koşulu 1 ile aynı değerleri ve kuralları destekler.

Ürün Koşulu 5

Ürün Koşulu 1 ile aynı değerleri ve kuralları destekler.

Ürün Koşulu 6

Ürün Koşulu 1 ile aynı değerleri ve kuralları destekler.

Ürün Koşulu 7

Ürün Koşulu 1 ile aynı değerleri ve kuralları destekler.

Ürün Operatörü 1

Koşulun işleç değeri. İşleç değeri eşit veya nota uygun.

Ekle: Isteğe bağlı
Güncelleştirme: Salt okunur. Koşul veya değer alanlarını güncelleştiremezsiniz. Koşulları güncelleştirmek için kampanya ürün kapsamını silmeniz ve yenisini eklemeniz gerekir.
Silmek: Salt okunur

Ürün Operatörü 2

Product Operator 1 ile aynı değerleri ve kuralları destekler.

Ürün Operatörü 3

Product Operator 1 ile aynı değerleri ve kuralları destekler.

Ürün Operatörü 4

Product Operator 1 ile aynı değerleri ve kuralları destekler.

Ürün Operatörü 5

Product Operator 1 ile aynı değerleri ve kuralları destekler.

Ürün Operatörü 6

Product Operator 1 ile aynı değerleri ve kuralları destekler.

Ürün Operatörü 7

Product Operator 1 ile aynı değerleri ve kuralları destekler.

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

İş kuralları için bkz . Ürün Koşulu 1.

Ekle: Gerekli
Güncelleştirme: Salt okunur. Koşul veya değer alanlarını güncelleştiremezsiniz. Koşulları güncelleştirmek için kampanya ürün kapsamını silmeniz ve yenisini eklemeniz gerekir.
Silmek: Salt okunur