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 untuk menggunakan Google Analytics atau JavaScript pihak ketiga lainnya.
Sebelum mulai mengerjakan penerapan tracking konversi, Anda harus memutuskan apakah akan melacak konversi di tingkat perangkat atau pengguna:
- Tingkat perangkat mencakup penggunaan cookie browser, penyimpanan 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 mengganti perangkat yang digunakan, menghapus penyimpanan/cookie lokal, atau menggunakan penjelajahan rahasia atau mode samaran, peristiwa konversi mungkin tidak diatribusikan dengan benar. Saat menggunakan tracking konversi tingkat perangkat, Anda harus menerapkannya kembali di setiap platform yang didukung (termasuk seluler).
- Tingkat pengguna mencakup mempertahankannya dalam database aplikasi Anda, melalui sistem analisis sisi server atau sistem sisi server lainnya. Karena token akan disimpan di sisi server, jika pengguna mengubah perangkat yang mereka gunakan, menghapus penyimpanan/cookie lokal, atau menggunakan penjelajahan rahasia atau mode samaran, peristiwa konversi masih akan diatribusikan setelah pengguna login kembali. Saat menggunakan tracking konversi tingkat pengguna, bergantung pada arsitektur sistem, Anda mungkin dapat menerapkannya 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 melalui
Feed, URL tersebut akan dimodifikasi untuk menyertakan parameter kueri
unik: rwg_token
. Nilai rwg_token
adalah string dienkode yang berisi beberapa metadata tentang
link yang diklik pengguna. Anda akan menyimpan token ini, dan meneruskannya kembali sebagai bagian dari peristiwa konversi.
Di setiap halaman landing / titik entri aplikasi, Anda harus mengurai nilai yang ditetapkan untuk parameter kueri rwg_token
dan menyimpannya. Persyaratan untuk
menyimpan parameter ini dijelaskan dalam langkah, Mempertahankan
rwg_token
.
Contoh cara token ini dapat diurai untuk pelacakan tingkat perangkat melalui browser disertakan di bawah. Atau, Anda dapat mengumpulkan token ini di sisi server saat merespons 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
Anda akan diwajibkan untuk mempertahankan parameter URL rwg_token
, yang akan ditambahkan ke semua link tindakan yang Anda sediakan, selama total durasi 30 hari. Nilai rwg_token
harus disimpan dan ditampilkan tanpa pengeditan.
Jika ada token yang dipertahankan dari kunjungan sebelumnya, token lama harus diganti, dan periode 30 hari untuk penyimpanan harus direset.
Ketika mempertahankan token, Anda dapat menyimpan token di tingkat perangkat atau di tingkat pengguna:
- Tingkat perangkat mencakup penggunaan cookie browser, penyimpanan lokal, penyimpanan lokal aplikasi, atau metode lain yang dapat mempertahankan token untuk periode atribusi 30 hari.
- Tingkat pengguna mencakup mempertahankannya dalam database aplikasi Anda, melalui sistem analisis sisi server atau sistem sisi server lainnya.
Berikut contoh tracking konversi tingkat perangkat, yang menyimpan token ini di browser web melalui cookie pihak pertama. Contoh ini mengasumsikan bahwa Anda telah mengurai nilai token menjadi variabel seperti pada 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
harus disimpan di server dan dikaitkan dengan pengguna.
Mengirim Data Konversi
Saat pengguna menyelesaikan transaksi yang dapat diatribusikan ke link Tindakan Google Place, Anda harus mengirimkan permintaan POST HTTP ke endpoint konversi. Ada dua endpoint, satu untuk lingkungan 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 yang dienkode json dalam format:
{ 'conversion_partner_id': partnerId, 'rwg_token': <rwg_token_val> }
Di lingkungan sandbox dan produksi, Anda akan diminta untuk memberikan rwg_token
yang valid saat mengirim peristiwa konversi.
Untuk tujuan pengujian di lingkungan sandbox, Anda dapat menggunakan token pengujian berikut.
ADQ7psRE9YyDSVR6YpfD-fYdxoFYVKS1xeTvXdSxqF8a3bnk0W62eMEnUjoNPwjhNHG0elwBnM1awTjr9vXET8yOowCeuODjwA==
Contoh lengkap tracking konversi tingkat perangkat (menggunakan cookie di perangkat pengguna) dalam javascript tentang cara membuat permintaan postingan ini disertakan di bawah:
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 terkait dengan pengguna (terlepas dari platform tempatnya berada) dari mekanisme penyimpanan sisi server dan mengirim token menggunakan endpoint produksi atau sandbox yang sama.
Persyaratan Atribusi Konversi
Standar wajib Google untuk atribusi konversi adalah periode atribusi 30 hari untuk setiap interaksi dengan link tempat, di toko mana pun.
Periode atribusi ini berarti kami memperkirakan peristiwa konversi akan dikirim dalam salah satu skenario berikut:
- Pengguna mengikuti link tindakan tempat dan melakukan pemesanan dalam sesi yang sama
- Pengguna mengikuti link tindakan tempat, lalu kembali dari saluran yang berbeda dalam periode 30 hari untuk melakukan pemesanan.
- Pengguna mengikuti link tindakan tempat, lalu memesan di toko yang berbeda, baik dalam sesi yang sama maupun sesi yang berbeda dalam periode 30 hari.
Selain itu, kami memperkirakan peristiwa konversi akan dikirim dari semua platform yang dapat dibuka pengguna dari link tindakan tempat. Termasuk:
- Aplikasi web seluler atau desktop
- Aplikasi seluler, baik melalui deep link aplikasi atau intent aplikasi yang terdaftar untuk domain Anda
Jika token disimpan di tingkat pengguna (lihat mempertahankan token), Anda diharapkan untuk memberikan atribusi lintas perangkat. Artinya, 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 cookie browser, Anda tidak diharapkan untuk memberikan atribusi lintas perangkat. Dalam hal ini, setiap perangkat akan memiliki token terpisah yang disimpan jika pengguna telah mengikuti link tindakan di perangkat tersebut, dan setiap perangkat akan mengikuti aturan atribusi secara terpisah.