Siapkan mode pihak pertama

Dokumen ini ditujukan untuk pengguna yang ingin men-deploy tag Google dalam mode pihak pertama. Sebaiknya gunakan mode pihak pertama untuk konfigurasi tag yang paling andal.

Ringkasan

Catatan: Mode pihak pertama masih dalam versi beta. Menyiapkan mode pihak pertama dapat membantu penyiapan tag Anda berperforma lebih baik, sehingga menghasilkan pemulihan sinyal pengukuran yang hilang, dengan cara yang menjaga privasi. Jika ada pertanyaan atau masalah terkait penyiapan, hubungi kami di [e-mail].

Mode pihak pertama memungkinkan Anda men-deploy tag Google menggunakan infrastruktur pihak pertama Anda sendiri, yang dihosting di domain situs Anda (mis. example.com). Infrastruktur ini berada di antara situs Anda dan layanan Google, sehingga infrastruktur pihak pertama Anda menjadi satu-satunya teknologi untuk berinteraksi langsung dengan pengguna situs Anda. Mode pihak pertama menambahkan lapisan keamanan data dan mengaktifkan kontrol privasi data tambahan, seperti obfuscation IP penuh, tanpa mengurangi pengukuran Anda. Penyiapan dalam dokumentasi ini akan membantu Anda memulihkan sinyal pengukuran X% lebih banyak di situs Anda. Anda dapat menyiapkannya menggunakan Jaringan Penayangan Konten (CDN), load balancer, atau server web yang ada, untuk mengaktifkan mode pihak pertama.

Dalam penyiapan tag Google standar, halaman web Anda meminta tag Google dari domain Google (misalnya, www.googletagmanager.com). Saat diaktifkan, tag akan mengirimkan permintaan pengukuran langsung ke produk Google. Dalam mode pihak pertama, situs Anda memuat tag Google dari domain pihak pertama (mis. example.com). Saat diaktifkan, tag akan mengirimkan permintaan pengukuran ke domain pihak pertama Anda, tempat permintaan tersebut diteruskan ke produk Google yang relevan.

Anda akan menikmati pengukuran penuh saat beralih dari penyiapan tag Google standar ke konfigurasi mode pihak pertama.

Diagram ini mewakili alur informasi dalam mode pihak pertama:

Sebelum memulai

Panduan ini mengasumsikan bahwa situs Anda telah dikonfigurasi dengan:

• Tag Google atau Penampung Tag Manager
• Jaringan Penayangan Konten (CDN) atau load balancer yang dapat meneruskan permintaan ke endpoint eksternal

1. Pilih jalur penayangan tag

Anda harus mereservasi jalur di domain situs untuk menayangkan tag. Pastikan jalur ini belum digunakan di domain Anda.

Pilih jalur yang diinginkan untuk menyiapkan mode pihak pertama. Contoh jalur yang mungkin ingin Anda gunakan mencakup: /metrics, /securemetric, /analytics, atau sebaiknya string alfanumerik acak yang tidak digunakan di situs Anda.

Isi fitur berikut untuk mengisi contoh di seluruh dokumen ini.

Your domain: example.com
Google tag ID: GTM-123456
Tag serving path: /metrics

Perhatian: Penyiapan ini akan mengubah rute semua traffic dengan jalur yang dipilih. Agar tidak memengaruhi situs Anda, pilih jalur yang belum digunakan.

2. Lalu lintas rute

Bagian ini mengasumsikan bahwa situs Anda sudah menggunakan CDN atau load balancer yang mendukung pemilihan rute traffic berdasarkan jalur.

Google Cloud

Anda perlu menyiapkan backend baru yang mencari perkiraan lokasi geografis pengunjung situs, dan membuat aturan perutean di External Application LoadBalancer yang sudah ada.

Membuat backend baru

1. Buka load balancer GCP

2. Di load balancer, buka bagian Backend configuration. Buat layanan backend baru.

3. Konfigurasi layanan backend baru Anda dengan informasi geolokasi:

   • Tentukan nama, misalnya measurement-be-svc.
   • Tetapkan Backend type ke Internet network endpoint group.
   • Tetapkan Protocol ke HTTPS dan biarkan Timeout sebagai nilai yang telah diisi sebelumnya.
   • Di bagian Backends, klik menu drop-down Internet network endpoint group, lalu buat grup endpoint jaringan internet baru:
     • Tetapkan Network endpoint group type ke Internet NEG (Global,Regional).
     • Tetapkan Cakupan ke Global.
     • Tetapkan opsi Tambahkan-tayang ke Nama dan port domain yang sepenuhnya memenuhi syarat.
     • Setel Nama domain yang sepenuhnya memenuhi syarat (FQDN) ke GTM-123456.fps.goog.
     • Klik CREATE untuk membuat endpoint.
     • Tutup tab Network endpoint group untuk kembali ke tab New backend service.
   • Telusuri nama grup endpoint jaringan baru dan pilih.
   • Buka bagian Advanced configurations. Tambahkan header permintaan kustom berikut.

     Nama header	Nilai Header
     Host	GTM-123456.fps.goog
     X-Gclb-Country	{client_region}
     X-Gclb-Region	{client_region_subdivision}

   • Tinjau setelan lainnya. Cloud CDN maupun Cloud Armor tidak diperlukan untuk integrasi ini, sehingga Anda dapat menonaktifkan keduanya dengan aman.
   • Simpan layanan backend baru tersebut.

Mengonfigurasi aturan pemilihan rute

1. Di load balancer, buka bagian Routing rules.

2. Tambahkan aturan host dan jalur berikut:

   Host	Jalur	Backend
   *	/metrics/*	measurement-be-svc

3. Memperbarui konfigurasi load balancer.

4. Di browser, verifikasi penyiapan dengan membuka: https://example.com/metrics/healthy. Halaman harus memiliki teks ok. Pastikan informasi geografis disertakan dengan membuka: https://example.com/metrics/?validate_geo=healthy. Halaman harus memiliki teks ok.

Cloudflare

Untuk menayangkan tag dalam mode pihak pertama, Anda akan membuat entri CNAME untuk subdomain baru, membuat Aturan Origin untuk meneruskan permintaan, dan membuat Aturan Transformasi untuk menyertakan informasi geolokasi.

Buat entri CNAME

Catatan: Tag tidak akan menggunakan entri CNAME ini; Cloudflare menggunakannya untuk merutekan permintaan secara internal.

Pilih subdomain yang akan dicadangkan untuk entri CNAME. Isi fitur berikut untuk mengisi contoh di seluruh dokumen ini. CNAME ini tidak pernah terekspos di luar konfigurasi Cloudflare Anda, sehingga namanya bersifat arbitrer.

CNAME subdomain: fps

1. Di tab DNS, buka bagian Records.
2. Tambahkan kumpulan data baru dengan konfigurasi berikut:
   • Tetapkan Type ke CNAME.
   • Tetapkan Name ke fps.
   • Tetapkan Target ke GTM-123456.fps.goog.
3. Simpan data CNAME.

Membuat Aturan Origin

1. Di tab Rules, buka Origin Rules dan buat aturan.
2. Masukkan nama aturan, seperti Route measurement.
3. Cocokkan permintaan masuk berdasarkan Ekspresi filter kustom, lalu klik Edit ekspresi.
4. Tempelkan ekspresi berikut di builder: (http.host eq "example.com" and starts_with(http.request.uri.path, "/metrics"))
5. Update Host Header menjadi Rewrite to... GTM-123456.fps.goog.
6. Perbarui DNS Record menjadi Override to... fps.example.com.
7. Simpan Aturan Asal.
8. Jika ada Aturan Origin lainnya, tingkatkan posisi Aturan yang baru dibuat sehingga akan berjalan setelah jalur karakter pengganti lainnya.
9. Di browser, verifikasi penyiapan dengan membuka: https://example.com/metrics/healthy. Halaman seharusnya terbaca ok.

Sertakan informasi geolokasi

1. Di tab Rules, buka Transform Rules.
2. Buat aturan Ubah Header Permintaan.
3. Terapkan aturan ke Semua permintaan masuk.
4. Ubah header permintaan dengan konfigurasi berikut:
   • Tetapkan operator ke Tetapkan dinamis.
   • Tetapkan Header name ke X-CfIpCountryRegion.
   • Tetapkan Nilai ke ip.src.subdivision_1_iso_code.
5. Deploy Aturan Transformasi.
6. Tunggu beberapa menit agar aturan diterapkan. Di browser, verifikasi penyiapan dengan membuka: https://example.com/metrics/?validate_geo=healthy. Halaman akan terbaca ok.

(Opsional) Hapus header IP pengunjung

Mode pihak pertama tidak memerlukan IP pengunjung untuk beroperasi dengan benar. Anda dapat menghapus semua header IP pengunjung menggunakan opsi Menghapus header IP pengunjung Terkelola.

Lainnya

Untuk menayangkan tag dalam mode pihak pertama, Anda perlu mengonfigurasi CDN atau load balancer untuk merutekan permintaan ke endpoint mode pihak pertama.

1. Tambahkan origin atau backend yang mengarah ke GTM-123456.fps.goog.
2. Ganti header Host agar sama dengan GTM-123456.fps.goog. Izinkan semua cookie dan string kueri untuk diteruskan.
3. Tambahkan aturan jalur untuk /metrics/* guna merutekan traffic ke mode pihak pertama.
4. Konfigurasi jalur yang dicadangkan agar memiliki prioritas yang lebih tinggi daripada aturan default.
5. Di browser, verifikasi penyiapan dengan membuka: https://example.com/metrics/healthy. Halaman seharusnya terbaca ok.

Langkah 3: Perbarui skrip di situs untuk menggunakan Jalur Pengukuran

Ganti skrip di setiap halaman situs dengan salah satu skrip berikut:

gtag.js

Di bagian atas bagian <head>, temukan dua baris skrip dengan ID tag Google Anda:

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=GTM-123456"></script>

dan menggantinya dengan jalur pengukuran:

<!-- Google tag (gtag.js) -->
<script async src="/metrics/"></script>

gtm.js

Di bagian atas bagian <head>, ganti cuplikan Tag Manager dengan kode berikut:

<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'/metrics/?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','');</script>
<!-- End Google Tag Manager -->

Langkah 4: Menguji konfigurasi pengukuran

Untuk menguji penyiapan pengukuran, konfigurasi penampung Anda agar memiliki setidaknya satu tag yang diaktifkan.

1. Buka Tag Assistant dan lihat pratinjau penampung Anda. Jelajahi situs Anda untuk memicu tag.

2. Di tab Summary > Output > Hits Sent, pastikan hit tersebut dirutekan ke /metrics.

   

Langkah 5: Masukan

Berikan masukan tentang mode pihak pertama melalui formulir masukan.