Om session_attributes

Import av offlinekonvertering (OCI) spårar offlinekonverteringar från importer med hjälp av GCLID. I situationer där GCLID inte är tillgängligt kan OCI-användare använda andra identifierare, till exempel hashad data som tillhandahålls av användaren, wbraid/gbraid eller session_attributes.

På den här sidan

• Om session_attributes
• Samla in session_attributes
• Skicka data till Google Ads

---

Om session_attributes

session_attributes är ett fält som ger ytterligare sammanhang och signaler om användarens interaktion med din webbplats. Det kan förbättra noggrannheten i konverteringsmätning, rapportering (däribland fördelning efter samma enhet/flera enheter) och budgivning. Du kan använda vårt användargränssnittsskript nedan för att skapa den base64-kodade strängen med session_attributes, skicka den till din databas/ditt CRM-system och skicka den vidare till Google i dina API-importer. Om du inte kan använda användargränssnittsskriptet kan du skicka varje nyckel/värdepar separat med fältet session_attributes_key_value_pairs.

Vi rekommenderar att du skickar alla underfält, men du kan välja hur många du vill sicka. Alla underfält är valfria. Den rekommenderade lagringsstorleken för fältet session_attributes är 5 kB. Den storleken överskrids oftast inte vid normal användning. Om session_attributes är större än så kan du antingen kontakta din CRM-leverantör för att ändra fältstorleken (starkt rekommenderat) eller ta bort parametrarna landing_page_url och landing_page_referrer från JavaScript-hjälpfunktionen.

Följande underfält finns i fältet session_attributes:

• gad_source: En samlad parameter som visas i webbadressen för att identifiera källan till trafik som kommer från annonser. Läs mer om gad_*-webbadressparametrar.
• gad_campaignid: Id för den specifika annonskampanj som ledde till annonsklicket. Läs mer om gad_*-webbadressparametrar.
• landing_page_url: Den fullständiga webbadressen till målsidan på din webbplats. Denna parameter anger den specifika sida som användaren kom till först.
• session_start_time_usec: Tidsstämpel för när användarens session påbörjades på din webbplats. Denna parameter hjälper dig att spåra hur lång tid användarna stannar på webbplatsen. Det är viktigt att du använder ett konsekvent tidsformat i unixtid i mikrosekunder.
• landing_page_referrer: Webbadressen till den webbsida som länkade användaren vidare till din webbplats. Denna parameter hjälper dig att förstå vilka trafikkällor som leder till din webbplats. Mer information om hänvisningsadresser finns i denna artikel. Den fokuserar på Analytics, men begreppet hänvisningskälla gäller hela webben.
• landing_page_user_agent: En sträng som identifierar användarens webbläsare och operativsystem. Denna information kan vara användbar för att förstå användarnas tekniska miljö.

---

Samla in session_attributes

Du kan använda JavaScript-hjälpfunktionen och HTML-formuläret nedan på målsidan för att samla in och lagra session_attributes.

Denna exempelkod lagrar data i localStorage. Innan du implementerar den på webbplatsen behöver du se till att eventuella krav på samtycke och datalagring som är specifika för din webbplats uppfylls.

HTML-formulär

1. Du måste redigera varje sida där formuläret kan skickas in för att lägga till ett dolt fält för session_attributes. Så här skickas session_attributes till ditt backend-system. Nedan finns en exempelkod som visar hur detta fungerar.
   <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. Exempelskript för att samla in session_attributes_encoded och ange det i formulärfältet. Denna exempelkod lagrar data i 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>

---

Skicka data till Google Ads

1. Fältet session_attributes_encoded i Google Ads API

Från och med den 2 februari 2026 accepterar Google Ads API inte längre att nya användare börjar använda data om sessionsattribut eller IP-adress som en del av konverteringsimporter. Vi vill säkerställa en mer robust och skalbar upplevelse för hantering av komplex data och rekommenderar därför att Google Ads API-utvecklare övergår till Data Manager API – där sessionsattribut och IP-adress accepteras – som primärt API för import av konverterings- och användardata. Läs mer om ändringar av stödet för IP-adress och sessionsattribut i Google Ads API.

Befintliga användare av import av offlinekonvertering (OCI) som använder JavaScript kan skicka denna data genom att ange de kodade session_attributes som samlas in av JavaScript-koden i ett nytt fält som heter ClickConversion.session_attributes_encoded i det befintliga uppladdningsschemat. Fortsätt använda din befintliga metod för import av offlinekonverteringar, men ange det nya fältet för dina importer. Google Ads använder session_attributes när dina andra identifierare inte finns med.

Alla nya användare måste använda Data Manager API. Om ett konto inte finns med på godkännandelistan för att skicka IP-adresser eller sessionsattribut via Google Ads API visas ett felmeddelande för dessa konverteringar.

Obs! Du måste uppgradera till v19 eller senare för att få åtkomst till det nya fältet i Google Ads API.

Avancerat

Om du inte kan använda JavaScript kan du samla in de enskilda nyckel/värdeparen och skicka dem tillsammans med dina importer av offlinekonverteringar.

Befintliga användare av import av offlinekonvertering (OCI) som inte använder JavaScript kan även ange fältet ClickConversion.session_attributes_key_value_pairs för nyckel-värdepar i det befintliga uppladdningsschemat. Vi föreslår att du skickar nyckel-värdepar tillsammans med dessa fält när du anropar API:et. I utvecklardokumentationen kan du läsa mer om hur du lägger till enskilda nyckel-värdepar i en ClickConversion.

2. Fältet session_attributes med Data Manager

Du kan även skicka fältet session_attributes med Data Manager.

• Användargränssnittet i Data Manager: Använd den medföljande JavaScript-funktionen för att skapa fältet session_attributes och ladda upp det via användargränssnittet i Data Manager.
• Data Manager API: Du kan integrera med Data Manager API för att ladda upp data programmatiskt. Mer information om specifika anvisningar och schema finns i dokumentationen för Data Manager.

Genom att skicka rätt data kan Google Ads använda informationen för att tillskriva konverteringar till rätt kampanjer och ge dig en mer heltäckande konverteringsrapportering.