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 Google Analytics atau JavaScript pihak ketiga lainnya.

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

Tingkat perangkat termasuk penggunaan cookie browser, data 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 mengubahnya perangkat yang mereka gunakan, menghapus cookie/penyimpanan lokal mereka, atau menggunakan penjelajahan rahasia atau mode samaran. Peristiwa konversi mungkin tidak diatribusikan dengan benar. Saat menggunakan level perangkat tracking konversi, Anda harus menerapkan kembali ini di setiap platform yang didukung (termasuk perangkat seluler).
Tingkat pengguna termasuk mempertahankannya di aplikasi Anda {i>database<i}, melalui sistem analitik sisi server atau {i>tool<i} sistem sisi server. Karena token akan disimpan di sisi server, jika pengguna mengubah perangkat yang mereka gunakan, menghapus penyimpanan/cookie lokal mereka, atau menggunakan mode samaran, peristiwa konversi tetap akan diatribusikan satu kali pengguna melakukan {i>login<i} kembali. Saat menggunakan tracking konversi tingkat pengguna, tergantung pada arsitektur sistem, Anda mungkin dapat menerapkan ini 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 Feed, URL tersebut akan diubah untuk menyertakan kueri unik parameter: rwg_token. rwg_token adalah string yang dienkode yang berisi beberapa metadata tentang tautan yang diklik pengguna. Anda akan menyimpan token ini, dan meneruskannya kembali sebagai sebagai bagian dari peristiwa konversi.

Di setiap halaman landing / titik entri aplikasi, Anda harus mengurai kumpulan nilai untuk parameter kueri rwg_token, lalu simpan. Persyaratan untuk penyimpanan parameter ini dijelaskan pada langkah, Mempertahankan rwg_token.

Contoh cara menguraikan token ini untuk pelacakan tingkat perangkat melalui browser disertakan di bawah ini. Atau, Anda bisa mengumpulkan token ini di sisi server ketika menanggapi 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 dengan benar menerapkan periode atribusi yang diperlukan. Untuk mengetahui 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, dengan jumlah total yang berdurasi 30 hari. Nilai rwg_token harus disimpan dan dikembalikan tanpa perlu diedit. Jika ada token yang dipertahankan dari kunjungan sebelumnya, token lama harus diganti, dan periode penyimpanan 30 hari harus direset.

Saat mempertahankan token, Anda dapat menyimpan token di di tingkat perangkat atau pengguna:

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

Berikut adalah contoh tracking konversi tingkat perangkat, menyimpan token ini di browser web melalui cookie pihak ketiga. Contoh ini mengasumsikan bahwa Anda telah menguraikan nilai token menjadi variabel seperti dalam 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 seharusnya disimpan di server dan dikaitkan dengan pengguna.

Mengirim Data Konversi

Saat pengguna menyelesaikan transaksi yang disebabkan oleh Google Place Action, Anda harus mengirim permintaan HTTP POST ke titik akhir konversi. Ada dua endpoint, satu untuk 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 berenkode json dalam format:

{
  'conversion_partner_id': partnerId,
  'rwg_token': <rwg_token_val>
}

Baik di lingkungan {i>sandbox<i} maupun di lingkungan produksi, Anda akan diminta untuk memberikan rwg_token yang valid saat mengirim peristiwa konversi. Untuk tujuan pengujian di lingkungan {i>sandbox<i}, Anda dapat menggunakan token pengujian.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

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

Contoh lengkap tracking konversi tingkat perangkat (menggunakan cookie di perangkat pengguna) di javascript tentang cara membuat permintaan postingan ini adalah termasuk di bawah ini:

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 dikaitkan dengan pengguna (terlepas dari platformnya aktif) dari mekanisme penyimpanan sisi server Anda dan mengirim 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 dan sesuai dengan tempat token disimpan, selama konversi dikirim tepat satu kali per konversi, dan menyertakan Nilai rwg_token.

Persyaratan Atribusi Konversi

Standar yang diwajibkan Google untuk atribusi konversi adalah 30 hari jendela atribusi untuk setiap interaksi dengan link tempat, kapan saja Anda.

Periode atribusi ini berarti kami memperkirakan konversi untuk dikirim dalam skenario berikut:

Pengguna mengikuti link tindakan tempat dan melakukan pemesanan di sesi yang sama
Pengguna mengikuti link tindakan tempat, lalu kembali dari saluran yang berbeda dalam jangka waktu 30 hari untuk melakukan pemesanan.
Pengguna mengikuti link tindakan tempat, lalu memesan di toko yang berbeda, baik dalam sesi yang sama maupun sesi dalam jangka waktu 30 hari.

Selain itu, kami memperkirakan peristiwa konversi akan dikirim dari semua platform tempat pengguna dapat diarahkan dari link tindakan tempat. Termasuk:

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

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

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