Mengirim peristiwa Web ke GA4 menggunakan Measurement Protocol

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 web/situs dengan Google Analytics 4 yang diimplementasikan.

Yang akan Anda pelajari

  • Langkah-langkah untuk melakukan panggilan MP pertama Anda
  • Memahami parameter yang diperlukan untuk panggilan
  • Mengirim dan memvalidasi panggilan uji coba Anda
  • Buat skrip contoh 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. Kumpulkan kolom wajib diisi

Membuat Rahasia API di GA4

Buka GA4 dan buat secret API baru dengan membuka Admin > Aliran Data > pilih aliran data Anda > Measurement Protocol > Buat

8dee89e850ae90bb.png

d0be19d8112435a2.png

de5a80a1445d3a14.png

Anda dapat memberikan nama panggilan apa pun, dan nilai rahasia akan ditampilkan, yang dapat Anda gunakan dalam panggilan

Mengumpulkan client_id

Anda dapat menggunakan salah satu metode di bawah untuk mengumpulkan client_id Anda.

  1. Mengumpulkan melalui gTag

Keduanya dijelaskan secara mendetail di bawah

Mengumpulkan data melalui gTag

Anda dapat mengambil client_id melalui situs menggunakan :

gtag('get', 'UA-XXXXXXXX-Y', 'client_id', (clientID) => {
  Do something with clientID)
}

Berikut adalah link lainnya, bergantung pada infrastruktur Anda

3. Membuat Panggilan

Anda dapat membuat contoh panggilan menggunakan Pembuat Peristiwa di GA4. (Cara ini mengharuskan Anda untuk login dan mengaktifkan cookie). Pastikan tombol ditetapkan ke "gtag.js"

b904d2a053eb7817.png

Anda harus mengisi kolom berikut

  • api_secret - Sudah dibuat sebelumnya di GA4
  • measurement_id- Untuk mendapatkan ID ini, Anda dapat membuka Admin > Aliran Data > pilih aliran data Anda . Tampilannya akan seperti di bawah

d362992ff592c675.png

  • client_id - Anda telah mengambil nilai ini
  • user_id tidak wajib diisi. Anda dapat mengosongkannya untuk saat ini
  • Kategori - ubah ini menjadi "Kustom" dari dropdown, dan masukkan nama peristiwa pilihan Anda (jangan gunakan peristiwa yang dikumpulkan secara otomatis). Di sini kita menggunakan "test_from_codelab"

cf580a708bb0a8a2.png

Secara opsional, Anda juga dapat memilih untuk memberikan parameter peristiwa dan/atau properti pengguna dengan mengklik tombol di bawah

da59bb982f6f906a.png

Setelah mengisi semuanya, Anda akan melihat tampilan seperti ini, dengan tombol "Validasi Acara"

31f720d550906298.png

Setelah Anda mencapai langkah ini, klik "VALIDATE EVENT" , tombol yang ditandai dengan warna oranye. Pesan di bawah akan ditampilkan, yang menyatakan bahwa peristiwa tersebut valid, dan Anda akan melihat tombol "KIRIM KE GA". Pada tahap ini, jika acara muncul sebagai tidak valid, alat akan memberi tahu Anda kolom persisnya yang bermasalah, dan Anda dapat memperbaikinya lalu mencoba lagi

1d63d1e067c46294.png

Sekarang Anda dapat mengklik tombol tersebut, dan tombol tersebut 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 acara muncul

7b9e9a0f74b64757.png

Diperlukan waktu sekitar 24 jam agar peristiwa disebarkan dari tampilan real-time ke tab pelaporan peristiwa sebenarnya, jadi Anda tidak perlu khawatir jika tidak melihatnya di pelaporan peristiwa reguler dengan segera.

5. Membangun 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. Kemudian, Anda 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 endpointnya adalah sebagai berikut

POST /mp/collect?measurement_id=XXXX&api_secret=XXXX 
HTTP/1.1
Host: www.google-analytics.com

Payload peristiwa adalah sebagai berikut

{
  "client_id": XXXX,
  "non_personalized_ads": false,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}

Anda dapat menerjemahkannya ke python dengan menggunakan sesuatu 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 menjalankan ini dengan nilai yang tepat, Anda akan melihat peristiwa yang sama tercermin secara real-time di GA4.

6. Selamat

Selamat, Anda telah berhasil menggunakan Measurement Protocol di GA4. Sekarang Anda dapat membuat arsitektur solusi yang efektif untuk mengirim data yang lebih bermakna ke Google Analytics dan meningkatkan analisis bisnis dan pemasaran Anda. Untuk mendapatkan hasil maksimal, sebaiknya Anda juga terhubung ke Google Ads, dan mengimpor 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

Dokumen referensi