Müşteri Listesi Öğesi Kaydı - Toplu

Makale
12/21/2023

Toplu dosyaya yüklenebilecek bir müşteri listesi öğesi tanımlar.

Not

Müşteri listesi öğelerinin toplu olarak indirilmesi desteklenmez.

Önemli

Müşteri listesi verilerini Toplu API aracılığıyla karşıya yükleyebilmeniz için önce bir müşteri listesi hedef kitlesi oluşturmanız ve Microsoft Advertising kullanıcı arabirimindeki hüküm ve koşulları kabul etmeniz gerekir. İlk müşteri listesinin herhangi bir müşteri verisi içermesi gerekmez, ancak Kabul Ediyorum'ı seçmeniz gerekir. "Kabul ediyorum" seçeneğini belirleyerek (1) kişisel veriler olan hedef kitle ayrıntılarını Microsoft'a yasal olarak açıklayabildiğinizi ve (2) Müşteri Eşleştirme Koşullarını, Microsoft Reklam Sözleşmesi'ni ve Microsoft Reklam ilkelerini kabul ettiğinizi kabul edersiniz. Microsoft, yüklediğiniz verileri Müşteri Eşleştirme Koşullarına uygun olarak kullanır.

Müşteri listesi, müşteri eşleşmesini etkinleştirmek için derlediğiniz müşteri iletişim bilgileri kümesidir. Her liste birden çok Email öğesi içerebilir.

Müşteri Listesi kaydını Toplu karşıya yükleme dosyasına ekleyin ve Eylem Türü alanını "Ekle", "Kaldır" veya "Değiştir" olarak ayarlayın.
Aynı Toplu karşıya yükleme dosyasına bir veya daha fazla Müşteri Listesi Öğesi kaydı ekleyin ve Üst Kimlik, Alt Tür ve Metin alanlarını ayarlayın.

Aynı Toplu karşıya yükleme dosyasında müşteri listesi öğesi kaydı olmadan müşteri listesi kaydı ekleyebilir veya güncelleştirebilirsiniz; ancak, eşlik eden üst Müşteri Listesi kaydı olmadan hiçbir Müşteri Listesi Öğesi kaydını karşıya yükleyemezsiniz.

48 saat sonra, Bing Ağı'nda bu müşterilerden kaçını eşleştirdiğimize bakmak için hedef kitle arama boyutu gibi hedef kitle boyutu alanlarını kontrol edin. Bu noktada reklamlarınız bu yeni hedef kitle için gösterilmeye başlayabilir.

İpucu

İzleyiciler hakkında genel bir bakış ve daha fazla bilgi için hedef kitle API'leri teknik kılavuzuna bakın.

DownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds hizmet isteğine CustomerLists'inDownloadEntity değerini ekleyerek hesaptaki tüm Müşteri Listesi Öğesi 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 yeni bir müşteri listesi öğesi ekler.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Action Type,Sub Type,Text
Format Version,,,,,,6.0,,,,,,
Customer List,Active,-10,,ClientIdGoesHere,,,New customer list description,Customer,New Customer List,Add,,
Customer List Item,,,-10,ClientIdGoesHere,,,,,,,Email,HashedValue

Müşteri Listesi Öğesi kaydı için, Toplu Dosya Şeması'nda aşağıdaki öznitelik alanları kullanılabilir.

Seyirci
İstemci Kimliği
Üst Kimlik
Alt Tür
Metin

Seyirci

Üst müşteri listesi hedef kitlesinin adı.

Ad en fazla 128 karakter içerebilir.

Ekle: Gerekli. Üst Kimlik veya hedef kitle alanını belirtmeniz gerekir.
Silmek: Gerekli. Üst Kimlik veya hedef kitle 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ı
Silmek: Isteğe bağlı

Üst Kimlik

Üst müşteri listesi hedef kitlesinin tanımlayıcısı.

Üst Kimlik veya hedef kitle alanını belirtmeniz gerekir.

Ekle: Salt okunur ve Gerekli. Mevcut bir müşteri listesi tanımlayıcısı belirtmeniz veya üst Müşteri Listesi kaydının Kimlik alanına eşit negatif bir tanımlayıcı belirtmeniz gerekir. Aynı Toplu dosyadaki yeni bir müşteri listesine yeni müşteri listesi öğeleri ekliyorsanız bu gereklidir. Daha fazla bilgi için bkz. Toplu Dosya Şeması Başvuru Anahtarları.
Silmek: Gerekli.

Alt Tür

Metin alanının karma bir Email değeri temsil edip etmediğini belirler.

Şu anda desteklenen tek değer "Email"dir.

Ekle: Gerekli
Silmek: Gerekli

Metin

Karma metin olarak Email.

Alt Tür "Email" ise, bu alan düz metin içeremez. Dize sha-256 algoritması kullanılarak karma olmalıdır. Karma Email uzunluğu 64 olan onaltılık bir dize olmalıdır. Örneğin, "test@contoso.com" yerine "f25ad364d33972379a7a4f4df33db142205f5c40eb19cfdb2fc5aaf117e10101" gibi karma bir dize yüklemeniz gerekir.