Notas da versão

Aqui você pode saber o que mudou em cada versão da API Data Manager.

2026-05-28 v1.7

• Adicionamos suporte para enviar eventos de conversão off-line aos produtos do Google Marketing Platform, incluindo Campaign Manager 360, Search Ads 360 e Display & Video 360, usando um IngestEventsRequest.

  • Adição de FLOODLIGHT_CONFIG à enumeração AccountType para oferecer suporte a destinos do Floodlight.
  • Os campos dclid, impression_id, match_id e encrypted_user_ids foram adicionados a AdIdentifiers.
  • Adicionamos o campo conversion_count ao recurso Event para permitir o acompanhamento das quantidades de conversão.

  Confira o guia de envio de eventos para começar ou saiba como fazer upgrade da API do Campaign Manager 360.

• Adição do campo composite_data ao recurso AudienceMember, que aceita um objeto CompositeData e permite combinar vários tipos de identificadores, como UserData e IpData. Consulte Dados compostos para mais informações.

  • Adicionamos novos status IngestCompositeDataStatus e RemoveCompositeDataStatus que incluem diagnósticos (record_count e data_type_counts) para solicitações de membros do público-alvo que usam CompositeData.

• Adicionamos suporte à ingestão de endereços IP para a Segmentação por lista de clientes do Google Ads enviando IpData em dados compostos.

• Adicionamos novos motivos de erro FIELD_VALUE_TOO_SHORT, TOO_FEW_ELEMENTS, BASELINE_LOCATION_AUTO_DETECTION_FAILED e INSIGHTS_MISSING_FOR_DIMENSION à enumeração ErrorReason.

• Adicionamos novos valores de diagnóstico a ProcessingErrorReason para fornecer feedback mais granular sobre falhas durante a ingestão de eventos.

2026-05-07 v1.6

• Adicionamos suporte para o envio de conversões de vendas na loja do Google Ads usando um IngestEventsRequest. Para usar esse recurso, sua conta do Google Ads precisa atender a determinados requisitos de qualificação.
  • Adicionamos o campo event_location a Event, que permite informar um store_id. físico.
  • Adicionamos o campo third_party_user_data a Event, permitindo que os dados ingeridos sejam explicitamente sinalizados como de propriedade de terceiros.
    • O preenchimento desse campo só é permitido para parceiros de dados.
  • Adicionamos os seguintes campos ao recurso Item:
    • merchant_id
    • merchant_feed_label
    • merchant_feed_language_code
    • conversion_value
    • custom_variables (aceita uma lista de objetos ItemCustomVariable)
  • Confira os guias a seguir para começar:
    • Fazer upgrade no Google Ads
    • Enviar eventos
• Agora é possível enviar ao Google Analytics qualquer evento da Web ou de app que não seja um evento reservado.
  • Adicionamos o campo app_instance_id ao recurso Event.
  • Adição de campos a DeviceInfo para fornecer metadados sobre o dispositivo do usuário.
  • Adicionamos o campo mobile_device_id a AdIdentifiers.
  • Adicionamos o campo event_location a Event para capturar campos como city, subdivision_code, region_code, subcontinent_code e continent_code.
  • Confira os guias a seguir para começar:
    • Enviar eventos recomendados e personalizados
    • Fazer upgrade do Measurement Protocol
    • Referência de eventos recomendados
• Adicionamos suporte para enviar qualquer evento com um ID de transação a fluxos de dados da Web e de apps como uma fonte de dados adicional para sua tag ou implementações do SDK do Google Analytics para Firebase (GA4F).
  • Esse recurso é limitado a propriedades do Google Analytics em uma lista de permissões. Preencha este formulário se quiser adicionar sua propriedade à lista.
• Adicionamos o campo coupon_codes a CartData para rastrear todos os códigos de cupom aplicados ao carrinho em eventos enviados ao Google Ads e ao Google Analytics.
  • Para casos de uso de resgate de cupons no Google Ads, use o tipo de conversão OFFLINE_PROMOTION_REDEMPTION.
• Adicionamos um novo escopo do OAuth, https://www.googleapis.com/auth/datamanager.partnerlink, para métodos relacionados à criação, pesquisa e exclusão de links de parceiros.
• Adicionamos novos valores à enumeração ErrorReason para oferecer suporte à validação detalhada das vendas na loja e à ingestão de eventos do Google Analytics.
• Os campos youtube_members_count e gmail_members_count foram adicionados ao recurso SizeInfo.

2026-03-26

• Adição de EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED à enumeração ErrorReason.

  Para obedecer à regulamentação de anúncios políticos na União Europeia (PAR da UE), o Google exige que todos os clientes declarem se os anúncios são considerados políticos de acordo com a PAR da UE. Saiba o que é um anúncio político na UE e quais são as restrições do Google para esse tipo de publicidade na região.

  A partir de 1º de abril de 2026, as seguintes operações em contas sem essa declaração poderão ser restritas ou falhar com o erro EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED.

  • UserListService (create, update e delete)
  • IngestionService (ingestAudienceMembers)

  Para resolver o erro, os anunciantes precisam enviar a declaração obrigatória na interface do Google Ads. Saiba como confirmar em sua conta.

• Adição de INVALID_MERCHANT_ID à enumeração ErrorReason.

2026-02-17 v1.5

A API Data Manager agora é compatível com todo o fluxo de trabalho de gerenciamento de públicos-alvo, incluindo criação, ingestão e recuperação.

• Adicionamos o recurso UserList e UserListService para permitir a criação, recuperação, atualização e exclusão de listas de usuários.
  • Confira os guias do Google Ads ou do Display & Video 360 para um tutorial completo sobre como criar, preencher e verificar públicos-alvo de Segmentação por lista de clientes usando a API Data Manager.
  • Consulte os guias de upgrade do Google Ads ou do Display & Video 360 para conhecer as etapas de migração.
• Adicionamos suporte para o envio do ID do usuário pela ingestão de membros do público-alvo, permitindo o uso com a Segmentação por lista de clientes no Google Ads.
  • Adicionamos UserIdData a AudienceMember.
  • Adição de IngestUserIdDataStatus e RemoveUserIdDataStatus aos status retornados pelo método RetrieveRequestStatus. Use esses campos para recuperar informações de diagnóstico sobre a ingestão e remoção do User-ID.
• Adição do recurso PartnerLink e do PartnerLinkService para criar e gerenciar vínculos entre contas de anunciantes e parceiros de dados.
  • Confira os guias de links de parceiros para começar.

2026-02-10

O envio de conversões com várias fontes de dados para melhorar a performance e a qualidade dos dados já está disponível para todas as contas do Google Ads.

Esse recurso ainda está disponível apenas para propriedades do Google Analytics em uma lista de permissões. Preencha o formulário se quiser adicionar sua propriedade do Google Analytics à lista de permissão.

05/11/2025 v1.4

• Adicionamos suporte para enviar eventos purchase do Google Analytics como uma fonte de dados adicional para suas conversões de tag, maximizando os indicadores de interação com o anúncio e fortalecendo seus dados e a performance geral.

  • Adição de GOOGLE_ANALYTICS_PROPERTY à enumeração AccountType.
  • Vários campos foram adicionados a Event:
    • event_name
    • client_id
    • user_id
    • additional_event_parameters
  • O método additional_user_properties foi adicionado a UserProperties.

  Leia mais sobre como enviar eventos purchase do Google Analytics e mapear parâmetros de evento e propriedades do usuário do Google Analytics para os equivalentes da API do Gerenciador de dados no guia de eventos.

• Adicionamos AwsWrappedKeyInfo para oferecer suporte ao uso de chaves de criptografia do AWS Serviço de Gerenciamento de Chaves.

• Adicionamos os seguintes valores de enumeração a ErrorReason:

  • EVENT_TIME_INVALID
  • FIELD_VALUE_TOO_LONG
  • INVALID_EVENT_NAME
  • INVALID_PROPERTY_TYPE
  • INVALID_REQUEST_ID
  • INVALID_STREAM_TYPE
  • LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT
  • MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT
  • NOT_ALLOWLISTED
  • OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH
  • RESERVED_NAME_USED
  • TOO_MANY_ELEMENTS
  • UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER
  • UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER

2025-10-06 v1.3

• A API Data Manager já está disponível para todos os usuários.

  O envio de conversões com várias fontes de dados para aumentar a performance e a qualidade dos dados ainda está disponível apenas para contas em uma lista de permissão. Preencha o formulário se quiser adicionar sua conta.

  Preencha o formulário de interesse de parceiro para se tornar um parceiro de dados.

• Adição do método RetrieveRequestStatus para recuperar informações de diagnóstico para solicitações de ingestão de eventos e públicos-alvo.

• O campo product de ProductAccount e o enum Product foram descontinuados. Use o campo account_type e o novo AccountType enum.

• Adição de suporte para especificar o destination de cada AudienceMember em um IngestAudienceMembersRequest. Use esse recurso para enviar dados de público-alvo a vários destinos distintos em uma única solicitação.

• Os públicos-alvo ingeridos com a API agora estão qualificados para segmentação quando têm pelo menos 100 membros. Antes, o limite era de mil membros.

• O transaction_id de um Event agora é opcional ao enviar conversões off-line ou conversões otimizadas para leads. O transaction_id ainda é necessário ao enviar conversões off-line como uma fonte de dados adicional para aumentar a performance e a integridade dos dados.

06/08/2025 v1.2

• Adicionamos suporte para enviar conversões off-line e conversões otimizadas para leads a destinos do Google Ads usando o método IngestEvents. Consulte o guia de criptografia atualizado para saber como configurar a criptografia dessas conversões.
• Adição dos valores APP, IN_STORE, PHONE e OTHER à enumeração EventSource. Um event_source é necessário para conversões off-line e conversões otimizadas para leads.
• Adicionamos o campo user_properties a Event. Defina esse campo como um objeto UserProperties para adicionar informações avaliadas pelo anunciante sobre um usuário quando o evento ocorreu.
• Adicionamos um campo repetido destination_references a CustomVariable. Use este campo para aplicar um valor de variável personalizada apenas a um subconjunto dos destinos de um Event.
• Adicionamos os seguintes erros para conversões off-line e conversões otimizadas para leads:
  • DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS
  • DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS
  • DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED

2025-06-25 v1.1

• Adição do método IngestEvents ao IngestionService. Use IngestEvents como uma fonte de dados adicional para as conversões da sua tag, para maximizar os indicadores de interação com o anúncio e melhorar seus dados e a performance geral.

2025-04-02 v1.0

• Primeira versão da API Data Manager, com suporte para envio de dados de público-alvo ao Google Ads e ao Display & Video 360.
• Adição de suporte para gRPC e REST.
• Adicionamos o IngestionService com os métodos IngestAudienceMembers e RemoveAudienceMembers para gerenciar membros do público-alvo usando os seguintes tipos de dados:
  • Dados de contato
  • IDs de dispositivos móveis
  • IDs da PAIR
• Os públicos-alvo gerenciados com a API Data Manager só podem ser segmentados se tiverem pelo menos mil membros.