1. Pengantar
Terakhir diperbarui: 08-06-2021
Hal yang akan Anda build
Dalam codelab ini, Anda akan mempelajari cara mengirim peristiwa eksternal ke GA4 menggunakan Measurement Protocol.
Codelab ini mengasumsikan bahwa Anda sudah memiliki Aplikasi dengan Google Analytics for Firebase yang diterapkan. Jika Anda ingin mempelajari cara mengintegrasikan dengan Google Analytics for Firebase, baca codelab ini terlebih dahulu. Jika Anda ingin mempelajari cara mem-build aplikasi dengan Firebase, baca Chat yang Ramah untuk Build Codelab Android Firebase.
Yang akan Anda pelajari
- Langkah-langkah untuk melakukan panggilan MP pertama Anda
- Memahami parameter yang diperlukan untuk panggilan
- Kirim dan validasi panggilan uji coba Anda
- Membuat contoh skrip di Python untuk melakukan panggilan
Yang Anda butuhkan
- Aplikasi Android atau iOS Anda
- IDE apa pun untuk membuat perubahan
- Akun GA4
- Opsional - Lingkungan pengembangan Python (atau Colab)
2. Lengkapi kolom wajib diisi
Membuat Rahasia API di GA4
Buka GA4 dan buat rahasia API baru Anda dengan membuka Admin > Aliran Data > pilih aliran data Anda > Measurement Protocol > Buat
Anda dapat memberikan nama panggilan apa pun, dan nilai secret akan ditampilkan, yang dapat digunakan dalam panggilan Anda
Jika tidak tahu cara mengakses GA4, Anda dapat membuka Project Firebase, memeriksa Setelan Project > Integrasi > Google Analytics, lalu mengklik "Kelola". Koneksi Google Analytics harus terlihat, dan Anda juga dapat menavigasi langsung dari sana
Mengumpulkan app_instance_id
Anda dapat menggunakan salah satu metode di bawah ini untuk mengumpulkan app_instance_id.
- Menggunakan BigQuery Export
- Mengambil Secara Native di Kode Sumber Aplikasi Anda
Keduanya dijelaskan secara mendetail di bawah
- Menggunakan BigQuery Export
Jika BigQuery Export diaktifkan, Anda dapat mengikuti langkah-langkah berikut
- Login ke Firebase
- Buka Setelan Project > Integrasi > BigQuery
- Klik "View in BigQuery" di dekat set data
Catatan : Set data hanya akan tersedia setelah tombol diaktifkan selama sekitar 24-48 jam
- Di BigQuery, Anda dapat memeriksa user_pseudo_id pada tabel. Ini adalah app_instance_id yang dapat Anda gunakan dalam panggilan
- Mengambil Secara Native di Kode Sumber Aplikasi Anda
Jika aplikasi Anda dibangun menggunakan Java, Anda dapat menggunakan sesuatu seperti ini untuk mengambil app_instance_id
FirebaseAnalytics.getInstance(this).getAppInstanceId().addOnCompleteListener(new OnCompleteListener<String>() {
@Override
public void onComplete(@NonNull Task<String> task) {
if (task.isSuccessful()) {
String user_pseudo_id = task.getResult();
}
}
});
Untuk Kotlin, Anda dapat mencoba tindakan di bawah ini
Thread {
Firebase.analytics.appInstanceId.addOnSuccessListener { user_pseudo_id ->
Log.d("Firebase", "user_pseudo_id using appInstanceId is $user_pseudo_id")
/*
Store the value to your server or do something with the retrieved id
*/
}
}.start()
Jika memiliki Aplikasi iOS, Anda dapat menggunakan kode berikut di Swift
let user_pseudo_id = Analytics.appInstanceID()
print("user_pseudo_id = \(user_pseudo_id)")
/*
Store the value to your server or do something with the retrieved id
*/
Di bawah ini adalah link lainnya bergantung pada infrastruktur Anda
3. Membangun Komunikasi
Anda dapat membuat panggilan contoh menggunakan Pembuat Peristiwa di GA4. (Hal ini mengharuskan Anda untuk masuk dan mengaktifkan cookie). Pastikan tombol disetel ke "firebase"
Anda harus mengisi kolom berikut
- api_secret - Sudah dibuat sebelumnya di GA4
- firebase_app_id - Untuk mendapatkannya, Anda dapat membuka Admin > Aliran Data > pilih aliran data Anda . Seharusnya ditampilkan seperti di bawah ini
- app_instance_id - Anda telah mengambil nilai ini
- user_id tidak wajib. Untuk saat ini, Anda dapat mengosongkannya
- Kategori - ubah ini menjadi "Kustom" dari dropdown, lalu masukkan nama peristiwa pilihan Anda (jangan gunakan peristiwa yang dikumpulkan secara otomatis). Di sini kita menggunakan "test_from_codelab"
Secara opsional, Anda juga dapat memilih untuk memberikan parameter peristiwa dan/atau properti pengguna dengan mengklik tombol di bawah
Setelah mengisi semua, Anda akan melihat sesuatu seperti ini, dengan tombol "Validasi Peristiwa"
Setelah Anda mencapainya, klik "VALIDASI ACARA" , tombol yang disorot dengan warna oranye. Seharusnya muncul pesan di bawah, yang menentukan bahwa peristiwa tersebut valid, dan Anda akan melihat tombol "KIRIM KE GA" sekarang. Pada tahap ini, jika peristiwa tersebut tidak valid, alat ini akan memberi tahu kolom persis tempat terjadinya masalah, dan Anda dapat memperbaikinya lalu mencoba lagi
Anda sekarang dapat mengklik tombol tersebut, dan peristiwa pengujian akan dikirim ke GA4
4. Memvalidasi peristiwa di GA4
Setelah mengirim peristiwa, Anda dapat membuka akun GA4 dan memeriksa Realtime. Anda akan melihat peristiwa tersebut
Dibutuhkan waktu sekitar 24 jam untuk menyebarkan peristiwa dari tampilan realtime ke tab pelaporan peristiwa yang sebenarnya. Jadi, Anda tidak perlu khawatir jika tidak langsung melihatnya di pelaporan peristiwa reguler.
Jika Anda mengalami masalah atau perbedaan, sebaiknya lihat batasan Measurement Protocol yang telah diketahui di sini
5. Membuat Skrip Python
Setelah mengujinya, Anda dapat memeriksa panggilan API, dan payload peristiwa untuk membangun arsitektur serupa di Python (atau dalam bahasa pilihan Anda) yang dapat melakukan panggilan ini. Anda kemudian dapat menjadwalkannya pada frekuensi yang diinginkan dan mengoperasikannya. Untuk bagian ini, Anda dapat menggunakan IDE pilihan Anda yang mendukung Python atau cukup menggunakan notebook Google Colab yang tidak memerlukan penginstalan apa pun di perangkat Anda
Dengan merujuk kembali ke Pembuat Peristiwa GA4, Anda akan melihat bahwa endpoint-nya seperti di bawah ini
POST /mp/collect?firebase_app_id=XXXX&api_secret=XXXX
HTTP/1.1
Host: www.google-analytics.com
Payload peristiwa adalah seperti di bawah ini
{
"app_instance_id": XXXX,
"non_personalized_ads": false,
"events": [
{
"name": "test_from_codelab",
"params": {
"test_param": "test_123"
}
}
]
}
Anda dapat menerjemahkan ini ke python dengan menggunakan sesuatu seperti ini
import requests
import json
url = "https://www.google-analytics.com/mp/collect?firebase_app_id=XXXX&api_secret=XXXX"
payload = {
"app_instance_id": XXXX,
"non_personalized_ads": False,
"events": [
{
"name": "test_from_codelab",
"params": {
"test_param": "test_123"
}
}
]
}
r = requests.post(url,data=json.dumps(payload),verify=True)
print(r.status_code)
Setelah menjalankan parameter ini dengan nilai yang tepat, Anda juga akan melihat peristiwa tersebut tercermin secara real time di GA4.
6. Selamat
Selamat, Anda telah berhasil menggunakan Measurement Protocol di GA4. Sekarang Anda dapat membuat arsitektur solusi yang canggih untuk mengirimkan data yang lebih bermakna ke Google Analytics serta meningkatkan analisis pemasaran dan bisnis Anda. Untuk mendapatkan hasil maksimal, sebaiknya hubungkan juga ke Google Ads, dan impor peristiwa ini sebagai konversi. Anda dapat melihat langkah 6 dalam codelab ini untuk mengetahui petunjuk mendetail tentangnya. Untuk tujuan tracking konversi, Google Ads hanya akan menampilkan data yang terkait dengan IDFA atau ID perangkat yang dikumpulkan dari Firebase SDK dalam 60 hari terakhir. Perlu diingat bahwa ini masih berupa API alfa. Pastikan untuk memahami batasan yang tercantum di sini yang harus diatasi sebelum peluncuran penuh
Anda telah mempelajari
- Cara mengumpulkan variabel yang tepat untuk melakukan panggilan MP
- Cara mengirim dan memvalidasi peristiwa pengujian
- Cara membuat skrip untuk mengirim panggilan MP