Aracılığıyla paylaş

Müşteri Listesi Kaydı - Toplu

  • Makale

Toplu bir dosyada indirilebilen ve karşıya yüklenebilecek bir müşteri listesi tanımlar.

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

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

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

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

Eylem Türü

Aynı Toplu karşıya yükleme dosyasına eklediğiniz Müşteri Listesi Öğesi kayıtlarının eklenip eklenmeyeceğini, kaldırılacağını veya değiştirileceğini belirler.

Eylem türü "Ekle" ise, hizmet aynı Toplu karşıya yükleme dosyasına eklediğiniz Müşteri Listesi Öğesi kayıtlarını eklemeyi dener.

Eylem türü "Kaldır" olarak ayarlanırsa, hizmet aynı Toplu karşıya yükleme dosyasına eklediğiniz Müşteri Listesi Öğesi kayıtlarını kaldırmayı dener.

Eylem türü "Değiştir" olarak ayarlanırsa, bu listenin önceki tüm müşteri eşleştirme verileri kaldırılır ve hizmet, aynı Toplu karşıya yükleme dosyasına eklediğiniz Müşteri Listesi Öğesi kayıtlarını eklemeyi dener.

Ekle: Isteğe bağlı. Varsayılan olarak yeni müşteri listeleri için "Ekle" eylem türü kullanılır. Değer ayarlasanız da ayarlamasanız da, bu alan yeni müşteri listeleri için yoksayılır.
Güncelleştirme: Aynı Toplu karşıya yükleme dosyasına mevcut bir hedef kitle için Müşteri Listesi Öğesi kayıtlarını da dahil ediyorsanız ve aksi takdirde bu alan isteğe bağlıdır.
Silmek: Salt okunur

Seyirci

Müşteri listesinin adı.

Ad en fazla 128 karakter içerebilir.

Ekle: Gerekli
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

Hedef Kitle Ağ Boyutu

Hedef Kitle ağındaki bu hedef kitlenin etkin üyesi olan toplam kişi sayısı. Bu, hedefleyebileceğiniz hedef kitle ağı kullanıcısı sayısı hakkında size bir fikir verir.

Microsoft Advertising'in iyileştirmeler için kullanabilmesi için hedef kitlenin en az 300 kişi olması gerekir.

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

İzleyici Arama Boyutu

Arama ağındaki bu hedef kitlenin etkin üyesi olan toplam kişi sayısı. Bu size kaç arama kullanıcısının hedefleyebileceğiniz hakkında bir fikir verir.

Microsoft Advertising'in iyileştirmeler için kullanabilmesi için hedef kitlenin en az 300 kişi olması gerekir.

Bu özellik, örneğin müşteri listesi üyelik süresini, kuralını veya etiket tanımlayıcısını ekler veya güncelleştirirseniz hedef kitle oluşturulurken 24 saate kadar boş kalır.

Müşteri listesi web sitenizden listeyi oluşturmak için gereken müşteri bilgilerini alamadığından, müşteri listesiyle ilişkilendirilmiş UET etiketi Doğrulanmamış veya Etkin Değil durumundaysa bu özellik boş olur.

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

Açıklama

Müşteri listesinin açıklaması. Bu müşteri listesiyle hedeflediğiniz hedef kitleyi hatırlamanıza yardımcı olması için bir açıklama kullanın.

Açıklama en fazla 1.024 karakter içerebilir.

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

Müşteri listesinin sistem tarafından oluşturulan tanımlayıcısı.

Ekle: Isteğe bağlı. Bu alanı boş bırakmanız veya negatif bir tanımlayıcı belirtmeniz gerekir. Daha sonra müşteri listesi öğesi gibi bağımlı kayıt türlerinin Üst Kimlik alanında müşteri listesi için negatif tanımlayıcı kümesine başvurulabilir. Aynı Toplu dosyaya yeni bir müşteri listesi ve yeni müşteri listesi öğeleri ekliyorsanız bu gereklidir. Daha fazla bilgi için bkz. Toplu Dosya Şeması Başvuru Anahtarları.
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

Üyelik Süresi

Bir müşteri listesi oluşturduğunuzda, kullanıcıların bu segmentte ne kadar süre kaldığını belirtebilirsiniz.

En düşük süre 1 gündür. Not: Bir kullanıcının 180 gün boyunca hiçbir etkinliği yoksa, tüm segmentlerden kaldırılır.

Üyelik süresi "-1" ise süre sonu yoktur.

Üyelik süresi null ise, varsayılan süre (30 gün) kullanılır.

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.
Silmek: Salt okunur

Üst Kimlik

Müşteri listesini içeren müşterinin Microsoft Advertising tanımlayıcısı.

Ekle: Isteğe bağlı
Güncelleştirme: Salt okunur. Üst kimliği değiştiremezsiniz.
Silmek: Salt okunur

Kapsam

Kapsam, hangi hesapların bu müşteri listesini kullanabileceğini tanımlar. Bir müşteri listesi için desteklenen tek kapsam Müşteri'dir ve müşteri listesi tüm müşteri hesaplarında kampanyalar ve reklam gruplarıyla ilişkilendirilebilir.

Ekle: Gerekli
Güncelleştirme: Salt okunur. Kapsamı değiştiremezsiniz.
Silmek: Salt okunur

Durum

Müşteri listesi durumu.

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

Ekle: Isteğe bağlı. Varsayılan değer Etkin'dir.
Güncelleştirme: Salt okunur
Silmek: Gerekli. Durum , Silinmiş olarak ayarlanmalıdır.

Desteklenen Kampanya Türleri

Bu müşteri listesini destekleyen kampanya türlerinin noktalı virgülle ayrılmış listesi.

Desteklenen değerler: Audience, DynamicSearchAds, Search ve Shopping. Gelecekte yeni kampanya türleri eklenebilir, bu nedenle sabit bir değer kümesine bağımlılık almamalısınız.

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