Tracking Konversi

Gambar 1: Ringkasan Tracking Konversi

Ringkasan

Tracking Konversi ditujukan untuk melacak konversi yang dimulai oleh Google melalui salah satu Integrasi Pusat Tindakan kami. Hal ini penting agar integrasi Anda tetap sehat, berjalan, dan dapat memengaruhi peringkat di halaman tertentu. Setiap kali Google menampilkan action_link, URL tersebut diubah untuk menyertakan parameter kueri unik: rwg_token. Terserah Anda untuk menyimpan token itu dan menampilkan nilai yang sesuai saat pengguna menyelesaikan pemesanan.

Untuk menyelesaikan integrasi, Anda harus menyelesaikan langkah-langkah berikut:

1. Kumpulkan dan Simpan rwg_token.
2. Mengumpulkan dan Menyimpan penjual.
3. Tampilkan nilai rwg_token dan merchant_change.
4. Menguji dan Memverifikasi Tracking Konversi.

Kumpulkan dan Simpan rwg_token.

Untuk menyelesaikan integrasi ini, Anda harus mengumpulkan dan menyimpan rwg_token untuk lebih banyak hingga 30 hari rujukan Google awal. Nilai rwg_token adalah string yang dienkode yang berisi beberapa metadata tentang link dan penjual yang membuat link tindakan tersebut. Perlu diperhatikan bahwa tidak ada data pengguna yang disimpan atau dienkripsi dalam token.

Pengumpulan Token

Saat pengguna diarahkan ke halaman pembuatan janji temu, masukkan parameter kueri baru rwg_token, akan ditambahkan ke URL yang diberikan. Di halaman pemesanan, Anda harus mengurai nilai. Contoh yang menunjukkan bagaimana token ini dapat diuraikan untuk pelacakan tingkat perangkat melalui browser disertakan.

var query = location.search.substring(1);
var params = query.split('&');
var rwgToken = undefined;
for (var i = 0; i < params.length; ++i) {
  var pair = params[i].split('=');
  if (pair[0] == 'rwg_token') {
    rwgToken = decodeURIComponent(pair[1]);
    break;
  }
}

Parameter kueri yang ditambahkan ke URL Anda akan menjadi token terenkripsi, lihat contoh rwg_token berikut. Gunakan token contoh ini untuk memastikan penguraian Anda token dengan benar, termasuk karakter khusus seperti "=". Hal berikut adalah contoh dari seperti apa token pada umumnya.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Penyimpanan Token

Saat menyimpan rwg_token, ada dua tingkat berbeda tempat Anda dapat menerapkan tracking konversi, yaitu tingkat perangkat dan tingkat pengguna. Anda dapat memutuskan tempat untuk menyimpan token, tetapi Anda harus menyimpan token selama 30 hari sejak rujukan awal.

Penting: Saat pengguna dirujuk ke halaman pembuatan janji temu Anda dari Google, jika ada token rwg_token yang ada dipertahankan dari kunjungan sebelumnya, token sebelumnya harus diganti, dan periode 30 hari untuk penyimpanan harus direset. Lihat Persyaratan Atribusi Konversi untuk mengetahui detail selengkapnya.

Contoh berikutnya adalah pelacakan konversi tingkat perangkat, yang menyimpan nilai ini di browser web menggunakan cookie pihak pertama. Contoh ini mengasumsikan bahwa Anda telah menguraikan token ke dalam variabel seperti dalam contoh Penyimpanan Token. Pastikan untuk mengupdate rootdomain.com dengan domain Anda.

if (typeof rwg_token !== 'undefined') {
  document.cookie =
  "_rwg_token=" + rwg_token + ";max-age=2592000;domain=rootdomain.com;path=/";
}

Pertimbangkan hal berikut saat memutuskan tempat untuk menyimpan rwg_token.

Penyimpanan Tingkat Perangkat

Tingkat perangkat mencakup penggunaan cookie browser, penyimpanan lokal, penyimpanan lokal aplikasi, atau metode lain yang dapat mempertahankan token selama periode atribusi 30 hari. Karena token akan disimpan secara lokal di perangkat pengguna, jika pengguna mengubah perangkat yang digunakan, menghapus penyimpanan lokal atau cookie, atau menggunakan penjelajahan pribadi atau mode Samaran, peristiwa konversi mungkin tidak diatribusikan dengan benar. Saat menggunakan tracking konversi tingkat perangkat, Anda harus menerapkannya kembali di setiap platform yang didukung (termasuk seluler).

Penyimpanan Tingkat Pengguna

Tingkat pengguna mencakup mempertahankannya di database aplikasi Anda, melalui sistem analisis sisi server atau sistem sisi server lainnya. Karena token akan disimpan di sisi server, jika pengguna mengubah perangkat yang mereka gunakan, membersihkan penyimpanan lokal atau cookie mereka, atau menggunakan mode penjelajahan atau mode samaran, peristiwa konversi masih diatribusikan sekali pengguna melakukan {i>login<i} kembali. Saat menggunakan tracking konversi tingkat pengguna, bergantung pada pada arsitektur sistem, Anda mungkin dapat menerapkannya sekali saja di server web dan menggunakannya kembali di semua platform yang didukung.

Setiap kali Google menampilkan action_link yang telah Anda berikan melalui Feed, URL tersebut diubah untuk menyertakan parameter kueri unik: rwg_token. Nilai rwg_token adalah string yang dienkode yang berisi beberapa metadata tentang link yang diklik pengguna, tetapi tidak ada data pengguna. Anda harus menyimpan token ini, dan meneruskannya kembali sebagai bagian dari peristiwa konversi.

Kumpulkan dan Simpan penjual.

Saat pengguna diarahkan ke halaman pembuatan janji temu, Anda harus menerapkan logika yang akan menemukan dan menangkap penjual tersebut. Biasanya, partner menambahkan metadata penjual atau merchant_id ke link tindakan mereka dan menggunakannya untuk mengidentifikasi serta menyimpan penjual. Sebaiknya simpan merchant_id (atau ID yang dipilih) bersama rwg_token sehingga saat pengguna mengonfirmasi pemesanan, Anda dapat merujuk ke penjual sebelum mengirim permintaan konversi yang telah selesai. Mirip dengan token penjual harus disimpan dengan token selama 30 hari sejak rujukan awal.

Contoh berikutnya menyesuaikan rwg_token yang disimpan sebelumnya. Hal ini mengasumsikan bahwa Anda memecah penjual dari metadata di URL yang diberikan dan menyimpannya sebagai merchant_id atau mencocokkannya dengan merchant_id yang ada.

if (typeof rwg_token !== 'undefined') {
  document.cookie =
  "_rwg_token=" + rwg_token + ";_merchant_id=" + merchantid + ";max-age=2592000;domain=rootdomain.com;path=/";
}

Menampilkan nilai rwg_token dan merchant_change.

Saat sebuah penggunaan menyelesaikan pemesanan yang dimulai dari rujukan Link Tindakan, Anda harus kirim permintaan HTTP POST ke endpoint konversi. Ada dua endpoint, satu untuk lingkungan produksi dan satu untuk lingkungan sandbox.

• Produksi: https://www.google.com/maps/conversion/collect
• Sandbox: https://www.google.com/maps/conversion/debug/collect

Saat mengirim peristiwa konversi, Anda harus menyertakan rwg_token dan nilai merchant_change sebesar 1 atau 2, detail selengkapnya di merchant_change lihat Mengembalikan Nilai Perubahan Penjual.

Isi POST harus berupa objek yang dienkode JSON dalam format:

{
  "conversion_partner_id": "<partnerId>",
  "rwg_token": "<rwg_token_val>",
  "merchant_changed": "1|2"
}

{
  "conversion_partner_id": "XXXXXXX",
  "rwg_token": "AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==",
  "merchant_changed": "2"
}

Contoh berikutnya mencakup tracking konversi tingkat perangkat yang menggunakan cookie di perangkat pengguna, ini ditulis dalam JavaScript:

const partnerId = XXXXXXXXXX;

const endpoint = `https://www.google.com/maps/conversion/collect`;

const rwgTokenCookie = document.cookie
  .split('; ')
  .find(row => row.startsWith('_rwg_token='));

if (typeof rwgTokenCookie !== 'undefined') {
  const rwgTokenVal = rwgTokenCookie.split('=')[1];
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: rwgTokenVal,
      merchant_changed: merchantChanged
    })
  });
}

Perhatian: Satu-satunya Jenis Konten MIME yang diterima adalah text/plain. Jangan setel Content-Type di header. Jika Anda melakukannya, Anda akan mendapatkan error CORS.

Peringatan: Pastikan Identifikasi Pribadi pengguna sebagai bagian dari data konversi Informasi (PII) tidak dikirim ke Google.

Catatan: Dalam produksi, Anda tidak boleh mengirim peristiwa konversi yang tidak yang diatribusikan ke integrasi ini. Praktik terbaiknya adalah untuk memeriksa nilai rwg_token yang belum habis masa berlakunya sebelum mengirim peristiwa.

Menampilkan Nilai Perubahan Penjual

Nilai merchant_changed digunakan untuk menentukan apakah penjual telah diubah dari penjual pengalihan awal. Mengubah penjual adalah hal biasa jika halaman landing berada dalam platform yang menyertakan penjual lain. Dalam hal ini, jika pengguna dirujuk ke platform Anda oleh Google dan memutuskan untuk membuka penjual lain dan menyelesaikan pemesanan, kami ingin mengetahui bahwa konversi terjadi, tetapi dengan penjual terpisah. Kami tidak perlu mengetahui penjual, hanya peristiwa konversi yang terjadi dan penjualnya berbeda. Kami menggunakan Boolean untuk mengidentifikasi apakah penjual telah berubah atau tidak.

Saat memutuskan nilai yang akan ditetapkan ke merchant_change, Anda harus mengambil penjual asli yang disimpan di Mengumpulkan dan Menyimpan Penjual dan memeriksa apakah penjual telah berubah, lalu lihat tabel berikut saat menetapkan nilai.

Jika halaman pemesanan Anda tidak berada dalam platform atau pengguna tidak dapat membuka penjual lain, Anda dapat melakukan hardcode nilai permintaan ini ke 2. Hal ini umum terjadi pada partner yang mengintegrasikan halaman pemesanan ke dalam situs penjual atau memiliki halaman landing kustom untuk memproses pemesanan.

Nilai Perubahan Penjual	Persyaratan
1	Nilai ini harus digunakan saat pengguna telah keluar dari situs penjual asli dan menyelesaikan pembelian melalui platform Anda dengan penjual lain
2	Nilai ini harus digunakan saat pelanggan menyelesaikan transaksi melalui Entitas asli (Penjual).

Menguji dan Memverifikasi Tracking Konversi.

Untuk memastikan penerapan tracking konversi Anda sudah benar, Anda harus menjalankan pengujian berikut. Pastikan untuk menggunakan Link Tindakan yang terkait dengan penjual dan permintaan dibuat di jendela pribadi atau samaran untuk memastikan token sebelumnya yang terkait dengan pengguna tersebut dihapus.

1. Selesaikan pemesanan hanya menggunakan Link Tindakan
   • Pemesanan langsung tanpa rujukan atau token tersimpan sebelumnya tidak akan dihasilkan dalam permintaan apa pun yang dikirim ke Google.
2. Selesaikan pemesanan menggunakan link dengan tambahan rwg_token.
   • Pastikan permintaan berhasil dan dikirim dengan rwg_token dan nilai merchant_change dari 2
   • Pastikan Anda menyimpan rwg_token selama 30 hari
3. Selesaikan pemesanan baru dengan penjual yang sama menggunakan rwg_token baru.
   • Pastikan permintaan berhasil dan dikirim dengan rwg_token yang baru dan Nilai merchant_change dari 2
   • Pastikan periode penyimpanan atribusi token diperbarui selama 30 hari
4. Buka langsung halaman pemesanan penjual yang telah Anda uji dan buat pemesanan baru tanpa rwg_token yang ditambahkan.
   • Pastikan permintaan dikirim dengan rwg_token yang disimpan sebelumnya dan nilai merchant_change adalah 2

Jika Anda adalah platform yang memungkinkan pengguna melakukan checkout menggunakan penjual yang berbeda, uji hal berikut.

1. Buka halaman pemesanan penjual menggunakan link dengan rwg_token yang ditambahkan. kemudian lanjutkan ke penjual lain dan lakukan pemesanan.
   • Pastikan permintaan dikirim dengan nilai rwg_token dan merchant_change 1

Saat menguji, kirim permintaan HTTP POST ke endpoint konversi. Ada dua endpoint, satu untuk lingkungan produksi dan satu untuk lingkungan sandbox.

• Produksi: https://www.google.com/maps/conversion/collect
• Sandbox: https://www.google.com/maps/conversion/debug/collect

Anda harus menambahkan token berikut ke link atau URL tindakan:

rwg_token=AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ%3D%3D

Gunakan token berikut untuk pengujian yang memerlukan token tambahan.

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

Setelah mengirim peristiwa konversi yang berhasil, Anda dapat melihat peristiwa tersebut digabungkan di Pusat Tindakan dalam Dasbor Tracking Konversi. Perhatikan bahwa konversi mungkin memerlukan waktu hingga satu jam untuk muncul di dasbor.

Persyaratan Atribusi Konversi

Standar yang diperlukan Google untuk atribusi konversi adalah periode atribusi 30 hari untuk setiap interaksi dengan link tempat, di toko mana pun.

Periode atribusi ini berarti Google memperkirakan peristiwa konversi dikirim dalam salah satu skenario berikut:

• Pengguna mengikuti link tindakan tempat dan melakukan pemesanan untuk penjual yang sama dalam sesi yang sama. (Nilai Perubahan Penjual = 2 )
• Pengguna mengikuti link tindakan tempat, lalu kembali dari saluran lain dalam periode 30 hari untuk melakukan pemesanan bagi penjual yang sama. (Nilai Perubahan Penjual = 2 )
• Pengguna mengikuti link tindakan tempat, lalu melakukan pemesanan di toko yang berbeda, baik dalam sesi yang sama maupun sesi yang berbeda dalam periode 30 hari. ( Nilai Perubahan Penjual = 1 )

Selain itu, Google mengharapkan peristiwa konversi dikirim dari semua platform yang dapat dituju pengguna dari link tindakan tempat. Termasuk:

• Aplikasi web desktop atau seluler
• Aplikasi seluler, baik melalui deep link aplikasi maupun intent aplikasi terdaftar untuk domain Anda

Jika token disimpan di tingkat pengguna (lihat mempertahankan token), Anda diharapkan memberikan atribusi lintas perangkat. Yaitu, pengguna yang mengikuti link tindakan dari desktop, lalu menyelesaikan transaksi di perangkat seluler (menggunakan akun pengguna yang sama), akan memicu peristiwa konversi.

Jika token disimpan secara eksklusif di tingkat perangkat, seperti di browser cookie, Anda tidak perlu menyediakan atribusi lintas perangkat. Dalam hal ini, setiap perangkat akan memiliki token terpisah yang dipertahankan jika pengguna telah mengikuti link tindakan di perangkat tersebut, dan setiap perangkat akan mengikuti aturan atribusi secara terpisah.

Catatan: Framework atribusi ini mungkin berbeda dengan cara sistem analisis Anda konversi atribut. Sistem ini dirancang untuk beroperasi secara independen dari tracking konversi apa pun yang Anda lakukan di sistem, dan tidak akan memengaruhi analisis internal Anda.