Halaman ini diterjemahkan oleh Cloud Translation API.

Tracking Konversi

Implementasi

Ringkasan

Ada tiga bagian dalam penerapan tracking konversi:

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

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

Sebelum mulai menerapkan penerapan tracking konversi, Anda harus memutuskan apakah Anda 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 dia gunakan, menghapus penyimpanan/cookie lokal, 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/cookie lokal, atau menggunakan mode penjelajahan atau samaran pribadi, peristiwa konversi akan tetap diatribusikan setelah pengguna login kembali. Saat menggunakan tracking konversi tingkat pengguna, bergantung pada arsitektur sistem yang ada, Anda mungkin dapat menerapkannya sekali di sisi server, lalu menggunakannya kembali di semua platform yang didukung.

Mengumpulkan `rwg_token`

Setiap kali Google memunculkan action_link yang 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. Anda akan menyimpan token ini dan meneruskannya kembali sebagai bagian dari peristiwa konversi.

Di setiap titik entri aplikasi/halaman landing, 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 disertakan di bawah ini. 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`

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

Anda akan diminta untuk menyimpan parameter URL rwg_token, yang akan ditambahkan ke semua link tindakan yang Anda berikan, selama total 30 hari. Nilai rwg_token harus disimpan dan ditampilkan tanpa pengeditan apa pun. Jika ada token yang tersimpan dari kunjungan sebelumnya, token lama harus diganti, dan periode 30 hari untuk penyimpanan harus direset.

Jika token dipertahankan, Anda dapat menyimpan token 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 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 token ini di browser web melalui cookie pihak pertama. Contoh ini mengasumsikan bahwa Anda telah mengurai nilai token menjadi variabel seperti pada contoh di atas. Untuk menggunakan contoh ini, Anda harus memperbarui “rootdomain” ke domain Anda.

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

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

Mengirim Data Konversi

Setelah pengguna menyelesaikan transaksi yang disebabkan oleh 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>
}

Di lingkungan sandbox dan produksi, Anda akan diminta untuk memberikan rwg_token yang valid saat mengirim peristiwa konversi. Untuk tujuan pengujian di lingkungan sandbox, Anda dapat menggunakan token pengujian berikut.

ADQ7psRE9YyDSVR6YpfD-fYdxoFYVKS1xeTvXdSxqF8a3bnk0W62eMEnUjoNPwjhNHG0elwBnM1awTjr9vXET8yOowCeuODjwA==

Catatan: 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 tersebut.

Contoh lengkap tracking konversi tingkat perangkat (menggunakan cookie di perangkat pengguna) pada 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
    })
  });
}

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

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

Persyaratan Atribusi Konversi

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

Jendela atribusi ini berarti bahwa kita berharap peristiwa konversi akan dikirim dalam salah satu skenario berikut:

Pengguna mengikuti link tindakan tempat dan melakukan pemesanan di sesi yang sama
Pengguna mengikuti link tindakan tempat dan kemudian kembali dari saluran lain dalam periode 30 hari untuk melakukan pemesanan.
Pengguna mengikuti link tindakan tempat lalu melakukan pemesanan di toko yang berbeda, baik dalam sesi yang sama atau sesi yang berbeda dalam periode 30 hari.

Selain itu, kami memperkirakan peristiwa konversi akan 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 mempertahankan token), Anda harus 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 sebaiknya tidak 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.