Pelacakan Konversi

Catatan: Pelacakan konversi diperbarui pada 2 Februari 2024. Jika ada pertanyaan terkait perubahan ini, hubungi perwakilan Google Anda.

Gambar 1. Ringkasan tracking konversi

Ringkasan

Tracking konversi melacak konversi yang dimulai oleh Google melalui salah satu integrasi Pusat Tindakan kami. Hal ini membantu menjaga integrasi Anda tetap sehat dan berjalan, karena dapat memengaruhi peringkat di halaman tertentu. Setiap kali Google membuat action_link, URL tertentu 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. Parse dan simpan rwg_token.
2. Mengurai dan menyimpan informasi penjual.
3. Menampilkan nilai rwg_token dan merchant_changed.
4. Uji dan verifikasi tracking konversi.

Catatan: Prosedur integrasi standar mengharuskan partner menerapkan tracking konversi untuk pengukuran performa, dengan langkah-langkah teknis yang dijelaskan di bagian selanjutnya. Perlu diketahui bahwa penerapan tracking konversi bersifat opsional untuk partner di vertikal layanan kesehatan berdasarkan kebutuhan bisnis

Mengurai dan Menyimpan rwg_token

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

Penting: Tidak ada informasi identitas pribadi yang disimpan atau dienkripsi.

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.

const rwgToken = new URLSearchParams(location.search).get('rwg_token') || undefined;

Penting: Google merekomendasikan agar Anda menyimpan token sebagai nilai yang didekodekan di cookie, karena cookie browser memiliki penggunaan khusus untuk karakter khusus seperti =. Bagaimanapun, pastikan versi yang didekode dikirim dalam RPC konversi dan menyertakan karakter khusus seperti =.

Menyimpan Token

Saat menyimpan rwg_token, Anda dapat menerapkan tracking konversi di dua tingkat 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 ke dalam variabel. Pastikan untuk mengganti rootdomain.com dengan domain Anda.

if (rwgToken !== undefined) {
  document.cookie =
  "_rwgToken=" + rwgToken + "; max-age=2592000; domain=rootdomain.com; path=/";
}

Setiap kali Google membuat action_link yang telah Anda berikan melalui feed, URL diubah untuk menyertakan parameter kueri unik: rwg_token. Anda harus menyimpan token ini, dan mengirimkannya 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 mereka gunakan.
• Menghapus penyimpanan lokal atau cookie.
• Menggunakan browser pribadi atau samaran.

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

Menyimpan 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 tetap diatribusikan dengan benar setelah pengguna login kembali.

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

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

Memperbarui Token

Saat Google merujuk pengguna ke penjual yang sama, token yang sudah disimpan akan diganti dengan token baru dari rujukan terbaru. Setelah penggantian token, periode atribusi 30 hari penyimpanan token direset dan setiap konversi baru untuk penjual ini 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, Anda harus menerapkan logika yang dapat menemukan dan mengambil detail penjual. Biasanya, partner menambahkan metadata penjual atau merchant_id ke link tindakan mereka dan menggunakannya untuk mengidentifikasi dan menyimpan informasi penjual.

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

Contoh berikut mengubah rwg_token yang sebelumnya disimpan. Asumsinya adalah Anda telah mem-parsing informasi penjual dari metadata di URL yang diberikan dan menyimpannya sebagai merchant_id atau mencocokkannya dengan merchant_id yang ada.

// Store the rwgToken and merchantId in your cookie and set the cookie
// expiration date to 30 days.
if (typeof rwgToken !== 'undefined') {
  document.cookie =
  "_rwgToken=" + rwgToken + "; _merchantId=" + 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 sebesar 1 atau 2. Untuk mengetahui detail selengkapnya tentang merchant_changed, lihat Mengembalikan 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 mencakup 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`;

// Retrieve the value of the rwgToken stored in the browser's cookie
const match = document.cookie.match(new RegExp('(?:^| )_rwgToken=([^;]+)'));
const storedRwgToken = match ? match[1] : undefined;

// Send Conversion event with decoded token, verify any special characters
// are sent properly.
if (storedRwgToken !== undefined) {
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: decodeURIComponent(storedRwgToken),
      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: Verifikasi 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. Sebaiknya periksa 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 berubah dari penjual pengalihan awal. Perubahan penjual sering terjadi 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 halaman penjual lain untuk menyelesaikan pemesanan, Anda perlu mengetahui bahwa konversi terjadi dengan penjual lain. Anda dapat menggunakan Boolean untuk mengidentifikasi perubahan penjual, tetapi bukan detail penjual.

Saat memutuskan nilai mana yang akan ditetapkan ke merchant_changed, Anda harus mengambil penjual asli yang disimpan di Parse and Store the Merchant Information. Periksa apakah penjual telah berubah, dan tetapkan nilai sesuai kebutuhan Anda.

• Persyaratan: saat pengguna meninggalkan 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 halaman penjual lain, Anda dapat meng-hardcode nilai permintaan ini ke 2. Hal ini umum terjadi pada partner yang mengintegrasikan halaman pembuatan janji temu ke situs penjual atau memiliki halaman landing kustom untuk memproses pembuatan janji temu.

Menguji dan Memverifikasi Tracking Konversi

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

Gunakan link tindakan atau URL halaman pemesanan yang disediakan di feed Anda, dan jalankan setiap kasus pengujian dengan menambahkan Token Pengujian di akhir URL. Pastikan untuk menggunakan jendela browser pribadi atau samaran -- tindakan ini akan menghapus semua token yang ada yang terkait dengan pengguna saat ini dan memberi Anda awal yang bersih untuk digunakan.

Kasus Pengujian	Deskripsi Pengujian	Alur Penggunaan	Hasil yang Diharapkan
1	Pengguna menyelesaikan pemesanan yang tidak berasal dari Google.	Pengguna membuka halaman pemesanan secara langsung tanpa dirujuk oleh Google atau tanpa rujukan yang ada. Tindakan ini tidak akan menghasilkan peristiwa konversi.	Tidak ada peristiwa konversi karena pengguna belum pernah 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 pembuatan janji temu Anda, dan menyelesaikan pembuatan janji temu.	Peristiwa konversi akan dikirim dengan Token A dan nilai merchant changed sebesar 2 karena pengguna dirujuk ke halaman pemesanan oleh Google.
3	Pengguna (yang berasal dari Google) memulai alur pemesanan, tetapi menghentikan sesi sebelum pemesanan selesai. Catatan: Biarkan sesi ini tetap terbuka untuk Pengujian 4 dan 5.	Pengguna dirujuk ke halaman pembuatan janji temu Anda, tetapi sesi berakhir dan mereka tidak menyelesaikan pembuatan janji temu.	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 Test #4. Token B harus disimpan selama 30 hari dan setiap konversi selama 30 hari tersebut harus menampilkan peristiwa konversi.	Peristiwa konversi akan dikirim dengan Token B dan nilai merchant changed sebesar 2 karena pengguna kembali ke halaman pemesanan setelah rujukan sebelumnya dari Google.
5	Pengguna menyelesaikan pemesanan baru yang berasal dari Google setelah Test #4.	Jika pengguna kembali ke halaman pemesanan Anda menggunakan rujukan Google setelah rujukan Google sebelumnya, periode penyimpanan 30 hari 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 merchant changed sebesar 2 karena pengguna menyelesaikan pemesanan dan token baru menggantikan token yang disimpan sebelumnya.

Jika Anda memiliki platform yang memungkinkan pengguna checkout dengan penjual lain, uji hal berikut.

Penting: Seperti yang disebutkan di bagian Mengembalikan Nilai Perubahan Penjual, Anda dapat meng-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 pembuatan janji temu ke situs penjual atau memiliki halaman landing kustom untuk memproses pembuatan janji temu. Jika Anda adalah salah satu partner ini, Anda dapat melewati kasus pengujian berikut.

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

Saat Anda melakukan pengujian, 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

Menguji Token

Untuk menguji tracking konversi, tambahkan salah satu token pengujian berikut di akhir URL link Tindakan atau 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 Anda mengirim peristiwa konversi yang berhasil, Anda dapat melihatnya digabungkan di Pusat Tindakan di dasbor pelacakan 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 dari penjual yang sama. Nilai perubahan penjual = 2.
• Pengguna mengikuti link tindakan tempat, lalu melakukan pemesanan di toko lain, baik dalam sesi yang sama maupun sesi yang berbeda dalam periode atribusi 30 hari. Nilai perubahan penjual = 1.

Selain itu, Google berharap untuk 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 maksud 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 cara sistem analisis Anda mengatribusikan konversi. Sistem ini dirancang untuk beroperasi secara independen dari tracking konversi yang Anda lakukan di sistem Anda, dan tidak perlu memengaruhi analisis internal Anda.