Tracking Konversi

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

Penerapan

Ringkasan

Ada tiga bagian dalam penerapan tracking konversi:

• Mengumpulkan rwg_token dan merchant_id dari titik entri halaman landing / aplikasi.
• Mempertahankan rwg_token dan merchant_id untuk periode atribusi yang sesuai.
• Bandingkan merchant_id dan merchant_id yang dipertahankan pada waktu konversi (pemesanan selesai).
• Mengirim peristiwa konversi pada waktu konversi (pemesanan selesai).

Penerapan tracking konversi ini tidak mengharuskan Anda menggunakan Google Analytics atau JavaScript pihak ketiga lainnya.

Poin Penting: Ada dua tingkat berbeda untuk menerapkan tracking konversi, yaitu tingkat perangkat dan tingkat pengguna. Keduanya didukung selama integrasi ini, dan Anda dapat memilih berdasarkan arsitektur produk.

Sebelum mulai menerapkan tracking konversi, Anda harus memutuskan apakah akan melacak konversi di tingkat perangkat atau tingkat pengguna:

• Tingkat perangkat mencakup penggunaan cookie browser, penyimpanan lokal, penyimpanan lokal aplikasi, atau metode lain yang dapat mempertahankan token untuk periode atribusi 30 hari. Karena token akan disimpan secara lokal di perangkat pengguna, jika pengguna mengubah perangkat yang mereka gunakan, menghapus penyimpanan lokal atau cookie mereka, atau menggunakan penjelajahan rahasia 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).
• 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, menghapus penyimpanan lokal atau cookie mereka, atau menggunakan mode penjelajahan atau samaran, peristiwa konversi masih 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.

Mengumpulkan rwg_token

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.

Di setiap halaman landing / titik entri aplikasi, Anda harus mengurai nilai yang ditetapkan untuk parameter kueri rwg_token dan menyimpannya. Persyaratan untuk menyimpan parameter ini dijelaskan pada langkah, Mempertahankan rwg_token.

Contoh cara mengurai token ini untuk pelacakan tingkat perangkat melalui browser disertakan di bawah. Atau, Anda dapat mengumpulkan token ini di sisi server saat merespons permintaan:

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;
  }
}

Mengumpulkan merchant_id

Jika Anda menerapkan logika tracking konversi di frontend, di halaman landing, Anda harus menerapkan skrip kustom yang akan menemukan dan mengambil merchant_id. Biasanya, merchant_id mungkin sudah ada di halaman landing atau di URL sehingga Anda dapat mengambilnya dari sana. Jika tidak, Anda harus menemukan cara untuk mengeksposnya di suatu tempat sehingga kamera tersebut memiliki kemampuan yang mungkin menyiratkan perubahan backend.

Jika menerapkan logika tracking konversi di backend, Anda mungkin menemukan merchant_id bersama data yang mengkueri sistem internal untuk membuat halaman frontend.

merchant_id ini harus sama dengan yang telah Anda bagikan ke Google di feed Anda.

Catatan: Dalam kasus jarang, pengalaman frontend Anda tidak mengizinkan pengguna untuk beralih antar-penjual (mungkin terjadi untuk situs white label yang tidak memiliki tombol "layar utama" untuk kembali ke penjual yang dipilih). Anda dapat melewati pengambilan merchant_id dan berasumsi bahwa merchant_id tidak berubah ("merchant_changed": 2) karena pengguna tidak mungkin beralih antar-penjual dalam perjalanan pemesanan.

Mempertahankan rwg_token dan merchant_id

Catatan: Mempertahankan rwg_token adalah kunci untuk menerapkan jendela atribusi yang diperlukan dengan benar. Untuk detail selengkapnya tentang persyaratan atribusi, lihat bagian Persyaratan Atribusi Konversi di bawah.

Anda akan diminta untuk mempertahankan parameter URL rwg_token, yang akan ditambahkan ke semua link tindakan yang Anda sediakan, selama total durasi 30 hari. Nilai rwg_token harus disimpan dan ditampilkan tanpa pengeditan apa pun.

Bersama dengan rwg_token, Anda harus menyimpan merchant_id yang terkait dengan link tindakan.

Jika ada token yang dipertahankan dari kunjungan sebelumnya, rwg_token dan merchant_id sebelumnya harus diganti, dan periode 30 hari untuk penyimpanan harus direset.

Jika mempertahankan pasangan di atas, Anda dapat menyimpan nilai di tingkat perangkat atau pada tingkat pengguna:

• Tingkat perangkat mencakup penggunaan cookie browser, penyimpanan lokal, penyimpanan lokal aplikasi, atau metode lain yang dapat mempertahankan token untuk periode atribusi 30 hari.
• Tingkat pengguna mencakup mempertahankannya di database aplikasi Anda, melalui sistem analisis sisi server atau sistem sisi server lainnya.

Berikut adalah contoh tracking konversi tingkat perangkat, yang menyimpan nilai ini di browser web menggunakan cookie pihak pertama. Contoh ini mengasumsikan bahwa Anda telah menguraikan nilai token menjadi variabel seperti pada contoh di atas. Untuk menggunakan contoh ini, Anda harus mengupdate rootdomain.com ke domain Anda.

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

Saat menggunakan tracking konversi tingkat pengguna, rwg_token + merchant_id harus disimpan di server dan dikaitkan dengan pengguna.

Mengirim Data Konversi

Saat pengguna menyelesaikan transaksi yang diatribusikan ke link Tindakan Tempat Google, Anda harus mengirim permintaan HTTP POST ke endpoint konversi. Ada dua endpoint, satu untuk lingkungan produksi dan satu lagi untuk lingkungan sandbox.

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

Isi postingan harus berupa objek yang dienkode JSON dalam format:

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

Contoh (penjual yang tidak berubah dengan token pengujian untuk partner 20123456):

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

Nilai merchant_changed digunakan untuk menentukan apakah penjual telah diubah dari penjual pengalihan awal. Ada dua nilai yang bisa diteruskan

Nilai Perubahan Penjual	Persyaratan
1	Nilai ini harus digunakan saat pengguna telah meninggalkan 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).

Di lingkungan sandbox dan produksi, Anda harus memberikan rwg_token yang valid saat mengirim peristiwa konversi. Untuk tujuan pengujian, gunakan token pengujian berikut di kedua lingkungan hingga Anda meluncurkannya:

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Perhatian: Dalam produksi, Anda tidak boleh mengirim peristiwa konversi yang tidak diatribusikan ke integrasi ini. Pastikan untuk memeriksa nilai rwg_token yang valid dan belum habis masa berlakunya sebelum mengirim peristiwa.

Contoh lengkap tracking konversi tingkat perangkat (menggunakan cookie di perangkat pengguna) dalam JavaScript tentang cara membuat permintaan postingan ini disertakan di bawah:

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
    })
  });
}

Saat menggunakan tracking konversi tingkat pengguna, Anda harus mengambil token yang dikaitkan dengan pengguna (terlepas dari platform tempat mereka berada) dari mekanisme penyimpanan sisi server dan mengirim token menggunakan endpoint sandbox atau produksi yang sama.

Catatan: Peristiwa konversi dapat dikirim dari klien web atau aplikasi, atau dari server. Anda dapat membuat keputusan ini sesuai dengan kebutuhan Anda dan sesuai dengan tempat token disimpan, selama peristiwa konversi dikirim tepat satu kali per konversi, dan menyertakan nilai rwg_token yang valid.

Persyaratan Atribusi Konversi

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

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

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

• Pengguna mengikuti link tindakan tempat dan melakukan pemesanan untuk penjual yang sama di sesi yang sama. (Nilai Perubahan Penjual = 2)
• Pengguna mengikuti link tindakan tempat, lalu kembali dari saluran lain dalam periode 30 hari untuk melakukan pemesanan oleh penjual yang sama. (Nilai Perubahan Penjual = 2)
• Pengguna mengikuti link tindakan tempat, lalu memesan di toko lain, 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 dikunjungi 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 cara 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 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.