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 følgende underfelter i feltet session_attributes, selvom kun 4 af de 6 er påkrævet:
gad_source(påkrævet): En aggregeret parameter, der vises i webadressen for at identificere kilden til trafik, der stammer fra annoncer. Få flere oplysninger om gad_*-webadresseparametre.- Eksempelværdi:
"1"
Retningslinje: Dette er aggregerede parametre, der føjes til webadressen for annonceklikket (f.eks.&gad_source=1). Du skal registrere den værdi, der er angivet i webadressen for landingssiden.
- Eksempelværdi:
gad_campaignid(påkrævet): Id'et for den specifikke annoncekampagne, der førte til annonceklikket. Få flere oplysninger om gad_*-webadresseparametre.- Eksempel på værdi:
"1234567890"
Retningslinje: Dette er også en webadresseparameter (f.eks.&gad_campaignid=1234567890) og skal hentes fra webadressen for landingssiden.
- Eksempel på værdi:
session_start_time_usec(påkrævet): 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.- Eksempel på værdi:
"1678886400000000"(repræsenterer et bestemt tidspunkt i mikrosekunder)
Retningslinje: Sørg for et ensartet tidsformat (UNIX-tidsstempel i mikrosekunder). Dette hjælper med at spore varigheden af brugerbesøg.
- Eksempel på værdi:
landing_page_user_agent(påkrævet): En streng, der identificerer brugerens browser og operativsystem. Disse oplysninger kan være nyttige, hvis du vil have indblik i dine brugeres tekniske miljø.- Eksempelværdi:
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/117.0.0.0 Safari/537.36"
Retningslinje: Dette skal hentes fra brugeragentheaderen i den indgående HTTP-anmodning for landingssiden. Undgå generiske eller hardcodede værdier.
- Eksempelværdi:
landing_page_url: Den fulde webadresse for landingssiden på dit website. Dette angiver den specifikke side, som brugeren først ankom til.- Eksempel på værdi:
"https://www.example.com/product/deluxe-widget?gad_source=1&gad_campaignid=1234567890"
Retningslinje: Angiv den nøjagtige, fulde webadresse. Brug ikke pladsholderstrenge, interne appstier (f.eks. "/productdetailscreen") eller ufuldstændige webadresser. Det er bedre at udelade dette felt, hvis den fulde, nøjagtige webadresse ikke er tilgængelig.
- Eksempel på værdi:
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.-
Eksempelværdi:
"https://www.google.com/"eller"https://www.socialmedia.com/henvisning"
Retningslinje: Dette afspejler den umiddelbart foregående side, som brugeren var på, før vedkommende landede på dit website.
-
Bedste praksis for datakvalitet
- Undgå dårlige
landing_page_url-data: Forkerte eller delviselanding_page_url-værdier er skadelige for modelleringen. Det er bedre at udelade dem, hvis du ikke kan angive den fulde, nøjagtige webadresse. - Undgå dublerede uploads: Send ikke den samme konverteringshændelse flere gange. Brug et unikt id, f.eks. et ordre-id, til at fjerne dubletter.
Den anbefalede lagerstørrelse for feltet session_attributes er 5 KB, hvilket de fleste eksempler på brug ikke overskrider. Hvis session_attributes overstiger 5 KB, anbefaler vi, at du samarbejder med din CRM-udbyder om at ændre feltstørrelsen. Du kan også fjerne parametrene landing_page_url og landing_page_referrer fra JavaScript-støttefunktionen.
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">
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> - 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.
Du kan gennemgå følgende anbefalinger og opdatere din implementering for at sikre, at der sendes gyldige data:
gad_campaignid (kampagne-id): Sørg for, at du konsekvent sender det gyldige Google Ads-kampagne-id, der er knyttet til annonceklikket. Dette er det kampagne-id, der udfyldes i webadressen for annonceklik som "gad_campaignid=1234". Dette er en kerneattribut, som er afgørende for nøjagtig tilskrivning.session_start_time_usec: Sørg for konsekvent at sende attributten (tidsstemplet for, hvornår brugersessionen startede).landing_page_url (webadresse): Sørg for, at du sender den korrekte, fulde webadresse for landingssiden. Send ikke pladsholderstrenge, interne appstier eller ufuldstændige webadresser.- Bemærk! Hvis den nøjagtige, fulde webadresse ikke er tilgængelig, anbefales det at fjerne hele feltet, da forkerte data kan have en negativ indvirkning på modelleringen.
landing_page_user_agent (brugeragent): Sørg for, at strengen nøjagtigt afspejler brugerens browser og operativsystem, og undgå at sende generiske eller hardcodede værdier.
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.