Notas da versão

Aqui você encontra as mudanças em cada versão da API Data Manager.

2026-07-30 v1.8

  • Adicionamos o método RemoveAllAudienceMembers 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 de Segmentação por Lista de Clientes para o Google Ads ou o Display & Video 360.
  • Adicionamos suporte para retornar avisos detalhados durante a ingestão de eventos e públicos-alvo.
    • Adição do campo field_warnings a IngestEventsResponse e IngestAudienceMembersResponse, que contém uma lista de objetos FieldWarning.
    • Adicionamos o recurso FieldWarning, que contém um reason (WarningReason ), description e um caminho field.
    • Adicionamos o tipo enumerado WarningReason para definir os motivos dos avisos, como variáveis personalizadas não ativadas ou IDs do comerciante ausentes nos dados do carrinho.
  • Adicionamos suporte para o envio de mais campos de endereço para a ingestão de eventos do Google Analytics.
    • Os campos address_line, city e administrative_area foram adicionados a AddressInfo (usado em UserData).
  • Adicionamos os motivos de erro INVALID_REMOVE_AS_OF_TIME e REQUIRED_PREREQUISITE_LINK_MISSING ao tipo enumerado ErrorReason.

28/05/2026 v1.7

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 a Event, que permite fornecer um store_id. físico.
    • Adicionamos o campo third_party_user_data a Event, permitindo que os dados ingeridos sejam explicitamente sinalizados como pertencentes a terceiros.
    • 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:
  • Adicionamos suporte para enviar ao Google Analytics qualquer evento da Web ou de app que não seja um evento reservado.
  • 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 suas implementações da tag ou do SDK do Google Analytics para Firebase (GA4F).
    • Esse recurso é limitado às propriedades do Google Analytics em uma lista de permissões. Preencha este formulário se quiser adicionar sua propriedade à lista de permissões.
  • Adicionamos o campo coupon_codes a CartData para acompanhar 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 ao tipo enumerado ErrorReason para oferecer suporte à validação detalhada de vendas na loja e ingestão de eventos do Google Analytics.
  • Adição dos campos youtube_members_count e gmail_members_count ao recurso SizeInfo.

2026-03-26

17/02/2026 v1.5

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

2026-02-10

O envio de conversões com várias fontes de dados para melhorar 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 de permissões.

05/11/2025 v1.4

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

    • Adição de GOOGLE_ANALYTICS_PROPERTY ao tipo enumerado AccountType.
    • Adicionamos vários campos a Event:
      • event_name
      • client_id
      • user_id
      • additional_event_parameters
    • additional_user_properties foi adicionado a UserProperties.

    Leia mais sobre como enviar eventos do Google Analytics purchase e como mapear parâmetros de evento 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 tipo enumerado 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á em disponibilidade geral para todos os usuários.

    O envio de conversões com várias fontes de dados para melhorar 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 tiver interesse em adicionar sua conta.

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

  • Adição do 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 campo account_type e o novo tipo enumerado AccountType.

  • Adicionamos suporte para especificar o destination para cada AudienceMember em um IngestAudienceMembersRequest. Use esse recurso para enviar dados de público-alvo para vários destinos diferentes 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 otimizadas para leads. O transaction_id ainda é necessário ao enviar conversões off-line como uma fonte de dados adicional para melhorar a performance e a consistência dos dados.

06/08/2025 v1.2

  • Adicionamos suporte para enviar conversões off-line e conversões otimizadas para leads aos destinos do Google Ads usando o método IngestEvents. Consulte o guia de criptografia atualizado para saber como configurar a criptografia para essas conversões.
  • Adicionamos os valores APP, IN_STORE, PHONE e OTHER ao tipo enumerado EventSource. É necessário um event_source 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 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 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

25/06/2025 v1.1

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

02/04/2025 v1.0