Konfigurasi domain kustom

Artikel ini ditujukan untuk developer yang ingin menghosting pemberian tag sisi server dalam konteks pihak pertama yang sama dengan situs mereka. Penayangan dari origin yang sama adalah praktik terbaik yang memungkinkan Anda memanfaatkan keunggulan keamanan dan ketahanan dari cookie yang ditetapkan server. Petunjuk di bawah berlaku untuk menyiapkan penayangan dengan origin yang sama, apa pun tag Google yang di-deploy di situs Anda (gtag.js atau gtm.js).

Saat Anda pertama kali menyiapkan server pemberian tag, server tersebut dihosting di domain yang disediakan oleh penyedia cloud. Saat Anda menggunakan endpoint default, endpoint tersebut akan mengirimkan data ke penampung server, tetapi berjalan dalam konteks pihak ketiga. Untuk mendapatkan manfaat dari konteks pihak pertama, seperti cookie yang lebih tahan lama, server pemberian tag dan situs Anda harus berjalan di domain yang sama.

Tabel di bawah ini mengilustrasikan cara menghosting server pemberian tag saat situs induk dihosting di www.example.com:

	Origin yang sama (praktik terbaik)	Subdomain	Domain default
Contoh URL	https://www.example.com/metrics	https://metrics.example.com	https://metrics.run.app
Akses cookie yang ditetapkan server	Akses penuh ke manfaat keamanan dan ketahanan.	Akses penuh ke manfaat keamanan dan ketahanan.	Tidak ada. Hanya dapat menetapkan cookie JavaScript.
Kompleksitas penyiapan	Konfigurasikan CDN atau load balancer untuk meneruskan permintaan. Mungkin perlu memperbarui entri DNS.	Memperbarui entri DNS.	Sudah dikonfigurasi sebelumnya.

Pilih opsi penerapan Anda untuk memulai.

Subdomain Sama asal

Prasyarat

Panduan ini mengasumsikan bahwa Anda telah:

• Menyiapkan penampung server di Tag Manager
• Menyiapkan server pemberian tag
• CDN atau load balancer yang dapat meneruskan permintaan.
• Jika Anda menggunakan App Engine: Server pemberian tag harus menjalankan versi 2.2.0 atau yang lebih baru. Untuk mempersiapkan server pemberian tag Anda di masa mendatang, bermigrasilah ke Cloud Run.

Mengonfigurasi domain kustom

Anda dapat menyiapkan penampung server untuk berjalan di jalur dari domain yang sama dengan situs Anda. Misalnya, jika situs Anda menyalurkan traffic web di www.example.com, lakukan reservasi jalur seperti www.example.com/metrics untuk penampung server Anda.

1. Memilih jalur domain yang akan digunakan untuk server pemberian tag

Jalur ini akan dicadangkan untuk implementasi penayangan pihak pertama ini. Pastikan Anda memilih jalur yang belum digunakan.

Contoh jalur yang mungkin ingin Anda gunakan meliputi: /collect, /metrics, /data

Perhatikan string jalur ini. Anda akan menggunakannya di seluruh langkah berikutnya sebagai pengganti /metrics di mana pun Anda melihat: /metrics

Perhatian: Metode penyiapan ini merutekan semua traffic yang diawali dengan jalur yang dipilih ke server pemberian tag. Pilih jalur yang tidak digunakan agar tidak memengaruhi traffic situs Anda. Jalur tidak boleh berisi /gtm.

2. Memilih rute traffic ke server pemberian tag Anda

Jika situs Anda sudah disiapkan dengan CDN atau load balancer yang mendukung pemilihan rute traffic berdasarkan jalur, lanjutkan ke langkah #4.

1. Tambahkan origin atau backend yang mengarah ke situs Anda.
2. Ganti header Host menjadi nama host situs, seperti example.com
3. Izinkan semua cookie dan string kueri untuk diteruskan. Jika opsi ini tidak ada, platform kemungkinan besar akan melakukannya secara default.
4. Tambahkan origin atau backend lain yang mengarah ke server pemberian tag Anda. Ini dapat berupa domain yang disediakan oleh penyedia cloud, seperti metrics.run.app
5. Ganti header Host agar sama dengan domain yang ditentukan di atas. Izinkan semua cookie dan string kueri untuk diteruskan.
6. Tambahkan aturan jalur, seperti /metrics/*, untuk memilih rute traffic ke server pemberian tag.
7. Konfigurasi jalur pemberian tag sisi server yang direservasi agar memiliki prioritas yang lebih tinggi daripada aturan default.
8. Perbarui DNS Anda agar mengarah ke CDN atau load balancer jika belum dilakukan. Mungkin perlu waktu beberapa saat untuk menerapkan pembaruan DNS.
9. Buka endpoint /healthy di domain yang baru saja Anda siapkan, seperti https://example.com/metrics/healthy. Anda akan melihat ok.

3. Memperbarui URL server di Google Tag Manager

Anda perlu mengupdate konfigurasi penampung server agar dapat mengidentifikasi awalan jalur dan memproses permintaan dengan benar.

Untuk mengupdate ke endpoint baru:

1. Buka Google Tag Manager
2. Buka penampung server yang disiapkan di origin yang sama dengan situs.
3. Di tab Admin > Setelan Penampung, hapus semua URL sebelumnya. Hal ini diperlukan karena semua URL penampung server harus memiliki jalur yang sama.
4. Klik Tambahkan URL dan masukkan URL Anda termasuk awalan jalur.
5. Simpan dan kembali ke ruang kerja Anda.
6. Klik tombol Pratinjau untuk memulai sesi debug baru dan mengirim permintaan di tab terpisah.
7. Klik permintaan yang dikirim. Pastikan klien Anda mengklaim permintaan masuk.

Memecahkan masalah umum

1. Pratinjau tidak menampilkan permintaan masuk
   1. Buka log explorer project cloud Anda. Pastikan deployment pemberian tag sisi server menerima traffic. Jika tidak, ikuti petunjuk di langkah 1.
   2. Pastikan CDN atau load balancer meneruskan cookie.
   3. Pastikan Anda memiliki satu server pratinjau dan server pemberian tag telah menetapkan PREVIEW_SERVER_URL.
   4. Pastikan server pratinjau berjalan dengan membuka PREVIEW_SERVER_URL + /healthy. Anda akan melihat ok.
2. Klien tidak mengklaim permintaan - Perbarui URL di Setelan Penampung untuk menggunakan jalur yang dicadangkan. Jika URL tidak berisi jalur atau jika berbeda, klien tidak akan berfungsi dengan benar.