Import af offlinekonverteringer (OCI, Offline Conversion Import) sporer offlinekonverteringer fra import ved hjælp af GCLID. I situationer, hvor GCLID ikke er tilgængeligt, kan OCI-brugere anvende andre id'er, f.eks. hashkrypterede brugergenererede data, wbraid/gbraid eller session_attributes.
På denne side
- Om session_attributes
- Sådan registrerer du session_attributes
- Sådan sender du dataene til Google Ads
Om session_attributes
session_attributes er et felt, der indeholder yderligere kontekst og signaler om brugerens interaktion med dit website, hvilket kan forbedre nøjagtigheden af konverteringsmåling, rapportering (herunder opdeling for samme/forskellige enheder) og budgivning. Du kan bruge vores frontend-script nedenfor til at oprette den base64-indkodede streng med session_attributes, overføre den til din database/dit CRM-system og sende den til Google i dine API-importer. Hvis du ikke kan bruge frontend-scriptet, skal du bruge feltet session_attributes_key_value_pairs til at sende hvert nøgleværdipar individuelt.
Vi anbefaler, at du sender alle underfelterne, men du kan vælge at sende lige så få eller så mange af dem, som du vil. Alle underfelter er valgfri. Den anbefalede lagerstørrelse for feltet session_attributes er 5 kB. Det meste forbrug overskrider ikke denne størrelse. Hvis session_attributes er større end dette, skal du enten samarbejde med din CRM-udbyder om at ændre feltstørrelsen (anbefales på det kraftigste) eller fjerne parametrene landing_page_url og landing_page_referrer fra JavaScript-støttefunktionen.
Her er underfelterne i feltet session_attributes:
gad_source: En aggregeret parameter, der vises i webadressen for at identificere kilden til trafik, der stammer fra annoncer. Få flere oplysninger om gad_*-webadresseparametre.gad_campaignid: Id'et for den specifikke annoncekampagne, der førte til annonceklikket. Få flere oplysninger om gad_*-webadresseparametre.landing_page_url: Den fulde webadresse for landingssiden på dit website. Dette angiver den specifikke side, som brugeren først ankom til.session_start_time_usec: Tidsstemplet for, hvornår brugerens session startede på dit website. Dette hjælper med at spore varigheden af brugerbesøg. Det er vigtigt at bruge et ensartet tidsformat i UNIX-tidsstempelepoken i mikrosekunder.landing_page_referrer: Webadressen for den webside, der førte brugeren til dit website. Dette hjælper med at forstå de trafikkilder, der fører til dit website. Du kan få flere oplysninger om henvisningskilder i denne artikel, der fokuserer på Analytics, men hvor konceptet henvisningskilder er universelt på nettet.landing_page_user_agent: En streng, der identificerer brugerens browser og operativsystem. Disse oplysninger kan være nyttige, hvis du vil have indblik i dine brugeres tekniske miljø.
Sådan registrerer du session_attributes
Du kan bruge JavaScript-hjælpefunktionen og HTML-formularen nedenfor på din landingsside til at registrere og bevare session_attributes.
Denne eksempelkode gemmer data i localStorage. Inden du implementerer på dit website, skal du desuden sikre dig, at eventuelle nødvendige krav til samtykke og dataopbevaring, der er specifikke for dit website, overholdes efter behov.
HTML-formular
- Du skal ændre hver formularindsendelsesside, så der tilføjes et skjult felt til
session_attributes. Sådan bliversession_attributesoverført til dit backend-system. Nedenfor kan du se en eksempelkode, der demonstrerer dette.<form action="" name="myForm">
Navn: <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> - Eksempel på et script til registrering af
session_attributes_encodedog angivelse af det i formularfeltet. Denne eksempelkode gemmer 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>
Sådan sender du dataene til Google Ads
1. Feltet session_attributes_encoded i Google Ads API
Hvis du er blandt de brugere, der allerede bruger import af offlinekonverteringer (OCI, Offline Conversion Import), og du bruger JavaScript, skal du sende disse data ved at angive de kodede session_attributes, der er registreret fra det JavaScript, der er angivet, i et nyt felt med navnet ClickConversion.session_attributes_encoded i dit eksisterende uploadskema. Fortsæt med at bruge din nuværende OCI-proces, men angiv dette nye felt, når du foretager importer. Google Ads bruger session_attributes, når dine andre id'er ikke er til stede.
Alle nye brugere skal bruge Data Manager API. Hvis en konto ikke er på tilladelseslisten for overførsel af IP-adresser eller sessionsattributter via Google Ads API, får du en fejlmeddelelse for disse konverteringer.
Avanceret
Hvis du ikke kan bruge JavaScript, kan du registrere de individuelle nøgleværdipar og sende dem sammen med dine importer af offlinekonverteringer.
Hvis du er blandt de brugere, der allerede bruger import af offlinekonverteringer (OCI, Offline Conversion Import), og du ikke bruger JavaScript, kan du også angive feltet med nøgleværdipar ClickConversion.session_attributes_key_value_pairs i dit eksisterende uploadskema. Vi foreslår, at du sender nøgleværdipar med disse felter, når du aktiverer API'en. Se udviklerdokumentationen, der forklarer, hvordan du føjer individuelle nøgleværdipar til en ClickConversion.
2. Feltet session_attributes ved at bruge Data Manager
Du kan også sende feltet session_attributes ved at bruge Data Manager.
- Data Manager-brugerfladen: Brug det angivne JavaScript til at oprette feltet
session_attributes, og upload det via Data Manager-brugerfladen. - Data Manager API: Du kan integrere med Data Manager API'et for at uploade dine data programmatisk. Se dokumentationen til Data Manager for at få specifikke vejledninger og oplysninger om skemaer.
Ved at sende de rigtige data giver du Google Ads mulighed for at bruge disse oplysninger til at tilskrive konverteringer til de korrekte kampagner og give dig mere omfattende konverteringsrapportering.
