L'importation des conversions hors connexion suit les conversions hors connexion dans les importations utilisant le paramètre GCLID. Lorsque GCLID n'est pas disponible, les utilisateurs souhaitant importer des conversions hors connexion peuvent utiliser d'autres identifiants : données hachées fournies par l'utilisateur, wbraid/gbraid ou session_attributes.
Sur cette page
- À propos des session_attributes
- Capturer des session_attributes
- Comment transmettre les données à Google Ads
À propos des session_attributes
Le champ session_attributes donne davantage de contexte et d'indications sur la manière dont un utilisateur interagit avec votre site Web. Cela peut rendre plus précis la mesure des conversions, le reporting (y compris la répartition par appareil identique/différent) et les enchères. Vous pouvez utiliser notre script frontal ci-dessous pour créer la chaîne de session_attributes encodée en Base64, la transmettre à votre base de données/CRM et l'envoyer à Google dans vos importations d'API. Si vous ne pouvez pas utiliser ce script, servez-vous du champ session_attributes_key_value_pairs pour transmettre séparément chaque paire clé-valeur.
Vous pouvez choisir le nombre de sous-champs à envoyer, mais nous vous recommandons de n'en omettre aucun. Les sous-champs sont tous facultatifs. La taille de stockage recommandée pour le champ session_attributes est de 5 Ko. La plupart des utilisations ne dépasseront pas cette taille. Si session_attributes est plus grand, contactez votre fournisseur de CRM pour modifier la taille du champ (fortement recommandé), ou supprimez les paramètres landing_page_url et landing_page_referrer de la fonction d'assistance JavaScript.
Voici les sous-champs inclus dans le champ session_attributes :
gad_source: ce paramètre agrégé intégré à l'URL identifie la source du trafic provenant d'annonces. En savoir plus sur les paramètres d'URL gad_*.gad_campaignid: il s'agit de l'ID de la campagne publicitaire spécifique ayant généré le clic sur une annonce. En savoir plus sur les paramètres d'URL gad_*.landing_page_url: il s'agit de l'URL complète de la page de destination sur votre site Web. Elle indique la page spécifique sur laquelle l'utilisateur arrive en premier.session_start_time_usec: il s'agit du code temporel correspondant au début de la session de l'utilisateur sur votre site Web. Il vous aide à suivre la durée des visites. Il est important de respecter un format d'heure cohérent en microsecondes epoch dans l'horodatage UNIX.landing_page_referrer: il s'agit de l'URL de la page Web qui a redirigé l'utilisateur vers votre site Web. Ce paramètre vous aide à comprendre d'où provient le trafic dirigé vers votre site. Pour en savoir plus sur les URL de provenance, consultez cet article. Bien qu'il porte principalement sur Analytics, le concept d'URL de provenance est le même partout sur le Web.landing_page_user_agent: cette chaîne identifie le navigateur et le système d'exploitation de l'utilisateur. Ces informations peuvent vous aider à comprendre l'environnement technique de vos utilisateurs.
Capturer des session_attributes
Pour capturer et conserver des session_attributes, vous pouvez utiliser la fonction d'assistance JavaScript et le formulaire HTML ci-dessous sur votre page de destination.
Cet exemple de code conserve les données dans localStorage. Avant de l'implémenter sur votre site Web, assurez-vous également de respecter les éventuels impératifs liés au consentement et à la conservation des données spécifiques à votre site.
Formulaire HTML
- Vous devez modifier chaque page d'envoi de formulaire en ajoutant un champ
session_attributescaché. C'est ainsi que vossession_attributesseront transmis à votre système backend. L'exemple de code ci-dessous illustre le fonctionnement.<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> - Exemple de script permettant de capturer
session_attributes_encodedet de l'insérer dans le champ de formulaire. Cet exemple de code conserve les données dans 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>
Transmettre les données à Google Ads
1. Champ session_attributes_encoded dans l'API Google Ads
Si vous utilisez JavaScript lorsque vous importez vos conversions hors connexion, transmettez ces données en définissant sur un nouveau champ nommé session_attributes (dans le schéma d'importation existant) le paramètre encodé session_attributes capturé dans le JavaScript fourni. Vous pouvez continuer à utiliser votre processus d'importation des conversions hors ligne actuel, mais définissez ce nouveau champ pour vos importations. Google Ads utilisera les session_attributes en l'absence de vos autres identifiants.
Tous les nouveaux utilisateurs doivent utiliser l'API Data Manager. Si un compte n'a pas été ajouté à la liste d'autorisation pour transmettre des adresses IP ou des attributs de session via l'API Google Ads, vous recevrez un message d'erreur pour ces conversions.
Avancé
Si vous ne pouvez pas utiliser JavaScript, il est possible de capturer séparément les paires clé-valeur et de les envoyer avec vos importations de conversions hors connexion.
Pour les utilisateurs existants de l'importation des conversions hors ligne (OCI) qui n'utilisent pas JavaScript, vous pouvez aussi définir le champ de paires clé-valeur nommé ClickConversion.session_attributes_key_value_pairs dans votre schéma d'importation actuel. Nous vous conseillons d'envoyer les paires clé-valeur avec ces champs lorsque vous appelez l'API. Consultez cette documentation pour les développeurs qui explique comment ajouter séparément des paires clé-valeur à un champ ClickConversion.
Vous pouvez consulter les recommandations suivantes et mettre à jour votre implémentation pour vous assurer que des données valides sont envoyées :
gad_campaignid (ID de la campagne): assurez-vous d'envoyer systématiquement l'ID de campagne Google Ads valide associé au clic sur l'annonce. Il s'agit de l'ID de campagne renseigné dans l'URL de suivi des clics sur l'annonce, sous la formegad_campaignid=1234. Il s'agit d'un attribut essentiel pour une attribution précise.session_start_time_usec: veillez à envoyer l'attribut de manière cohérente (code temporel correspondant au début de la session utilisateur).landing_page_url (URL): assurez-vous d'envoyer l'URL complète et exacte de la page de destination. N'envoyez pas de chaînes d'espace réservé, de chemins d'application internes ni d'URL incomplètes.- Remarque : Si l'URL complète et précise n'est pas disponible, nous vous recommandons de supprimer l'intégralité du champ, car des données incorrectes peuvent avoir un impact négatif sur la modélisation.
landing_page_user_agent (user-agent): assurez-vous que la chaîne reflète précisément le navigateur et le système d'exploitation de l'utilisateur, et évitez d'envoyer des valeurs génériques ou codées en dur.
2. Envoyer le champ "session_attributes" à l'aide du Gestionnaire de données
Vous pouvez également envoyer le champ session_attributes à l'aide du Gestionnaire de données.
- Interface utilisateur du Gestionnaire de données : utilisez le code JavaScript fourni pour créer le champ
session_attributeset l'importer via l'interface utilisateur du Gestionnaire de données. - API Data Manager : vous pouvez automatiser l'importation de vos données grâce à l'API Data Manager. Vous trouverez des instructions spécifiques et des détails sur les schémas dans la documentation sur le Gestionnaire de données.
En transmettant les données correctes, vous permettez à Google Ads d'utiliser ces informations pour attribuer les conversions aux bonnes campagnes. Vous bénéficiez aussi d'un reporting plus complet sur les conversions.
