Impor Konversi Offline (OCI) melacak konversi offline dari impor menggunakan GCLID. Dalam skenario saat GCLID tidak tersedia, pengguna OCI dapat mengandalkan ID lain, seperti data yang disediakan pengguna yang di-hash, WBRAID/GBRAID, atau session_attributes.
Pada halaman ini
Tentang session_attributes
session_attributes adalah kolom yang memberikan sinyal dan konteks lebih lanjut tentang interaksi pengguna dengan situs Anda, yang dapat meningkatkan akurasi pengukuran konversi, pelaporan (termasuk pengelompokan perangkat yang sama/lintas perangkat), dan bidding. Anda dapat menggunakan skrip front-end kami di bawah untuk membuat string yang dienkode dengan base64 dari session_attributes, meneruskannya ke database/CRM, dan mengirimkannya kepada Google dalam impor API Anda. Jika Anda tidak dapat menggunakan skrip front-end, gunakan kolom session_attributes_key_value_pairs untuk mengirim pasangan nilai kunci satu per satu.
Sebaiknya kirim semua sub-kolom, tetapi Anda dapat menentukan jumlah yang akan dikirim sesuai keinginan. Semua sub-kolom bersifat opsional. Ukuran penyimpanan yang direkomendasikan untuk kolom session_attributes adalah 5 KB. Sebagian besar penggunaan tidak akan melebihi ukuran ini. Jika session_attributes lebih besar dari ukuran ini, hubungi penyedia CRM Anda untuk mengubah ukuran kolom (sangat direkomendasikan) atau hapus parameter landing_page_url dan landing_page_referrer dari fungsi bantuan JavaScript.
Berikut adalah sub-kolom di dalam kolom session_attributes:
gad_source: Parameter gabungan yang ditayangkan di URL untuk mengidentifikasi sumber traffic yang berasal dari iklan. Pelajari lebih lanjut Parameter URL gad_*.gad_campaignid: ID kampanye iklan tertentu yang mendorong klik iklan. Pelajari lebih lanjut Parameter URL gad_*.landing_page_url: URL lengkap halaman landing di situs Anda. Sub-kolom ini menunjukkan halaman spesifik yang pertama kali dibuka oleh pengguna.session_start_time_usec: Stempel waktu saat sesi pengguna dimulai di situs Anda. Sub-kolom ini membantu melacak durasi kunjungan pengguna. Sebaiknya gunakan format stempel waktu yang konsisten dalam mikrodetik epoch UNIX.landing_page_referrer: URL halaman web yang menautkan pengguna ke situs Anda. Sub-kolom ini membantu Anda memahami sumber traffic yang mengarah ke situs Anda. Untuk informasi selengkapnya tentang perujuk, lihat artikel ini yang meskipun berfokus pada Analytics, konsep perujuk umumnya sama di semua web.landing_page_user_agent: String yang mengidentifikasi browser dan sistem operasi pengguna. Informasi ini berguna untuk memahami lingkungan teknis pengguna Anda.
Cara mengambil session_attributes
Anda dapat menggunakan fungsi bantuan JavaScript dan formulir HTML di bawah di halaman landing untuk mengambil dan mempertahankan session_attributes.
Contoh kode ini mempertahankan data ke localStorage. Sebelum menerapkan kode di situs Anda, pastikan juga bahwa persyaratan izin dan retensi data yang diperlukan khusus untuk situs Anda dipatuhi sebagaimana mestinya.
Formulir HTML
- Anda perlu mengubah setiap halaman pengiriman formulir guna menambahkan kolom tersembunyi untuk
session_attributes. Beginilahsession_attributesakan diteruskan ke sistem backend Anda. Berikut kode contoh untuk mendemonstrasikan proses penerusan ini.<form action="" name="myForm">
Nama: <input type="text" name="name">
<input type="hidden" id="session_attributes_field" name="session_attributes_field" value="">
<input type="submit" value="Kirim Formulir" name="btnSubmit">
</form> - Contoh skrip untuk mengambil
session_attributes_encodeddan menetapkannya di kolom formulir. Contoh kode ini mempertahankan data ke localStorage.<script>
function getSessionAttributes() {
const searchParams = new URLSearchParams(window.location.search);
if (Array.from(searchParams.keys()).some(key => key.startsWith('gad_')) ||
searchParams.has('gclid') || searchParams.has('gbraid')) {
const params = {};
searchParams.forEach((value, key) => {
if (key.startsWith('gad_')) params[key] = value;
});
params['session_start_time_usec'] =
(new Date().getTime() * 1000).toString();
params['landing_page_url'] = window.location.href;
params['landing_page_referrer'] = document.referrer;
params['landing_page_user_agent'] = navigator.userAgent;
const sessionAttributesEncoded = btoa(JSON.stringify(params))
.replace(/\+/g, '-')
.replace(/\//g, '_')
.replace(/=+$/, '');
localStorage.setItem('google_session_attributes', sessionAttributesEncoded);
return sessionAttributesEncoded;
}
return localStorage.getItem('google_session_attributes') || '';
}
function addSessionAttributes() {
const sessionAttributesEncoded = getSessionAttributes();
var sessionAttributesFormField =
document.getElementById('session_attributes_field');
if (sessionAttributesFormField && sessionAttributesEncoded != '') {
sessionAttributesFormField.value = sessionAttributesEncoded;
}
}
window.addEventListener('load', addSessionAttributes);
</script>
Cara mengirim data ke Google Ads
1. Kolom session_attributes_encoded di Google Ads API
Untuk pengguna Impor Konversi Offline (OCI) yang sudah ada dan menggunakan JavaScript, kirim data ini dengan menetapkan session_attributes yang dienkode yang diambil dari JavaScript yang disediakan di kolom baru bernama ClickConversion.session_attributes_encoded dalam skema upload yang ada. Teruskan penggunaan proses OCI saat ini, tetapi tetapkan kolom baru ini saat melakukan impor. Google Ads akan menggunakan session_attributes jika tidak ada ID Anda yang lain.
Semua pengguna baru harus menggunakan Data Manager API. Jika akun belum dimasukkan dalam daftar yang diizinkan untuk mengirimkan alamat IP atau atribut sesi melalui Google Ads API, Anda akan menerima pesan error untuk konversi tersebut.
Lanjutan
Jika tidak dapat menggunakan JavaScript, Anda dapat mengambil setiap pasangan nilai kunci dan mengirimkannya dengan Impor Konversi Offline.
Untuk pengguna Impor Konversi Offline (OCI) yang sudah ada dan tidak menggunakan JavaScript, Anda juga dapat menetapkan kolom pasangan nilai kunci bernama ClickConversion.session_attributes_key_value_pairs dalam skema upload yang ada. Sebaiknya kirim pasangan nilai kunci dengan kolom ini saat memanggil API. Lihat dokumentasi developer yang menjelaskan cara menambahkan setiap pasangan nilai kunci ke ClickConversion.
Anda dapat meninjau rekomendasi berikut dan memperbarui penerapan Anda untuk memastikan data yang valid dikirim:
gad_campaignid (ID Kampanye): Pastikan Anda konsisten mengirim ID Kampanye Google Ads valid yang terkait dengan klik iklan. ID ini adalah ID Kampanye yang diisi di URL klik iklan dalam format “gad_campaignid=1234”. ID ini adalah atribut utama dan krusial untuk atribusi yang akurat.session_start_time_usec: Pastikan untuk mengirim atribut ini secara konsisten (stempel waktu saat sesi pengguna dimulai).landing_page_url (URL): Pastikan Anda mengirim URL lengkap halaman landing yang akurat. Jangan mengirim string placeholder, jalur aplikasi internal, atau URL yang tidak lengkap.- Catatan: Jika URL lengkap yang akurat tidak tersedia, sebaiknya hapus seluruh kolom tersebut karena data yang salah dapat berdampak negatif pada pemodelan.
landing_page_user_agent (Agen pengguna): Pastikan string ini mencerminkan browser dan sistem operasi pengguna secara akurat, serta jangan mengirim nilai generik atau hardcode.
2. Kolom session_attributes menggunakan Pengelola Data
Anda juga dapat mengirim kolom session_attributes menggunakan Pengelola Data.
- UI Pengelola Data: Gunakan JavaScript yang disediakan untuk membuat kolom
session_attributesdan menguploadnya melalui UI Pengelola Data. - Data Manager API: Anda dapat melakukan integrasi dengan Data Manager API untuk mengupload data secara terprogram. Lihat dokumentasi Pengelola Data untuk mengetahui petunjuk dan detail skema tertentu.
Dengan mengirim data yang tepat, Anda memungkinkan Google Ads menggunakan informasi ini untuk mengatribusikan konversi ke kampanye yang benar dan memberikan pelaporan konversi yang lebih komprehensif kepada Anda.