The Data Manager API is in closed beta. To express interest in joining the closed beta, fill out
this form.
Práticas recomendadas
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Lembre-se das práticas recomendadas a seguir ao usar a API Data Manager.
Enviar todos os identificadores de usuário
Seja para enviar membros do público-alvo ou eventos com UserData, inclua o maior número possível de user_identifiers, incluindo vários identificadores do mesmo tipo.
Por exemplo, se você tiver vários endereços de e-mail para um usuário, inclua um
UserIdentifier separado para cada um deles. Da mesma forma, se você tiver identificadores de
diferentes tipos para um usuário, como endereços de e-mail, números de telefone e
endereços, adicione um UserIdentifier separado para cada identificador, até o
número máximo de identificadores.
Otimizar solicitações
Para reduzir a probabilidade de exceder os limites diários de solicitação, faça o agrupamento de quantos
itens for possível em cada solicitação, até os limites por solicitação.
Por exemplo, se você quiser adicionar 10.000 membros a um público-alvo, adicione todos os 10.000 membros na lista audience_members em uma IngestAudienceMembersRequest. Agrupar todos os 10.000 membros
em uma única solicitação é muito mais eficiente do que enviar uma solicitação separada para adicionar
cada membro do público-alvo.
Enviar solicitações simultâneas
Para reduzir o tempo geral necessário para ingerir dados, envie solicitações simultâneas
para o IngestionService. Recomendamos enviar até 10 solicitações simultaneamente para reduzir a probabilidade de exceder o limite de solicitações por minuto.
É possível enviar solicitações simultâneas, mesmo que elas tenham o mesmo
destinations.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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`."]]
