O polju »session_attributes«

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«
• Zajemanje polja »session_attributes«
• Pošiljanje podatkov v Google Ads

---

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 ta podpolja polja session_attributes, čeprav so obvezna samo 4 od 6:

• gad_source (obvezno): 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_*«.
  • Primer vrednosti: "1"
    Smernica: To so združeni parametri, ki so dodani URL-ju klika oglasa (na primer: &gad_source=1). Zajemite vrednost, ki je prisotna v URL-ju ciljne strani.
• gad_campaignid (obvezno): ID določene oglaševalske akcije, ki je spodbudila klik oglasa. Preberite več o parametrih URL-jev »gad_*«.
  • Primer vrednosti: "1234567890"
    Smernica: To je tudi parameter URL-ja (na primer: &gad_campaignid=1234567890) in ga je treba zajeti iz URL-ja ciljne strani.
• session_start_time_usec (obvezno): Č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.
  • Primer vrednosti: "1678886400000000" (predstavlja določen čas v mikrosekundah)
    Smernica: Zagotovite dosledno obliko ure (časovna oznaka v mikrosekundah UNIX-ove epohe). Tako lahko sledite trajanju obiskov uporabnikov.
• landing_page_user_agent (obvezno): Niz, ki določa uporabnikov brskalnik in operacijski sistem. Ti podatki so lahko koristni za razumevanje tehničnega okolja uporabnikov.
  • Primer vrednosti: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/117.0.0.0 Safari/537.36"
    Smernica: To je treba zajeti iz glave uporabnikovega posrednika dohodne zahteve HTTP za ciljno stran. Izogibajte se splošnim ali fiksno nastavljenim vrednostim.
• landing_page_url: Celotni URL ciljne strani na vašem spletnem mestu. To označuje stran, na katero je uporabnik sprva prispel.
  • Primer vrednosti: "https://www.example.com/product/deluxe-widget?gad_source=1&gad_campaignid=1234567890"
    Smernica: Navedite točni in celotni URL. Ne uporabljajte nadomestnih nizov, internih poti aplikacij (npr. »/productdetailscreen«) ali nepopolnih URL-jev. Če celotni in točni URL ni na voljo, je bolje, da to polje izpustite.
• 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.

  • Primer vrednosti: "https://www.google.com/" ali "https://www.socialmedia.com/referral"
    Smernica: To odraža neposredno prejšnjo stran, ki jo je uporabnik obiskal, preden je prispel na vaše spletno mesto.

Najboljši postopki za kakovost podatkov

• Izogibajte se neveljavnim podatkom za landing_page_url: Nepravilne ali delne vrednosti za landing_page_url negativno vplivajo na modeliranje. Če ne morete zagotoviti celotnega in točnega URL-ja, je bolje, da ga izpustite.
• Preprečevanje podvojenih nalaganj: Istega dogodka konverzije ne pošiljajte večkrat. Za odstranjevanje podvojenih elementov uporabite enolični identifikator, kot je ID naročila.

Priporočena velikost shrambe za polje session_attributes je 5 KB, kar večina primerov uporabe ne bo presegla. Če session_attributes presega 5 KB, priporočamo, da se obrnete na ponudnika sistema CRM, da spremeni velikost polja. Iz pomožne funkcije JavaScript lahko odstranite tudi parametra landing_page_url in landing_page_referrer.

---

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

1. Če želite dodati skrito polje za session_attributes, morate spremeniti vsako stran za oddajo obrazca. Tako se bo session_attributes posredoval 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>
2. Vzorčni skript za zajem atributa session_attributes_encoded in 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

Od 2. februarja 2026 API za Google Ads ne bo več sprejemal novih uporabnikov podatkov o atributih seje ali naslovu IP v okviru uvozov konverzij. Za zagotavljanje bolj zmogljive in prilagodljive izkušnje pri obdelavi kompleksnih podatkov priporočamo, da razvijalci API-ja za Google Ads preidejo na API Data Manager – kjer atributi seje in naslov IP so sprejeti – kot primarni API za uvoz konverzij in podatkov uporabnika. Preberite več o spremembah podpore za naslov IP in atribut seje 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.

Opomba: Za dostop do novega polja v API-ju za Google Ads morate nadgraditi na v19 ali novejšo.

Dodatno

Č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.

Preglejte naslednja priporočila in posodobite implementacijo, da poskrbite, da se bodo pošiljali veljavni podatki:

• gad_campaignid (ID oglaševalske akcije): Zagotovite, da dosledno pošiljate veljaven ID oglaševalske akcije Google Ads, povezan s klikom oglasa. To je ID oglaševalske akcije, ki je izpolnjen v URL-ju klika oglasa kot »gad_campaignid=1234«. To je ključni atribut in je ključen za natančno dodeljevanje.
• session_start_time_usec: Zagotovite, da dosledno pošiljate atribut (časovno oznako začetka uporabniške seje).
• landing_page_url (URL): Zagotovite, da pošiljate točen in celoten URL ciljne strani. Ne pošiljajte nadomestnih nizov, internih poti aplikacij ali nepopolnih URL-jev.
  • Opomba: Če natančen in celoten URL ni na voljo, priporočamo, da odstranite celotno polje, saj lahko napačni podatki negativno vplivajo na modeliranje.
• landing_page_user_agent (uporabnikov posrednik): Zagotovite, da niz natančno odraža uporabnikov brskalnik in operacijski sistem, ter se izogibajte pošiljanju splošnih ali fiksno nastavljenih 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_attributes in 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, programu Google Ads omogočite, da te podatke uporabi za dodeljevanje konverzij ustreznim oglaševalskim akcijam in zagotavljanje celovitejše poročanje o konverzijah.