Tentang codelab ini
1. Pengantar
Terakhir diperbarui: 30-04-2019
Yang akan Anda bangun
- Dalam codelab ini, Anda akan mempelajari cara mengirim peristiwa eksternal ke GA4 menggunakan Measurement Protocol.
- Codelab ini mengasumsikan bahwa Anda sudah memiliki Halaman/situs dengan Google Analytics 4 yang diterapkan.
Yang akan Anda pelajari
- Langkah-langkah untuk melakukan panggilan telepon MP pertama Anda
- Memahami parameter yang diperlukan untuk panggilan
- Mengirim dan memvalidasi panggilan uji coba Anda
- Membuat contoh skrip di Python untuk melakukan panggilan
Yang Anda butuhkan
- Situs/Halaman Web
- IDE apa pun untuk melakukan perubahan
- Akun GA4
- Opsional - Lingkungan pengembangan Python (atau Colab)
2. Mengumpulkan kolom wajib
Membuat Rahasia API di GA4
Buka GA4 dan buat rahasia API baru dengan membuka Admin > Aliran Data > pilih streaming Anda > Measurement Protocol > Berkreasi
Anda dapat memberikan nama panggilan apa pun, dan nilai rahasia akan ditampilkan, yang dapat digunakan dalam panggilan Anda
Mengumpulkan client_id
Anda dapat menggunakan salah satu metode di bawah ini untuk mengumpulkan client_id.
- Mengumpulkan melalui gTag
Keduanya dijelaskan secara mendetail di bawah ini
Mengumpulkan melalui gTag
Anda dapat mengambil client_id melalui situs menggunakan :
gtag('get', 'UA-XXXXXXXX-Y', 'client_id', (clientID) => {
Do something with clientID)
}
Di bawah ini adalah link lainnya bergantung pada infrastruktur Anda
3. Membangun Panggilan
Anda dapat membuat contoh panggilan menggunakan Pembuat Peristiwa di GA4. (Ini mengharuskan Anda masuk dan mengaktifkan cookie). Pastikan tombol ditetapkan ke "gtag.js"
Anda harus mengisi kolom berikut
- api_secret - Sudah dibuat sebelumnya di GA4
- measurement_id- Untuk mendapatkannya, Anda dapat membuka Admin > Aliran Data > pilih feed Anda . Seharusnya ditampilkan seperti di bawah ini
- client_id - Anda telah mengambil nilai ini
- user_id tidak wajib. Anda dapat membiarkannya kosong untuk saat ini
- Kategori - ubah ini menjadi "Kustom" dari menu 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 semuanya, Anda akan melihat tampilan seperti ini, dengan tombol "Validasi Acara"
Setelah sampai di sini, klik "VALIDASI ACARA" , tombol disorot dengan warna oranye. Seharusnya muncul pesan di bawah, yang menetapkan bahwa peristiwa valid, dan Anda akan melihat tombol "SEND TO GA" sekarang. Pada tahap ini, jika peristiwa dianggap tidak valid, alat akan memberi tahu Anda kolom persis tempat terjadinya masalah, dan Anda dapat memperbaikinya serta mencoba lagi
Anda sekarang dapat mengklik tombol, dan tindakan ini akan mengirim peristiwa pengujian ke GA4
4. Memvalidasi peristiwa di GA4
Setelah mengirim peristiwa, Anda dapat membuka akun GA4 dan memeriksa Real-Time. Anda akan melihat peristiwa dimulai
Diperlukan waktu sekitar 24 jam agar peristiwa disebarkan dari tampilan real-time ke tab pelaporan peristiwa yang sebenarnya, jadi Anda tidak perlu khawatir jika tidak langsung melihatnya di pelaporan peristiwa reguler.
5. Membuat Skrip Python
Setelah mengujinya, Anda dapat memeriksa panggilan API, dan payload peristiwa untuk membangun arsitektur serupa di Python (atau dalam bahasa apa pun pilihan Anda) yang dapat melakukan panggilan ini. Selanjutnya, Anda dapat menjadwalkan ini pada frekuensi yang diinginkan dan mengoperasionalkannya. 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.
Mengacu kembali ke Pembuat Peristiwa GA4, Anda akan melihat bahwa endpoint-nya adalah seperti di bawah ini
POST /mp/collect?measurement_id=XXXX&api_secret=XXXX
HTTP/1.1
Host: www.google-analytics.com
Payload peristiwa adalah seperti di bawah ini
{
"client_id": XXXX,
"non_personalized_ads": false,
"events": [
{
"name": "test_from_codelab",
"params": {
"test_param": "test_123"
}
}
]
}
Anda dapat menerjemahkan ini ke {i>python<i} dengan menggunakan alat seperti ini
import requests
import json
url = "https://www.google-analytics.com/mp/collect?measurement_id=XXXX&api_secret=XXXX"
payload = {
"client_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 menjalankannya 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 membangun arsitektur solusi yang canggih untuk mengirim data yang lebih bermanfaat ke Google Analytics dan meningkatkan analisis pemasaran serta bisnis Anda. Untuk mendapatkan hasil maksimal dari hal ini, sebaiknya hubungkan juga ke Google Ads, dan impor peristiwa ini sebagai konversi.
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