Під час імпорту офлайн-конверсій використовується ідентифікатор кліку 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, навіть якщо обов’язковими є лише 4 із 6.
gad_source(обов’язково): сукупний параметр, який додається в URL-адресу, щоб визначати джерело трафіку, який надійшов з оголошень. Докладніше про параметри gad_* у URL-адресах.- Приклад значення:
"1"
Вказівка. Це сукупні параметри, які додаються до URL-адреси кліку оголошення (наприклад,&gad_source=1). Вам потрібно отримати значення, указане в URL-адресі цільової сторінки.
- Приклад значення:
gad_campaignid(обов’язково): ідентифікатор рекламної кампанії, у якій отримано клік оголошення. Докладніше про параметри gad_* у URL-адресах.- Приклад значення:
"1234567890"
Вказівка. Це також параметр URL-адреси (наприклад,&gad_campaignid=1234567890), який потрібно отримати з URL-адреси цільової сторінки.
- Приклад значення:
session_start_time_usec(обов’язково): позначка часу початку сеансу користувача на вашому вебсайті. Допомагає відстежувати тривалість відвідувань. Важливо використовувати узгоджений формат часу в мікросекундах від початку епохи UNIX.- Приклад значення:
"1678886400000000"(позначає певний час у мікросекундах)
Вказівка. Використовуйте узгоджений формат часу (мікросекунди від початку епохи UNIX). Допомагає відстежувати тривалість відвідувань.
- Приклад значення:
landing_page_user_agent(обов’язково): сегмент, що ідентифікує вебпереглядач і операційну систему користувача. Ця інформація допомагає аналізувати технічне середовище ваших користувачів.- Приклад значення:
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/117.0.0.0 Safari/537.36"
Вказівка. Це значення потрібно отримати із заголовка агента користувача вхідного запиту HTTP цільової сторінки. Не надсилайте загальні або задані в коді програми значення.
- Приклад значення:
landing_page_url: повна URL-адреса цільової сторінки вашого вебсайту (першої сторінки, на яку перейшов користувач).- Приклад значення:
"https://www.example.com/product/deluxe-widget?gad_source=1&gad_campaignid=1234567890"
Вказівка. Укажіть точну повну URL-адресу. Не використовуйте сегменти заповнювачів, внутрішні шляхи додатків (наприклад, "/productdetailscreen") або неповні URL-адреси. Якщо повна й точна URL-адреса недоступна, краще пропустити це поле.
- Приклад значення:
landing_page_referrer: URL-адреса вебсторінки, з якої користувач перейшов на ваш сайт. Допомагає аналізувати джерела трафіку до вашого сайту. Щоб дізнатися більше про URL-адреси переходу, прочитайте цю статтю. Вона призначена для Analytics, але поняття URL-адреси переходу однакове для всієї інтернет-мережі.-
Приклад значення:
"https://www.google.com/"або"https://www.socialmedia.com/referral"
Вказівка. Це попередня сторінка, на якій перебував користувач, перш ніж перейти на ваш сайт.
-
Практичні поради щодо якості даних
- Уникайте неправильних даних
landing_page_url. Неправильні або неповні значенняlanding_page_urlнегативно впливають на моделювання. Якщо ви не можете надати повну й точну URL-адресу, краще не вказувати її взагалі. - Уникайте ідентичних завантажень. Не надсилайте ту ж саму подію-конверсію кілька разів. Щоб уникнути повторів, використовуйте унікальний ідентифікатор, зокрема ідентифікатор замовлення.
Рекомендований розмір сховища для поля session_attributes – 5 КБ. Цього достатньо для більшості сценаріїв застосування. Якщо значення session_attributes перевищує 5 КБ, рекомендуємо попросити постачальника системи CRM змінити розмір поля. Ви також можете вилучити параметри landing_page_url і landing_page_referrer із допоміжної функції JavaScript.
Як отримувати значення 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.
Щоб переконатися, що надсилаються дійсні дані, перегляньте наведені нижче рекомендації і оновіть налаштування.
gad_campaignid (ідентифікатор кампанії): перевірте, чи ви надсилаєте дійсний ідентифікатор кампанії Google Ads, пов’язаний із кліком оголошення. Ідентифікатор кампанії, який підставляється в URL-адресу кліку оголошення якgad_campaignid=1234. Це основний і найважливіший атрибут для точної атрибуції.session_start_time_usec: переконайтеся, що ви завжди надсилаєте цей атрибут (позначку часу початку сеансу користувача).landing_page_url (URL-адреса): перевірте, чи ви надсилаєте точну повну URL-адресу цільової сторінки. Не надсилайте сегменти заповнювачів, внутрішні шляхи додатків або неповні URL-адреси.- Примітка. Якщо точна повна URL-адреса недоступна, рекомендуємо вилучити все поле, оскільки неправильні дані можуть негативно вплинути на моделювання.
landing_page_user_agent (агент користувача): переконайтеся, що сегмент точно відображає вебпереглядач і операційну систему користувача, і не надсилайте загальні або задані в коді програми значення.
2. Поле session_attributes у Менеджері даних
Ви також можете надсилати поле session_attributes за допомогою Менеджера даних.
- В інтерфейсі Менеджера даних. Використовуйте наданий код JavaScript, щоб створити поле
session_attributesі завантажити його через інтерфейс Менеджера даних. - Через Data Manager API. Ви можете налаштувати інтеграцію з Data Manager API, щоб завантажувати дані автоматично. Докладні вказівки й опис схеми наведено в документації Менеджера даних.
Надсилаючи потрібні дані, ви даєте змогу Google Ads пов’язувати конверсії з правильними кампаніями й створювати більш комплексні звіти про конверсії.