Quinta-feira, 30 de julho de 2026
A versão mais recente da API Data Manager apresenta recursos que simplificam o gerenciamento de públicos-alvo, melhoram os fluxos de trabalho de ingestão com avisos no nível do campo e permitem dados mais granulares fornecidos pelo usuário para o Google Analytics.
Remover todos os membros do público-alvo
Use o novo método RemoveAllAudienceMembers para remover todos os membros das listas de usuários especificadas em uma única operação.
O parâmetro opcional removeAsOfTime permite segmentar apenas os
membros adicionados antes de um carimbo de data/hora específico.
Isso é útil quando você precisa realizar uma atualização completa (ou "substituir tudo") dos dados do público-alvo, o que permite limpar a lista atual e preenchê-la com um novo conjunto de usuários.
Avisos de campo de ingestão
As respostas de ingestão da API Data Manager agora incluem avisos detalhados no nível do campo para problemas de validação em campos opcionais. Se a API detectar problemas de validação com campos opcionais, sua solicitação de ingestão será bem-sucedida e o restante dos dados de ingestão ainda será processado. As falhas de validação em campos obrigatórios vão continuar a falhar em toda a solicitação, seguindo o modelo de falha rápida.
Se algum campo opcional fornecido for inválido, a resposta de
IngestEventsRequest
ou
IngestAudienceMembersRequest
vai incluir um campo field_warnings com uma lista de objetos
FieldWarning. Cada aviso fornece um motivo específico (WarningReason), uma mensagem descritiva e o local do campo na solicitação em que
o problema ocorreu.
Dados de endereço adicionais para eventos do Google Analytics
Agora é possível fornecer mais informações de endereço do usuário ao ingerir eventos
para destinos do Google Analytics. Além dos campos given_name,
family_name, region_code e
postal_code,
o recurso AddressInfo
agora é compatível com:
address_line(endereço)cityadministrative_area(estado ou província)
Além disso, agora é possível usar o campo de dados fornecidos pelo usuário (user_data)
para atender ao
requisito de identificadores para eventos de várias origens enviados a fluxos de dados da
Web. Isso oferece outra opção quando você não tem o
ad_identifiers.gclid, user_id ou
client_id para um evento de várias origens.
Começar
-
Saiba como implementar o novo método
RemoveAllAudienceMemberspara seu fluxo de trabalho: - Consulte a seção Avisos de ingestão do guia Entender os erros da API para saber como verificar se há avisos nas respostas.
- Comece a enviar eventos ao Google Analytics com a API Data Manager:
Crie mais rápido com as habilidades do agente de IA: recentemente, lançamos novas habilidades do agente da API Data Manager para ajudar você a acelerar suas integrações. Confira as novas habilidades no repositório do GitHub do Google Skills para receber orientações mais precisas e eficientes diretamente no seu ambiente de programação assistido por IA.
Se tiver dúvidas ou quiser discutir este post, entre em contato no nosso servidor do Discord "Google Advertising and Measurement Community". Você também pode entrar em contato conosco pela página de suporte se tiver um problema ou precisar de ajuda com a API.
Se você tiver interesse em se tornar um parceiro de dados, preencha o formulário de interesse do parceiro.
- Lindsey Volta, em nome da equipe da API Data Manager
Rótulos: analytics, data-manager-api