Pelacakan Konversi

Gambar 1. Ringkasan tracking konversi

Ringkasan

Tracking konversi terus melacak konversi yang dimulai oleh Google melalui salah satu integrasi Action Center kami. Anda harus memastikan integrasi Anda tetap berjalan dengan baik, karena hal ini dapat memengaruhi peringkat di halaman tertentu. Setiap kali Google membuat action_link, URL tertentu akan diubah untuk menyertakan parameter kueri unik: rwg_token. Anda dapat menyimpan token dan menampilkan nilai yang sesuai saat pengguna menyelesaikan pemesanan.

Untuk menyelesaikan integrasi, ikuti langkah-langkah berikut:

1. Mengurai dan menyimpan rwg_token.
2. Mengurai dan menyimpan informasi penjual.
3. Menampilkan nilai rwg_token dan merchant_changed.
4. Uji dan verifikasi tracking konversi.

Mengurai dan Menyimpan rwg_token

Untuk menyelesaikan integrasi, Anda perlu mengumpulkan dan menyimpan rwg_token hingga 30 hari sejak rujukan Google awal. Nilai rwg_token adalah string yang dienkode, yang berisi metadata tentang link dan informasi penjual yang menghasilkan action_link tersebut.

Penting: Tidak ada data pengguna yang disimpan atau dienkripsi dalam token.

Mengurai Token

Saat pengguna diarahkan ke halaman pemesanan Anda, rwg_token baru akan ditambahkan ke URL yang diberikan. Di halaman pemesanan, Anda perlu mengurai nilai token.

Contoh berikut menunjukkan cara rwg_token diuraikan untuk pelacakan tingkat perangkat melalui browser.

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

Token yang ditambahkan ke URL Anda dienkripsi, lihat contoh rwg_token berikut. Gunakan token contoh ini untuk memastikan Anda mengurai token dengan benar, beserta karakter khusus seperti =.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Menyimpan Token

Saat menyimpan rwg_token, Anda dapat menerapkan tracking konversi di dua level yang berbeda:

• Tingkat perangkat
• Tingkat pengguna

Anda dapat menyimpan token di tingkat mana pun, tetapi Anda harus menyimpan token selama 30 hari setelah rujukan awal.

Contoh berikut menunjukkan pelacakan konversi tingkat perangkat. Anda dapat menyimpan nilai token di browser dengan cookie pihak pertama. Contoh ini mengasumsikan bahwa Anda mengurai nilai token menjadi variabel. Pastikan untuk memperbarui rootdomain.com dengan domain Anda.

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

Setiap kali Google membuat action_link yang telah Anda berikan melalui feed, URL akan diubah untuk menyertakan parameter kueri unik: rwg_token. Anda harus menyimpan token ini, dan meneruskannya kembali sebagai bagian dari peristiwa konversi.

Menyimpan di Tingkat Perangkat

Tingkat perangkat mencakup penggunaan cookie browser, penyimpanan lokal, penyimpanan lokal aplikasi, atau metode lain yang dapat mempertahankan token selama periode atribusi 30 hari. Token disimpan secara lokal di perangkat pengguna. Jadi, peristiwa konversi tidak dapat diatribusikan dengan benar, jika pengguna:

• Mengubah perangkat yang digunakan.
• Menghapus penyimpanan lokal atau cookie.
• Menggunakan browser pribadi atau samaran.

Saat menggunakan tracking konversi tingkat perangkat, Anda perlu menerapkan ulang peristiwa konversi di setiap perangkat yang didukung, termasuk perangkat seluler.

Simpan di Tingkat Pengguna

Tingkat pengguna mempertahankan token di database aplikasi Anda, melalui sistem analisis sisi server atau sistem sisi server lainnya. Token disimpan di sisi server. Jadi, peristiwa konversi masih diatribusikan dengan benar setelah pengguna login kembali.

Saat menggunakan tracking konversi tingkat pengguna berdasarkan arsitektur sistem, Anda dapat menerapkan peristiwa konversi sekali di sisi server dan menggunakannya kembali di semua perangkat yang didukung.

Catatan: Anda dapat menentukan tempat penyimpanan rwg_token berdasarkan kebutuhan Anda.

Memuatnya Ulang

Saat Google merujuk pengguna ke penjual yang sama, token yang sudah ada dan sudah disimpan akan diganti dengan token baru dari rujukan terbaru. Setelah penggantian token, periode atribusi 30 hari untuk penyimpanan token akan direset dan konversi baru untuk penjual ini akan diatribusikan ke token terbaru.

Lihat Persyaratan untuk Atribusi Konversi untuk mengetahui detail selengkapnya.

Mengurai dan Menyimpan Informasi Penjual

Saat pengguna diarahkan ke halaman pemesanan, Anda perlu menerapkan logika yang dapat menemukan dan mengambil detail penjual. Biasanya, partner menambahkan metadata atau merchant_id penjual ke link tindakan mereka dan menggunakannya untuk mengidentifikasi serta menyimpan informasi penjual.

Sebaiknya simpan merchant_id atau ID yang dipilih bersama rwg_token. Saat pengguna mengonfirmasi pemesanan, Anda dapat merujuk ke penjual sebelum mengirim permintaan konversi lengkap. Serupa dengan penyimpanan token, Anda harus menyimpan detail penjual dengan token selama 30 hari setelah rujukan awal.

Contoh berikut mengubah rwg_token yang disimpan sebelumnya. Ini mengasumsikan bahwa Anda mengurai informasi penjual dari metadata di URL yang diberikan dan menyimpannya sebagai merchant_id atau mencocokkannya dengan merchant_id yang ada.

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

Menampilkan Nilai rwg_token dan merchant_changed

Saat pengguna menyelesaikan pemesanan yang dimulai dari rujukan action_link, Anda harus mengirim permintaan POST HTTP ke endpoint konversi. Ada dua endpoint:

• Lingkungan produksi: https://www.google.com/maps/conversion/collect
• Lingkungan sandbox: https://www.google.com/maps/conversion/debug/collect

Saat mengirim peristiwa konversi, Anda harus menyertakan rwg_token yang disimpan dan nilai merchant_changed 1 atau 2. Untuk mengetahui detail selengkapnya tentang merchant_changed, lihat Menampilkan Nilai Perubahan Penjual.

Isi POST harus berupa objek yang dienkode JSON dalam format:

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

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

Contoh berikut menyertakan tracking konversi tingkat perangkat dengan cookie di perangkat pengguna, yang ditulis dalam JavaScript:

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

Perhatian: Satu-satunya MIME Content-Type yang diterima adalah text/plain. Jangan menetapkan Content-Type lain di header, yang akan menyebabkan error CORS.

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

Catatan: Dalam produksi, Anda tidak boleh mengirim peristiwa konversi yang tidak diatribusikan ke integrasi ini. Praktik terbaiknya adalah memeriksa nilai rwg_token yang valid dan belum habis masa berlakunya sebelum Anda mengirim peristiwa.

Menampilkan Nilai Perubahan Penjual

Nilai merchant_changed digunakan untuk menentukan apakah penjual diubah dari penjual pengalihan awal. Perubahan penjual adalah hal yang umum jika halaman landing Anda berada dalam platform yang menyertakan penjual lain. Dalam hal ini, jika pengguna dirujuk ke platform Anda oleh Google dan memutuskan untuk membuka penjual lain untuk menyelesaikan pemesanan, Anda perlu mengetahui bahwa konversi terjadi dengan penjual terpisah. Anda dapat menggunakan Boolean untuk mengidentifikasi perubahan penjual, tetapi tidak detail penjual.

Saat memutuskan nilai yang akan ditetapkan ke merchant_changed, Anda harus mengambil penjual asli yang disimpan di Mengurai dan Menyimpan Informasi Penjual. Periksa apakah penjual telah berubah, dan tetapkan nilai sesuai dengan persyaratan Anda.

• Persyaratan: saat pengguna keluar dari situs penjual asli dan menyelesaikan pembelian melalui platform Anda dengan penjual lain.
  • Nilai perubahan penjual: 1
• Persyaratan: saat pengguna menyelesaikan transaksi melalui penjual asli.
  • Nilai perubahan penjual: 2

Catatan: Jika halaman pemesanan Anda tidak berada dalam platform atau pengguna tidak dapat membuka penjual lain, Anda dapat melakukan hardcode nilai permintaan ini ke 2. Hal ini umum terjadi pada partner yang mengintegrasikan halaman pemesanan ke dalam situs penjual atau memiliki halaman landing kustom untuk memproses pemesanan.

Menguji dan Memverifikasi Tracking Konversi

Kasus pengujian berikut menggunakan token pengujian yang disediakan di bagian Token Pengujian dan dimaksudkan untuk membantu memandu Anda melalui berbagai skenario yang dapat menghasilkan peristiwa konversi. Tindakan ini memastikan bahwa token disimpan dengan benar, nilai merchant_changed ditetapkan dengan benar, dan peristiwa konversi dikirim jika sesuai.

Gunakan link tindakan atau URL halaman pemesanan yang disediakan di feed Anda, dan jalankan setiap kasus pengujian dengan menambahkan Token Pengujian ke bagian akhir URL. Pastikan untuk menggunakan jendela browser pribadi atau mode Samaran -- tindakan ini akan menghapus token yang ada dan terkait dengan pengguna saat ini, sehingga Anda dapat memulai dari awal.

Kasus Pengujian	Deskripsi Pengujian	Alur Penggunaan	Hasil yang Diharapkan
1	Pengguna menyelesaikan pemesanan yang tidak berasal dari Google.	Pengguna langsung membuka halaman pemesanan tanpa dirujuk oleh Google atau tanpa rujukan yang ada. Tindakan ini tidak akan menghasilkan peristiwa konversi apa pun.	Tidak ada peristiwa konversi karena pengguna sebelumnya tidak mengunjungi halaman pemesanan atau tidak dirujuk oleh Google.
2	Pengguna menyelesaikan pemesanan yang berasal dari Google.	Pengguna menemukan penjual Anda melalui Google, diarahkan ke halaman pemesanan Anda, dan menyelesaikan pemesanan.	Peristiwa konversi akan dikirim dengan nilai Token A dan merchant changed sebesar 2 karena pengguna diarahkan ke halaman pemesanan oleh Google.
3	Pengguna (berasal dari Google) memulai alur pemesanan, tetapi meninggalkan sesi sebelum pemesanan selesai. Catatan: Biarkan sesi ini terbuka untuk Pengujian 4 dan 5.	Pengguna diarahkan ke halaman pemesanan Anda, tetapi sesi berakhir dan mereka tidak menyelesaikan pemesanan.	Tidak ada konversi karena pengguna tidak menyelesaikan pemesanan, tetapi Token B harus disimpan selama 30 hari.
4	Pengguna kembali ke halaman pemesanan, tanpa berasal dari Google, dan menyelesaikan pemesanan. Catatan: URL alur pemesanan tidak boleh menyertakan rwg_token.	Pengguna kembali ke halaman pemesanan setelah Pengujian #4. Token B harus disimpan selama 30 hari dan setiap konversi selama 30 hari tersebut harus menampilkan peristiwa konversi.	Peristiwa konversi akan dikirim dengan nilai Token B dan penjual berubah sebesar 2 karena pengguna kembali ke halaman pemesanan setelah rujukan sebelumnya dari Google.
5	Pengguna menyelesaikan pemesanan baru yang berasal dari Google setelah Pengujian #4.	Jika pengguna kembali ke halaman pemesanan Anda menggunakan rujukan Google setelah rujukan Google sebelumnya, periode penyimpanan 30 hari mereka akan direset dan token baru Token C akan menggantikan token lama Token B. Semua konversi mendatang kemudian akan diatribusikan ke Token C.	Peristiwa konversi akan dikirim dengan nilai Token C dan penjual berubah sebesar 2 karena pengguna menyelesaikan pemesanan dan token baru menggantikan token yang disimpan sebelumnya.

Jika Anda memiliki platform dengan kemampuan bagi pengguna untuk melakukan checkout dengan penjual lain, uji hal berikut.

Penting: Seperti yang disebutkan di bagian Menampilkan Nilai Perubahan Penjual, Anda dapat melakukan hardcode nilai permintaan ini ke 2 jika halaman pemesanan atau Link Tindakan Anda tidak memiliki kemampuan bagi pengguna untuk beralih penjual. Hal ini umum terjadi pada partner yang mengintegrasikan halaman pemesanan ke dalam situs penjual atau memiliki halaman landing kustom untuk memproses pemesanan. Jika Anda adalah salah satu partner ini, Anda dapat melewati kasus pengujian berikut.

Kasus Pengujian	Deskripsi Pengujian	Alur Penggunaan	Hasil yang Diharapkan
6	Pengguna diarahkan ke halaman pemesanan Anda oleh Google dan menyelesaikan pemesanan dengan penjual lain.	Pengguna dirujuk ke halaman pemesanan Anda oleh Google, Token A digunakan, tetapi sebelum menyelesaikan pemesanan, mereka membuka halaman lain dan menyelesaikan pemesanan dengan penjual yang berbeda dari rujukan awal.	Peristiwa konversi akan dikirim karena pengguna menyelesaikan pemesanan yang berasal dari rujukan dari Google dengan nilai Token A dan penjual berubah sebesar 1 karena pengguna menyelesaikan pemesanan di penjual yang berbeda dengan rujukan.

Saat menguji, kirim permintaan POST HTTP ke endpoint konversi. Ada dua endpoint:

• Lingkungan produksi: https://www.google.com/maps/conversion/collect
• Lingkungan sandbox: https://www.google.com/maps/conversion/debug/collect

Token Pengujian

Untuk menguji tracking konversi, tambahkan salah satu token pengujian berikut ke akhir Link tindakan atau URL halaman pemesanan yang Anda berikan di feed.

Token A:

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

Token B:

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

Token C:

rwg_token=AJKvS9VwInjZ_hGZPvBz0COVWJ5oFDzocFt9hGi7TMurlo2l71uiXP48PspPUMmRnqCUDE1mF_A5H_dMV78cBTF8jIfSQK6lEA%3D%3D

Saat mengirim peristiwa konversi yang berhasil, Anda dapat melihatnya digabungkan di Action Center pada dasbor tracking konversi.

Catatan: Konversi dapat memerlukan waktu hingga satu jam untuk muncul di dasbor.

Persyaratan untuk Atribusi Konversi

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

Periode atribusi ini berarti Google dapat mengharapkan 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 atribusi 30 hari untuk melakukan pemesanan bagi penjual yang sama. Nilai perubahan penjual = 2.
• Pengguna mengikuti link tindakan tempat, lalu melakukan pemesanan di toko yang berbeda, baik dalam sesi yang sama maupun sesi yang berbeda dalam periode atribusi 30 hari. Nilai perubahan penjual = 1.

Selain itu, Google berharap dapat mengirim peristiwa konversi dari perangkat apa pun yang dapat diakses pengguna melalui link tindakan tempat. Perangkat ini mencakup:

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

Jika token disimpan di tingkat pengguna, Anda diharapkan memberikan atribusi lintas perangkat. Untuk mengetahui informasi selengkapnya, lihat Menyimpan di Tingkat Pengguna. Dalam hal ini, pengguna yang mengikuti link tindakan dari desktop, lalu menyelesaikan transaksi di perangkat seluler dengan akun pengguna yang sama, harus memicu peristiwa konversi.

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

Catatan: Framework atribusi ini dapat berbeda dengan konversi atribusi sistem analitik Anda. Sistem ini dirancang untuk beroperasi secara independen dari tracking konversi apa pun yang Anda lakukan di sistem, dan tidak perlu memengaruhi analisis internal Anda.