Offline conversies importeren (OCI) houdt offline conversies bij die worden geïmporteerd met de GCLID. In gevallen waarin de GCLID niet beschikbaar is, kunnen OCI-gebruikers andere ID's gebruiken, zoals gehashte door gebruikers ingediende gegevens, wbraid/gbraid en session_attributes.
Op deze pagina
Over session_attributes
session_attributes is een veld dat meer context en signalen biedt over de interactie van de gebruiker met uw website. Hierdoor kunnen de conversiemeting, rapportages (inclusief uitsplitsing voor hetzelfde/verschillende apparaten) en de nauwkeurigheid van biedingen worden verbeterd. U kunt ons frontend-script hieronder gebruiken om de base64-gecodeerde tekenreeks van session_attributes te maken, deze door te geven aan uw database/CRM en naar Google te sturen in uw API-imports. Als u het frontend-script niet kunt gebruiken, gebruikt u het veld session_attributes_key_value_pairs om elk sleutel/waarde-paar afzonderlijk te sturen.
We raden u aan alle subvelden te sturen, maar u kunt er zo veel of zo weinig sturen als u wilt. Alle subvelden zijn optioneel. De aanbevolen opslaggrootte voor het veld session_attributes is 5 KB. Meestal wordt deze grootte niet overschreden. Als session_attributes groter is, werkt u samen met uw CRM-provider om de veldgrootte aan te passen (sterk aanbevolen) of verwijdert u de parameters landing_page_url en landing_page_referrer uit de JavaScript-helperfunctie.
Dit zijn de subvelden in het veld session_attributes:
gad_source: Een verzamelparameter die in de URL staat om de bron te bepalen van het verkeer dat afkomstig is van advertenties. Meer informatie over URL-parameters van het type gad_*.gad_campaignid: De ID van de specifieke advertentiecampagne die de advertentieklik heeft opgeleverd. Meer informatie over URL-parameters van het type gad_*.landing_page_url: De hele URL van de landingspagina op uw website. Dit geeft aan op welke specifieke pagina de gebruiker de eerste keer is terechtgekomen.session_start_time_usec: Het tijdstempel van het moment waarop de sessie van de gebruiker op uw website is begonnen. Zo kunt u de duur van gebruikersbezoeken bijhouden. Het is belangrijk om een consistente tijdnotatie te gebruiken in tijdvak-microseconden van het UNIX-tijdstempel.landing_page_referrer: De URL van de webpagina die de gebruiker naar uw website heeft geleid. Hiermee krijgt u inzicht in de verkeersbronnen die naar uw site leiden. Ga naar dit artikel voor meer informatie over verwijzende URL's. Hoewel dit artikel over Analytics gaat, is een verwijzende URL een algemeen concept op het web.landing_page_user_agent: Een tekenreeks die de browser en het besturingssysteem van de gebruiker aangeeft. Deze informatie kan nuttig zijn om inzicht te krijgen in de technische omgeving van uw gebruikers.
Session_attributes registreren
U kunt de JavaScript-helperfunctie en het HTML-formulier hieronder op uw landingspagina gebruiken om session_attributes te registreren en op te slaan.
Deze voorbeeldcode slaat gegevens op in localStorage. Voordat u de functie op uw website implementeert, moet u ook zorgen dat u voldoet aan de vereisten voor toestemming en bewaring van gegevens die specifiek van toepassing zijn op uw website.
HTML-formulier
- U moet elke formulier-indieningspagina aanpassen en een verborgen veld voor
session_attributesdaaraan toevoegen. Zo wordensession_attributesdoorgegeven aan uw backend-systeem. Hieronder staat voorbeeldcode.<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> - Voorbeeldscript om
session_attributes_encodedte registreren en in het formulierveld in te stellen. Deze voorbeeldcode slaat gegevens op in 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>
De gegevens naar Google Ads sturen
1. Het veld session_attributes_encoded in de Google Ads API
Bestaande gebruikers van offline conversies importeren (OCI) die JavaScript gebruiken, sturen deze gegevens door de gecodeerde session_attributes in te stellen die zijn vastgelegd in de JavaScript die is ingediend in een nieuw veld met de naam ClickConversion.session_attributes_encoded in hun bestaande uploadschema. Blijf uw huidige OCI-proces gebruiken, maar stel dit nieuwe veld in als u importeert. Google Ads gebruikt session_attributes als uw andere ID's niet aanwezig zijn.
Alle nieuwe gebruikers moeten de Data Manager API gebruiken. Als een account niet op de toelatingslijst staat om IP-adressen of sessiekenmerken over te dragen via de Google Ads API, krijgt u een foutmelding voor die conversies.
Geavanceerd
Als u geen JavaScript kunt gebruiken, kunt u de afzonderlijke sleutel/waarde-paren vastleggen en deze samen met uw offline conversies imports sturen.
Bestaande gebruikers van offline conversies importeren (OCI) die geen JavaScript gebruiken, kunnen ook het veld met sleutel/waarde-paren, ClickConversion.session_attributes_key_value_pairs genaamd, instellen in hun bestaande uploadschema. We raden u aan sleutel/waarde-paren met deze velden te sturen als u de API aanroept. In de documentatie voor ontwikkelaars vindt u meer informatie over hoe u afzonderlijke sleutel/waarde-paren aan een ClickConversion toevoegt.
Neem de volgende aanbevelingen door en update uw implementatie om te zorgen dat er geldige gegevens worden gestuurd:
gad_campaignid (campagne-ID): Zorg dat u consequent de geldige Google Ads-campagne-ID stuurt die aan de advertentieklik is gekoppeld. Dit is de campagne-ID die in de URL van de advertentieklik is ingevuld alsgad_campaignid=1234. Dit is een kernkenmerk en is essentieel voor nauwkeurige attributie.session_start_time_usec: Zorg dat u het kenmerk consistent stuurt (het tijdstempel waarop de gebruikerssessie is begonnen).landing_page_url (URL): Zorg dat u de juiste, volledige URL van de landingspagina stuurt. Stuur geen tijdelijke tekenreeksen, interne app-paden of onvolledige URL's.- Opmerking: Als de nauwkeurige, volledige URL niet beschikbaar is, raden we u aan het hele veld te verwijderen, omdat onjuiste gegevens een negatieve invloed kunnen hebben op de modellering.
landing_page_user_agent (User-agent): Zorg dat de tekenreeks de browser en het besturingssysteem van de gebruiker nauwkeurig weerspiegelt en stuur geen algemene of hardgecodeerde waarden.
2. Het veld session_attributes via Gegevensbeheer
U kunt het veld session_attributes ook sturen via Gegevensbeheer.
- UI van Gegevensbeheer: Gebruik de meegeleverde JavaScript om het veld
session_attributeste maken en upload het via de UI van Gegevensbeheer. - Data Manager API: U kunt integreren met de Data Manager API om uw gegevens programmatisch te uploaden. Raadpleeg de documentatie van Gegevensbeheer voor specifieke instructies en schemagegevens.
Als u de juiste gegevens stuurt, kan Google Ads deze informatie gebruiken om conversies aan de juiste campagnes toe te schrijven en u uitgebreidere conversierapporten te bieden.