Импортирането на офлайн реализации (OCI) проследява офлайн реализациите от импортирания, като използва GCLID. В случаите, когато GCLID не е налице, използващите OCI могат да разчитат на други идентификатори, като хеширани предоставени от потребителя данни, WBRAID/GBRAID или session_attributes.
На тази страница
- Всичко за session_attributes
- Как да записвате session_attributes
- Как да изпращате данните до Google Ads
Всичко за session_attributes
session_attributes е поле, което предоставя допълнителен контекст и сигнали за взаимодействието на потребителя с уебсайта Ви, което може да подобри точността на измерването на реализациите, отчитането (включително разбивка по едно и също/различни устройства) и оферирането. Можете да използвате скрипта ни за преден слой по-долу, за да създадете кодирания с base64 низ session_attributes, да го предадете на базата си от данни/системата за управление на връзките с клиенти (CRM) и изпратите до Google в импортиранията си с API. Ако не можете да използвате скрипта за преден слой, използвайте полето session_attributes_key_value_pairs, за да изпращате всяка двойки ключ – стойност поотделно.
Препоръчваме да изпращате всички подполета, но можете да изберете да изпращате толкова, колкото искате. Всички подполета са по избор. Препоръчителният размер на хранилището за полето session_attributes е 5 KB. При повечето случаи на използване размерът няма да надхвърля тази стойност. Ако session_attributes е по-голям от това, работете с доставчика си на CRM, за да промените размера на полето (силно препоръчително), или премахнете параметрите landing_page_url и landing_page_referrer от помощната функция на JavaScript.
Това са подполетата в полето session_attributes:
gad_source: Обобщен параметър, показван в URL адреса, за да се идентифицира източникът на трафик, идващ от реклами. Научете повече за параметрите на URL адреса gad_*.gad_campaignid: ID на конкретната рекламна кампания, довела до кликването върху рекламата. Научете повече за параметрите на URL адреса gad_*.landing_page_url: Пълният URL адрес на целевата страница в уебсайта Ви. Показва конкретната страница, на която потребителят е пристигнал за първи път.session_start_time_usec: Клеймото за дата и час, когато сесията на потребителя е започнала на уебсайта Ви. Помага за проследяването на продължителността на посещенията на потребителите. Важно е да използвате последователен формат на часа в клеймото за дата и час в микросекунди на епоха на Unix.landing_page_referrer: URL адресът на уеб страницата, свързала потребителя с уебсайта Ви. Помага да разберете източниците на трафик, водещи към сайта Ви. За повече информация относно препращащите URL адреси вижте тази статия, която въпреки че е съсредоточена върху Анализ, концепцията за препращащ URL адрес е универсална в мрежата.landing_page_user_agent: Низ, който идентифицира браузъра и операционната система на потребителя. Тази информация може да е полезна за разбиране на техническата среда на потребителите Ви.
Как да записвате session_attributes
Можете да използвате помощната функция на JavaScript и HTML формуляра по-долу на целевата си страница, за да записвате и съхранявате session_attributes.
Този примерен код съхранява данните в 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 в API на Google Ads
За съществуващи потребители на импортиране на офлайн реализации (OCI), които използват JavaScript: изпратете тези данни, като зададете кодираните session_attributes получени от JavaScript, в ново поле, наречено ClickConversion.session_attributes_encoded в съществуващата си схема за качване. Продължете да използвате текущия си процес за OCI, но задайте това ново поле, когато извършвате импортирания. Google Ads ще използва session_attributes, когато другите Ви идентификатори не са налице.
Всички нови потребители трябва да използват Data Manager API. Ако даден профил не е включен в списъка на разрешените потребители да предава IP адреси или атрибути на сесията чрез API на Google Ads, ще получите съобщение за грешка за тези реализации.
Разширена
Ако не можете да използвате JavaScript, можете да записвате отделните двойки ключ – стойност и да ги изпращате с импортиранията на офлайн реализациите.
Съществуващите потребители на функцията за импортиране на офлайн реализации (OCI), които не използват JavaScript, могат също да зададат полето за двойка ключ – стойност, наречено ClickConversion.session_attributes_key_value_pairs, в съществуващата схема за качване. Препоръчваме да изпращате двойки ключ – стойност с тези полета, когато извиквате API. Прегледайте документацията за програмисти, в която се обяснява как да добавяте отделни двойки ключ – стойност към ClickConversion.
2. Поле session_attributes чрез Мениджър на данни
Можете също да изпратите полето session_attributes чрез Мениджър на данни.
- Потребителски интерфейс на Мениджър на данни: Използвайте предоставения JavaScript, за да създадете полето
session_attributesи да го качите чрез потребителския интерфейс на Мениджър на данни. - API на Мениджър на данни: Можете да интегрирате с API на Мениджър на данни, за да качвате данните си по програмен начин. Прегледайте документацията на Мениджър на данни за конкретни инструкции и подробности за схемата.
Като изпращате правилните данни, давате възможност на Google Ads да използва тази информация, за да приписва реализации на правилните кампании и да Ви предоставя по-изчерпателно отчитане на реализациите.