Ad Group Otel Listeleme Grubu Kaydı - Toplu

Toplu dosyaya yüklenip indirilebilen bir reklam grubu otel listeleme grubunu tanımlar.

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

• En azından grup grubu ağaç yapısını listeleyen otel için en az kök düğümü belirtmeniz gerekir. Grup grubunun kök düğümünü listeleyen otel grubunun Otel Özniteliği alanı "Tümü" olarak ayarlanmış ve Otel Öznitelik Değeri null veya boş olmalıdır. Katalogdaki tüm otellere eşit şekilde teklif verirseniz , Alt Tür alanını Birim olarak ayarlayın. Teklifleri daha belirli otel özniteliklerine 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 grup ağacı düğümlerini listeleyen en fazla 20.000 otel ekleyebilirsiniz. Bir reklam grubu için grup ağacı düğüm sayısının tamamı 20.000'i aşamaz.

• Aynı ağaç (aynı reklam grubu) için grup ağacı düğümlerini listeleyen otelin dosyada birlikte gruplanması gerekir.

• İndirme sırasında otel listeleme grubu düğümlerinin sırası garanti değildir 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, grup ağacı düğümlerini listeleyen üst otel, grup ağacı düğümlerini listeleyen alt otel öncesinde 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, Üst Kimlik ve Teklif alanlarını karşıya yüklemeniz gerekir.

• Otel Özniteliği, Otel Öznitelik Değeri veya Dışlandı alanını güncelleştirmek için mevcut otel listeleme grup ağacı düğümünü silmeniz ve yeni bir tanımlayıcı alacak yeni bir otel listeleme grup 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 otel listeleme grubu düğümü ekleme ve silme eylemlerinin tam bir ağaç yapısına neden olması gerekir.

• 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ı doğru değilse ve bu da 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 Otel Öznitelik Değeri 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.

• Teklif alanı yalnızca Hariç Tutuldu alanının yanlış olması durumunda geçerlidir; bu da düğümün teklif edilebilir bir reklam grubu ölçütü olduğu anlamına gelir. Ancak Alt Bölüm bölüm düğümleri için Teklif yoksayılır. Bu öğeler yalnızca Birim (yaprak) bölüm düğümleri için geçerlidir.

• Herhangi bir otel listeleme grubunu 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 otel listeleme grubunu silerseniz, tüm alt öğeleri ve alt öğeleri de silinir.

• Bir dalda yinelenen otel öznitelikleri belirtemeyebilirsiniz.

AdGroupHotelListingGroups'unDownloadEntity değerini DownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds hizmet isteğine ekleyerek hesaptaki tüm Ad Group Otel 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.

Aşağıdaki Toplu CSV örneği, geçerli bir Ebeveyn Kimliği değeri sağlanırsa yeni bir reklam grubu otel listeleme grubu ekler.

Type,Name,Campaign,Time Zone,Campaign Type,Language,Sub Type,Budget Id,Budget,Budget Type,Bid Strategy Type,Bid Strategy PercentMaxCpc,Ad Schedule Use Searcher Time Zone,Client Id,Id,Parent ID,Parent Criterion Id,Ad Group,Ad Group Type,Search Network,Content Network,Percent Cpc Bid,Hotel Ad Group Type,Percent Bid,Hotel Attribute,Hotel Attribute Value,Is Excluded
Format Version,6,,,,,,,,,,,,,,,,,,,,,,,,,
Campaign,,Test Hotel Campaign HLG,PacificTimeUSCanadaTijuana,Hotel,All,,delete_value,25,DailyBudgetStandard,PercentCpc,8.3,false,0,,,,,,,,,,,,,,
AdGroup,,Test Hotel Campaign HLG,,,,,,,,,,,,,,,Test Hotel AdGroup,Hotel,On,Off,3.74,HotelAd,,,,,
Ad Group Hotel Listing Group,,Test Hotel Campaign HLG,,,,Subdivision,,,,,,,,-1,,,Test Hotel AdGroup,,,,,HotelAd,,All,,false
Ad Group Hotel Listing Group,,Test Hotel Campaign HLG,,,,Unit,,,,,,,,-2,,-1,Test Hotel AdGroup,,,,,HotelAd,4.1,Brand,Marriott,false
Ad Group Hotel Listing Group,,Test Hotel Campaign HLG,,,,Unit,,,,,,,,-3,,-1,Test Hotel AdGroup,,,,,HotelAd,4.1,Brand,Hilton,false
Ad Group Hotel Listing Group,,Test Hotel Campaign HLG,,,,Unit,,,,,,,,-4,,-1,Test Hotel AdGroup,,,,,HotelAd,4.1,Brand,,false

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAdGroupProductPartition
var bulkAdGroupProductPartition = new BulkAdGroupProductPartition
{
    // Map properties in the Bulk file to the BiddableAdGroupCriterion or
    // NegativeAdGroupCriterion object of the Campaign Management service.
    // Use the BiddableAdGroupCriterion to set the 'Is Excluded' field in the Bulk file to true,
    // and otherwise use the NegativeAdGroupCriterion to set the 'Is Excluded' field to false.
    BiddableAdGroupCriterion = new BiddableAdGroupCriterion
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,
        Criterion = new HotelListingGroup { 
            Condition = new HotelListingCondition
            {
                // 'Hotel Attribute Value' column header in the Bulk file
                Attribute = null,
                // 'Hotel Attribute' column header in the Bulk file
                Operand = "All",
            },
            // 'Parent Criterion Id' column header in the Bulk file
            ParentCriterionId = null
        },
        CriterionBid = new FixedBid
        {
            // 'Bid' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
            Amount = 0.50
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdGroupCriterionStatus.Paused,
        // 'Tracking Template' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
        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"
                },
            }
        },
    },
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
};

uploadEntities.Add(bulkAdGroupProductPartition);

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

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

Bir Ad Grubu Otel Listeleme Grubu kaydı için, Toplu Dosya Şeması'nda aşağıdaki öznitelik alanları bulunur.

• Reklam Grubu
• Teklif
• Teklif Yüzdesi
• Kampanya
• İstemci Kimliği
• Özel Parametre
• Son Url Soneki
• Kimlik
• Dışlandı
• Değiştirme Zamanı
• Üst Ölçüt Kimliği
• Üst Kimlik
• Otel Özniteliği
• Otel Öznitelik Değeri
• Durum
• Alt Tür
• İzleme Şablonu

Reklam Grubu

Otel listeleme grubunu içeren reklam grubunun adı.

Ekle: Salt okunur ve Gerekli
Güncelleştirme: Salt okunur ve Gerekli
Silmek: Salt okunur ve Gerekli

Teklif

Açık artırmada teklif edilen tutar. Bu, kampanya teklifi şeması ManualCpc olduğunda kullanılır.

Ekle:Dışlandıyanlış ise ve Alt TürBirim ise ve aksi takdirde teklife izin verilmiyorsa gereklidir.
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

Teklif Yüzdesi

Açık artırmada teklif edilen tutar. Bu, kampanya teklifi şeması PercentCpc veya Komisyon olduğunda kullanılır.

Ekle:Dışlandıyanlış ise ve Alt TürBirim ise ve aksi takdirde teklife izin verilmiyorsa gereklidir.
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

Kampanya

Reklam grubunu ve otel listeleme grubunu 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

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

Otel listeleme grubunun sistem tarafından oluşturulan tanımlayıcısı.

Ekle: Salt okunur
Güncelleştirme: Salt okunur ve Gerekli
Silmek: Salt okunur ve Gerekli

Dışlandı

Otel listeleme grubunun teklif edilebilir veya negatif bir ölçütü temsil edip etmediğini belirler.

True olarak ayarlanırsa bu negatif bir ölçüt, aksi takdirde yanlış ise teklif edilebilir bir ölçüt olur.

Ekle: Gerekli
Güncelleştirme: 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.

Ekle: Salt okunur
Güncelleştirme: Salt okunur
Silmek: Salt okunur

Üst Ölçüt Kimliği

Üst otel listeleme grubunun ölçüt tanımlayıcısı.

Bu toplu alan ParentNodeId ile eşler ve kök düğümü işaret etmek için null olmalıdır.

Ekle: Salt okunur ve Gerekli
Güncelleştirme: Salt okunur
Silmek: Salt okunur

Üst Kimlik

Otel listeleme grubunu 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 otel listeleme grupları 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

Otel Özniteliği

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

Otel Özniteliği değerinin işleneni olarak Hotel Özniteliğini kullanın.

Her kampanya ve reklam grubu için birden fazla otel özniteliği belirtilebilir. Otelin ö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, otel kataloğunun Brand özniteliğinin değeri Contoso'ya eşitse koşul karşılanır.

Kampanyalarınızda otel öznitelikleri kampanya ve reklam grubu düzeyinde ayarlanabilir. Aşağıdaki tabloda Ad Group Hotel Listing Group kayıtları için Hotel Attribute (işlenen) ve Hotel Attribute Value (öznitelik) iş kuralları açıklanmaktadır.

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

Otel Öznitelik Değeri

Koşulun öznitelik değeri.

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

Durum

Otel listeleme grubunun durumu.

Olası değerler Etkin veya Silinmiş değerlerdir.

Ekle: Isteğe bağlı. Mümkün olan tek durum Etkin'dir. Durumu Silinmiş olarak ayarlarsanız, bu durum yoksayılır ve döndürülen kaydın durumu Etkin olarak ayarlanır.
Güncelleştirme: Isteğe bağlı
Silmek: Gerekli. Durum , Silinmiş olarak ayarlanmalıdır.

Alt Tür

Otel listeleme grubunun türü.

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

Ekle: Gerekli
Güncelleştirme: Salt okunur
Silmek: Salt okunur

İzleme Şablonu

İzleme şablonları , İçerik API'si aracılığıyla gönderdiğiniz otel teklifi için 'Bağlantı' alanında belirtilen URL ile birlikte kullanılabilir. Akış URL'sini izleme şablonuyla birleştirerek, kullanıcının reklama tıkladıktan sonra yönlendirildiği giriş sayfası URL'si bir araya getirilir. akış URL'sinde güncelleştirmek yerine URL parametrelerini güncelleştirmek için İzleme Şablonu alanını kullandığınızda, akış URL'sinin editoryal incelemeden geçmesi gerekmez ve reklamlarınız kesintisiz olarak yayınlanmaya devam eder. Örneğin, katalog akışında otel teklifi URL'niz ise https://contoso.com/şu izleme şablonunu belirtebilirsiniz: {lpurl}?matchtype={matchtype}&device={device}.

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