Uvoz konverzij zunaj spleta sledi konverzijam zunaj spleta iz uvozov z uporabo parametra GCLID. V primerih, ko GCLID ni na voljo, se lahko uporabniki uvoza konverzij zunaj spleta zanašajo na druge identifikatorje, kot so zgoščeni podatki, ki jih posredujejo uporabniki, wbraid/gbraid ali session_attributes.
Na tej strani
O polju »session_attributes«
session_attributes je polje, ki zagotavlja dodaten kontekst in signale o uporabnikovi interakciji s spletnim mestom, kar lahko izboljša merjenje konverzij, poročanje (vključno z razčlenitvijo po isti/različnih napravah) in natančnost ponujanja. S spodnjim skriptom za čelni del lahko ustvarite niz session_attributes, kodiran v obliki base64, ga posredujete v zbirko podatkov/CRM in pošljete Googlu v uvozih prek API-ja. Če ne morete uporabiti skripta za čelni del, uporabite polje session_attributes_key_value_pairs za pošiljanje posameznih parov ključev/vrednosti.
Priporočamo, da pošljete vsa podpolja, lahko pa pošljete tudi poljubno število podpolj. Vsa podpolja so izbirna. Priporočena velikost shrambe za polje session_attributes je 5 KB. Večina uporabnikov ne bo presegla te velikosti. Če session_attributes presega to velikost, se obrnite na ponudnika sistema CRM, da spremeni velikost polja (močno priporočeno), ali pa iz pomožne funkcije JavaScript odstranite parametra landing_page_url in landing_page_referrer.
Tu so podpolja znotraj polja session_attributes:
gad_source: Združeni parameter, ki se prikaže v URL-ju za prepoznavanje vira prometa, ki izvira iz oglasov. Preberite več o parametrih URL-jev »gad_*«.gad_campaignid: ID določene oglaševalske akcije, ki je spodbudila klik oglasa. Preberite več o parametrih URL-jev »gad_*«.landing_page_url: Celotni URL ciljne strani na vašem spletnem mestu. To označuje stran, na katero je uporabnik sprva prispel.session_start_time_usec: Časovna oznaka začetka uporabnikove seje na vašem spletnem mestu. Tako lahko sledite trajanju obiskov uporabnikov. Pomembno je, da uporabite dosledno obliko zapisa časa, in sicer časovno oznako v mikrosekundah UNIX-ove epohe.landing_page_referrer: URL spletne strani, ki je uporabnika povezala z vašim spletnim mestom. Tako boste lažje razumeli vire prometa, ki vodijo do vašega spletnega mesta. Več informacij o napotiteljih je na voljo v tem članku, ki se sicer osredotoča na Analytics, vendar je koncept napotitelja univerzalen za ves splet.landing_page_user_agent: Niz, ki določa uporabnikov brskalnik in operacijski sistem. Ti podatki so lahko koristni za razumevanje tehničnega okolja uporabnikov.
Zajemanje polja »session_attributes«
Na ciljni strani lahko za zajemanje in ohranjanje polja session_attributes uporabite pomožno funkcijo JavaScript in spodnji obrazec HTML.
Ta vzorčna koda shrani podatke v localStorage. Pred implementacijo na spletnem mestu poskrbite tudi, da so vse potrebne zahteve glede privolitve in hrambe podatkov, specifične za vaše spletno mesto, upoštevane, kot morajo biti.
Obrazec HTML
- Če želite dodati skrito polje za
session_attributes, morate spremeniti vsako stran za oddajo obrazca. Tako se bosession_attributesposredoval v zaledni sistem. Spodaj je prikazan vzorčni primer kode, ki to ponazarja.<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> - Vzorčni skript za zajem polja
session_attributes_encodedin njegovo nastavitev v polju obrazca. Ta vzorčna koda shrani podatke v 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>
Pošiljanje podatkov v Google Ads
1. Polje »session_attributes_encoded« v API-ju za Google Ads
Obstoječi uporabniki uvoza konverzij zunaj spleta, ki uporabljajo JavaScript, lahko te podatke pošljejo tako, da nastavijo kodirano polje session_attributes, zajeto iz JavaScripta, ki je na voljo v novem polju, imenovanem ClickConversion.session_attributes_encoded, v obstoječi shemi nalaganja. Še naprej uporabljajte trenutni postopek za uvoz konverzij zunaj spleta, vendar pri uvozih nastavite to novo polje. Google Ads bo uporabil session_attributes, ko drugi identifikatorji ne bodo prisotni.
Vsi novi uporabniki morajo uporabljati API Data Manager. Če račun ni bil dodan na seznam dovoljenih za prenos naslovov IP ali atributov seje prek API-ja za Google Ads, boste za te konverzije prejeli sporočilo o napaki.
Napredno
Če ne morete uporabiti JavaScripta, lahko zajamete posamezne pare ključev/vrednosti in jih pošljete z uvozi konverzij zunaj spleta.
Obstoječi uporabniki uvoza konverzij zunaj spleta, ki ne uporabljajo JavaScripta, lahko v obstoječi shemi nalaganja nastavijo tudi polje s parom ključa in vrednosti, imenovano ClickConversion.session_attributes_key_value_pairs. Priporočamo, da pri klicanju API-ja pošljete pare ključev in vrednosti s temi polji. Oglejte si dokumentacijo za razvijalce, v kateri je pojasnjeno, kako v »ClickConversion« dodate posamezne pare ključev in vrednosti.
2. Polje »session_attributes« z upraviteljem podatkov
Polje session_attributes lahko pošljete tudi z upraviteljem podatkov.
- Uporabniški vmesnik upravitelja podatkov: Z zagotovljenim JavaScriptom ustvarite polje
session_attributesin ga naložite prek uporabniškega vmesnika upravitelja podatkov. - API Data Manager: Izvedete lahko integracijo z API-jem Data Manager za programsko nalaganje podatkov. Za podrobna navodila in podrobnosti o shemi si oglejte dokumentacijo za upravitelja podatkov.
Če pošljete ustrezne podatke, Googlu Ads omogočite, da te podatke uporabi za dodeljevanje konverzij ustreznim oglaševalskim akcijam in zagotavljanje celovitejšega poročanja o konverzijah.
