Pelacakan Konversi

Gambar 1. Ringkasan tracking konversi

Ringkasan

Tracking konversi melacak konversi yang dimulai oleh Google melalui salah satu integrasi Pusat Tindakan kami. Tracking konversi membantu menjaga integrasi Anda tetap sehat dan berjalan, karena 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 reservasi.

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. Menguji dan memverifikasi tracking konversi.

Catatan: Prosedur integrasi standar mengharuskan partner menerapkan tracking konversi untuk pengukuran performa, dengan langkah-langkah teknis yang dijelaskan di bagian yang akan dijelaskan nanti. Perlu diketahui bahwa penerapan tracking konversi bersifat opsional bagi 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 Google awal. 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 reservasi Anda, rwg_token baru akan ditambahkan ke URL yang diberikan. Di halaman reservasi, Anda perlu mengurai nilai token.

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

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

Penting: Google merekomendasikan Anda menyimpan token sebagai nilai yang didekodekan di cookie Anda, karena cookie browser memiliki penggunaan khusus untuk karakter khusus seperti =. Bagaimanapun, pastikan versi yang didekodekan 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 tracking 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 memperbarui 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 Anda berikan melalui feed, URL akan 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 digunakan.
• Menghapus penyimpanan lokal atau cookie.
• Menggunakan browser pribadi atau mode samaran.

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

Menyimpan di Tingkat Pengguna

Tingkat pengguna mempertahankan token dalam 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, Anda dapat menerapkan peristiwa konversi satu kali di sisi server dan menggunakannya kembali di semua perangkat yang didukung.

Catatan: Anda dapat memutuskan tempat menyimpan rwg_token berdasarkan persyaratan Anda.

Memuat Ulang Token

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

Lihat Persyaratan Atribusi Konversi untuk mengetahui detail selengkapnya.

Mengurai dan Menyimpan Informasi Penjual

Saat pengguna diarahkan ke halaman reservasi Anda, Anda perlu 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 reservasi, 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 disimpan sebelumnya. Contoh 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.

// 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 reservasi yang dimulai dari rujukan action_link, Anda harus mengirim permintaan HTTP POST 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 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": "AFd1xnHrJWKcjtriCyB5j3QL0bzbmLdcg1N1f5cJuSNVhteYjuOJz18Au6GIAT0tjHkw6fkUJKcarafV45b3c_gl7uT_o8HMcg==",
  "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`;

// 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 menghasilkan error CORS.

Peringatan: Pastikan bahwa sebagai bagian dari data konversi, Informasi Identitas Pribadi Pengguna (PII) 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 diubah 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 penjual lain guna menyelesaikan reservasi, Anda perlu mengetahui bahwa konversi terjadi dengan penjual yang berbeda. Anda dapat menggunakan nilai Boolean untuk mengidentifikasi perubahan penjual, tetapi bukan 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 persyaratan Anda.

• Persyaratan: saat pengguna meninggalkan situs penjual asli dan menyelesaikan pembelian melalui platform Anda dengan penjual yang berbeda.
  • Nilai perubahan penjual: 1
• Persyaratan: saat pengguna menyelesaikan transaksi melalui penjual asli.
  • Nilai perubahan penjual: 2

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

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 benar, nilai merchant_changed ditetapkan dengan benar, dan peristiwa konversi dikirim saat diperlukan.

Gunakan URL halaman reservasi atau link tindakan 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 yang terkait dengan pengguna saat ini dan memberi Anda awal yang baru untuk bekerja.

Kasus Pengujian	Deskripsi Pengujian	Alur Pengguna	Hasil yang Diharapkan
1	Pengguna menyelesaikan reservasi yang tidak berasal dari Google.	Pengguna membuka halaman reservasi 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 reservasi atau tidak dirujuk oleh Google.
2	Pengguna menyelesaikan reservasi yang berasal dari Google.	Pengguna menemukan penjual Anda melalui Google, dirujuk ke halaman reservasi Anda, dan menyelesaikan reservasi.	Peristiwa konversi akan dikirim dengan Token A dan nilai merchant changed sebesar 2 karena pengguna dirujuk ke halaman reservasi oleh Google.
3	Pengguna (berasal dari Google) memulai alur reservasi, tetapi meninggalkan sesi sebelum reservasi selesai. Catatan: Biarkan sesi ini terbuka untuk Pengujian 4 dan 5.	Pengguna dirujuk ke halaman reservasi Anda, tetapi sesi berakhir dan mereka tidak menyelesaikan reservasi.	Tidak ada konversi karena pengguna tidak menyelesaikan reservasi, tetapi Token B harus disimpan selama 30 hari.
4	Pengguna kembali ke halaman reservasi, tanpa berasal dari Google, dan menyelesaikan reservasi. Catatan: URL alur reservasi tidak boleh menyertakan rwg_token.	Pengguna kembali ke halaman reservasi setelah Pengujian #4. Token B harus disimpan selama 30 hari dan konversi apa pun 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 reservasi setelah rujukan sebelumnya dari Google.
5	Pengguna menyelesaikan reservasi baru yang berasal dari Google setelah Pengujian #4.	Jika pengguna kembali ke halaman reservasi 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 Token C dan nilai merchant changed sebesar 2 karena pengguna menyelesaikan reservasi dan token baru menggantikan token yang disimpan sebelumnya.

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

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

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

Saat Anda melakukan pengujian, kirim permintaan HTTP POST 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 bagian akhir URL halaman reservasi atau link tindakan yang Anda berikan di feed Anda.

Token A:

rwg_token=AFd1xnHrJWKcjtriCyB5j3QL0bzbmLdcg1N1f5cJuSNVhteYjuOJz18Au6GIAT0tjHkw6fkUJKcarafV45b3c_gl7uT_o8HMcg%3D%3D

Token B:

rwg_token=AE37R_gte8WCEaytMalsIr9agWQRLuN8199RsVhU2WoRKRvcZ0eBTD8cFvnfUZh-GY0IvY-zjS3W9KWAmy3WDiWXbVvQRZyzMQ%3D%3D

Token C:

rwg_token=AE37R_jmAP-UgWNApkxwdlX5M2z1UBGuUzHZ63YWmRWeTjRJKxfSD1mzJ4joLnB11MHrBULuisjP-9I64LnBJDXyCc_CIJSCPg%3D%3D

Saat Anda mengirim peristiwa konversi yang berhasil, Anda dapat melihatnya diagregasi di Pusat Tindakan di dasbor tracking konversi.

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

Persyaratan 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 lain, baik dalam sesi yang sama maupun sesi yang berbeda dalam periode atribusi 30 hari. Nilai perubahan penjual = 1.

Selain itu, Google mengharapkan untuk mengirim peristiwa konversi dari perangkat mana 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 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 atribut sistem analisis Anda. Sistem ini dirancang untuk beroperasi secara independen dari tracking konversi yang Anda lakukan di sistem Anda, dan tidak perlu memengaruhi analisis internal Anda.