The Data Manager API is in closed beta. To express interest in joining the closed beta, fill out
this form.
Bonnes pratiques
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Gardez à l'esprit les bonnes pratiques suivantes lorsque vous utilisez l'API Data Manager.
Envoyer tous les identifiants utilisateur
Que vous envoyiez des membres d'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 un utilisateur dispose de plusieurs adresses e-mail, incluez un UserIdentifier
distinct pour chacune d'elles. 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 la probabilité de dépasser les limites quotidiennes de requêtes, regroupez autant d'éléments que possible dans chaque requête, jusqu'aux limites par requête.
Par exemple, si vous souhaitez ajouter 10 000 membres à une audience, ajoutez tous les 10 000 membres de la liste audience_members
dans un seul IngestAudienceMembersRequest
. Le traitement par lots de l'ensemble des 10 000 membres dans une seule requête est beaucoup plus efficace que d'envoyer une requête distincte pour ajouter chaque membre de l'audience.
Envoyer des requêtes simultanées
Pour réduire le temps global nécessaire à l'ingestion de 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épasser la limite de requêtes par minute.
Vous pouvez envoyer des requêtes simultanées, même si elles ont la même destinations
.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/25 (UTC)."],[],[],null,["# Best practices\n\nKeep the following best practices in mind when using the Data Manager API.\n\nSend all user identifiers\n-------------------------\n\nWhether sending audience members or events with [`UserData`](/data-manager/api/reference/rpc/google.ads.datamanager.v1#userdata), include as many\n`user_identifiers` as possible, including sending multiple identifiers of the\nsame type.\n\nFor example, if you have multiple email addresses for a user, include a separate\n[`UserIdentifier`](/data-manager/api/reference/rpc/google.ads.datamanager.v1#useridentifier) for each email address. Similarly, if you have identifiers of\ndifferent types for a user, such as email addresses, phone numbers, and\naddresses, add a separate `UserIdentifier` for each identifier, up to the\n[maximum identifier count](/data-manager/api/limits#request_limits).\n\nOptimize requests\n-----------------\n\nTo reduce the likelihood of exceeding daily request limits, batch as many\nitems as possible in each request, up to the [per-request\nlimits](/data-manager/api/limits#request_limits).\n\nFor example, if you want to add 10,000 audience members to an audience, add all\n10,000 members in the `audience_members` list in one\n[`IngestAudienceMembersRequest`](/data-manager/api/reference/rpc/google.ads.datamanager.v1#ingestaudiencemembersrequest). Batching all 10,000 members\nin a single request is far more efficient than sending a separate request to add\neach audience member.\n\nSend concurrent requests\n------------------------\n\nTo reduce the overall time required to ingest data, send concurrent requests\nto the [`IngestionService`](/data-manager/api/reference/rpc/google.ads.datamanager.v1#ingestionservice). We recommend sending up to 10\nrequests concurrently to reduce the likelihood of exceeding the [requests per\nminute limit](/data-manager/api/limits#project_limits).\n\nYou can send concurrent requests even if the requests have the same\n`destinations`."]]