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
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 följande underfält i fältet session_attributes, även om bara fyra av de sex är obligatoriska:
gad_source(obligatoriskt): 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(obligatoriskt): Id för den specifika annonskampanj som ledde till annonsklicket. Läs mer om gad_*-webbadressparametrar.session_start_time_usec(obligatoriskt): 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_user_agent(obligatoriskt): 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ö.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.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.
Den rekommenderade lagringsstorleken för fältet session_attributes är 5 kB, vilket de flesta användningsfall inte överskrider. Om session_attributes överskrider 5 kB rekommenderar vi att du kontaktar din CRM-leverantör för att ändra fältstorleken. Du kan även ta bort parametrarna landing_page_url och landing_page_referrer från JavaScript-hjälpfunktionen.
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
- 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 skickassession_attributestill ditt backend-system. Nedan ser du ett exempel på 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> - Exempelskript för att fånga upp
session_attributes_encodedoch 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
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.
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 om hur du lägger till enskilda nyckel/värdepar i en ClickConversion.
Läs igenom följande rekommendationer och uppdatera implementeringen för att se till att giltig data skickas:
gad_campaignid (kampanj-id): Se till att du konsekvent skickar det giltiga Google Ads-kampanj-id som är kopplat till annonsklicket. Detta är kampanj-id:t som fylls i annonsklickadressen somgad_campaignid=1234. Detta är ett viktigt attribut som är avgörande för korrekt attribution.session_start_time_usec: Se till att attributet (tidsstämpeln för när användarsessionen började) skickas konsekvent.landing_page_url (webbadress): Se till att du skickar den korrekta, fullständiga webbadressen till målsidan. Skicka inte platshållarsträngar, interna programsökvägar eller ofullständiga webbadresser.- Obs! Om den korrekta, fullständiga webbadressen inte är tillgänglig rekommenderar vi att du tar bort hela fältet eftersom felaktig data kan påverka modelleringen negativt.
landing_page_user_agent (användaragent): Se till att strängen korrekt återspeglar användarens webbläsare och operativsystem och undvik att skicka generiska eller hårdkodade värden.
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_attributesoch 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 mera heltäckande konverteringsrapportering.