Tanımlayıcıları kitle segmentlerine toplu yükleme

Yalnızca Google Ad Manager 360'ta kullanılabilir.

 

Google Cloud ile tanımlayıcıları toplu yükleme hakkında bilgi edinin. #audiencesegments

This article has been updated in alignment with upcoming changes to Audience Solutions.

To adhere to the EU user consent policy and continue creating audience segments globally, publishers using batch upload must make updates to pass the required consent signals to Ad Manager by March 2024.

Kitle Çözümleri'ni etkinleştirmek için Yayıncı Desteği veya Satış ile iletişime geçmeniz gerekir. Bu ekiplerin verilen listeleri etkinleştirmeleri gerekir. Böylece, yayıncıların kitle segmentlerini görmesi gecikecektir.

Tanımlayıcılar dosyası oluşturabilir ve bunu Google Cloud aracılığıyla Google Ad Manager'a yükleyebilirsiniz. Yüklenebilecek tanımlayıcılar veya kimlikler arasında çerezler, mobil reklamcılık kimlikleri (AdID veya IDFA) ya da PPID'ler bulunur. Kimlikleri Google Cloud ile yüklemeniz, çok sayıda kimliği aynı anda eklemeniz gerektiğinde size zaman kazandırır.

Çerezlerin, PPID'lerin ve cihaz reklam kimliklerinin bir segmente eklenebilmesi için önce bir Ad Manager reklam isteğinin parçası olması gerekir. Veri Aktarımı raporlarındaki (yalnızca Google Ad Manager 360) şifrelenmiş tanımlayıcıların listelerini indirebilir veya diğer sistemlerden ham tanımlayıcıları (ör. mobil uygulamanızın günlüklerinden ham cihaz reklam kimliklerini) alabilirsiniz.

Toplu yükleme için PPID'lerin maksimum ömrü, son kullanıcı etkinliğinden veya yayında görüldükleri son tarihten itibaren 180 gündür. Cihaz kimlikleri için maksimum değer, kimliklerin oluşturulmasından itibaren 540 gündür. Diğer bir deyişle, cihazın yayında görüldüğü ilk tarihten 540 gün sonrasıdır.

Hem etkinlik pingi tabanlı doldurma yöntemi (ör. kaydolma etkinliği, önceden doldurma) hem de çerez yükleme tabanlı doldurma yöntemi (yani sağlanan CSV listeleri) kullanmak, kaldırılmış PPID'lerin tamamen hariç tutulmuş olarak görünmeyebileceği durumlarda çakışmalara neden olabilir.

Bu makalede aşağıda belirtilen konular ele alınmaktadır:

• Ön şartlar
• Yükleme dosyası oluşturma
• Tanımlayıcıları toplu olarak silme
• Dosyayı yükleme
• Toplu yüklenmiş tanımlayıcının süre sonu
• Toplu yüklemeler için en iyi uygulamalar

Ön şartlar

Tanımlayıcıları yükleyebilmeniz için önce hesap yöneticinizle birlikte çalışarak şunları yapmanız gerekir:

• Ağ kodunuzu bulup gönderin. Ad Manager'da ağ kodunuzu Yönetici, Genel ayarlar ve Ağ kodu altında bulun.
• Tanımlayıcıları ilişkilendirmek istediğiniz etkin birinci taraf kitle segmentini oluşturduğunuzdan emin olun. Bu segmentin kendi envanterinizi kullanarak kullanıcı toplamasını istemiyorsanız Doldurma yöntemi olarak "Yayıncı Tarafından Yönetilen"i seçin.
  
  Segment oluşturulduktan sonra toplu yükleme yapmaya başlamanız 24 saati bulabilir.
• Dosya yükleme ve görüntüleme erişimi olacak tüm Google Hesaplarını içeren bir Google Grubu oluşturun.

Hesap yöneticiniz kurulumunuzu tamamladığında yüklemek istediğiniz tanımlayıcıları içeren dosyayı oluşturmaya hazır olacaksınız.

Tanımlayıcıları yükleme konusunda yeni olan yayıncılar işlem sırasında hatalarla karşılaşabilir. Bunun nedeni genellikle yükleme işleminden önce reklam isteklerinde iletilmemiş tanımlayıcılar yüklemeleridir. Bu durumda, .fail dosyalarında şu mesajı görürler: 
"Sunucumuzda <identifier type> bulunamadı, yeniden deneme işe yaramaz."

Yükleme dosyası oluşturma

Gerekli izin etiketi

Tüm yayıncılar gerekli izin sinyallerini Ad Manager'a iletmek için güncellemeler yapmalıdır.

İznin toplandığını onaylamak için yüklenen tüm dosyaların başlığına process_consent etiketini ekleyin. CSV standartlarına uymak amacıyla satırlarda bu başlık sütunu için değerler bulunmalıdır ancak bu değerler işlemleri etkilemez; boş bir dize öneririz. Bu ifadenin yer almadığı tüm dosyaların kullanıcılardan gerekli izni almadığı varsayılır ve bu dosyalar Google tarafından işlenmez.

Bu güncelleme şu koşullarda gereklidir:

• Konumlarından bağımsız olarak tüm kullanıcılar için teknik bir koşuldur.
• AB/AEA kullanıcılarının AB kullanıcı rızası politikasına uymaları ve Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılara yönelik kitle segmentleri oluşturmaya devam etmeleri için gereklidir.

Tanımlayıcılar hakkında

Toplu yükleme işlemi birkaç farklı tanımlayıcı türünü destekler ve tanımlayıcıların türlerinin doğru yükleme dosya biçimi kullanılarak segmente yüklenmesi önemlidir. Bu tanımlayıcılar iki kategoriye ayrılır:

• Şifrelenmiş tanımlayıcılar: Google sistemlerinden elde edilen her şey
• Ham tanımlayıcılar: harici bir sistemden veya kaynaktan alınanlar

Şifrelenmiş tanımlayıcılar cookie_encrypted dosya biçimi kullanılarak, ham tanımlayıcılar ise türe özel bir yükleme dosyası biçiminde yüklenir.

Şifrelenmiş tanımlayıcılar ve PPID'ler ağa özeldir. Bu nedenle, bir ağdan elde edilip toplu olarak yüklenen PPID'ler veya şifrelenmiş tanımlayıcılar başka bir ağa yüklenemez. Yani A ağının Veri Aktarımı raporundan elde edilen bir kullanıcı tanımlayıcısı, B ağına toplu olarak yüklenemez. Öte yandan, cihaz tanımlayıcıları ağa özel değildir.

Aşağıdaki tabloda kullanılabilir tanımlayıcılar ve bunların nasıl yükleneceği özet olarak belirtilmiştir:

Tanımlayıcı	Açıklama	Kaynak	Yükleme biçimi
Çerez	Çerez tanımlayıcıları	Veri aktarımı UserId	cookie_encrypted
		Ham (harici kaynak)	Yok (çerezin yüklenebilmesi için şifrelenmiş olması gerekir)
PPID	Yayıncı tarafından sağlanan tanımlayıcılar	Veri aktarımı PublisherProvidedID	cookie_encrypted
		Ham (harici kaynak)	ppid
IDFA	Reklamcılık için tanımlayıcı	Veri aktarımı UserId	cookie_encrypted
		Ham (harici kaynak)	cookie_idfa
AdID	Android TV tanımlayıcıları	Veri aktarımı UserId	cookie_encrypted
		Ham (harici kaynak)	cookie_adid
Roku kimliği	Roku tanımlayıcıları	Veri aktarımı UserId	cookie_encrypted
		Ham (harici kaynak)	cookie_rida
tvOS kimliği	Apple TV tanımlayıcıları	Veri aktarımı UserId	cookie_encrypted
		Ham (harici kaynak)	cookie_tvos
Vizio IFA	Vizio tanımlayıcıları	Veri aktarımı UserId	cookie_encrypted
		Ham (harici kaynak)	cookie_vida
Samsung TIFA	Samsung tanımlayıcıları	Veri aktarımı UserId	cookie_encrypted
		Ham (harici kaynak)	cookie_tifa

Metin düzenleyici kullanarak bir düz metin dosyası oluşturun ve bunu herhangi bir dosya adıyla kaydedin. Dosyayı herhangi bir dosya uzantısı kullanarak ya da hiç uzantı kullanmadan kaydedebilirsiniz.

Google Cloud dosya adları herkes tarafından görülebilir. Dosya adlarınızda gizli bilgilere yer vermeyin.

Dosya içeriği gereksinimleri

• Dosya içeriğinin virgülle ayrılmış olduğundan emin olun.
• İlk satır şöyle olmalıdır:
  • Veri Aktarımı raporlarından (yalnızca Google Ad Manager 360) alınan şifrelenmiş çerezler ve şifrelenmiş tanımlayıcılar için: cookie_encrypted,list_id,process_consent
  • Ham Apple IDFA'ları için: cookie_idfa,list_id,process_consent
  • Ham Android AdID'leri için: cookie_adid,list_id,process_consent
  • Ham PPID'ler için: ppid,list_id,process_consent
  • Ham Roku kimlikleri için: cookie_rida,list_id,process_consent
  • Ham tvOS kimlikleri için: cookie_tvos,list_id,process_consent
• Sonraki her satır; bir tanımlayıcı, bir virgül ve tanımlayıcının ilişkilendirilmesi gereken kitle segmentinin kimliğini içermelidir
• Her bir satır, satır başı karakteri (CR) ile DEĞİL, unix satır bitiş türü satır beslemesi (LF) ile bitmelidir. Yükleme dosyasını üretmek için kullandığınız yönteme bağlı olarak satır bitiş türü, metin düzenleyicinizde veya dosyayı üreten programda ayarlanır.
• Yayıncılar, şifrelenmiş tanımlayıcıları Veri Aktarımı raporu (yalnızca Google Ad Manager 360) aracılığıyla kullanabilir. Google Ad Manager hesabınızda oturum açıp Envanter'i ve ardından Kitle segmentleri'ni seçerek kitle segmenti kimliğini öğrenebilirsiniz.
• "process_consent" sütunu, yükleme dosyasındaki son sütun olmalıdır.
• "process_consent" sütunundaki hücreler boş bırakılabilir. Ancak "process_consent" değerinin başlık olarak ayarlandığı sütunu eklemek önemlidir.
• Toplu yükleme dosyalarının boyutu 1 GB'tan büyük olamaz. Bundan büyük dosyalar düzgün şekilde işlenmeyebilir.

Şifrelenmiş çerez kimlikleri için örnek dosya içeriği:

cookie_encrypted,list_id,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,
w2gsrUcwxF-OiJTRmQswQA,3153490,

 

Ham AdID'ler için örnek dosya içeriği:

cookie_encrypted,list_id,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,
w2gsrUcwxF-OiJTRmQswQA,3153490,

Tanımlayıcıları toplu olarak silme

Dosyaya "sil" adlı bir sütun ekleyerek tanımlayıcıları toplu olarak silmek için aynı yükleme dosyasını kullanabilirsiniz. Segmentten silmek istediğiniz her bir tanımlayıcı için sil sütununa 1 girin, segmentte tutmak istediğiniz her bir kimlik içinse sil sütununa 0 girin.

Dosyadaki her satırın, sil sütununda 1 ya da 0 değerini içerdiğinden emin olmalısınız. Aksi takdirde, yükleme başarısız olur.

Aşağıdaki örnekte ilk çerez segmentte tutulur, ikinci çerez ise id=3153490 değerine sahip segmentten ayrılır.

cookie_encrypted,list_id,delete,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,0,
w2gsrUcwxF-OiJTRmQswQA,3153490,1,

Aşağıdaki örnekte ilk IDFA segmentten ayrılır, ikinci IDFA ise segmentte tutulur.

cookie_idfa,list_id,delete,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,1,
w2gsrUcwxF-OiJTRmQswQA,3153490,0,

Her satırda başlıktaki sayıda virgülle ayrılmış alan olmalıdır. Tanımlayıcıların hiçbir zaman CSV biçimiyle tutarsız virgüller veya diğer karakterler içermediğine dikkat edin.

Tanımlayıcılar eklenirken veya silinirken, Ad Manager'ın yüklenen tanımlayıcıları işlemesinin birkaç saat sürebileceğini unutmayın. Bir tanımlayıcı eklediğinizde, bunu bir sonraki yüklemeyle silebilmeniz için önce işlenmesini beklemeniz gerekir.

Dosyayı yükleme

Dosyayı oluşturduktan sonra bir Google Depolama Alanı grubuna yüklemeniz gerekir (alt klasörlere izin verilir). Ad Manager bulut depolama alanı paketlerine erişmek için kullanabileceğiniz en basitten en karmaşığa doğru sıralanmış üç yöntem vardır:

• İnternette: https://console.developers.google.com/storage/browser/gdfp_cookieupload_[Ad Manager ağ kodu]/ adresini ziyaret edin
• gsutil, depolama alanı paketi ile etkileşim için Unix benzeri komutlar sağlayan Python tabanlı bir komut satırı aracıdır. Paket kimlik doğrulaması soyutlanır ve otomatik olarak işlenir.
• Google Cloud Storage API; JSON veya XML RESTful web arayüzleri üzerinden kullanılabilen, depolama alanı grubunu yönetmeye yönelik tam donanımlı bir API'dır. Java, JavaScript, Python ve Objective-C dahil olmak üzere birçok popüler programlama ortamı için API istemci kitaplıkları mevcuttur. Bu yaklaşım, depolama alanı gruplarını bir Google App Engine uygulaması veya Java web uygulaması ile entegre etmek üzere programlı olarak işlemeniz gerektiğinde özellikle faydalıdır.

24 saat içinde Google Depolama Alanı hesabınızda dosyanızla aynı adı taşıyan ve son ekiyle dosyadaki tüm tanımlayıcıların başarıyla işlenip işlenmediğini belirten bir günlük dosyası oluşturulur.

Örneğin, dosyanızın adı 1234_20130115_1 ise oluşturulan dosya 1234_20130115_1.success ya da 1234_20130115_1.fail adını alacaktır. Dosya, başarıyla işlem yapılan tanımlayıcıların sayısını listeler ve işlenemeyen tanımlayıcılar için ayrıntılı hata mesajlarını verir. Daha ayrıntılı durum bilgisi için bu günlük dosyasını indirin.

Bu dosyayı, Google Depolama Alanı hesabınızdaki şu klasörde bulabilirsiniz:

https://console.developers.google.com/storage/gdfp_cookieupload_result_[Ad Manager ağ kodu]/

Yükleme işleminden sonra dosyanızdaki başarıyla işlenen tanımlayıcılar, envanter hedeflenirken ilişkili segmentlerinin üyesi olarak işleme alınır.

.fail veya .success dosyası, yalnızca dosyanın başarıyla ayrıştırılıp ayrıştırılmadığını gösterir; liste boyutundaki net artış/azalış hakkında anlamlı bilgiler vermez. Dosya yalnızca her tanımlayıcı başarıyla yüklenmişse .success olarak adlandırılır. Bununla birlikte, çoğu durumda en az bir hata görülür, bu nedenle çıkış dosyasında .fail son eki bulunur.

Yükleme ve günlük dosyaları 60 gün sonra silinir.

Toplu yüklenmiş tanımlayıcının süre sonu

Bir toplu yükleme işleminin parçası olarak yüklenen tanımlayıcılar, Ad Manager kullanıcı arayüzü aracılığıyla kitle segmenti üzerinde yapılandırılmış olan geçerlilik süre sonu ayarlarına uyar.

Kitle segmenti X günlük geçerlilik bitimi değeri ile yapılandırılmışsa ve tanımlayıcı yüklemeden sonra X gün içinde segment üyelik ölçütlerini yerine getirmiyorsa, söz konusu tanımlayıcının kitle segmentindeki geçerliliği X gün sonra sona erer. Her yükleme işlemi, yüklenen tanımlayıcıların segment üyeliğini ve süre sonu geri sayımını sıfırlar.

Toplu yüklemeler için en iyi uygulamalar

Dosya yapısı

Yüklemeler için kullanılan dosya sayısını en aza indirin. Liste kimliği dosyadaki her satır için belirtildiğinden, tanımlayıcıları birden fazla listeye yüklemek için tek bir dosya kullanılabilir.

Yükleme verimliliği

Dosya yüklerken aşağıdaki sınırlara uymanızı rica ederiz:

• Her 24 saatte bir en fazla 500 dosya yükleyin
• Her toplu yükleme dosyası için en fazla 1 GB yükleyin
• Her 24 saatte bir toplam toplu yükleme dosyası için en fazla 5 GB yükleyin

Artımlı/tam yüklemeler

• Gereksiz işlemlerden kaçınmak için rutin bir uygulama olarak tanımlayıcıların artımlı (delta) yüklemesini kullanmanızı öneririz. Tam segment tanımlayıcı listesini yüklemek yerine, yalnızca segmentteki üyeliği son yüklemeden beri değişmiş tanımlayıcıları eklemeniz veya silmeniz gerekir.
• Tüm segment tanımlayıcı verilerinin tam bir yüklemesini daha az sıklıkta (haftada en fazla bir kez ve yukarıdaki yükleme miktarı sınırlarına tabi olarak) çalıştırabilirsiniz. Bu tam yükleme, daha önce yaşı kitle segmentinin dışında kalmış tüm üyelerin segment üyeliğini yenileyecektir.
  • Tanımlayıcıların "güncelliğini" bazı başka sistemlerle izlemeniz ve bu tanımlayıcılar iptal edilmişse (sunum sırasında tekrar görülmeleri beklenmiyorsa) tanımlayıcıları yenileme yüklemesinden hariç tutmanız gerekir.

İşlem süresi

Toplu yüklemenin zamanından tüm toplu değişikliklerin yansıtıldığı zamana kadar 24 saat beklemeniz gerekebilir. Başka bir deyişle, sunum sırasında segmentlere ihtiyacınız olduğunda dosyalarınızı en az 24 saat önceden yükleyin.

Ayrıca, değişikliklerin Ad Manager kullanıcı arayüzünde görünür hâle gelmesi için toplu yükleme işleminden sonra 48 saate kadar beklemeniz gerekebilir.