Tag Floodlight Google

Artikel ini ditujukan untuk developer yang ingin memindahkan tag Floodlight dari penampung web Tag Manager ke penampung server.

Tag Manager sisi server memungkinkan Anda untuk memindahkan penjualan Floodlight Google dan tag penghitung dari halaman web ke server. Memindahkan kedua tag ini ke server akan mengurangi jumlah kode yang harus dijalankan di halaman, dan dapat membantu mempercepat waktu muat halaman.

Sebelum memulai

Sebelum Anda dapat memindahkan tag ke server, pastikan Anda telah:

• Memiliki akses admin ke Google Tag Manager dan Floodlight
• Menyiapkan dan menginstal Google Tag Manager
• Menyiapkan penampung server
• Menyiapkan klien Google Analytics: GA4

Langkah 1: Menyiapkan tag Conversion Linker

Akun Floodlight Anda hanya dapat mengirim data konversi ke Google Tag Manager jika Anda telah menyiapkan tag Conversion Linker.

Jika tag Conversion Linker sudah dikonfigurasi di penampung server, Anda dapat melewati langkah ini.

Untuk menyiapkan tag Conversion Linker:

1. Dari ruang kerja penampung server, buka menu Tag di sisi kiri halaman.
2. Klik Baru untuk menambahkan tag baru.
3. Pilih jenis tag Conversion Linker.
4. Siapkan pemicu yang akan menyebabkan tag sisi server Conversion Linker diaktifkan.
   Dalam sebagian besar kasus, pemicu Semua halaman adalah opsi terbaik.
5. Beri nama tag dan klik Simpan.

Langkah 2: Menyiapkan tag Floodlight

Google Tag Manager mendukung tag Penghitung Floodlight dan Penjualan Floodlight di penampung server.

Penghitung Floodlight

Untuk menyiapkan tag Penghitung Floodlight:

1. Di ruang kerja penampung server, pilih menu Tag di sisi kiri halaman.
2. Klik Baru untuk menambahkan tag baru.

3. Pilih jenis tag Penghitung Floodlight.

   

4. Untuk mengumpulkan nilai yang diperlukan konfigurasi tag, buka jendela browser lain lalu login ke Campaign Manager 360. Klik Pengiklan, lalu klik nama pengiklan. Masukkan nilai berikut di tag Penghitung Floodlight Tag Manager yang baru:

   • ID Pengiklan: ID Pengiklan akan muncul di halaman detail pengiklan tepat di bawah nama pengiklan. Nilai ini juga ditemukan sebagai nilai src= dalam cuplikan tag Floodlight yang dibuat.
   • String Tag Grup: Di tabel Aktivitas, identifikasi aktivitas yang ingin Anda gunakan dan temukan string tag grup yang tercantum di kolom sebelah kanan. Nilai ini juga ditemukan sebagai nilai type= dalam cuplikan tag Floodlight yang dibuat.
   • String Tag Aktivitas: Di tabel Aktivitas, identifikasi aktivitas yang ingin Anda gunakan dan temukan string tag aktivitas yang tercantum di kolom sebelah kanan. Nilai ini juga ditemukan sebagai nilai cat= dalam cuplikan tag Floodlight yang dibuat.

5. Tetapkan Metode Penghitungan yang diinginkan:

   • Standar: Menghitung setiap konversi.
   • Unik: Menghitung konversi pertama untuk setiap pengguna unik selama setiap 24 jam, dari tengah malam hingga tengah malam, Waktu Bagian Timur (AS).
   • Per sesi: Menghitung satu konversi per pengguna per sesi. Durasi sesi ditetapkan berdasarkan situs tempat tag Floodlight di-deploy.

6. Buka jendela Pilih pemicu.

7. Di menu Konfigurasi pemicu, pilih pemicu. Dalam sebagian besar kasus, Semua Halaman adalah opsi terbaik.

   

8. Masukkan nama tag dan klik Simpan.

   

Penjualan Floodlight

Untuk menyiapkan tag Penjualan Floodlight:

1. Di ruang kerja penampung server, pilih menu Tag di sisi kiri halaman.
2. Klik Baru untuk menambahkan tag baru.

3. Pilih jenis tag Penjualan Floodlight. Catatan: Tag Penjualan Floodlight secara otomatis mengumpulkan nilai berikut secara otomatis dari kolom e-commerce yang sesuai:

   *   Order ID (Transaction ID)
   *   Revenue (Value)
   

4. Untuk mengumpulkan nilai yang diperlukan konfigurasi tag, buka jendela browser lain lalu login ke Campaign Manager 360. Klik Pengiklan, lalu klik nama pengiklan. Masukkan nilai berikut di tag Penghitung Floodlight Tag Manager yang baru:

   • ID Pengiklan: ID Pengiklan akan muncul di halaman detail pengiklan tepat di bawah nama pengiklan. Nilai ini juga ditemukan sebagai nilai src= dalam cuplikan tag Floodlight yang dibuat.
   • String Tag Grup: Di tabel Aktivitas, identifikasi aktivitas yang ingin Anda gunakan dan temukan string tag grup yang tercantum di kolom sebelah kanan. Nilai ini juga ditemukan sebagai nilai type= dalam cuplikan tag Floodlight yang dibuat.
   • String Tag Aktivitas: Di tabel Aktivitas, identifikasi aktivitas yang ingin Anda gunakan dan temukan string tag aktivitas yang tercantum di kolom sebelah kanan. Nilai ini juga ditemukan sebagai nilai cat= dalam cuplikan tag Floodlight yang dibuat.

5. Tetapkan Metode Penghitungan yang diinginkan:

   • Standar: Menghitung setiap konversi.
   • Unik: Menghitung konversi pertama untuk setiap pengguna unik selama setiap 24 jam, dari tengah malam hingga tengah malam, Waktu Bagian Timur (AS).
   • Per sesi: Menghitung satu konversi per pengguna per sesi. Durasi sesi ditetapkan berdasarkan situs tempat tag Floodlight di-deploy.

6. Buka jendela Pilih pemicu.

7. Di menu Konfigurasi pemicu, pilih pemicu. Dalam sebagian besar kasus, Semua Halaman adalah opsi terbaik.

8. Masukkan nama tag dan klik Simpan.

Opsional: Menyiapkan Konversi yang Disempurnakan

Jika Anda menggunakan Konversi yang Disempurnakan, lanjutkan ke bagian Memvalidasi penyiapan.

Untuk mengonfigurasi Konversi yang Disempurnakan, ikuti langkah-langkah di bawah.

Menyiapkan variabel data yang disediakan pengguna

Ada 3 cara untuk menerapkan konversi yang disempurnakan di Tag Manager: Anda hanya perlu memilih satu opsi untuk mengumpulkan data yang disediakan pengguna.

	Pengumpulan otomatis	Konfigurasi manual	Konfigurasi kode
Metode pengumpulan	Secara otomatis mengumpulkan data yang disediakan pengguna berdasarkan kode situs Anda. Jika Anda perlu mengontrol tempat untuk mengumpulkan input, pilih konfigurasi kode atau manual.	Tentukan properti CSS atau variabel JavaScript tertentu untuk mengumpulkan data yang disediakan pengguna. Jika Anda perlu mengontrol pemformatan data dan hashing, pilih konfigurasi kode.	Tambahkan cuplikan kode di situs Anda yang mengirim data pelanggan yang telah di-hash untuk pencocokan. Metode ini adalah pilihan terbaik untuk memaksimalkan akurasi konversi yang disempurnakan dengan memungkinkan Anda mengirim data yang diformat secara konsisten setiap kali tag konversi diaktifkan.
Kompleksitas	Sederhana	Sedang	Rumit
Keahlian	Tidak memerlukan keahlian khusus	HTML dan CSS	Pengembangan web

Pengumpulan otomatis

1. Di penampung web Anda, buka menu Variabel.
2. Buat Variabel Buatan Pengguna baru dengan jenis Data yang Disediakan Pengguna.
3. Tetapkan Jenis ke Pengumpulan otomatis.
4. Beri variabel nama, misalnya, My user-defined data.
5. Klik Simpan.

Konfigurasi manual

1. Di penampung web Anda, buka menu Variabel.
2. Buat Variabel Buatan Pengguna baru dengan jenis Data yang Disediakan Pengguna.
3. Tetapkan Jenis ke Konfigurasi manual.

4. Untuk kolom data pengguna yang relevan yang ingin Anda berikan melalui konversi yang disempurnakan, tambahkan variabel baru atau yang sudah ada.

   Catatan: Jika sudah memiliki variabel di lapisan data (baik menggunakan pemilih CSS maupun jenis variabel lainnya), Anda dapat memilih variabel tersebut daripada membuat variabel baru. Jika Anda tidak yakin, lanjutkan membaca petunjuk ini: Variabel mungkin akan di-hash atau tidak di-hash.

5. Untuk menentukan elemen dari DOM, buat Variabel Baru > Konfigurasi Variabel > Elemen DOM.

6. Di bagian Metode Pemilihan, Anda dapat menggunakan Pemilih CSS atau ID. Tips: Jika variabel CSS Anda sering berubah, tambahkan ID HTML ke situs Anda dan gunakan variabel ID.

7. Masukkan nama ID atau pemilih CSS. Anda dapat mengosongkan kolom Nama atribut.

8. Beri nama dan Simpan variabel Elemen DOM. Layar Anda kemudian akan kembali ke setelan Data yang Disediakan Pengguna.

9. Beri nama variabel Data yang Disediakan Pengguna, misalnya, My user-defined data.

10. Klik Simpan.

Konfigurasi kode

Langkah 1: Mengidentifikasi dan menentukan variabel konversi yang disempurnakan

Anda dapat mengirim data tanpa hash, yang akan di-hash oleh Google sebelum diterima server, atau data yang telah di-hash. Jika Anda memutuskan untuk mengirim data yang telah di-hash, enkode data tersebut menggunakan SHA256 berenkode heksadesimal. Baik untuk data tanpa hash maupun yang telah di-hash, berikan minimal salah satu kolom berikut: email atau phone_number.
Untuk mengirim data tanpa hash ke lapisan data:

1. Di situs Anda, simpan data yang disediakan pengguna sebagai pasangan nilai kunci dalam variabel JavaScript. Contoh:

   var leadsUserData = {
     'email': '[e-mail]',
     'phone_number': '[phone]',
     'address': {
       first_name: 'John',
       last_name: 'Doe',
       street: '123 Lemon',
       city: 'Some city',
       region: 'CA',
       country: 'US',
       postal_code: '12345',
     },
   };
   

2. Kirim data pengguna bersama peristiwa menggunakan dataLayer.push(). Misalnya:

   <script>
     dataLayer.push({
       'event': 'formSubmitted',
       'leadsUserData': {
         'email': '[e-mail]',
         'phone_number': '[phone]',
         'address': {
            first_name: 'John',
            last_name: 'Doe',
            street: '123 Lemon',
            city: 'Some city',
            region: 'CA',
            country: 'US',
           postal_code: '12345',
          },
        },
     });
   <script>
   

Variabel leadsUserData kini tersedia di Google Tag Manager.

Untuk mengirim data yang telah di-hash ke lapisan data:

1. Di situs Anda, lakukan hashing terhadap data yang disediakan pengguna menggunakan SHA256 berenkode heksadesimal. Kunci untuk data yang dienkode tersebut harus diawali dengan sha256_. Contoh:

   {'sha256_email_address':await hashEmail(email.trim()),
   }
   

2. Kirim data pengguna bersama peristiwa menggunakan dataLayer.push(). Contoh di bawah menunjukkan penerapan lapisan data dengan asumsi bahwa Anda telah menulis fungsi hashing sendiri, yang dijalankan secara asinkron.

   <script>
     dataLayer.push({
       'event': 'formSubmitted',
       'leadsUserData': {
         'sha256_email_address': await hashEmail(email.trim()),
         'sha256_phone_number': await hashPhoneNumber(phoneNumber),
         'address': {
           sha265_first_name: await hashString(firstname),
           sha256_last_name: await hashString(lastname),
           sha256_street: await hashString(streetAddress),
           postal_code: '12345',
          },
        },
     });
   <script>
   

Variabel leadsUserData kini tersedia di Google Tag Manager.

Langkah 2: Membuat variabel data yang disediakan pengguna

1. Di penampung web Anda, buka menu Variabel.
2. Buat Variabel Buatan Pengguna baru dengan jenis Data yang Disediakan Pengguna.
3. Tetapkan Jenis ke Kode.
4. Untuk kolom data pengguna yang relevan yang ingin Anda berikan, klik menu drop-down lalu pilih Variabel Baru.
5. Di bagian Pilih Jenis Variabel, pilih Variabel Lapisan Data.
6. Di Variabel Lapisan Data, rujuk ke data pengguna yang tersimpan. Misalnya leadsUserData.
7. Beri nama dan Simpan variabel Lapisan Data. Layar Anda kemudian akan kembali ke setelan Data yang Disediakan Pengguna.
8. Beri nama variabel Data yang Disediakan Pengguna, misalnya, My user-defined data.
9. Klik Simpan.

Menetapkan variabel ke tag Google

1. Di penampung web Anda, buka menu Tag.
2. Edit Tag Google yang Anda gunakan untuk mengirim data ke server pemberian tag.
3. Di bagian Setelan konfigurasi, tambahkan Parameter konfigurasi baru yang disebut user_data. Tetapkan Nilai ke variabel Data yang disediakan pengguna, misalnya, {{My user-provided data}}.

4. Simpan perubahan Anda. Tag Anda harus terlihat seperti ini:

   

Mengonfigurasi tag Floodlight sisi server

Di penampung server Anda, aktifkan Konversi yang Disempurnakan dengan menyiapkan Tag Penjualan Floodlight atau Penghitung Floodlight.

Catatan: Tag Floodlight, saat diaktifkan, akan mengirim semua konversi yang tersedia ke Google (termasuk data yang disediakan pengguna). Jika Anda ingin memodifikasi atau kecualikan parameter peristiwa apa pun sebelum tag diaktifkan, konfigurasi, dan gunakan parameter transformasi dan melampirkannya ke tag Anda.

Opsional: Nilai Pendapatan

Tag Penjualan Floodlight menggunakan parameter value peristiwa sebagai jumlah default untuk menghitung pendapatan. Guna menentukan basis yang berbeda untuk menghitung nilai pendapatan, Anda perlu menyiapkan variabel untuk mengambil data dari database Anda dan menetapkannya ke tag Penjualan Floodlight.

Catatan: Penampung server mengenkripsi nilai pendapatan untuk memastikan data konversi tidak terekspos saat server mengirim data kembali ke browser.

Untuk membuat variabel baru:

1. Di penampung server Anda, buka menu Variabel.
2. Buat variabel buatan pengguna yang baru untuk input data. Misalnya, jika Anda ingin menggunakan nilai dari database Firestore, buat variabel {{Firestore Lookup}}.
3. Tentukan sumber data untuk variabel tersebut.
4. Beri nama variabel tersebut, misalnya, "Profit lookup" lalu Simpan.

Untuk menggunakan variabel tersebut di tag Penjualan Floodlight:

1. Di penampung server Anda, buka menu Tag.
2. Edit tag Penjualan Floodlight.

3. Di bagian Parameter Unik:

   • Untuk Sumber Data, pilih Konfigurasi kustom.
   • Untuk Pendapatan, pilih variabel yang telah Anda buat sebelumnya.
   • Untuk ID Pesanan, masukkan ID atau gunakan variabel untuk mengisi ID pesanan secara dinamis.

   

4. Simpan tag.

Opsional: Parameter kustom

Anda dapat meneruskan kolom kustom dari halaman web Anda ke Google Marketing Platform, seperti match_id.

Google Tag Manager

Guna mengonfigurasi kolom kustom untuk Floodlight, tambahkan awalan x-dc- ke nama parameter:

1. Di penampung web Anda, buka menu Tag.
2. Edit tag Peristiwa GA4 atau buat yang baru.

3. Di bagian Parameter Peristiwa, tambahkan nama parameter. Untuk menunjukkan bahwa parameter tersebut akan dikirim ke Floodlight, berikan awalan x-dc- ke namanya. Misalnya, jika Anda biasanya mengirim match_id, ubah menjadi x-dc-match_id.

   

4. Simpan tag.

gtag.js

Guna mengonfigurasi kolom kustom untuk Floodlight, tambahkan awalan x-dc- ke nama parameter peristiwa:

  gtag('event', 'purchase', {
      'x-dc-match_id': [MATCH_ID],
      ...
  })

Langkah 3: Memvalidasi penyiapan

Setelah Anda mulai mengirim data dengan penampung server, Anda dapat memeriksa apakah data berfungsi dengan benar dengan mengikuti langkah-langkah berikut:

1. Buka situs Anda.
2. Di penampung server Google Tag Manager Anda, pilih Pratinjau. Tag Assistant akan dimulai dan memuat penampung server Anda.
3. Tab Tag menampilkan semua tag yang telah diaktifkan. Pastikan untuk memeriksa apakah tag yang Anda konfigurasi telah aktif.
4. Tab Konsol menampilkan error yang terjadi selama transmisi data ke penampung server. Periksa apakah ada error dan atasi error tersebut.

Untuk mendapatkan bantuan lebih lanjut terkait proses debug penampung Tag Manager, lihat pratinjau dan bantuan debug.

Langkah berikutnya

Setelah tag Floodlight berfungsi sebagaimana mestinya, Anda dapat menghapus tag Floodlight yang setara di penampung web untuk menghindari duplikasi data.