Peristiwa kustom dan peristiwa yang direkomendasikan Google Analytics

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

Mengirim peristiwa yang direkomendasikan dan peristiwa kustom

Jika Anda mengupgrade dari Measurement Protocol Google Analytics, lihat Mengupgrade dari Measurement Protocol ke Data Manager API untuk mendapatkan petunjuk.

Ringkasan alur kerja

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

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

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

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

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

Kasus penggunaan

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

Berikut beberapa kasus penggunaan untuk mengirim peristiwa yang direkomendasikan dan kustom 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 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) harus dinormalisasi dan di-hash menggunakan SHA-256 sebelum diupload. Kolom lain (seperti kota, negara bagian atau provinsi, kode pos, dan kode negara) dinormalisasi, tetapi tidak di-hash. Ikuti panduan Memformat data pengguna untuk mengetahui persyaratan spesifik.

• Enkripsi: Anda dapat memilih untuk mengenkripsi data pengguna yang di-hash.

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

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

Pertimbangan integrasi

Perhatikan pertimbangan berikut saat menggunakan Data Manager API.

Pemasaran Ulang

Google Analytics mendukung pemasaran ulang di 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 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 otomatis menggabungkan informasi geografis dan perangkat terbaru dari pemberian tag dengan peristiwa Data Manager API menggunakan clientId atau appInstanceId. Tindakan ini memastikan bahwa peristiwa Data Manager API Anda ditampilkan 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 Data Manager API adalah untuk melengkapi peristiwa yang ada yang dikumpulkan menggunakan gtag, Tag Manager, atau Firebase. Sebagian 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.