À propos des session_attributes

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.

Nous vous recommandons d'envoyer tous les sous-champs suivants du champ session_attributes, même si seuls quatre des six sont obligatoires :

• gad_source (obligatoire) : 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_*.
  • Exemple de valeur : "1"
    Consigne : Il s'agit de paramètres agrégés ajoutés à l'URL de suivi des clics sur l'annonce (par exemple, &gad_source=1). Vous devez capturer la valeur présente dans l'URL de la page de destination.
• gad_campaignid (obligatoire) : 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_*.
  • Exemple de valeur : "1234567890"
    Consigne : il s'agit également d'un paramètre d'URL (par exemple, &gad_campaignid=1234567890) qui doit être extrait de l'URL de la page de destination.
• session_start_time_usec (obligatoire) : 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.
  • Exemple de valeur : "1678886400000000" (représente une heure spécifique en microsecondes)
    Consigne : Veillez à utiliser un format d'heure cohérent (microsecondes epoch dans l'horodatage UNIX). Il vous aide à suivre la durée des visites.
• landing_page_user_agent (obligatoire) : 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.
  • Exemple de valeur : "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/117.0.0.0 Safari/537.36"
    Consigne : cette valeur doit être extraite de l'en-tête user-agent de la requête HTTP entrante de la page de destination. Évitez les valeurs génériques ou codées en dur.
• 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.
  • Exemple de valeur : "https://www.example.com/product/deluxe-widget?gad_source=1&gad_campaignid=1234567890"
    Consigne : Indiquez l'URL complète et exacte. N'utilisez pas de chaînes d'espace réservé, de chemins d'application internes (par exemple, "/productdetailscreen") ni d'URL incomplètes. Mieux vaut omettre ce champ si l'URL complète et exacte n'est pas disponible.
• 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.

  • Exemple de valeur : "https://www.google.com/" ou "https://www.socialmedia.com/referral"
    Consigne : cette valeur reflète la page précédente sur laquelle l'utilisateur se trouvait juste avant d'accéder à votre site.

Bonnes pratiques pour la qualité des données

• Évitez les données landing_page_url incorrectes : les valeurs landing_page_url incorrectes ou partielles nuisent à la modélisation. Il est préférable de les omettre si vous ne pouvez pas fournir l'URL complète et exacte.
• Évitez les importations en double : n'envoyez pas le même événement de conversion plusieurs fois. Utilisez un identifiant unique, tel qu'un ID de commande, pour dédupliquer les données.

La taille de stockage recommandée pour le champ session_attributes est de 5 Ko, ce qui ne devrait pas être dépassé dans la plupart des cas d'utilisation. Si session_attributes dépasse 5 Ko, nous vous recommandons de contacter votre fournisseur de CRM pour modifier la taille du champ. Vous pouvez également supprimer les paramètres landing_page_url et landing_page_referrer de la fonction d'assistance JavaScript.

---

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

1. Vous devez modifier chaque page d'envoi de formulaire en ajoutant un champ session_attributes caché. C'est ainsi que vos session_attributes seront 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>
2. Exemple de script permettant de capturer session_attributes_encoded et 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

À partir du 2 février 2026, l'API Google Ads n'acceptera plus les nouveaux utilisateurs des données concernant les attributs de session ou l'adresse IP dans les importations de conversions. Pour garantir une expérience plus fiable et évolutive dans la gestion des données complexes, nous recommandons aux développeurs de l'API Google Ads de passer à l'API Data Manager comme API principale d'importation des données utilisateur et de conversion. En effet, elle accepte les attributs de session et les adresses IP. En savoir plus sur les modifications apportées à la compatibilité avec les adresses IP et les attributs de session 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.

Remarque : Pour accéder au nouveau champ dans l'API Google Ads, vous devez passer à la v19 ou à une version ultérieure.

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 campagne) : assurez-vous d'envoyer systématiquement l'ID de campagne Google Ads valide associé au clic sur une annonce. Il s'agit de l'ID de campagne renseigné dans l'URL de suivi des clics sur l'annonce sous la forme gad_campaignid=1234. Il s'agit d'un attribut essentiel pour une attribution précise.
• session_start_time_usec : veillez à envoyer l'attribut systématiquement (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 exacte 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. É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_attributes et 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.