Gardez à l'esprit les bonnes pratiques suivantes lorsque vous utilisez l'API Data Manager.
Envoyer tous les identifiants utilisateur
Que vous envoyiez des membres de l'audience ou des événements avec UserData, incluez autant de user_identifiers que possible, y compris en envoyant plusieurs identifiants du même type.
Par exemple, si vous disposez de plusieurs adresses e-mail pour un utilisateur, incluez un UserIdentifier distinct pour chaque adresse e-mail. De même, si vous disposez d'identifiants de différents types pour un utilisateur, tels que des adresses e-mail, des numéros de téléphone et des adresses, ajoutez un UserIdentifier distinct pour chaque identifiant, jusqu'au nombre maximal d'identifiants.
Optimiser les requêtes
Pour réduire le risque de dépasser les limites de requêtes quotidiennes, regroupez autant d'éléments que possible dans chaque requête, dans la limite des limites par requête.
Par exemple, si vous souhaitez ajouter 10 000 membres à une audience, ajoutez-les tous à la liste audience_members dans un seul IngestAudienceMembersRequest. Le traitement par lot des 10 000 membres dans une seule requête est plus efficace que l'envoi d'une requête distincte pour ajouter chaque membre de l'audience.
Envoyer des requêtes simultanées
Pour réduire le temps total nécessaire à l'ingestion des données, envoyez des requêtes simultanées à IngestionService. Nous vous recommandons d'envoyer jusqu'à 10 requêtes simultanément pour réduire le risque de dépassement de la limite de requêtes par minute.
Vous pouvez envoyer des requêtes simultanées même si elles ont le même destinations.
Utiliser validateOnly pour vérifier les erreurs d'échec rapide
Envoyez des requêtes avec validateOnly défini sur true pour intercepter les erreurs d'échec rapide. L'API Data Manager effectue les mêmes vérifications de validation qu'une requête standard, mais n'ingère ni ne supprime aucune donnée.
Une requête de validation seule réussie ne garantit pas qu'il n'y aura pas d'erreurs lors du traitement. Continuez donc à vérifier les diagnostics après avoir envoyé une requête standard.
Vérifier les diagnostics
Capturez et collectez l'élément request_id de chaque IngestAudienceMembersResponse ou IngestEventsResponse, et utilisez les ID de requête pour vérifier les diagnostics.
Surveiller les quotas et envoyer des alertes
Pour éviter les rejets de requêtes inattendus, configurez des alertes de quota et une surveillance dans la console Google Cloud. La surveillance de l'utilisation des quotas vous aide à suivre les modèles de consommation et à optimiser le traitement par lot des requêtes avant que votre application n'atteigne les limites quotidiennes ou par minute.
Déployer en production
Lorsque vous passez des tests locaux aux charges de travail de production, utilisez les identifiants par défaut de l'application avec un compte de service associé ou la fédération d'identité de charge de travail pour vous authentifier de manière non interactive et sécurisée.
Pour en savoir plus sur la configuration de l'authentification pour différents environnements de production, consultez Déployer en production.