Conversions API untuk Google Tag Manager (GTM) Sisi Server

Conversions API dirancang untuk membuat koneksi langsung antara data marketing Anda dan sistem, yang membantu mengoptimalkan penargetan iklan, menurunkan biaya per tindakan, dan mengukur hasilnya di seluruh teknologi Meta. Anda dapat mengonfigurasikan server yang Anda siapkan di Google Cloud Platform (GCP) atau penyedia layanan cloud lainnya untuk mengirim data web penting dan peristiwa offline melalui Conversions API. Dengan pengaturan ini, setelah Anda mengonfigurasi Tanda Web Google Analytics 4 (GA4), Anda bisa mengirimkan data ke server Anda sendiri yang di-hosting di Google Cloud Platform (GCP) dan pada akhirnya dikirim ke Meta melalui Conversions API.

Tanda Conversions API ditulis dan dikelola Meta berdasarkan Template Tag Khusus Google. Silakan hubungi Google jika Anda memiliki pertanyaan tentang menyiapkan produk Google atau dokumentasi developer Google.

Dokumen ini menguraikan hal-hal berikut:

• Prasyarat, termasuk cara membuat penampung server
• Cara mengonfigurasi penampung untuk mendukung penerapan Anda menggunakan Tag Web GA4
• Cara mengirim data dari situs web Anda ke server GCP Anda
• Cara membagikan data tersebut dengan Meta menggunakan Conversions API
• Pertanyaan umum

Prasyarat

Sebelum melanjutkan integrasi ini, kami merekomendasikan Anda untuk:

1. Mengenali integrasi Conversions API dan praktik terbaik untuk pengaturan
2. Mengenali Penandaan Sisi Server dan Template Tanda Khusus.

Jika sistem Anda menggunakan versi yang lebih lama dari GA4, Anda harus meningkatkan pengaturan pengelola tag yang ada untuk menggunakan GA4 sebelum melanjutkan dengan integrasi ini.

Integrasi

Membuat Penampung Server GTM

Anda akan perlu mengonfigurasi penampung server pada GCP dan penampung web:

• Kontainer web: Jika ini adalah pertama kalinya Anda menggunakan GTM, mulailah dengan menginstal kontainer web ke akun Anda. Pelajari selengkapnya di sini.
• Kontainer Server: Anda harus membuat kontainer server di Portal GTM Anda untuk menyiapkan URL server penandaan. Pelajari selengkapnya tentang langkah ini.

Menyiapkan kontainer server memerlukan konfigurasi server penandaan terlebih dahulu. Penerapan GCP default dapat diselesaikan saat menyiapkan kontainer server, lihat panduan berikut ini. Untuk provider cloud lainnya (contoh: AWS atau Microsoft Azure), lihat panduan pengaturan server manual.

Mengonfigurasi kontainer web dan kontainer server

1. Di penampung web Anda, buat artefak berikut:
   • Konfigurasi GA4 untuk mengonfigurasi URL server pemberian tanda.
   • Peristiwa GA4 untuk mengonfigurasi skema peristiwa yang akan disampaikan ke server.
2. Di penampung server Anda, buat artefak berikut:
   • Klien GA4, pendengar untuk peristiwa yang memicu peristiwa ke Meta.
   • Tanda Conversions API Meta, tag sisi server yang mengubah model peristiwa standar dari Klien GA4 menjadi skema peristiwa Conversions API dan mengirimkannya ke graph.facebook.com.

Langkah 1: Konfigurasi GA4 – Konfigurasikan URL Server Pemberian Tag

Konfigurasikan kontainer web Anda untuk mengirim data situs web Anda ke server penandaan yang dibuat. Pelajari selengkapnya tentang cara mengonfigurasi Google Analytics: Tanda Konfigurasi GA4.

• Jika Anda memilih Kirim ke kontainer server, atur URL Kontainer Server sebagai URL server penandaan.
• Jika Anda tidak memilih Kirim ke penampung server, di bawah Kolom untuk Ditetapkan, klik Tambahkan Baris dan atur:

  • Nama kolom: transport_url
  • Nilai kolom: URL server pemberian tanda

Anda dapat mengonfigurasi kolom tambahan untuk parameter lain yang ingin Anda kirim untuk semua peristiwa.

• Atur bendera first_party_collection ke true. Anda harus melakukan ini agar dapat meneruskan parameter user_data ke GTM Sisi Server. Di bawah Kolom untuk Ditetapkan, klik Tambahkan Baris dan atur:

  • Nama kolom: first_party_collection
  • Nilai kolom: true

Menggunakan Tag Konfigurasi GA4 yang Ada

Jika Konfigurasi GA4 Anda sudah siap, Anda dapat mengubahnya, atau membuat tag Konfigurasi tambahan untuk GTM Sisi Server.

Jika Anda menyiapkan GTM Sisi Server untuk pertama kalinya, menambahkan URL Penampung Server akan memulai pengiriman semua traffic Anda ke Penampung Server. Jika Anda ingin terus mengirimkan data ke GA4, Anda akan perlu menambahkan tag GA4 Sisi Server di Penampung Server Anda, memastikan ini terpicu pada semua peristiwa. Anda mungkin perlu membuat tag Peristiwa GA4 tambahan atau memodifikasi yang sudah ada untuk memastikan pemetaan lengkap ke peristiwa Meta Pixel.

Mengirim ID Browser Meta dan ID Klik Meta

Jika Anda telah menyiapkan domain khusus, dan domain server pemberian tag GTM Anda adalah pihak pertama, ID Browser Meta dan ID Klik Meta dikirim secara otomatis.

Jika Anda menggunakan domain default yang disediakan, atau melihat bahwa kolom ID Browser dan ID Klik tidak dikirim di Pengelola Peristiwa, Anda dapat mengonfigurasikan ini sebagai berikut:

• Arahkan ke bagian variabel, dan buat Variabel yang Ditentukan Pengguna baru untuk ID Browser Meta dan ID Klik Meta. Gunakan jenis variabel Cookie Pihak Pertama.

  • Untuk ID Browser Meta, atur Nama Cookie ke _fbp
  • Untuk ID Klik Meta, atur Nama Cookie ke _fbc
• Simpan variabel ini.
• Di tag Konfigurasi GA4, di bawah Kolom untuk Ditetapkan, klik Tambahkan Baris, dan atur:

  • Nama kolom: x-fb-ck-fbp
  • Nilai kolom: variabel ID Browser Meta Anda
• Tambahkan baris tambahan untuk ID Klik:
• Nama kolom: x-fb-ck-fbc
• Nilai kolom: variabel ID Klik Meta Anda

Buat Variabel Layer Data untuk parameter user_data setiap skema peristiwa umum GTM. Pelajari selengkapnya tentang menyiapkan variabel layer data. Contoh: untuk meneruskan alamat email ke GTM Sisi Server, buat variabel, (contoh: user_data_email_address) yang dapat dipetakan ke Nama Variabel Layer Data, eventModel.user_data.email_address.

Jika Anda tidak menggunakan layer data, konfigurasikan variabel untuk setiap parameter seperti yang ditunjukkan di bawah ini untuk digunakan. Daftar di bawah menunjukkan semua pemetaan untuk parameter user_data Meta dan GTM serta prioritas umum mereka dalam membantu meningkatkan Kualitas Pencocokan Peristiwa. Untuk mendapatkan hasil maksimal dari iklan Meta, sebaiknya gunakan praktik terbaik Conversions API saat Anda menyiapkan integrasi. Jika Anda telah menyiapkan Conversions API, kami merekomendasikan untuk mempertimbangkan praktik terbaik ini guna meningkatkan pengaturan yang ada. Praktik terbaik Conversions API dapat membantu meningkatkan kinerja iklan Anda dan menurunkan biaya per tindakan.

Langkah 2: Peristiwa GA4 – Konfigurasikan skema peristiwa yang akan disampaikan ke server

• Konfigurasikan kontainer web Anda untuk mengirim data situs web Anda ke server penandaan yang dibuat untuk menambahkan Google Analytics. Pelajari selengkapnya tentang cara mengonfigurasi Google Analytics: Tanda Konfigurasi GA4.

• Tambahkan Google Analytics: Tanda Peristiwa GA4 ke Workspace Anda dari Galeri Template:

  • Menyiapkan Nama Peristiwa untuk tanda. Anda bisa mengaturnya sebagai nilai statis atau mengonfigurasinya untuk dibaca dari variabel. Untuk peristiwa standar tertentu, kami akan memetakan peristiwa standar Google Analytics ke Meta yang setara. Untuk peristiwa ini, Anda dapat menggunakan nama peristiwa Google Analytics atau nama peristiwa Meta. Untuk semua peristiwa standar lainnya, gunakan nama peristiwa Meta. Untuk Peristiwa Khusus, gunakan nama Peristiwa Khusus. Pelajari selengkapnya. Pelajari selengkapnya.

• Di bagian Parameter Peristiwa:

  • Jika Anda menggunakan Meta Pixel, tambahkan parameter ID Peristiwa. Gunakan event_id sebagai nama parameter, dan variabel yang dibuat untuk ID peristiwa sebagai nilai parameter. Baca bagian Menghapus Duplikat untuk panduan cara membuat variabel ID Peristiwa, dan memodifikasi Meta Pixel.
  • Petakan masing-masing parameter yang ingin dikonfigurasi. Nama variabel akan dibaca dari peristiwa tersebut menggunakan skema peristiwa umum. Contoh: untuk menyiapkan email sebagai parameter peristiwa, Anda harus menetapkannya sebagai Nama Parameter: user_data.email_address dan menyiapkan Nilai sebagai nama variabel yang membaca email_address (didefinisikan sebelumnya di Bagian 1).
  • Untuk daftar lengkap, lihat bagian Parameter Data Khusus di bawah ini.

Langkah 3: Buat pendengar untuk peristiwa yang memicu peristiwa ke Meta

Setiap penampung sisi server GTM hadir dengan Klien GA4 standar untuk mendengarkan peristiwa yang dikonfigurasi dari Tag Web GA4. Klien GA4 mendengarkan rute /g/collect pada URL server pemberian tag Anda dan mengirim eventModel ke tag hilir. Jika Klien GA4 standar sudah terinstal di penampung server Anda di bawah bagian Klien, Anda dapat beralih ke Langkah 4.

Langkah 4: Buat Tanda Conversions API Meta, tanda sisi server yang mengonversi model peristiwa standar dari Klien GA4 ke skema peristiwa Conversions API dan mengirimkannya ke graph.facebook.com

Untuk mengirim peristiwa ke Conversions API, Anda perlu menginstal Tanda Conversions API Meta dari Galeri Template. Template tanda disebut Tanda Conversions API oleh facebookincubator. Tanda ini dapat disiapkan untuk terpicu ketika peristiwa diterima oleh Klien GA4 (di langkah sebelumnya) dan dikirim ke Conversions API. Untuk menginstal Tanda Conversions API Meta, Anda harus memiliki ID Pixel, token akses, dan menentukan sumber tindakan sebagai "situs web". Dengan menggunakan Conversions API, Anda setuju bahwa parameter action_source akurat sesuai pengetahuan Anda.

Menguji integrasi Anda

Kami merekomendasikan menggunakan mode pratinjau Google Tag Manager untuk menguji integrasi sebelum menerbitkan perubahan. Baik penampung web maupun penampung server memiliki mode pratinjau, dan Anda dapat menjalankan keduanya bersamaan.

Anda dapat memverifikasi bahwa peristiwa server Anda diterima seperti yang dimaksudkan dengan menggunakan fitur Uji Peristiwa di Pengelola Peristiwa. Untuk menemukan fitur ini, buka Pengelola Peristiwa > Sumber Data > Pixel Anda > Uji Peristiwa.

Fitur Uji Peristiwa membuat ID pengujian. Kirim ID sebagai parameter test_event_code di tanda Conversions API untuk mulai melihat aktivitas peristiwa muncul di jendela Uji Peristiwa. Pastikan untuk menghapus ini sebelum menerbitkan perubahan.

Fitur uji peristiwa memungkinkan Anda untuk melihat apakah peristiwa diterima dan dihapus duplikatnya dengan benar. Jika Anda tidak melihat peristiwa muncul setelah satu atau dua menit, periksa debugger sisi Server GTM untuk memastikan permintaan tersebut melalui:

1. Di debugger sisi Server, pilih peristiwa relevan yang ingin Anda periksa di menu sebelah kiri.
2. Konfirmasi tanda Anda ditampilkan di bawah bagian Tanda Terpicu. Jika demikian, Anda akan melihat Tag Conversions API - Berhasil atau Tag Conversions API - Gagal.
   • Tag Tidak Terpicu: Tinjau pemicu Tag Conversions API Anda dan pemicu peristiwa GA4 yang relevan di penampung web. Konfirmasikan bahwa Peristiwa GA4 telah terpicu di debugger web.
   • Tanda Terpicu: Berhasil: Klik tanda dan periksa Kode Peristiwa Uji sudah benar. Perbarui kode peristiwa uji jika diperlukan dan mulai ulang mode pratinjau.
   • Tag Terpicu: Gagal: Buka tab Permintaan, klik Permintaan berjalan terkirim ke https://graph.facebook.com. Tinjau Body Tanggapan di bagian bawah detail permintaan untuk melihat apa kesalahannya, dan perbarui integrasi Anda agar sesuai. Ingatlah untuk memulai ulang mode pratinjau setelah melakukan perubahan.

Setelah peristiwa ditampilkan, verifikasikan bahwa ID Peristiwa untuk setiap peristiwa dikirim dengan benar, dan semua kode pencocokan yang diharapkan dan parameter data khusus ditampilkan dengan benar. Fitur uji peristiwa akan menunjukkan kepada Anda apakah duplikat peristiwa dihapus dengan benar. Jika ID Peristiwa berbeda, pastikan tanda GA4 dan Meta Pixel diaktifkan pada pemicu yang sama, dan tinjau penerapan variabel ID Peristiwa Anda.

Menghapus Duplikat

Kami rekomendasikan Anda untuk menggunakan pengaturan peristiwa redundan dan membagikan peristiwa yang sama dari Conversions API dan Meta Pixel Anda. Pastikan bahwa kedua peristiwa menggunakan event_name yang identik serta event_id ataupun kombinasi external_id dan fbp disertakan.

Ini akan membantu Meta untuk menghapus duplikat peristiwa dan mengurangi pelaporan ganda untuk peristiwa yang identik. Pelajari selengkapnya tentang menghapus duplikat, saat diperlukan dan cara menyiapkannya. external_id dan fbp adalah solusi alternatif untuk menghapus duplikat dan membantu juga untuk meningkatkan kualitas pengaturan. Kami merekomendasikan untuk menyertakan tiga parameter ini jika memungkinkan.

GTM memiliki beragam cara untuk menyiapkan parameter dengan nilai yang sama di tanda browser dan tanda server. Salah satu cara adalah menggunakan peristiwa GA4 yang sama sebagai pemicu untuk memicu tanda Meta Pixel dan peristiwa server. Untuk mencapai ini:

• Gunakan pemicu yang sama untuk Tanda HTML Khusus Meta Pixel dan Tag Peristiwa GA4. Contoh: Anda bisa menetapkan syarat pemicu berdasarkan URL halaman konfirmasi pesanan.
• Gunakan event_id yang sama di kedua tanda:

  1. Atur ID unik dari Klien: Atur parameter khusus (x-fb-event_id) dari peristiwa gtag. Buat ID unik (per peristiwa) di situs web menggunakan metode JavaScript (atau menggunakan variabel JavaScript khusus Google Tag Manager) dan atur nilai dalam peristiwa sebagai:

  gtag('event', 'purchase', {
   'x-fb-event_id': generateEventId(),
  ...:...
  
   });

  Anda dapat membuat variabel yang mengarah ke JavaScript khusus yang ditunjukkan di atas. Setiap kali variabel tersebut dirujuk, JavaScript di bawah ini dimuat dalam baris:

  function() {
  var gtmData = window.google_tag_manager[{{Container ID}}].dataLayer.get('gtm');
  return gtmData.start + '.' + gtmData.uniqueEventId;
  }

  2. Buat dan kumpulkan Variabel Layer Data: Anda dapat membuat variabel Anda sendiri di penampung web untuk membaca nilai dari event_id. Anda dapat melakukan ini dengan membuat Variabel Layer Data baru, contoh: FBEventIdVar, dengan Nama Variabel Layer Data sebagai eventModel.event_id.
  3. Setelah variabel ditetapkan, Anda memiliki variabel untuk dimasukkan ke peristiwa web di tanda HTML khusus Anda, dan peristiwa server sebagai Parameter Peristiwa GA4 tambahan.
  4. Di Web, Anda dapat menyiapkan Tanda Meta di penampung web Google Tag Manager untuk membaca event_id dari variabel.

  fbq('track', Purchase, {..}, {eventID: FBEventIDVar });

  Konfigurasikan Peristiwa GA4 untuk mengirim parameter ekstra, bernama event_id, diatur ke variabel FBEventIdVar.

Parameter Data Khusus

Untuk mengirim data khusus, gunakan pemetaan di bawah ini dalam tanda Peristiwa GA4 Anda:

Mengirim Data dari Situs Web ke Server GCP Anda

Setelah mengonfigurasi penampung web dan penampung server, Anda dapat mengirim contoh peristiwa dari situs web Anda untuk memverifikasi peristiwa server. Contoh peristiwa di situs web Anda dengan parameter yang dikonfigurasi mungkin terlihat seperti ini

 gtag('event', 'purchase', 
  {
    'event_id': generateEventId(),
    'transaction_id': 't_12345',
    'currency': 'USD',
    'value': 1.23,
    user_data: {
      email_address: '<HASHED_DATA>',
      phone_number: '<HASHED_DATA>',
      address: {
        first_name: '<HASHED_DATA>',
        last_name: '<HASHED_DATA>',
        city: '<HASHED DATA>',
        region: '<HASHED_DATA>',
        postal_code: '<HASHED_DATA>',
        country: '<HASHED_DATA>'     
      },    
    },
    items: [
      {
        item_id: '1',
        item_name: 'foo',
        quantity: 5,
        price: 123.45,
        item_category: 'bar',
        item_brand: 'baz'     
      }
    ], 
  });      
     

Setelah peristiwa dipicu, Anda akan melihat permintaan yang dikirim ke misalnya: contoh tautan: www.analytics.example.com/g/collect, dengan parameter yang telah dikonfigurasi. Anda dapat menambahkan kode uji peristiwa ke Tanda Conversions API Meta untuk memverifikasi peristiwa yang dikirim ke Conversions API. Kode peristiwa uji seharusnya hanya digunakan untuk pengujian. Anda harus menghapusnya saat mengirim payload produksi Anda.

Setelah Anda menerbitkan perubahan Anda, gunakan halaman Memverifikasi pengaturan Anda di sini untuk memastikan bahwa peristiwa Anda dikirim dengan benar dengan memeriksa Memverifikasi Pengaturan - Conversions API berikut dan meninjau apakah integrasi kualitas memenuhi praktik terbaik kami.

Pertanyaan Umum

Apakah ada rencana untuk menambahkan kemampuan untuk mengirim parameter khusus? Jika ya, kapan ini akan tersedia?
J: Kami telah menambahkan pemetaan untuk sebagian besar parameter khusus standar Conversions API yang didukung dalam skema GTM. Kami juga telah menyediakan pemetaan khusus. Lihat di sini untuk selengkapnya.

Apakah server atau klaster tunggal dapat menjalankan beberapa kontainer?
J: Saat ini GTM hanya mendukung pemetaan 1:1. Baca rekomendasi tentang cara mengatur kontainer Anda.

Apakah GTM Sisi Server memerlukan tanda berbasis browser untuk memancarkan peristiwa?
J: Ya

Apakah mungkin GA4 tetap terpisah dari integrasi Sisi Server?
J: Agar integrasi GA4 dan GTM Sisi Server tetap terpisah, Anda dapat membuat ID Pengukuran tambahan di Google Analytics. Buat tanda Konfigurasi GA4 terpisah untuk GTM Sisi Server menggunakan ID Pengukuran ini, mengikuti langkah-langkah di atas. Dalam skenario ini, tanda Konfigurasi GA4 yang ada akan terus mengirimkan traffic GA melalui Kontainer Web, sedangkan tanda Konfigurasi baru akan mengirimkan data ke Kontainer Server. Buat tanda Peristiwa GA4 tambahan sesuai Langkah 2 untuk mengirim peristiwa sisi server, menggunakan tanda Konfigurasi baru

Apakah integrasi Conversions API GTM berfungsi dengan solusi hosting cloud selain GCP?
J: Integrasi Conversions API GTM seharusnya berfungsi dengan GCP atau platform lain yang Anda pilih. Baca selengkapnya di sini tentang penyediaan manual.

Pelajari Selengkapnya

• Conversions API
• Menghapus Duplikat untuk Peristiwa Meta Pixel dan Conversions API