Під час імпорту офлайн-конверсій використовується ідентифікатор кліку Google (GCLID). Коли GCLID недоступний, його можуть замінити інші ідентифікатори, наприклад хешовані дані, надані користувачами, wbraid/gbraid чи session_attributes.
Зміст
- Про поле session_attributes
- Як отримувати значення session_attributes
- Як надсилати дані в Google Ads
Про поле session_attributes
Поле session_attributes містить додатковий контекст і сигнали про взаємодію користувача з вашим вебсайтом. Ці дані дають змогу підвищити точність звітів (зокрема про дії на одному або кількох пристроях), призначення ставок і відстеження конверсій. За допомогою наведеного нижче інтерфейсного скрипту можна створити сегмент session_attributes, закодований за стандартом base64, передати його в базу даних або систему CRM, а потім надіслати в Google за допомогою API для імпорту. Якщо ви не можете використати інтерфейсний скрипт, надсилайте кожну пару "ключ – значення" окремо за допомогою поля session_attributes_key_value_pairs.
Рекомендуємо надсилати всі підполя, проте ви можете вибрати стільки, скільки вам потрібно. Усі підполя необов’язкові. Рекомендований розмір сховища для поля session_attributes – 5 КБ. Більшість значень не перевищуватиме цей розмір. Якщо значення session_attributes перевищує цей ліміт, зверніться до постачальника системи CRM, щоб змінити розмір поля (рекомендований варіант), або вилучіть параметри landing_page_url і landing_page_referrer із допоміжної функції JavaScript.
Нижче наведено підполя, доступні для поля session_attributes.
gad_source: сукупний параметр, який додається в URL-адресу, щоб визначати джерело трафіку, який надійшов з оголошень. Докладніше про параметри gad_* у URL-адресах.gad_campaignid: ідентифікатор рекламної кампанії, у якій отримано клік оголошення. Докладніше про параметри gad_* у URL-адресах.landing_page_url: повна URL-адреса цільової сторінки вашого вебсайту (першої сторінки, на яку перейшов користувач).session_start_time_usec: позначка часу початку сеансу користувача на вашому вебсайті. Допомагає відстежувати тривалість відвідувань. Важливо використовувати узгоджений формат часу в мікросекундах від початку епохи UNIX.landing_page_referrer: URL-адреса вебсторінки, з якої користувач перейшов на ваш сайт. Допомагає аналізувати джерела трафіку до вашого сайту. Щоб дізнатися більше про URL-адреси переходу, прочитайте цю статтю. Вона призначена для Analytics, але поняття URL-адреси переходу однакове для всієї інтернет-мережі.landing_page_user_agent: сегмент, що ідентифікує вебпереглядач і операційну систему користувача. Ця інформація допомагає аналізувати технічне середовище ваших користувачів.
Як отримувати значення session_attributes
Щоб отримувати й зберігати значення session_attributes, можна використовувати на цільовій сторінці допоміжну функцію JavaScript і наведену нижче форму HTML.
Цей приклад коду зберігає дані в локальне сховище localStorage. Перш ніж додавати його на вебсайт, переконайтеся, що ви дотримуєтеся всіх необхідних вимог щодо згоди користувачів і збереження даних.
Форма HTML
- У код кожної сторінки, на якій користувачі заповнюють форму, потрібно додати приховане поле
session_attributes. Так значенняsession_attributesпередаватимуться в серверну частину. Нижче наведено приклад коду.<form action="" name="myForm">
Name: <input type="text" name="name">
<input type="hidden" id="session_attributes_field" name="session_attributes_field" value="">
<input type="submit" value="Submit Form" name="btnSubmit">
</form> - Далі наведено приклад скрипту, який дає змогу отримати значення
session_attributes_encodedі вставити його в поле форми. Цей приклад коду зберігає дані в локальне сховище 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>
Як надсилати дані в Google Ads
1. Поле session_attributes_encoded у Google Ads API
Якщо ви використовуєте імпорт офлайн-конверсій і JavaScript, передавайте ці дані, налаштувавши збір закодованих значень session_attributes за допомогою JavaScript у новому полі ClickConversion.session_attributes_encoded наявної схеми завантаження. Ви можете й надалі використовувати поточну процедуру імпорту офлайн-конверсій, але додаючи це нове поле під час імпорту. Google Ads використовуватиме session_attributes, якщо не буде інших ідентифікаторів.
Усі нові користувачі натомість мають налаштувати Data Manager API. Якщо обліковий запис не внесено в білий список для надсилання даних IP-адрес або поля session_attributes через Google Ads API, ви отримаєте повідомлення про помилку для таких конверсій.
Додатково
Якщо ви не можете використовувати JavaScript, реєструйте окремі пари "ключ – значення" й передавайте їх під час імпорту офлайн-конверсій.
Якщо ви налаштували імпорт офлайн-конверсій, але не використовуєте JavaScript, можете також додати поле для пари "ключ – значення" під назвою ClickConversion.session_attributes_key_value_pairs у наявну схему завантаження. Радимо надсилати пари "ключ – значення" в цих полях під час виклику API. Перегляньте документацію для розробників, щоб дізнатись, як додавати окремі пари "ключ – значення" в поле ClickConversion.
2. Поле session_attributes у Менеджері даних
Ви також можете надсилати поле session_attributes за допомогою Менеджера даних.
- В інтерфейсі Менеджера даних. Використовуйте наданий код JavaScript, щоб створити поле
session_attributesі завантажити його через інтерфейс Менеджера даних. - Через Data Manager API. Ви можете налаштувати інтеграцію з Data Manager API, щоб завантажувати дані автоматично. Докладні вказівки й опис схеми наведено в документації Менеджера даних.
Надсилаючи потрібні дані, ви даєте змогу Google Ads пов’язувати конверсії з правильними кампаніями й створювати більш комплексні звіти про конверсії.