Lembre-se das práticas recomendadas a seguir ao usar a API Data Manager.
Enviar todos os identificadores de usuário
Ao enviar membros do público-alvo ou eventos com UserData, inclua o máximo de
user_identifiers possível, 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 endereço de e-mail. Da mesma forma, se você tiver identificadores de tipos diferentes 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 limite de identificadores.
Otimizar solicitações
Para reduzir a probabilidade de exceder os limites diários de solicitações, agrupe o máximo de itens possível em cada solicitação, até os limites por solicitação.
Por exemplo, se você quiser adicionar 10.000 membros do público-alvo a um público-alvo, adicione todos os 10.000 membros do público-alvo na lista audience_members em um IngestAudienceMembersRequest. Agrupar todos os 10.000
membros em uma única solicitação é 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 total 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.
Usar validateOnly para verificar se há erros de falha rápida
Envie solicitações com validateOnly definido como true para capturar
erros de falha rápida. A API Data Manager executa as mesmas verificações de validação
que uma solicitação normal, mas não ingere nem remove dados.
Uma solicitação de validação bem-sucedida não garante que não haverá erros durante o processamento. Portanto, continue verificando os diagnósticos depois de enviar uma solicitação normal.
Verificar diagnósticos
Capture e colete o request_id de cada
IngestAudienceMembersResponse ou
IngestEventsResponse e use os IDs de solicitação para
verificar os diagnósticos.
Monitorar e alertar sobre cotas
Para evitar rejeições inesperadas de solicitações, configure alertas de cota e monitoramento no console do Google Cloud. O monitoramento do uso de cotas ajuda a acompanhar os padrões de consumo e otimizar o lote de solicitações antes que o aplicativo atinja os limites diários ou por minuto.
Implantar para a produção
Ao migrar de testes locais para cargas de trabalho de produção, use o Application Default Credentials com uma conta de serviço anexada ou a federação de identidade da carga de trabalho para autenticar de forma não interativa e segura.
Para detalhes sobre como configurar a autenticação para diferentes ambientes de produção, consulte Implantar na produção.