Événements recommandés et personnalisés Google Analytics

Utilisez l'API Data Manager pour envoyer des événements recommandés et personnalisés Google Analytics.

Envoyer des événements recommandés et personnalisés

Si vous effectuez une mise à niveau à partir du protocole de mesure Google Analytics consultez Mettre à niveau le protocole de mesure vers l'API Data Manager pour obtenir des instructions.

Présentation du workflow

Pour envoyer des données d'événement avec l'API Data Manager, procédez comme suit :

1. Préparer les destinations : définissez les Destination objets pour le destinations champ de la requête d’ingestion afin de spécifier le compte cible et la conversion ou la destination de l’événement. Pour en savoir plus, consultez Préparer les destinations pour plus de détails.

2. Préparer les données d'événement et les identifiants : remplissez les champs Event avec les détails de l'événement et les identifiants requis (par exemple, les identifiants de clic sur une annonce, de client ou d'instance d'application). Si vous incluez des coordonnées dans userData, normalisez et hachez les identifiants en SHA-256 conformément aux consignes de mise en forme, et chiffrez-les si vous le souhaitez . Pour en savoir plus, consultez Préparer les données d'événement.

3. Créer et envoyer la requête d'ingestion : envoyez une events.ingest requête contenant vos destinations, Event enregistrements et encryptionInfo si vous avez chiffré userData. Utilisez validateOnly: true pour tester votre charge utile et détecter rapidement les erreurs avant d’envoyer les données produit. Pour connaître les exigences concernant les champs et obtenir des exemples de code, consultez Envoyer des événements pour.

4. Vérifier les diagnostics : récupérez les diagnostics de traitement asynchrone et vérifiez l'état de l'ingestion avec requestStatus.retrieve.

Cas d'utilisation

Point clé : L'objectif de l'API Data Manager est d'améliorer la collecte automatique via gtag, Tag Manager et Google Analytics pour Firebase, et non de la remplacer.

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.

• Mesurer 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 ligne.

• Envoyer des événements à partir d'appareils et d'applications où la collecte automatique n'est pas disponible, comme les bornes interactives et les montres.

Données fournies par l'utilisateur

Vous pouvez envoyer des données client propriétaires, telles que des adresses e-mail, des numéros de téléphone et des adresses physiques hachés, dans le userData field of an 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 l'utilisateur, tenez compte des points suivants :

• Envoyées avec des événements : dans l'API Data Manager, les données fournies par l'utilisateur doivent être envoyées dans le cadre d'un Event. Les importations autonomes sans événement ne sont pas acceptées.

• Mise en forme et hachage : les identifiants personnels (tels que l'adresse e-mail, le numéro de téléphone, le nom et l'adresse postale) doivent être normalisés et hachés à l'aide de SHA-256 avant d'être importés. Les autres champs (tels que la ville, l'état ou la province, le code postal et le code pays) 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 le userId avec userData chaque fois qu'un identifiant utilisateur cohérent est disponible.

• Implémentation : pour savoir comment créer des requêtes, consultez Ajouter des données fournies par l'utilisateur.

Points à prendre en compte pour l'intégration

Lorsque vous utilisez l'API Data Manager, tenez compte des points suivants.

Remarketing

Google Analytics est compatible avec le remarketing sur le même appareil lorsque vous activez les signaux Google. Pour le remarketing multi-appareils, userId est obligatoire.

De plus, vous pouvez 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 de l'utilisateur directement sur chaque événement à l'aide de l' consent objet.

Informations géographiques et sur l'appareil

Google Analytics associe automatiquement les informations géographiques et sur l'appareil les plus récentes issues du taggage aux événements de l'API Data Manager à l'aide de clientId ou appInstanceId. Ainsi, vos événements de l'API Data Manager sont reflétés dans les rapports qui incluent des dimensions géographiques et sur l'appareil.

Si vous souhaitez qu'un événement de l'API Data Manager reflète les informations géographiques et sur l'appareil d'une session spécifique au lieu des dernières informations pour le 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 l'appareil pour les événements à l'aide de l'API Data Manager.

Intégration complète de serveur à serveur

Bien qu'il soit possible d'envoyer des événements à Google Analytics uniquement avec l'API Data Manager, seuls des rapports partiels peuvent être disponibles. L'objectif de l'API Data Manager est d'améliorer 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 à une utilisation via 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 la génération ou le changement de nom des événements. Votre application doit implémenter la logique permettant d'envoyer des événements personnalisés via l'API Data Manager, comme les règles configurées dans l'interface utilisateur de Google Analytics.