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)

Pilih opsi penerapan Anda.

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.

Pilih opsi penerapan Anda.

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