Peristiwa kustom dan peristiwa yang direkomendasikan Google Analytics

Gunakan Data Manager API untuk mengirim peristiwa kustom dan yang direkomendasikan Google Analytics.

Mengirim peristiwa kustom dan yang direkomendasikan

Jika Anda melakukan upgrade dari Measurement Protocol Google Analytics lihat Melakukan Upgrade dari Measurement Protocol ke Data Manager API untuk mengetahui petunjuknya.

Ringkasan alur kerja

Untuk mengirim data peristiwa dengan Data Manager API, selesaikan langkah-langkah berikut:

1. Siapkan tujuan: Tentukan objek Destination untuk destinations kolom permintaan penyerapan guna menentukan akun target dan konversi atau tujuan peristiwa. Lihat Menyiapkan tujuan untuk mengetahui detailnya.

2. Siapkan data peristiwa dan ID: Isi Event kolom dengan detail peristiwa dan ID yang diperlukan (seperti ID klik iklan, klien, atau instance aplikasi). Jika Anda menyertakan informasi kontak pengguna di userData, lakukan normalisasi dan hash SHA-256 pada ID sesuai dengan panduan pemformatan, dan enkripsi secara opsional. Lihat Menyiapkan data peristiwa untuk mengetahui detailnya.

3. Buat dan kirim permintaan penyerapan: Kirim events.ingest yang berisi destinations, rekamanEvent, dan encryptionInfo jika Anda mengenkripsi userData. Gunakan validateOnly: true untuk menguji payload Anda terkait error fast-fail sebelum mengirim data produksi. Lihat Mengirim peristiwa untuk mengetahui persyaratan kolom dan contoh kode.

4. Periksa diagnostik: Ambil diagnostik pemrosesan asinkron dan verifikasi status penyerapan dengan requestStatus.retrieve.

Kasus penggunaan

Poin Penting: Tujuan dari Data Manager API adalah untuk melengkapi pengumpulan otomatis peristiwa melalui gtag, Tag Manager, dan Google Analytics for Firebase, bukan menggantikannya.

Berikut beberapa kasus penggunaan untuk mengirim peristiwa kustom dan 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 mengirim data pelanggan pihak pertama, seperti alamat email, nomor telepon yang di-hash, dan alamat fisik, di kolom userData dari Event. Hal ini membantu meningkatkan 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 guide untuk mengetahui persyaratan tertentu.

• Enkripsi: Anda dapat secara opsional mengenkripsi data pengguna yang di-hash.

• User-ID: Sebaiknya berikan userId bersama userData setiap kali ID pengguna yang konsisten tersedia.

• Implementasi: Lihat Menambahkan data yang disediakan pengguna untuk mengetahui petunjuk tentang cara membuat permintaan.

Pertimbangan integrasi

Perhatikan pertimbangan berikut saat menggunakan Data Manager API.

Pemasaran Ulang

Google Analytics mendukung pemasaran ulang 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 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 menyertakan 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 ditetapkan ke session_id dan value ditetapkan 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 dari Data Manager API adalah untuk melengkapi peristiwa yang sudah ada yang dikumpulkan melalui 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, mirip dengan aturan yang dikonfigurasi di UI Google Analytics.