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 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.
    • 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:
  • Agora é possível 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 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 de 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

2026-02-17 v1.5

Agora, a API Data Manager é compatível com todo o fluxo de trabalho de gerenciamento de 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 aumentar 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 extra para as conversões da tag. Assim, você maximiza os indicadores de interação com o anúncio e fortalece 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 eventos 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

  • O método IngestEvents foi adicionado 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