Notas da versão

Saiba o que mudou em cada versão da API Data Manager.

2026-07-30 v1.8

• Adicionamos o RemoveAllAudienceMembers método ao IngestionService para remover ou substituir todos os participantes das listas de usuários especificadas.
  • Para começar, consulte o guia sobre como remover todos os participantes de um público-alvo para sua integração específica. Por exemplo, consulte os guias da Segmentação por lista de clientes do Google Ads ou do Display & Video 360.
• Adicionamos suporte para retornar avisos detalhados durante a ingestão de eventos e públicos-alvo.
  • Adicionamos o campo field_warnings a IngestEventsResponse e IngestAudienceMembersResponse que contém uma lista de FieldWarning objetos.
  • Adicionamos o FieldWarning recurso, que contém um reason (WarningReason ), description e caminho field.
  • Adicionamos a WarningReason enumeração para definir motivos de avisos, como variáveis personalizadas não ativadas ou IDs de comerciantes ausentes nos dados do carrinho.
• Adicionamos suporte para enviar campos de endereço extras para a ingestão de eventos do Google Analytics.
  • Adicionamos os campos address_line, city e administrative_area a AddressInfo (usado em UserData).
• Adicionamos os motivos de erro INVALID_REMOVE_AS_OF_TIME e REQUIRED_PREREQUISITE_LINK_MISSING à ErrorReason enumeração.

2026-05-28 v1.7

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

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

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

• Adicionamos o 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 participantes do público-alvo que usam CompositeData.

• Adicionamos suporte para a ingestão de endereços IP para a Segmentação por lista de clientes do Google Ads Match 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 à ErrorReason enumeração.

• 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 enviar 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 ao Event, que oferece suporte ao fornecimento de um store_id.
  • Adicionamos o campo third_party_user_data a Event, permitindo que os dados ingeridos sejam explicitamente sinalizados como pertencentes a 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 ItemCustomVariable objetos)
  • Consulte os guias a seguir para começar:
    • Fazer upgrade do Google Ads
    • Enviar eventos
• Adicionamos suporte para enviar qualquer evento da Web ou do app ao Google Analytics que não seja um evento reservado.
  • Adicionamos o app_instance_id campo ao Event recurso.
  • Adicionamos campos ao DeviceInfo para fornecer metadados sobre o dispositivo do usuário.
  • Adicionamos o campo mobile_device_id aos AdIdentifiers.
  • Adicionamos o campo event_location ao Event para capturar campos como city, subdivision_code, region_code, subcontinent_code e continent_code.
  • Consulte os guias a seguir para começar:
    • Enviar eventos personalizados e recomendados
    • Fazer upgrade do Measurement Protocol
    • Referência de eventos recomendados
• Adicionamos suporte para enviar qualquer evento com um ID de transação aos fluxos de dados da Web e do app como uma fonte de dados extra para as implementações da tag ou do Google Analytics para Firebase (GA4F) SDK.
  • Esse recurso é limitado a propriedades do Google Analytics em uma lista de permissões; preencha este formulário se você estiver interessado em adicionar sua propriedade à lista.
• Adicionamos o campo coupon_codes ao CartData para acompanhar todos os códigos de cupom aplicados ao carrinho para 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 à ErrorReason enumeração para oferecer suporte à validação detalhada de vendas na loja e ingestão de eventos do Google Analytics.
• Adicionamos os campos youtube_members_count e gmail_members_count ao recurso SizeInfo.

2026-03-26

• Adicionamos EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED à ErrorReason enumeração.

  Para cumprir a 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 que não tiverem 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 fornecer a declaração obrigatória na interface do Google Ads. Saiba como confirmar para sua conta.

• Adicionamos INVALID_MERCHANT_ID à ErrorReason enumeração.

2026-02-17 v1.5

A API Data Manager agora oferece suporte a todo o fluxo de trabalho para gerenciar públicos-alvo, incluindo criação, ingestão e recuperação.

• Adicionamos o UserList recurso e UserListService para permitir a criação, recuperação, atualização e exclusão de listas de usuários.
  • Consulte os guias do Google Ads ou do Display & Video 360 para conferir um tutorial completo sobre como criar, preencher e verificar públicos-alvo da 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 conferir as etapas de migração.
• Adicionamos suporte para enviar o ID de usuário pela ingestão de participantes do público-alvo, permitindo o uso com a Segmentação por lista de clientes no Google Ads.
  • Adicionamos UserIdData ao AudienceMember.
  • Adicionamos IngestUserIdDataStatus e RemoveUserIdDataStatus aos status retornados pelo RetrieveRequestStatus método. Use esses campos para recuperar informações de diagnóstico sobre a ingestão e remoção de IDs de usuários.
• Adicionamos o PartnerLink recurso e PartnerLinkService para criar e gerenciar links entre contas de anunciantes e parceiros de dados.
  • Consulte os guias de links de parceiros para começar.

2026-02-10

O envio de conversões com várias fontes de dados para aumentar a performance e a qualidade dos dados agora 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.

2025-11-05 v1.4

• Adicionamos suporte para enviar eventos purchase do Google Analytics como uma fonte de dados adicional para as conversões da tag, a fim de maximizar os indicadores de interação com o anúncio e fortalecer seus dados e o desempenho geral.

  • Adicionamos GOOGLE_ANALYTICS_PROPERTY à enumeração AccountType.
  • Adicionamos vários campos ao Event:
    • event_name
    • client_id
    • user_id
    • additional_event_parameters
  • Adicionamos additional_user_properties a UserProperties.

  Leia mais sobre o envio de eventos purchase do Google Analytics e como mapear parâmetros de eventos e propriedades do usuário do Google Analytics para os equivalentes da API Data Manager 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 ao 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 agora 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ões. Preencha o formulário se quiser adicionar sua conta.

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

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

• O campo product de ProductAccount e a enumeração Product foram descontinuados. Use o campo account_type e a nova AccountType enumeração em vez disso.

• Adicionamos 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 participantes. Antes, o limite era de mil participantes.

• O transaction_id de um Event agora é opcional ao enviar conversões off-line ou conversões otimizadas para leads. O transaction_id ainda é obrigatório ao enviar conversões off-line como uma fonte de dados extra para aumentar a performance e a força dos dados.

2025-08-06 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.
• Adicionamos os valores APP, IN_STORE, PHONE e OTHER à enumeração EventSource. Uma event_source é necessária para conversões off-line e conversões otimizadas para leads.
• Adicionamos o user_properties campo ao Event. Defina este campo como um UserProperties objeto para adicionar informações avaliadas pelo anunciante sobre um usuário quando o evento ocorreu.
• Adicionamos um campo repetido destination_references a CustomVariable. Use esse 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

• Adicionamos o IngestEvents método ao IngestionService. Use IngestEvents como uma fonte de dados adicional para as conversões de tags, a fim de maximizar os indicadores de interação com o anúncio e fortalecer seus dados e o desempenho 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.
• Adicionamos suporte para gRPC e REST.
• Adicionamos o IngestionService com IngestAudienceMembers e RemoveAudienceMembers métodos para gerenciar participantes do público-alvo usando os seguintes tipos de dados:
  • Dados de contato
  • IDs de dispositivos móveis
  • IDs de PAIR
• Os públicos-alvo gerenciados usando a API Data Manager só estão qualificados para segmentação se tiverem pelo menos mil participantes.