Notas da versão

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

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 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)
  • Confira os seguintes guias para começar:
    • Fazer upgrade do Google Ads
    • Enviar eventos
• Adicionamos suporte para o envio de 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.
  • Confira os seguintes guias para começar:
    • Enviar eventos personalizados e recomendados
    • Fazer upgrade do Measurement Protocol
    • Referência de eventos recomendados
• Adicionamos suporte para o envio de qualquer evento com um ID de transação para fluxos de dados da Web e de apps como uma fonte de dados adicional para suas implementações de tag ou Google Analytics para Firebase (GA4F) SDK implementações.
  • 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 coupon_codes campo ao CartData para rastrear 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 enviar 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.
  • 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 conferir as etapas de migração.
• Adicionamos suporte para o envio do ID de 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 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.
  • 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 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 o envio de 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.

  Saiba 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 do parceiro para demonstrar 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 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 o envio de 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. 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 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 o 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 de dispositivos móveis
  • IDs de PAIR
• Os públicos-alvo gerenciados usando a API Data Manager só são qualificados para segmentação se tiverem pelo menos mil membros.