Mengirim data ke Tag Manager sisi server

Artikel ini menjelaskan berbagai cara untuk mengirim peristiwa ke penampung sisi server. Jika Anda memerlukan informasi latar belakang selengkapnya, lihat cara kerja pemberian tag sisi server.

Artikel ini membahas cara:

• Mengirim data dari situs ke penampung sisi server
• Mengirim data tambahan ke penampung server
• Menerima data di penampung sisi server
• Mengirim data dari sumber selain situs

Sebelum memulai

Panduan ini mengasumsikan bahwa Anda sudah:

• Menyiapkan penampung server di Tag Manager
• Menyiapkan server pemberian tag

1. Mengirim data dari situs ke penampung sisi server

Anda dapat merutekan data melalui penerapan sisi server menggunakan Tag Manager atau tag Google (gtag.js). Pilih opsi penerapan Anda.

Tag Manager Tag Google (gtag.js)

Tag Google: GA4Universal Analytics

Agar dapat menyiapkan tag Google untuk pemrosesan sisi server, Anda perlu menambahkan URL penampung server.

Membuat variabel konfigurasi untuk URL penampung server

1. Buka Google Tag Manager

2. Pilih penampung web yang ingin Anda konfigurasi.

3. Buka menu Variabel.

4. Buat variabel buatan pengguna yang Baru dengan jenis tag Google: Setelan konfigurasi.

5. Tambahkan parameter berikut:

   • Nama: server_container_url
   • Nilai: Tetapkan ke URL penampung server di penampung server Tag Manager Anda.

6. Beri nama variabel Anda, misalnya, "URL Server", lalu Simpan.

Menetapkan URL penampung server ke tag Google

1. Buka menu Tag.
2. Tambahkan tag Google yang baru, atau edit tag Google yang ada.
3. Di Setelan konfigurasi, pilih variabel penampung server yang baru saja Anda buat.
   Tips: Untuk melihat parameter yang diwarisi dari variabel setelan, klik Tampilkan setelan yang diwarisi.
4. Untuk memastikan tag Google diaktifkan sebelum pemicu lainnya, klik Pemicuan dan gunakan pemicu Inisialisasi - Semua Halaman. Pelajari Pemicu halaman lebih lanjut.
5. Simpan tag dan Publikasikan penampung.

Agar dapat menyiapkan tag untuk pemrosesan sisi server, tambahkan URL penampung server Anda:

1. Di penampung web, tambahkan tag Universal Analytics dengan Variabel Setelan Google Analytics, atau gunakan konfigurasi Universal Analytics yang ada.
2. Buka Setelan Lainnya > Konfigurasi Lanjutan.
3. Centang kotak Tetapkan URL Transpor.
4. Tambahkan URL penampung server ke kolom URL Transpor (misalnya, https://<DOMAIN_NAME> dengan DOMAIN_NAME adalah nama domain penampung server Anda).
5. Konfigurasi pemicu untuk diaktifkan berdasarkan Inisialisasi - Semua halaman.
6. Simpan tag dan Publikasikan penampung.

Opsional: Mengirim parameter tambahan dengan setiap peristiwa

Anda dapat mengirim dua jenis parameter tambahan: Parameter tingkat konfigurasi dan parameter tingkat peristiwa. Parameter konfigurasi memengaruhi perilaku tag Google dan hanya dapat ditetapkan di tingkat tag Google.

Parameter peristiwa menetapkan informasi tambahan tentang sebuah peristiwa dan dapat ditetapkan untuk semua peristiwa, peristiwa tertentu, atau peristiwa page_view.

Parameter konfigurasiSemua peristiwaPeristiwa tertentuPeristiwa page_view

Pelajari cara menggunakan kembali setelan konfigurasi di Google Tag Manager.

Untuk mengirim parameter tambahan di semua peristiwa, gunakan kembali setelan peristiwa di Google Tag Manager.

Untuk mengirim parameter tambahan dengan Peristiwa Google Analytics 4:

1. Di penampung web, tambahkan tag Peristiwa Google Analytics 4 atau edit tag yang ada.
2. Klik Parameter Peristiwa > Tambahkan Baris.
3. Tambahkan parameter yang akan dikirim dengan peristiwa. Untuk parameter peristiwa standar, lihat Referensi peristiwa yang direkomendasikan.
   • Di bagian Nama Kolom, tambahkan nama parameter Anda, misalnya language.
   • Di bagian Nilai, tambahkan nilai parameter Anda.

Tips: Jika nilai Anda harus ditentukan pada saat Tag Manager dimuat, gunakan variabel, bukan nilai hard code.

1. Konfigurasi pemicu untuk diaktifkan berdasarkan Inisialisasi - Semua Halaman.
2. Simpan tag dan Publikasikan penampung.

Untuk mengirim parameter pada peristiwa page_view:

1. Di penampung web, edit tag Google yang ada.

2. Nonaktifkan page_view default di setelan konfigurasi dengan menambahkan parameter baru:

   • Nama: send_page_view
   • Nilai: false

3. Buat tag Google Analytics: Peristiwa GA4 yang baru.

   • Pilih tag konfigurasi yang Anda ubah di langkah 1.
   • Tetapkan Nama Peristiwa ke page_view.

4. Tambahkan parameter yang akan dikirim dengan peristiwa. Untuk parameter peristiwa standar, lihat Referensi peristiwa yang direkomendasikan. - Di bagian Nama Kolom tambahkan nama parameter Anda, misalnya language.

   • Di bagian Nilai, tambahkan nilai parameter Anda.

Tips: Jika nilai Anda harus ditentukan pada saat Tag Manager dimuat, gunakan variabel, bukan nilai hard code.

1. Konfigurasi pemicu untuk diaktifkan berdasarkan Inisialisasi - Semua Halaman.
2. Simpan tag dan Publikasikan penampung.

2. Menerima data di penampung sisi server

Saat Anda mengirim permintaan HTTP ke penampung server, sebuah klien harus mengklaim permintaan tersebut.

Istilah Penting: "Klien" adalah adaptor antara software yang berjalan di perangkat pengguna dan penampung Tag Manager sisi server Anda. Klien menerima data pengukuran dari perangkat, mengubah data tersebut menjadi satu atau beberapa peristiwa, memproses data dalam penampung, dan memaketkan hasilnya agar dikirim kembali ke perangkat.

Untuk melihat daftar klien yang tersedia:

1. Buka Google Tag Manager

2. Buka penampung server Anda.

3. Pada menu navigasi di sebelah kiri, klik Klien. Klien GA4 sudah diinstal sebelumnya di penampung sisi server Anda secara default. Jika Anda harus menggunakan Universal Analytics, siapkan klien Google Analytics: Universal Analytics.

4. Klik nama klien untuk melihat atau mengedit detailnya.

Setelan klien opsional

Pada umumnya, klien tidak akan memerlukan perubahan. Namun, kasus penggunaan Anda mungkin berbeda dan Anda dapat mengedit salah satu setelan berikut:

• Prioritas: Menentukan urutan untuk menjalankan klien. Angka yang lebih besar akan dijalankan terlebih dahulu, lalu klien pertama yang sesuai dengan permintaan masuk akan menjadi klien aktif untuk permintaan tersebut.

• Kriteria Aktivasi: Kriteria aktivasi menentukan kapan klien akan merespons permintaan:

  • Untuk klien UA: Jalur Universal Analytics default: Klien akan diaktifkan saat jalur permintaan menyertakan /collect, /r/collect, dan jalur serupa lainnya yang digunakan oleh file JavaScript yang mengirim data ke Google Analytics. Setelan ini aktif secara default.

  • Jalur gtag.js default untuk ID tertentu: Gunakan setelan ini untuk mengaktifkan penayangan JavaScript gtag.js melalui URL penampung server Anda. Saat diaktifkan, klien ini akan diaktifkan sebagai respons terhadap permintaan ke jalur permintaan gtag.js default, misalnya, /gtag/js?id=TAG_ID. Klik Tambahkan ID Pengukuran untuk menambahkan satu atau beberapa ID tujuan.

Opsional: Menerima data tambahan di Tag Manager sisi server

Jika Anda mengirim parameter tambahan, Anda harus menyiapkan klien Google Analytics 4 di penampung server untuk mengurai parameter tambahan dan membuat data peristiwa dari parameter tersebut.

Untuk menggunakan parameter tambahan di tag server:

1. Di penampung server, klik Variabel di navigasi sebelah kiri.
2. Buat Variabel Buatan Pengguna Baru.
3. Di bagian Konfigurasi Variabel, pilih jenis variabel Data Peristiwa.
4. Di bagian Jalur Kunci, masukkan nama parameter.
5. Beri nama variabel Anda, lalu klik Simpan.

Sekarang, Anda dapat menggunakan parameter peristiwa di tag lain dalam penampung server Anda.

3. Opsional: Mengirim data dari sumber selain situs

Measurement Protocol Google Analytics dapat digunakan untuk mengaktifkan dukungan pemberian tag sisi server dari sumber seperti aplikasi seluler dan aplikasi server ke server.

Aplikasi seluler

Agar aplikasi Android atau iOS dapat mengirim data ke penampung server, Anda harus membuat tag gambar kustom dan mengonfigurasinya untuk menggunakan Measurement Protocol:

1. Di penampung seluler (Android atau iOS), klik Tag > Baru.
2. Di Konfigurasi Tag pilih jenis tag Gambar Kustom.
3. Tetapkan nilai URL Gambar ke gambar piksel di penampung server di jalur dalam klien Measurement Protocol yang telah Anda tentukan sebelumnya. Tambahkan parameter Measurement Protocol yang diinginkan ke bagian akhir URL piksel:
   https://custom.example.com/app?v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home
4. Batalkan pilihan Aktifkan Cache Busting.
5. Simpan tag dan publikasikan penampung.
6. Di penampung sisi server, klik Klien > Baru.
7. Di Konfigurasi Klien, pilih jenis klien Measurement Protocol.
8. Tetapkan Jalur Aktivasi ke jalur endpoint pengumpulan aplikasi Anda.
9. Simpan konfigurasi klien dan publikasikan penampung sisi server.

Aplikasi server ke server

Untuk mengirim data protokol pengukuran ke penampung server, ganti nama host www.google-analytics.com dengan nama domain penampung server Anda. Contoh:

POST /batch HTTP/1.1
Host: collection.example.com

v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home

Untuk menerima hit Measurement Protocol, konfigurasikan penginstalan Tag Manager sisi server Anda dengan klien Measurement Protocol:

1. Di penampung sisi server, klik Klien > Baru.
2. Di Konfigurasi Klien, pilih jenis klien Measurement Protocol.
3. Tetapkan Jalur Aktivasi ke jalur endpoint server Anda.
4. Simpan konfigurasi klien dan publikasikan penampung.

Langkah berikutnya

Untuk mengirim data dalam konteks pihak pertama yang sebenarnya, Anda harus menayangkan skrip Google, seperti library Google Analytics dari server Anda sendiri.

Memuat skrip Google melalui server