Mengupload banyak ID ke segmen audiens

Hanya tersedia di Google Ad Manager 360.

 

Mempelajari upload massal ID dengan Google Cloud. #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.

Anda harus menghubungi Dukungan Penayang atau Bagian Penjualan untuk mengaktifkan Solusi Audiens. Mereka harus mengaktifkan daftar yang diberikan, yang akan mengakibatkan penundaan sebelum penayang mulai melihat segmen audiensnya.

Anda dapat membuat file ID dan menguploadnya ke Google Ad Manager melalui Google Cloud. ID yang tersedia untuk diupload mencakup cookie, ID periklanan seluler (ID iklan atau IDFA), atau PPID. Mengupload ID melalui Google Cloud akan menghemat waktu jika Anda perlu menambahkan banyak ID sekaligus.

Cookie, PPID, dan ID periklanan perangkat harus menjadi bagian dari permintaan iklan Ad Manager sebelum dapat ditambahkan ke segmen. Anda dapat mendownload daftar ID terenkripsi di laporan Transfer Data (khusus Google Ad Manager 360), atau mengambil ID mentah dari sistem lain (misalnya, ID iklan perangkat mentah dari log aplikasi seluler Anda).

Masa aktif maksimum PPID untuk Upload Banyak adalah 180 hari setelah aktivitas pengguna terakhir, atau kali terakhir terlihat dalam penayangan. Untuk ID perangkat, batas maksimumnya adalah 540 hari setelah pembuatan, dengan kata lain, 540 hari setelah pertama kali perangkat terlihat dalam penayangan.

Perhatikan bahwa penggunaan metode pengisian berdasarkan ping peristiwa (misalnya, peristiwa pendaftaran, pengisian otomatis) dan metode pengisian berdasarkan upload cookie (yaitu daftar CSV yang diberikan) dapat menimbulkan konflik ketika PPID yang dihapus mungkin tidak muncul sebagai sepenuhnya dikecualikan.

Artikel ini membahas topik berikut:

• Prasyarat
• Membuat file upload
• Menghapus ID secara massal
• Mengupload file
• Masa berakhir ID upload banyak
• Praktik terbaik untuk upload banyak

Prasyarat

Sebelum dapat mengupload ID, bekerja samalah dengan Account Manager Anda untuk:

• Menemukan dan mengirimkan kode jaringan. Temukan kode jaringan Anda di Ad Manager pada bagian Admin, lalu Setelan global, kemudian Kode jaringan.
• Memastikan Anda telah membuat segmen audiens pihak pertama aktif yang ID-nya ingin Anda kaitkan. Jika tidak ingin segmen ini mengumpulkan pengguna menggunakan inventaris Anda, pilih "Dikelola Penayang" sebagai Metode populasi.
  
  Anda mungkin harus menunggu hingga 24 jam sejak waktu pembuatan segmen hingga Anda dapat melakukan upload banyak.
• Membuat Google Grup yang berisi semua Akun Google yang akan memiliki akses untuk mengupload dan melihat file.

Setelah Account Manager menyelesaikan penyiapan, Anda akan siap untuk membuat file berisi ID yang akan diupload.

Penayang yang pertama kali mencoba mengupload ID mungkin akan mengalami kegagalan dalam melakukan prosesnya. Hal ini sering kali terjadi karena penayang mengupload ID yang belum diteruskan dalam permintaan iklan sebelum melakukan upload. Dalam hal ini, mereka melihat pesan berikut dalam file .fail: 
"Tidak dapat menemukan <type of identifier> di server kami, mencoba ulang tidak akan membantu".

Membuat file upload

Tag izin yang diperlukan

Semua penayang harus melakukan perubahan untuk memberikan sinyal izin yang diperlukan ke Ad Manager.

Untuk mengonfirmasi bahwa izin telah dikumpulkan, tambahkan tag process_consent di header setiap file yang diupload. Baris harus berisi nilai untuk kolom header ini agar sesuai dengan standar CSV, tetapi pemrosesan tidak akan terpengaruh; sebaiknya gunakan string kosong. File apa pun yang tidak menyertakan frasa ini akan dianggap tidak memiliki izin yang sesuai dari pengguna dan akan gagal diproses oleh Google.

Pembaruan ini diperlukan:

• Untuk semua pengguna, di mana pun lokasinya, sebagai persyaratan teknis.
• Bagi pengguna Uni Eropa/EEA, patuhi Kebijakan izin pengguna Uni Eropa dan terus buat segmen audiens untuk pengguna di Wilayah Ekonomi Eropa (EEA).

Tentang ID

Proses upload banyak mendukung beberapa jenis ID yang berbeda, dan jenis ID harus diupload ke segmen menggunakan format file upload yang benar. ID ini dikelompokkan dalam dua kategori:

• ID terenkripsi: semua ID yang didapat dari sistem Google
• ID mentah: didapat dari sistem atau sumber eksternal

ID terenkripsi diupload menggunakan format file cookie_encrypted, sedangkan ID mentah diupload dengan format file upload spesifik per jenisnya.

ID terenkripsi dan PPID bersifat spesifik per jaringan. Oleh karena itu, upload banyak PPID atau ID terenkripsi yang didapatkan dari satu jaringan tidak dapat diupload ke jaringan lain. Artinya, ID pengguna yang didapat dari laporan Transfer Data jaringan A tidak dapat diupload banyak ke jaringan B. Di sisi lain, ID perangkat tidak bersifat spesifik per jaringan.

Tabel berikut meringkas ID yang tersedia dan cara menguploadnya:

ID	Deskripsi	Sumber	Upload sebagai
Cookie	ID cookie	Transfer data UserId	cookie_encrypted
		Data mentah (sumber eksternal)	T/A (cookie harus terenkripsi agar dapat diupload)
PPID	ID yang diberikan penayang	Transfer data PublisherProvidedID	cookie_encrypted
		Data mentah (sumber eksternal)	ppid
IDFA	ID untuk iklan	Transfer data UserId	cookie_encrypted
		Data mentah (sumber eksternal)	cookie_idfa
ID iklan	ID Android TV	Transfer data UserId	cookie_encrypted
		Data mentah (sumber eksternal)	cookie_adid
ID Roku	ID Roku	Transfer data UserId	cookie_encrypted
		Data mentah (sumber eksternal)	cookie_rida
ID tvOS	ID Apple TV	Transfer data UserId	cookie_encrypted
		Data mentah (sumber eksternal)	cookie_tvos
Vizio IFA	ID Vizio	Transfer data UserId	cookie_encrypted
		Data mentah (sumber eksternal)	cookie_vida
Samsung TIFA	ID Samsung	Transfer data UserId	cookie_encrypted
		Data mentah (sumber eksternal)	cookie_tifa

Dengan menggunakan editor teks, buatlah file teks biasa dan simpan dengan nama file apa pun. Anda dapat menyimpan file tersebut menggunakan ekstensi file atau tanpa ekstensi sama sekali.

Nama file Google Cloud dapat dilihat oleh publik. Jangan menyertakan informasi rahasia dalam nama file Anda.

Persyaratan konten file

• Pastikan konten file dipisahkan tanda koma.
• Baris pertama harus bertuliskan:
  • Untuk cookie dan ID terenkripsi yang diperoleh dari laporan Transfer Data (khusus Google Ad Manager 360): cookie_encrypted,list_id,process_consent
  • Untuk data mentah IDFA Apple: cookie_idfa,list_id,process_consent
  • Untuk data mentah AdID Android: cookie_adid,list_id,process_consent
  • Untuk data mentah PPID: ppid,list_id,process_consent
  • Untuk data mentah ID Roku: cookie_rida,list_id,process_consent
  • Untuk data mentah ID tvOS: cookie_tvos,list_id,process_consent
• Setiap baris berikutnya harus berisi ID, koma, dan ID segmen audiens yang akan dikaitkan
• Setiap baris harus diakhiri dengan linefeed (LF) jenis baris akhir unix, BUKAN enter (CR). Bergantung pada metode yang Anda gunakan untuk menghasilkan file upload, jenis akhir baris ditetapkan dalam editor teks atau program yang membuat file.
• ID terenkripsi tersedia untuk penayang melalui laporan Transfer Data (khusus Google Ad Manager 360). Anda dapat memperoleh ID segmen audiens dengan login ke akun Google Ad Manager Anda dan memilih Inventaris lalu Segmen audiens.
• Kolom "process_consent" harus merupakan kolom terakhir dalam file upload.
• Sel dalam kolom "process_consent" boleh dibiarkan kosong. Namun, penting untuk menyertakan kolom dengan nilai "process_consent" yang ditetapkan sebagai header.
• Ukuran file yang diupload banyak tidak boleh lebih dari 1 GB. File yang lebih besar dari ukuran ini mungkin akan gagal diproses dengan benar.

Contoh konten file untuk ID cookie terenkripsi:

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

 

Contoh konten file untuk ID Iklan mentah:

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

Menghapus ID secara massal

Anda dapat menggunakan file upload yang sama untuk menghapus banyak ID, dengan menambahkan kolom yang bernama hapus (delete). Untuk setiap ID yang ingin Anda hapus dari segmen, masukkan 1 di kolom hapus, dan untuk setiap ID yang ingin Anda simpan dalam segmen, masukkan 0 di kolom hapus.

Anda harus memastikan bahwa setiap baris dalam file berisi 1 atau 0 di kolom hapus. Jika tidak, upload akan gagal.

Pada contoh di bawah, cookie pertama disimpan dalam segmen, tetapi cookie kedua dibatalkan pengaitannya dari segmen dengan id=3153490.

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

Pada contoh berikut, IDFA pertama dipisahkan dari segmen, tetapi IDFA kedua disimpan dalam segmen.

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

Setiap baris harus berisi kolom yang dipisahkan koma dengan jumlah yang sama dengan yang ditetapkan pada header. Perlu diketahui bahwa ID tidak pernah berisi koma atau karakter lain yang tidak konsisten dengan format CSV.

Perlu diingat bahwa mungkin diperlukan waktu beberapa jam bagi Ad Manager untuk memproses upload ID, baik saat Anda menambahkannya atau menghapusnya. Jika Anda menambahkan ID, Anda harus menunggunya untuk diproses sebelum dapat menghapusnya dengan upload berikutnya.

Mengupload file

Setelah Anda membuat file, Anda perlu menguploadnya ke bucket Google Storage (subfolder diizinkan). Ada tiga cara untuk mengakses bucket penyimpanan cloud Ad Manager. Sesuai urutan kompleksitasnya:

• Di web: Buka https://console.developers.google.com/storage/browser/gdfp_cookieupload_[kode jaringan Ad Manager]/
• gsutil adalah alat command line berbasis Python yang menyediakan perintah seperti Unix untuk berinteraksi dengan bucket penyimpanan. Autentikasi bucket diabstraksi dan ditangani secara otomatis.
• Google Cloud Storage API adalah API dengan fitur lengkap untuk memanipulasi bucket penyimpanan, yang tersedia melalui antarmuka web XML RESTful atau JSON. Library klien API tersedia untuk banyak lingkungan pemrograman populer, termasuk Java, JavaScript, Python, dan Objective-C. Pendekatan ini paling berguna jika Anda perlu memanipulasi bucket penyimpanan secara terprogram untuk mengintegrasikan dengan aplikasi Google App Engine atau aplikasi web Java.

Dalam waktu 24 jam, file log akan dibuat di akun Google Storage yang memiliki nama yang sama dengan file dan akhiran yang menunjukkan apakah semua ID dalam file berhasil diproses atau tidak.

Misalnya, jika file Anda bernama 1234_20130115_1, lalu file yang dibuat akan bernama 1234_20130115_1.success atau 1234_20130115_1.fail. File log ini mencantumkan jumlah ID yang berhasil diproses, dengan pesan error mendetail untuk ID yang tidak dapat diproses. Download file log ini untuk mendapatkan detail informasi status.

Nama file yang dihasilkan akan muncul dalam folder berikut di akun Google Storage Anda:

https://console.developers.google.com/storage/gdfp_cookieupload_result_[kode jaringan Google Ad Manager]/

Setelah diupload, ID yang berhasil diproses dalam file Anda diperlakukan sebagai anggota segmen terkait saat menargetkan inventaris.

File .fail atau .success hanya menunjukkan apakah file tersebut telah berhasil diurai atau tidak; file tersebut tidak memberikan informasi yang berarti tentang peningkatan/penurunan bersih dalam ukuran daftar. File hanya diberi nama .success jika setiap ID berhasil diupload. Namun, hampir di semua kasus, setidaknya terdapat satu kegagalan, sehingga file output berisi akhiran .fail.

File log dan file upload akan dihapus setelah 60 hari.

Masa berakhir ID upload banyak

ID yang diupload sebagai bagian dari operasi Upload Banyak mengikuti setelan masa berakhir yang telah dikonfigurasi di segmen audiens melalui UI Ad Manager.

Jika segmen audiens dikonfigurasi dengan nilai masa berakhir X hari dan ID tidak memenuhi kriteria keanggotaan segmen dalam X hari setelah diupload, ID tersebut akan berakhir masa berlakunya dari segmen audiens setelah X hari. Setiap operasi upload akan menyetel ulang keanggotaan segmen dan hitungan masa berakhir untuk ID yang diupload.

Praktik terbaik untuk upload banyak

Struktur file

Minimalkan jumlah file yang digunakan untuk upload. Perlu diperhatikan bahwa satu file dapat digunakan untuk mengupload ID ke dalam beberapa daftar, karena ID daftar ditetapkan untuk setiap baris dalam file.

Throughput upload

Sebaiknya Anda mematuhi batasan berikut saat mengupload file:

• Upload tidak lebih dari 500 file per 24 jam
• Ukuran maksimal 1 GB per file upload banyak
• Ukuran total file upload banyak maksimal 5 GB per 24 jam

Upload tambahan/lengkap

• Untuk menghindari pemrosesan yang tidak perlu, sebaiknya gunakan upload tambahan (delta) pada ID sebagai praktik rutin. Anda harus menambahkan atau menghapus ID yang keanggotaannya di segmen telah berubah sejak upload terakhir saja, bukan mengupload daftar ID segmen secara lengkap.
• Dengan frekuensi yang tidak terlalu sering (tidak lebih dari sekali per minggu dan masih mematuhi batas throughput upload di atas), Anda dapat menjalankan upload lengkap untuk semua data ID segmen. Upload lengkap ini akan memperbarui keanggotaan segmen untuk setiap anggota yang sebelumnya telah mencapai batas waktu segmen audiens.
  • Anda harus melacak "masa berlaku" ID melalui beberapa sistem lainnya, dan Anda harus memiliki cara untuk mengecualikan ID dari upload lengkap jika ID ini telah ditinggalkan (tidak diharapkan untuk dilihat lagi di penayangan).

Waktu pemrosesan

Anda mungkin harus menunggu hingga 24 jam sejak waktu dilakukannya upload banyak hingga semua perubahan kelompok diterapkan dalam penayangan. Dengan kata lain, upload file Anda setidaknya 24 jam sebelum Anda membutuhkan segmen tersebut dalam penayangan.

Selain itu, tunggu hingga 48 jam sejak waktu upload banyak sebelum perubahan terlihat di antarmuka pengguna Ad Manager.