Pelacakan Konversi

Gambar 1: Ringkasan Tracking Konversi

Ringkasan

Tracking Konversi dimaksudkan untuk melacak konversi yang dimulai oleh Google melalui salah satu Integrasi Action Center 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 akan diubah untuk menyertakan parameter kueri unik: rwg_token. Anda dapat menyimpan token tersebut dan menampilkan nilai yang sesuai saat pengguna menyelesaikan pemesanan.

Untuk menyelesaikan integrasi, Anda perlu menyelesaikan hal berikut:

1. Kumpulkan dan Simpan rwg_token.
2. Kumpulkan dan Simpan penjual.
3. Menampilkan 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 hingga 30 hari sejak rujukan Google awal. Nilai rwg_token adalah string yang dienkode yang berisi beberapa metadata tentang link dan penjual yang membuat link tindakan tersebut. Penting untuk diperhatikan bahwa tidak ada data pengguna yang disimpan atau dienkripsi dalam token.

Pengumpulan Token

Saat pengguna diarahkan ke halaman pemesanan Anda, parameter kueri baru, rwg_token, akan ditambahkan ke URL yang diberikan. Di halaman pemesanan, Anda harus mengurai nilai. Contoh cara 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 berupa token terenkripsi, lihat contoh rwg_token berikut. Gunakan token contoh ini untuk memastikan Anda mengurai token dengan benar, termasuk karakter khusus seperti "=". Berikut adalah contoh token standar.

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.

Contoh berikutnya adalah tracking konversi tingkat perangkat, yang menyimpan nilai ini di browser web menggunakan cookie pihak pertama. Contoh ini mengasumsikan bahwa Anda telah mengurai nilai token ke dalam variabel seperti dalam contoh Penyimpanan Token. Pastikan untuk memperbarui 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 penyimpanan 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 digunakan, menghapus penyimpanan lokal atau cookie, atau menggunakan mode penjelajahan pribadi atau mode Samaran, peristiwa konversi masih akan diatribusikan setelah pengguna login kembali. Saat menggunakan tracking konversi tingkat pengguna, bergantung pada arsitektur sistem, Anda mungkin dapat menerapkannya sekali di sisi server dan menggunakannya kembali di semua platform yang didukung.

Setiap kali Google menampilkan action_link yang telah Anda berikan melalui Feed, URL tersebut akan 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.

Memuatnya Ulang

Saat pengguna dirujuk oleh Google ke penjual yang sama, jika token yang ada disimpan, token tersebut akan diganti dengan token baru dari rujukan terbaru. Saat token diganti, periode penyimpanan token selama 30 hari akan direset dan setiap konversi baru untuk penjual ini harus diatribusikan ke token terbaru.

Lihat Persyaratan Atribusi Konversi untuk mengetahui detail selengkapnya.

Kumpulkan dan Simpan penjual.

Saat pengguna diarahkan ke halaman pemesanan, Anda harus menerapkan logika yang akan menemukan dan mengambil penjual. 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. Serupa dengan periode penyimpanan 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 pengguna menyelesaikan pemesanan yang dimulai dari rujukan Action Link, Anda harus mengirim permintaan POST HTTP 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 yang disimpan dan nilai merchant_change 1 atau 2. Untuk mengetahui detail selengkapnya tentang merchant_change, lihat Menampilkan 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 menggunakan cookie di perangkat pengguna, yang 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 menetapkan Content-Type lain di header. Jika Anda melakukannya, Anda akan mendapatkan error CORS.

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

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

Menampilkan Nilai Perubahan Penjual

Nilai merchant_changed digunakan untuk menentukan apakah penjual telah berubah dari penjual pengalihan awal. Mengubah penjual adalah hal yang umum jika halaman landing Anda 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 Action yang terikat dengan penjual Anda dan permintaan dibuat di jendela pribadi atau samaran untuk memastikan token sebelumnya yang terkait dengan pengguna tersebut dihapus.

1. Selesaikan pemesanan hanya menggunakan Link Action
   • Pemesanan langsung tanpa rujukan atau token yang disimpan sebelumnya tidak boleh menghasilkan permintaan apa pun yang dikirim ke Google.
2. Selesaikan pemesanan menggunakan link dengan rwg_token yang ditambahkan.
   • Pastikan permintaan berhasil dan dikirim dengan nilai rwg_token dan 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 nilai rwg_token dan merchant_change baru dari 2
   • Pastikan periode penyimpanan atribusi token diperbarui selama 30 hari
4. Buka langsung halaman pemesanan penjual yang telah Anda uji dan lakukan 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, lalu lanjutkan untuk membuka penjual lain dan melakukan pemesanan.
   • Pastikan permintaan dikirim dengan nilai rwg_token dan merchant_change dari 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 melihatnya digabungkan di Action Center pada bagian 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 akan mengharapkan 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. Artinya, 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 cookie browser, Anda tidak diharapkan untuk memberikan 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 mengatribusikan konversi. Sistem ini dirancang untuk beroperasi secara independen dari tracking konversi apa pun yang Anda lakukan di sistem, dan tidak akan memengaruhi analisis internal Anda.