Med importering av konverteringer utenfor nettet spores konverteringer utenfor nettet fra importeringer ved hjelp av GCLID. I scenarioer der GCLID ikke er tilgjengelig, kan de som bruker importering av konverteringer utenfor nettet, benytte andre identifikatorer (f.eks. hashede data fra brukere, wbraid/gbraid eller session_attributes).
På denne siden
Om session_attributes
session_attributes er et felt som inneholder mer kontekst og signaler om brukerens interaksjoner med nettstedet ditt. Dette kan gi mer presis konverteringsmåling, rapportering (inkludert en oversikt på samme enhet / flere enheter) og budgivning. Du kan bruke grensesnittskriptet nedenfor til å lage den base64-kodede strengen for session_attributes, sende den til databasen eller CRM-systemet du bruker, og sende den til Google via API-importeringer. Hvis du ikke kan bruke grensesnittskriptet, kan du sende hvert nøkkel/verdi-par enkeltvis via feltet session_attributes_key_value_pairs.
Vi anbefaler at du sender alle underfeltene, men du kan velge å sende så få eller så mange som du vil. Alle underfeltene er valgfrie. Den anbefalte lagringsstørrelsen for session_attributes-feltet er 5 kB. Få bruksmønstre overskrider denne størrelsen. Hvis session_attributes er større enn dette, kan du enten samarbeide med CRM-leverandøren om å endre feltstørrelsen (anbefales på det sterkeste) eller fjerne parameterne landing_page_url og landing_page_referrer fra JavaScript-hjelpefunksjonen.
Dette er underfeltene i session_attributes-feltet:
gad_source: Dette er en samlet parameter som vises i nettadressen for å identifisere kilden til annonsetrafikken. Finn ut mer om gad_*-nettadresseparametere.gad_campaignid: Dette er ID-en for den spesifikke annonsekampanjen som førte til annonseklikket. Finn ut mer om gad_*-nettadresseparametere.landing_page_url: Dette er den fullstendige nettadressen til landingssiden på nettstedet. Dette indikerer den spesifikke siden brukeren først kom til.session_start_time_usec: Dette er tidsstempelet for når brukerens økt startet på nettstedet. Dette gjør det enklere å spore varigheten av brukerbesøk. Det er viktig at du bruker et konsekvent tidsformat i mikrosekunder i samsvar med UNIX-epoken.landing_page_referrer: Dette er nettadressen til nettsiden som viderekoblet brukeren til nettstedet. Dette kan gi en bedre forståelse av trafikkildene som fører til nettstedet. Du finner mer informasjon om henvisningsadresser i denne artikkelen, som hovedsakelig handler om Analytics, men henvisningsadresser er et universelt konsept på nettet.landing_page_user_agent: Dette er en streng som identifiserer brukerens nettleser og operativsystem. Denne informasjonen kan være nyttig for å forstå brukernes tekniske miljø.
Slik registrerer du session_attributes
Du kan bruke JavaScript-hjelpefunksjonen og HTML-skjemaet nedenfor på landingssiden din til å registrere og lagre session_attributes.
Denne eksempelkoden lagrer data i den lokale lagringen. Før du implementerer tagger på nettstedet, må du også påse at du overholder eventuelle krav til samtykke og oppbevaring av data som er spesifikke for nettstedet.
HTML-skjema
- Du må legge til et skjult felt for
session_attributespå alle sidene der skjemaer sendes inn. Slik sendessession_attributestil tjenerdelen av systemet ditt. Nedenfor ser du eksempelkode som viser dette.<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="Send inn skjemaet" name="btnSubmit">
</form> - Eksempelskript for å registrere
session_attributes_encodedog angi det i skjemafeltet. Denne eksempelkoden lagrer data i den lokale lagringen.<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>
Slik sender du dataene til Google Ads
1. «session_attributes_encoded»-feltet i Google Ads API
Hvis du allerede bruker JavaScript til importering av konverteringer utenfor nettet, kan du sende disse dataene ved å angi de kodede session_attributes-verdiene som registreres via JavaScript-koden, i et nytt felt som heter ClickConversion.session_attributes_encoded, i det eksisterende opplastingsoppsettet. Fortsett å bruke den nåværende prosessen for importering av konverteringer utenfor nettet, men angi dette nye feltet når du importerer data. Google Ads bruker session_attributes når de andre identifikatorene ikke er til stede.
Alle nye brukere må bruke Data Manager API. Hvis en konto ikke er satt på godkjenningslisten for å overføre IP-adresser eller øktattributter via Google Ads API, får du en feilmelding for disse konverteringene.
Avansert
Hvis du ikke kan bruke JavaScript, kan du registrere nøkkel/verdi-parene enkeltvis og sende dem sammen med importeringene av konverteringer utenfor nettet.
Hvis du allerede bruker importering av konverteringer utenfor nettet, men ikke bruker JavaScript, kan du også angi feltet for nøkkel/verdi-par som heter ClickConversion.session_attributes_key_value_pairs, i det eksisterende opplastingsoppsettet. Vi anbefaler at du sender nøkkel/verdi-par med disse feltene når du kaller opp API-et. I utviklerdokumentasjonen forklarer vi hvordan du legger til nøkkel/verdi-par enkeltvis i ClickConversion-elementer.
2. «session_attributes»-feltet via Data Manager
Du kan også sende session_attributes-feltet via Data Manager.
- UI-et for Data Manager: Bruk den angitte JavaScript-koden til å opprette
session_attributes-feltet, og last det opp via UI-et for Data Manager. - Data Manager API: Du kan integrere Data Manager API for å laste opp dataene dine programmatisk. Du finner spesifikk veiledning og informasjon om oppsettet i Data Manager-dokumentasjonen.
Når du sender de rette dataene, kan Google Ads bruke denne informasjonen til å tilskrive konverteringer til de rette kampanjene og gi deg mer omfattende konverteringsrapportering.