Tracking Konversi

Penerapan

Ringkasan

Ada tiga bagian dalam penerapan tracking konversi:

  • Mengumpulkan rwg_token dan merchant_id dari halaman landing / aplikasi titik entri.
  • Mempertahankan rwg_token dan merchant_id untuk atribusi yang sesuai jendela.
  • 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 Analytics atau JavaScript pihak ketiga lainnya.

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

  • Tingkat perangkat termasuk penggunaan cookie browser, penyimpanan lokal, lokal aplikasi penyimpanan, atau metode lain yang dapat mempertahankan token selama 30 hari periode atribusi. Karena token akan disimpan secara lokal di perangkat, jika pengguna mengubah perangkat yang mereka gunakan, akan menghapus penyimpanan atau cookie, ataupun 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 situs yang didukung platform (termasuk seluler).
  • Tingkat pengguna termasuk 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 mereka menggunakan, membersihkan penyimpanan lokal atau {i>cookie<i} mereka, atau menggunakan mode penjelajahan atau mode samaran, peristiwa konversi masih diatribusikan sekali pengguna melakukan {i>login<i} kembali. Saat menggunakan tracking konversi tingkat pengguna, bergantung pada pada arsitektur sistem, Anda mungkin dapat menerapkannya sekali saja di server web 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 diubah untuk menyertakan parameter kueri unik: rwg_token. Tujuan 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.

Pada setiap halaman landing / titik entri aplikasi, Anda harus mengurai nilai yang ditetapkan untuk rwg_token, lalu simpan. Persyaratan untuk menyimpan dijelaskan dalam 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 pada 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, saat halaman landing Anda harus menerapkan skrip khusus 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 ke suatu tempat sehingga dapat diandalkan yang mungkin menyiratkan perubahan backend.

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

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

Mempertahankan rwg_token dan merchant_id

Anda akan diminta untuk mempertahankan parameter URL rwg_token, yang akan menjadi ditambahkan ke semua link tindakan yang Anda berikan, 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 dipertahankan dari kunjungan sebelumnya, rwg_token dan merchant_id harus diganti, dan periode 30 hari untuk penyimpanan harus direset.

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

  • Tingkat perangkat termasuk penggunaan cookie browser, penyimpanan lokal, lokal aplikasi penyimpanan, atau metode lain yang dapat mempertahankan token selama 30 hari periode atribusi.
  • 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, yang menyimpan nilai tersebut di browser web menggunakan cookie pihak pertama. Contoh ini mengasumsikan bahwa Anda telah menguraikan token ke dalam variabel seperti dalam contoh di atas. Untuk menggunakan contoh ini, Anda harus memperbarui rootdomain.com untuk 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 seharusnya disimpan di server dan dikaitkan dengan pengguna.

Mengirim Data Konversi

Saat pengguna menyelesaikan transaksi yang dapat diatribusikan ke Google Place Action, Anda harus mengirim permintaan POST HTTP ke endpoint konversi. Ada dua endpoint, satu untuk lingkungan produksi dan satu untuk lingkungan sandbox{i> <i}ini.

  • 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 ketika 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).

Baik di lingkungan sandbox maupun 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==

Untuk melakukan pengujian di Sandbox, Anda harus menambahkan parameter URL berikut secara manual ke link Sandbox Anda:

rwg_token=AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ%3D%3D

Contoh lengkap tracking konversi tingkat perangkat (menggunakan cookie di perangkat) di javascript tentang cara membuat permintaan postingan ini disertakan 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,
      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 sistem produksi endpoint sandbox.

Persyaratan Atribusi Konversi

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

Periode atribusi ini berarti Google memperkirakan 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 pada penjual yang sama. (Penjual Perubahan Nilai = 2 )
  • Pengguna mengikuti link tindakan tempat, lalu memesan di tempat yang berbeda toko Anda, baik dalam sesi yang sama maupun sesi berbeda dalam waktu 30 hari jendela. ( Nilai Perubahan Penjual = 1 )

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

  • Aplikasi web desktop atau seluler
  • Aplikasi seluler, baik melalui deep link aplikasi atau aplikasi yang terdaftar untuk domain Anda

Jika token disimpan di tingkat pengguna (lihat di mana token disimpan), diharapkan Anda menyediakan atribusi lintas perangkat. Yaitu, 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 browser cookie, Anda tidak perlu menyediakan atribusi lintas perangkat. Di sini setiap perangkat akan memiliki token terpisah yang tetap bertahan jika pengguna telah mengikuti tautan tindakan pada perangkat tersebut, dan setiap perangkat akan mengikuti atribusi aturan secara terpisah.

Sebelumnya
Feed
Berikutnya
Peninjauan Integrasi