Увоз офлајн конверзија прати офлајн конверзије из увоза помоћу параметра GCLID. У ситуацијама када GCLID није доступан, корисници увоза офлајн конверзија могу да се ослањају на друге идентификаторе, као што су хеширани подаци које је доставио корисник, wbraid/gbraid или session_attributes.
На овој страници
- О параметру session_attributes
- Како да евидентирате параметар session_attributes
- Како да шаљете податке Google Ads-у
О параметру session_attributes
session_attributes је поље које пружа додатни контекст и сигнале о интеракцији корисника са веб-сајтом, што може да побољша прецизност мерења конверзија, извештавања (укључујући анализу на истом уређају или на више уређаја) и лицитирања. Можете да користите скрипту на страни клијента у наставку да бисте направили base64 кодирани стринг session_attributes, проследили га бази података или систему за управљање односима са клијентима и послали Google-у у API увозима. Ако не можете да користите скрипту на страни клијента, користите поље session_attributes_key_value_pairs да бисте појединачно слали сваки пар кључ/вредност.
Препоручујемо вам да пошаљете сва поља, али можете да пошаљете колико год желите. Сва потпоља су опционална. Препоручена величина меморијског простора за поље session_attributes је 5 kB. За употребу вам углавном не треба више. Ако је session_attributes већи од овога, заједно са добављачем система за управљање односима са клијентима измените величину поља (препоручујемо) или уклоните параметре landing_page_url и landing_page_referrer из JavaScript функције помоћника.
Ево потпоља у пољу session_attributes:
gad_source: Обједињени параметар који се приказује у URL-у за идентификовање извора саобраћаја који потиче из огласа. Сазнајте више о параметрима URL-а gad_*.gad_campaignid: ИД конкретне рекламне кампање која је довела до клика на оглас. Сазнајте више о параметрима URL-а gad_*.landing_page_url: Комплетан URL одредишне странице на веб-сајту. Означава конкретну страницу на коју је корисник прво дошао.session_start_time_usec: Временска ознака почетка сесије корисника на веб-сајту. То вам помаже да пратите трајање посета корисника. Важно је да користите доследан формат времена у микросекундама Unix времена активације временске ознаке.landing_page_referrer: URL веб-странице која је повезала корисника са веб-сајтом. Помаже вам да разумете изворе саобраћаја који воде до сајта. Више информација о референцама потражите у овом чланку који је фокусиран на Аналитику, али је концепт референце универзалан на вебу.landing_page_user_agent: Стринг који идентификује прегледач и оперативни систем корисника. Ове информације могу да буду корисне за разумевање техничког окружења корисника.
Како да евидентирате параметар session_attributes
Можете да користите JavaScript функцију помоћника и HTML образац у наставку на одредишној страници да бисте евидентирали и задржали session_attributes.
Овај пример кода трајно чува податке у локалну меморију. Пре него што га примените на веб-сајт, уверите се да су по потреби испуњени сви неопходни услови за сагласност и задржавање података специфични за веб-сајт.
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и подешавање у пољу обрасца. Овај пример кода трајно чува податке у локалну меморију.<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 адреса или атрибута сесије преко Google Ads API-ја, добићете поруку о грешци за те конверзије.
Напредно
Ако не можете да користите JavaScript, можете да евидентирате појединачне парове кључ/вредност и шаљете их уз увоз офлајн конверзија.
За постојеће кориснике увоза офлајн конверзија који не користе JavaScript, можете да подесите и поље за пар кључ/вредност под називом ClickConversion.session_attributes_key_value_pairs у постојећој шеми отпремања. Препоручујемо вам да шаљете парове кључ/вредност са овим пољима када позивате API. У документацији за програмере погледајте како да додате појединачне парове кључ/вредност у ClickConversion.
2. Поље session_attributes помоћу Менаџера података
Поље session_attributes можете да шаљете и помоћу Менаџера података.
- Кориснички интерфејс Менаџера података: Користите наведени JavaScript да бисте направили поље
session_attributesи отпремите га преко корисничког интерфејса Менаџера података. - API менаџера података: Можете да обавите интеграцију са API-јем менаџера података да бисте програмски отпремали податке. Конкретна упутства и детаље о шеми потражите у документацији Менаџера података.
Слањем одговарајућих података омогућавате Google Ads-у да на основу њих приписује конверзије одговарајућим кампањама и пружа вам свеобухватније извештаје о конверзијама.
