Utilisez l'API Data Manager pour envoyer des événements recommandés et des événements personnalisés Google Analytics.
Pour en savoir plus, consultez Envoyer des événements.
Si vous migrez depuis le protocole de mesure Google Analytics, consultez Migrer du protocole de mesure vers l'API Data Manager pour obtenir des instructions.
Cas d'utilisation
Voici quelques cas d'utilisation pour l'envoi d'événements recommandés et personnalisés avec l'API Data Manager :
Établir un lien entre les comportements en ligne et hors connexion.
mesurent les interactions côté client et côté serveur ;
Envoyer des événements qui ne concernent pas les interactions standards des utilisateurs, comme les conversions hors connexion
Envoyer des événements effectués sur les appareils et dans les applications où la collecte automatique n'est pas disponible (comme les kiosques et les montres)
Données fournies par l'utilisateur
Vous pouvez envoyer des données client propriétaires, comme des adresses e-mail, des numéros de téléphone et des adresses physiques hachés, dans le champ userData d'un Event. Cela permet d'améliorer la mesure des conversions, l'attribution et la création d'audiences dans Google Analytics.
Lorsque vous envoyez des données fournies par les utilisateurs, tenez compte des points suivants :
Envoyées avec les événements : dans l'API Data Manager, les données fournies par l'utilisateur doivent être envoyées dans un
Event. Les importations autonomes sans événement ne sont pas acceptées.Mise en forme et hachage : les identifiants personnels (adresse e-mail, numéro de téléphone, nom et adresse postale, par exemple) doivent être normalisés et hachés à l'aide de SHA-256 avant d'être importés. Les autres champs (ville, département, code postal et code pays, par exemple) sont normalisés, mais pas hachés. Pour connaître les exigences spécifiques, consultez le guide Mettre en forme les données utilisateur.
Chiffrement : vous pouvez éventuellement chiffrer les données utilisateur hachées.
User-ID : nous vous recommandons de fournir
userIden plus deuserDatachaque fois qu'un identifiant utilisateur cohérent est disponible.Implémentation : consultez Ajouter des données fournies par l'utilisateur pour obtenir des instructions sur la création de requêtes.
Points à prendre en compte pour l'intégration
Tenez compte des points suivants lorsque vous utilisez l'API Data Manager.
Remarketing
Google Analytics est compatible avec le remarketing sur le même appareil lorsque vous activez les signaux Google. Pour le remarketing inter-appareil, userId est obligatoire.
Vous pouvez également envoyer des données fournies par l'utilisateur pour activer la mise en correspondance des audiences propriétaires.
Identifiants publicitaires
Google Analytics associe automatiquement les identifiants publicitaires (tels que GBRAID ou WBRAID) collectés lors des interactions en ligne avec les événements de l'API Data Manager à l'aide de clientId ou appInstanceId.
Paramètres de confidentialité
Google Analytics associe les événements de l'API Data Manager aux interactions en ligne à l'aide de clientId ou appInstanceId pour adopter les paramètres de confidentialité des utilisateurs, tels que "Annonces non personnalisées" et "Limiter le suivi des annonces".
Vous pouvez également spécifier les paramètres de consentement utilisateur directement sur chaque événement à l'aide de l'objet consent.
Informations géographiques et sur l'appareil
Google Analytics associe automatiquement les informations géographiques et sur les appareils les plus récentes issues du taggage aux événements de l'API Data Manager à l'aide de clientId ou appInstanceId.
Cela permet de s'assurer que vos événements de l'API Data Manager sont reflétés dans les rapports qui incluent des dimensions géographiques et d'appareil.
Si vous souhaitez qu'un événement de l'API Data Manager reflète des informations géographiques et sur l'appareil d'une session spécifique au lieu des dernières informations pour clientId ou appInstanceId, incluez une entrée dans additionalEventParameters avec parameterName défini sur session_id et value défini sur l'ID de la session spécifique, puis envoyez l'événement dans les 24 heures suivant le début de la session.
Vous pouvez fournir des informations géographiques et des informations sur les appareils pour les événements à l'aide de l'API Data Manager.
Serveur à serveur complet
Bien qu'il soit possible d'envoyer des événements à Google Analytics uniquement avec l'API Data Manager, il est possible que seuls des rapports partiels soient disponibles. L'objectif de l'API Data Manager est d'augmenter les événements existants collectés à l'aide de gtag, Tag Manager ou Firebase. Certains noms d'événements et de paramètres sont réservés pour la collecte automatique et ne peuvent pas être envoyés via l'API Data Manager.
Générer ou renommer des événements
Les événements envoyés avec l'API Data Manager ne déclenchent pas de règles pour générer ou renommer des événements. Votre application doit implémenter la logique permettant d'envoyer des événements personnalisés via l'API Data Manager, de la même manière que les règles configurées dans l'interface utilisateur Google Analytics.