Gunakan Data Manager API untuk mengirim peristiwa yang direkomendasikan dan peristiwa kustom Google Analytics.
Lihat Mengirim peristiwa untuk mengetahui detailnya.
Jika Anda melakukan upgrade dari Measurement Protocol Google Analytics, lihat artikel Mengupgrade dari Measurement Protocol ke Data Manager API untuk mengetahui petunjuknya.
Kasus penggunaan
Berikut beberapa kasus penggunaan untuk mengirim peristiwa kustom dan peristiwa yang direkomendasikan dengan Data Manager API:
Mengaitkan perilaku online ke offline.
Mengukur interaksi sisi klien dan sisi server.
Mengirim peristiwa yang terjadi di luar interaksi pengguna standar, seperti konversi offline.
Mengirim peristiwa dari perangkat dan aplikasi yang tidak memiliki fitur pengumpulan otomatis peristiwa, seperti kios dan jam tangan.
Data yang disediakan pengguna
Anda dapat mengirimkan data pelanggan pihak pertama, seperti alamat email, nomor telepon, dan alamat fisik yang di-hash, di kolom userData Event. Hal ini
membantu meningkatkan kualitas pengukuran konversi, atribusi, dan pembuatan audiens di
Google Analytics.
Perhatikan hal-hal berikut saat mengirim data yang disediakan pengguna:
Dikirim dengan peristiwa: Di Data Manager API, data yang disediakan pengguna harus dikirim sebagai bagian dari
Event. Upload mandiri tanpa peristiwa tidak didukung.Pemformatan dan hashing: ID pribadi (seperti alamat email, nomor telepon, nama, dan alamat jalan) harus dinormalisasi dan di-hash menggunakan SHA-256 sebelum diupload. Kolom lainnya (seperti kota, negara bagian atau provinsi, kode pos, dan kode negara) dinormalisasi, tetapi tidak di-hash. Ikuti panduan Memformat data pengguna untuk mengetahui persyaratan tertentu.
Enkripsi: Anda dapat secara opsional mengenkripsi data pengguna yang di-hash.
ID Pengguna: Sebaiknya berikan
userIdbersamauserDatasetiap kali ID pengguna yang konsisten tersedia.Penerapan: Lihat Menambahkan data yang disediakan pengguna untuk petunjuk tentang cara membuat permintaan.
Pertimbangan integrasi
Perhatikan hal-hal berikut saat menggunakan Data Manager API.
Pemasaran Ulang
Google Analytics mendukung pemasaran ulang terhadap perangkat yang sama jika Anda mengaktifkan sinyal Google. Untuk
pemasaran ulang lintas perangkat, userId diperlukan.
Selain itu, Anda dapat mengirim data yang disediakan pengguna untuk mengaktifkan pencocokan audiens pihak pertama.
ID iklan
Google Analytics secara otomatis menggabungkan ID iklan (seperti GBRAID atau WBRAID) yang dikumpulkan selama interaksi online dengan peristiwa Data Manager API menggunakan clientId atau appInstanceId.
Setelan privasi
Google Analytics menggabungkan peristiwa Data Manager API dengan interaksi online menggunakan
clientId atau appInstanceId untuk menerapkan setelan privasi pengguna seperti
"iklan yang tidak dipersonalisasi" dan "batasi pelacakan iklan".
Anda juga dapat menentukan setelan izin pengguna secara langsung di setiap peristiwa menggunakan objek
consent.
Informasi geografis dan perangkat
Google Analytics secara otomatis menggabungkan informasi geografis dan perangkat terbaru dari pemberian tag dengan peristiwa Data Manager API menggunakan clientId atau appInstanceId.
Hal ini memastikan bahwa peristiwa Data Manager API Anda tercermin dalam laporan yang mencakup dimensi geografis dan perangkat.
Jika Anda ingin peristiwa Data Manager API mencerminkan informasi geografis dan perangkat dari sesi tertentu, bukan informasi terbaru untuk clientId atau appInstanceId, sertakan entri di additionalEventParameters dengan parameterName disetel ke session_id dan value disetel ke ID sesi tertentu, lalu kirim peristiwa dalam waktu 24 jam setelah sesi dimulai.
Anda dapat memberikan informasi geografis dan informasi perangkat untuk peristiwa menggunakan Data Manager API.
Server ke server lengkap
Meskipun peristiwa dapat dikirim ke Google Analytics dengan Data Manager API saja, pelaporan yang tersedia mungkin tidak berisi data lengkap. Tujuan Data Manager API adalah untuk melengkapi peristiwa yang sudah ada yang dikumpulkan menggunakan gtag, Tag Manager, atau Firebase. Beberapa nama peristiwa dan parameter dicadangkan untuk digunakan melalui pengumpulan otomatis dan tidak dapat dikirim melalui Data Manager API.
Membuat atau mengganti nama peristiwa
Peristiwa yang dikirim dengan Data Manager API tidak memicu aturan untuk membuat atau mengganti nama peristiwa. Aplikasi Anda harus menerapkan logika untuk mengirim peristiwa kustom melalui Data Manager API, serupa dengan aturan yang dikonfigurasi di UI Google Analytics.