Halaman ini diterjemahkan oleh Cloud Translation API.

Tracking Konversi

Penerapan

Ringkasan

Ada tiga bagian dalam penerapan tracking konversi:

Mengumpulkan rwg_token dari halaman landing / titik entri aplikasi.
Mempertahankan rwg_token untuk periode atribusi yang sesuai
Mengirim peristiwa konversi saat checkout

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

Sebelum mulai mengerjakan penerapan 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 selama periode atribusi 30 hari. Karena token akan disimpan secara lokal di perangkat pengguna, jika pengguna mengubah perangkat yang digunakan, menghapus penyimpanan atau cookie lokal, atau menggunakan mode samaran atau penjelajahan rahasia, peristiwa konversi mungkin tidak diatribusikan dengan benar. Saat menggunakan tracking konversi tingkat perangkat, Anda harus menerapkannya kembali di setiap platform yang didukung (termasuk perangkat seluler).
Level pengguna mencakup mempertahankan data tersebut dalam 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 atau cookie lokal, atau menggunakan penjelajahan pribadi atau mode samaran, peristiwa konversi masih dikaitkan 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 dimodifikasi untuk menyertakan parameter kueri unik: rwg_token. Nilai rwg_token adalah string dienkode yang berisi beberapa metadata tentang link yang diklik 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 dalam langkah, Mempertahankan rwg_token.

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

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

Mempertahankan rwg_token

Anda akan diminta untuk mempertahankan parameter URL rwg_token, yang akan ditambahkan ke semua link tindakan yang Anda sediakan, dengan 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 disimpan 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 di tingkat pengguna:

Tingkat perangkat mencakup penggunaan cookie browser, penyimpanan lokal, penyimpanan lokal aplikasi, atau metode lain yang dapat mempertahankan token selama periode atribusi 30 hari.
Level pengguna mencakup mempertahankan data tersebut dalam 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 mengurai nilai token menjadi variabel seperti dalam contoh di atas. Untuk menggunakan contoh ini, Anda harus mengupdate 'rootdomain' ke domain Anda.

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

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 dapat diatribusikan ke link Tindakan Tempat Google, 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

Isi postingan harus berupa objek yang dienkode JSON dalam format:

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

Nilai merchant_change digunakan untuk menentukan apakah penjual telah diubah dari penjual pengalihan awal atau tidak. Ada dua nilai yang dapat diteruskan

Nilai Perubahan Penjual	Persyaratan
1	Nilai ini harus digunakan jika 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 (Penjual) asli.

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:

ADQ7psRE9YyDSVR6YpfD-fYdxoFYVKS1xeTvXdSxqF8a3bnk0W62eMEnUjoNPwjhNHG0elwBnM1awTjr9vXET8yOowCeuODjwA==

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 terkait dengan pengguna (terlepas dari platform tempatnya berada) dari mekanisme penyimpanan sisi server dan mengirim token menggunakan endpoint produksi atau sandbox yang sama.

Persyaratan Atribusi Konversi

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

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

Pengguna mengikuti link tindakan tempat dan memesan 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 memesan penjual yang sama. ( Nilai Perubahan Penjual = 2 )
Pengguna mengikuti link tindakan tempat, lalu memesan di toko lain, baik dalam sesi yang sama maupun di sesi yang berbeda dalam periode 30 hari. ( Nilai Perubahan Penjual = 1 )

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

Aplikasi web desktop atau seluler
Aplikasi seluler, baik melalui deep link aplikasi atau maksud 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), harus memicu peristiwa konversi.

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