Terima kasih telah melihat pratinjau dokumentasi platform tag Google yang baru. Situs ini berstatus beta versi publik. (Masukan)

Pengantar pemberian tag sisi server

Pemberian tag sisi server adalah cara baru untuk menggunakan Google Tag Manager untuk melengkapi aplikasi Anda di berbagai perangkat. Penampung server menggunakan tag, pemicu, dan model variabel yang sama dengan yang Anda gunakan, sekaligus menyediakan alat baru yang memungkinkan Anda mengukur aktivitas pengguna di mana pun hal tersebut terjadi.

Konfigurasi pemberian tag umum tanpa pemberian tag sisi server bergantung pada penampung di halaman untuk mengirim data pengukuran ke berbagai server pengumpulan. Gambar 1 menampilkan contoh bagaimana penampung web Tag Manager yang berjalan di browser web mengirim data ke beberapa server.

Diagram situs yang diinstrumentasikan untuk menggunakan penampung web Google Tag Manager

Gambar 1: Diagram situs yang diinstrumentasikan untuk menggunakan penampung web Google Tag Manager.

Sebaliknya, penampung server tidak berjalan di browser pengguna atau di ponsel mereka. Namun, penampung server ini berjalan di server yang Anda kontrol.

Diagram situs yang diinstrumentasikan menggunakan penampung pemberian tag sisi server.

Gambar 2: Contoh konfigurasi pemberian tag yang menggunakan penampung server.

Server berjalan di project Google Cloud Platform Anda sendiri—atau di lingkungan lain yang Anda pilih—dan hanya Anda yang memiliki akses ke data dalam server sampai Anda memilih untuk mengirimkannya ke tempat lain. Anda memiliki kontrol penuh atas cara pembentukan data tersebut, dan lokasi perutean data tersebut dari server. Tag dibuat menggunakan teknologi JavaScript dengan sandbox. Izin memberi Anda visibilitas mengenai fungsi yang dapat dilakukan tag, dan kebijakan memungkinkan Anda menetapkan batasan di seputar penampung.

Server menerima permintaan web dari perangkat pengguna dan mengubah permintaan tersebut menjadi peristiwa. Setiap peristiwa diproses oleh tag, pemicu, dan variabel penampung. Tag, pemicu, dan variabel di penampung server bekerja persis seperti di jenis penampung lainnya: Pemicu memeriksa setiap peristiwa untuk mencari kondisi tertentu, dan jika sesuai, mengaktifkan tag yang mengirim data peristiwa untuk diproses.

Model ini memperkenalkan dua pertanyaan penting untuk penampung server:

  • Bagaimana cara pengiriman data pengukuran dari perangkat pengguna ke penampung server?
  • Bagaimana cara mengubah data pengukuran yang dikirim ke penampung server menjadi peristiwa?

Jawaban untuk kedua pertanyaan tersebut adalah jenis entitas baru untuk digunakan dalam penampung server: klien.

Cara kerja klien

Klien adalah adaptor antara software yang berjalan di perangkat pengguna dan penampung server. Klien menerima data pengukuran dari perangkat, mengubah data tersebut menjadi satu atau beberapa peristiwa, merutekan data untuk diproses di penampung, dan mengemas hasilnya untuk dikirim kembali ke pemohon.

Banyak sekali fungsinya. Mari kita pelajari lebih lanjut setiap bagian satu per satu. Gambar 3 menunjukkan data yang mengalir ke penampung server dari browser web pengguna, dan dari server web Anda ke penampung server.

Diagram situs yang diinstrumentasikan menggunakan penampung pemberian tag sisi server.

Gambar 3: Klien yang berbeda menangani setiap aliran data.

Klien menerima data pengukuran dari perangkat. Misalkan Anda ingin mengukur aktivitas pengguna di tiga tempat: situs, aplikasi telepon, dan smart toaster. Situs Anda menggunakan Google Analytics, aplikasi telepon Anda menggunakan Firebase Analytics, dan toaster Anda menggunakan protokol eksklusif yang disebut "ToastMeasure".

Menginstrumentasikan ketiga perangkat ini dengan Google Tag Manager biasanya akan memerlukan penampung yang berbeda untuk setiap platform. Karena penampung server tidak berjalan di perangkat, penampung yang sama dapat menangani instrumentasi analisis untuk ketiga platform perangkat. Namun demikian, ada masalah. Semua perangkat tersebut tidak berkomunikasi dengan cara yang sama. Protokol Google Analytics tidak sama dengan protokol ToastMeasure. Di sinilah peran klien.

Sebagai pengganti ketiga penampung tersebut, penampung server Anda memiliki tiga klien. Setiap permintaan yang masuk ke penampung akan diproses oleh setiap klien dalam urutan prioritas, klien dengan prioritas tertinggi akan didahulukan. Hal pertama yang akan dilakukan setiap klien adalah memutuskan apakah klien mengetahui cara memproses permintaan semacam itu. Jika tahu, klien "mengklaim" permintaan tersebut dan melanjutkan ke tahap pemrosesan berikutnya. Tindakan mengklaim permintaan akan mencegah klien berikutnya berjalan. Jika tidak dapat memproses permintaan, klien tidak akan melakukan apa pun dan mengizinkan klien lainnya memutuskan apakah permintaan akan ditangani atau tidak.

Klien mengubah data permintaan menjadi satu atau beberapa peristiwa. Setelah klien ToastMeasure mengklaim permintaan, klien perlu mengubah permintaan menjadi hal yang dipahami oleh penampung lainnya. Hal tersebut adalah kumpulan peristiwa.

Peristiwa adalah kejadian yang ingin Anda ukur. Peristiwa bisa berupa apa pun: start_toasting, finish_toasting, atau buy_bread. Ada beberapa rekomendasi tentang struktur peristiwa yang dihasilkan klien, tetapi satu-satunya persyaratan adalah bahwa penampung lain memahaminya.

Klien menjalankan penampung. Klien telah mengklaim permintaan dan mengubahnya menjadi peristiwa. Sekarang saatnya untuk tag, pemicu, dan variabel. Klien meneruskan setiap peristiwa ke penampung lainnya untuk diproses lebih lanjut.

Klien mengemas hasilnya untuk dikirim kembali ke perangkat. Setelah penampung berjalan, saatnya merespons toaster. Responsnya dapat bermacam-macam. Mungkin klien hanya mengucapkan "Oke, selesai." Mungkin salah satu tag ingin mengalihkan permintaan ke server pengumpulan lainnya. Atau mungkin salah satu tag memberi tahu lampu di toaster untuk mengubah warna. Apa pun yang hasil yang diharapkan, tugas klien adalah mengemas hasilnya dan mengirimkannya kembali ke pemohon.

Untungnya, Tag Manager menangani sebagian besar hal ini untuk Anda. Penampung server dilengkapi dengan tiga klien: Google Analytics 4, Google Analytics: Universal Analytics, dan Measurement Protocol. Klien ini menyediakan alat yang Anda butuhkan untuk mulai menginstrumentasikan aplikasi Anda segera setelah Anda membuat penampung.

Contoh singkat

Mari kita lihat contoh singkat untuk mengetahui cara penyatuan semua bagian. Dalam contoh ini, Anda akan membuat hal berikut:

  1. Situs sederhana yang menggunakan gtag.js untuk mengirim peristiwa click ke penampung server.
  2. Klien Google Analytics 4 yang menerima peristiwa.
  3. Pemicu yang diaktifkan di peristiwa click.
  4. Tag Google Analytics 4 yang mengirim data peristiwa ke Google Analytics untuk diproses.

Untuk contoh ini, kami akan mengasumsikan bahwa Anda telah membuat dan men-deploy penampung server Anda.

Mengonfigurasi gtag.js

Pertama, konfigurasikan gtag.js untuk mengirim data ke penampung server Anda. Dengan gtag.js, pengiriman data ke penampung server Anda berfungsi seperti mengirim data ke Google Analytics, dengan satu modifikasi. Seperti pada halaman contoh di bawah, tetapkan opsi konfigurasi transport_url agar mengarah ke penampung server.

<!-- Global site tag (gtag.js) - Google Analytics -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-EXAMPLE"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'G-EXAMPLE', {
    transport_url: 'https://analytics.example.com',
  });
</script>

Ganti G-EXAMPLE dengan ID Google Analytics 4. Ganti https://analytics.example.com dengan URL penampung server Anda.

Selanjutnya, tambahkan fungsi sendEvent() untuk menangani peristiwa click:

<!-- Global site tag (gtag.js) - Google Analytics -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-EXAMPLE"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'G-EXAMPLE', {
    transport_url: 'https://analytics.example.com',
  });

  function sendEvent() {
    gtag('event', 'click');
  }
</script>

<button onclick="javascript:sendEvent()">Send Event</button>

Ganti G-EXAMPLE dengan ID Google Analytics 4. Ganti https://analytics.example.com dengan URL penampung server Anda.

Dengan konfigurasi ini, pengendali peristiwa seperti fungsi sendEvent() yang disertakan dalam contoh ini akan mengirim peristiwa click ke penampung server Anda.

Klien Google Analytics 4

Penampung Anda memerlukan klien untuk menerima peristiwa setelah mencapai server. Untungnya, penampung server sudah diinstal dengan klien Google Analytics 4, sehingga Anda sudah menyelesaikan langkah ini.

Pemicu klik

Selanjutnya, buat pemicu yang diaktifkan di peristiwa click. Buat Pemicu Kustom yang diaktifkan saat variabel bawaan Nama Peristiwa sama dengan "klik".

konfigurasi pemicu

Tag Google Analytics 4

Terakhir, lampirkan tag GA4 ke pemicu. Sama seperti klien, penampung server dilengkapi dengan tag GA4. Cukup buat tag, konfigurasikan setelan, dan kini Anda telah menyiapkan penampung. Klien GA4 dan tag GA4 didesain untuk berfungsi bersama. Ini berarti Anda hanya perlu membuat tag GA4, dan konfigurasinya akan otomatis diambil dari peristiwa yang datang dari klien.

Melihat pratinjau penampung

Setelah penampung dikonfigurasi, klik Pratinjau. Buka situs Anda di jendela browser lain. Karena permintaan dan peristiwa dikirim ke penampung server, Anda akan melihat permintaan dan peristiwa yang tercantum di sebelah kiri halaman pratinjau.

Setelah Anda puas dengan perubahan yang dilakukan, publikasikan penampung server.

Mengonfigurasi server Anda untuk mode produksi dengan penayangan pihak pertama

Sebelum mengirim traffic produksi ke penampung server, sebaiknya instal server di domain pihak pertama dan upgrade server ke mode produksi.