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

Proses debug Mode Izin Tag Assistant

Artikel ini ditujukan untuk developer dan administrator situs yang menggunakan Mode Izin Google, baik secara langsung maupun melalui solusi pengelolaan izin, yang ingin memastikan mode tersebut berfungsi dengan benar. Tag Assistant dapat menunjukkan apakah dan bagaimana status izin ditetapkan dan diperbarui menggunakan hal berikut:

Tag Assistant adalah aplikasi web dengan ekstensi browser opsional yang direkomendasikan, yaitu Tag Assistant Companion. Tag Assistant memungkinkan Anda memeriksa:

  • Apakah status izin default yang benar ditetapkan untuk jenis izin yang berlaku, seperti ad_storage dan analytics_storage, sebelum tag apa pun diaktifkan. Setelan default yang relevan akan bergantung pada kebijakan organisasi.
  • Apakah status izin diperbarui dengan benar saat pengunjung memberikan atau menolak izin.
  • Jenis izin yang diperiksa oleh setiap tag.
  • Apakah jenis izin yang diperlukan diberikan saat setiap tag dipicu, dan apakah tag lulus pemeriksaan terkait izin tambahan yang diperlukan.

Untuk melakukan debug konfigurasi izin, luncurkan Tag Assistant, gunakan aplikasi ini untuk membuka sebuah halaman di situs Anda, dan lakukan tindakan sesuai perilaku pengunjung. Jalankan semua kemungkinan kasus penggunaan pengunjung, masing-masing dalam pengujian terpisah. Misalnya, menolak semua izin, memberikan semua izin, dan mencoba semua kemungkinan kombinasi. Anda mungkin juga perlu melakukan tindakan lainnya di halaman yang memicu semua tag dengan pemeriksaan izin. Setelah masing-masing pengujian, beralih ke jendela Tag Assistant.

Panel kiri Tag Assistant menampilkan peristiwa halaman. Yang terbaru akan ditampilkan di bagian atas. Untuk membuka:

  • Pilih peristiwa untuk melihat status dan konfigurasi izin pada saat itu.
  • Pilih tab Consent untuk melihat status izin berbagai jenis penyimpanan.
  • Pilih tab Tags (khusus penampung GTM) untuk melihat kapan tag diaktifkan dan kapan tag diblokir oleh status izin.

Contoh berikut menampilkan jendela Tag Assistant setelah menguji sebuah halaman. Jika peristiwa Consent dipilih, tab Consent akan menampilkan Event Consent State untuk ad_storage dan analytics_storage pada saat ini. Tabel Event Consent Configuration Status menampilkan adanya perintah izin default dan perintah update izin saat setiap peristiwa terjadi. Tabel ini dapat digunakan untuk memverifikasi bahwa status izin diperbarui dengan benar saat pengunjung memberikan atau menolak izin.

Status izin peristiwa

Saat Status Izin diperbarui, status Default dan Update akan menampilkan Detected:

Status izin diperbarui

Contoh TCF

Layar berikut menampilkan pesan TCF compatibility enabled. Pesan tersebut ditampilkan di bawah tabel Event Consent Configuration Status saat TCF digunakan untuk menetapkan Status Izin:

TCF compatibility enabled

Jika Tag Assistant mendeteksi error penerapan, error tersebut juga ditampilkan di bawah tabel Event Consent Configuration Status:

Error TCF

Tag Assistant akan melaporkan masalah yang paling umum terkait penetapan urutan dan waktu untuk konfigurasi izin:

Tab Consent di Tag Assistant akan kosong jika Mode Izin tidak diterapkan di halaman.

Status izin default harus ditetapkan di halaman sebelum tag atau kode lainnya mencoba menggunakan atau memperbarui izin. Jika terlambat ditetapkan, izin default mungkin tidak akan memberikan efek yang diharapkan.

Misalnya, dalam skenario berikut, Tag iklan telah membaca atau menulis cookie sebelum izin default ditetapkan:

  1. Pengunjung membuka halaman
  2. Tag iklan diaktifkan
  3. Izin default ditetapkan ke ditolak

Tag Assistant melaporkan error:

Error Tag Assistant

Untuk memperbaiki masalah ini saat:

  • Izin default ditetapkan dengan perintah izin gtag hard code di halaman: Pindahkan semua kode yang memanggil perintah default izin gtag ke posisi yang lebih tinggi di halaman, di atas cuplikan tag apa pun atau kode lain yang mungkin menggunakan izin. Jangan menetapkan status izin default secara asinkron.
  • Menggunakan Google Tag Manager: Jika status izin default ditetapkan oleh tag template, pastikan tag template yang menulis izin diaktifkan berdasarkan pemicu inisialisasi izin dan semua tag lainnya yang bergantung pada status izin diaktifkan berdasarkan pemicu setelah inisialisasi izin. Jika menggunakan tag HTML kustom di GTM untuk memanggil perintah izin gtag, Anda harus menggantinya dengan tag template yang menggunakan API template kustom untuk menetapkan status izin.