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 membros do público-alvo das listas de usuários especificadas.
  • Para começar, consulte o guia sobre como remover todos os membros 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 o WarningReason tipo enumerado 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 mais campos de endereço 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 ao ErrorReason tipo enumerado.

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 ao tipo enumerado AccountType 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 membros 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 ao ErrorReason tipo enumerado.

• 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 ao Google Analytics qualquer evento da Web ou do app 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 adicional 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 ao ErrorReason tipo enumerado 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 ao tipo enumerado ErrorReason.

  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 ao tipo enumerado ErrorReason.

2026-02-17 v1.5

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

• 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 segmentados 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 membros do público-alvo, permitindo o uso dele 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 do usuário.
• 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 força dos dados agora está com disponibilidade geral 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ões.

2025-11-05 v1.4

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

  • Adicionamos GOOGLE_ANALYTICS_PROPERTY ao tipo enumerado AccountType.
  • Adicionamos vários campos ao Event:
    • event_name
    • client_id
    • user_id
    • additional_event_parameters
  • Adicionamos additional_user_properties a UserProperties.

  Saiba mais sobre como enviar 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 em o 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 tipo enumerado 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 força 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 do parceiro 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 o tipo enumerado Product foram descontinuados. Use o account_type campo e o novo AccountType tipo enumerado 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 podem ser segmentados quando tiverem pelo menos 100 membros. Antes, o limite de membros era de mil.

• 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 adicional 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 ao tipo enumerado EventSource. Um event_source é obrigatório 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 da tag, 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 membros do público-alvo usando os seguintes tipos de dados:
  • Dados de contato
  • IDs digitais
  • IDs de PAIR
• Os públicos-alvo gerenciados usando a API Data Manager só podem ser segmentados se tiverem pelo menos mil membros.