Note di rilascio

Qui puoi scoprire cosa è cambiato in ogni release dell'API Data Manager.

07/05/2026 v1.6

  • È stato aggiunto il supporto per l'invio delle conversioni generate da vendite in negozio di Google Ads utilizzando un IngestEventsRequest. Per utilizzare questa funzionalità, il tuo account Google Ads deve soddisfare determinati requisiti di idoneità.
    • È stato aggiunto il campo event_location a Event, che supporta la fornitura di un store_id. fisico
    • È stato aggiunto il campo third_party_user_data a Event, consentendo di contrassegnare esplicitamente i dati importati come di proprietà di una terza parte.
      • La compilazione di questo campo è consentita solo per i partner di dati.
    • Sono stati aggiunti i seguenti campi alla risorsa Item:
      • merchant_id
      • merchant_feed_label
      • merchant_feed_language_code
      • conversion_value
      • custom_variables (accetta un elenco di oggetti ItemCustomVariable)
    • Per iniziare, consulta le seguenti guide:
  • È stato aggiunto il supporto per l'invio a Google Analytics di qualsiasi evento web o app che non sia un evento riservato.
  • È stato aggiunto il supporto per l'invio di qualsiasi evento con un ID transazione sia agli stream di dati web sia a quelli delle app come origine dati aggiuntiva per le implementazioni del tag o dell'SDK Google Analytics for Firebase (GA4F).
    • Questa funzionalità è limitata alle proprietà Google Analytics in una lista consentita; compila questo modulo se ti interessa aggiungere la tua proprietà alla lista consentita.
  • È stato aggiunto il campo coupon_codes a CartData per monitorare tutti i codici coupon applicati al carrello per gli eventi inviati a Google Ads e Google Analytics.
    • Per i casi d'uso del riscatto dei coupon in Google Ads, utilizza il tipo di conversione OFFLINE_PROMOTION_REDEMPTION.
  • È stato aggiunto un nuovo ambito OAuth, https://www.googleapis.com/auth/datamanager.partnerlink, per i metodi relativi alla creazione, alla ricerca e all'eliminazione dei link dei partner.
  • Sono stati aggiunti nuovi valori all'enumerazione ErrorReason per supportare la convalida dettagliata per l'importazione di vendite in negozio ed eventi Google Analytics.
  • Sono stati aggiunti i campi youtube_members_count e gmail_members_count alla risorsa SizeInfo.

2026-03-26

2026-02-17 v1.5

L'API Data Manager ora supporta l'intero workflow end-to-end per la gestione dei segmenti di pubblico, inclusi la creazione, l'importazione e il recupero.

2026-02-10

L'invio di conversioni con più origini dati per migliorare il rendimento e l'efficacia dei dati è ora disponibile a livello generale per tutti gli account Google Ads.

Questa funzionalità è ancora disponibile solo per le proprietà Google Analytics in una lista consentita. Compila il modulo se ti interessa aggiungere la tua proprietà Google Analytics alla lista consentita.

2025-11-05 v1.4

  • È stato aggiunto il supporto per l'invio degli eventi purchase di Google Analytics come origine dati aggiuntiva per le conversioni dei tag, per massimizzare gli indicatori di interazione con l'annuncio e rafforzare i dati e il rendimento complessivo.

    • Aggiunta di GOOGLE_ANALYTICS_PROPERTY all'enumerazione AccountType.
    • Sono stati aggiunti più campi a Event:
      • event_name
      • client_id
      • user_id
      • additional_event_parameters
    • Aggiunta di additional_user_properties a UserProperties.

    Scopri di più sull'invio di eventi purchase di Google Analytics e su come mappare i parametri evento e le proprietà utente di Google Analytics ai relativi equivalenti dell'API Data Manager nella guida agli eventi.

  • È stato aggiunto AwsWrappedKeyInfo per supportare l'utilizzo di chiavi di crittografia da AWS Key Management Service.

  • Sono stati aggiunti i seguenti valori enum 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

  • L'API Data Manager è ora disponibile a livello generale per tutti gli utenti.

    L'invio di conversioni con più origini dati per migliorare il rendimento e l'efficacia dei dati è ancora disponibile solo per gli account inclusi in una lista consentita. Compila il modulo se ti interessa aggiungere il tuo account.

    Compila il modulo di interesse per i partner per esprimere il tuo interesse a diventare un partner di dati.

  • È stato aggiunto il metodo RetrieveRequestStatus per recuperare informazioni diagnostiche per le richieste di importazione di eventi e segmenti di pubblico.

  • Il campo product di ProductAccount e l'enumerazione Product sono stati ritirati. Utilizza il campo account_type e la nuova enumerazione AccountType.

  • È stato aggiunto il supporto per la specifica di destination per ogni AudienceMember in un IngestAudienceMembersRequest. Utilizza questa funzionalità per inviare i dati dei segmenti di pubblico a più destinazioni distinte in un'unica richiesta.

  • I segmenti di pubblico inseriti con l'API ora sono idonei per il targeting una volta che hanno almeno 100 membri. In precedenza, la soglia dei membri era di mille membri.

  • Il transaction_id di un Event ora è facoltativo quando invii conversioni offline o conversioni avanzate per i lead. Il transaction_id è comunque necessario quando invii conversioni offline come origine dati aggiuntiva per migliorare il rendimento e la qualità dei dati.

06/08/2025 v1.2

  • È stato aggiunto il supporto per l'invio di conversioni offline e conversioni avanzate per i lead alle destinazioni Google Ads utilizzando il metodo IngestEvents. Consulta la guida aggiornata alla crittografia per scoprire come configurare la crittografia per queste conversioni.
  • Sono stati aggiunti i valori APP, IN_STORE, PHONE e OTHER all'enumerazione EventSource. Un event_source è obbligatorio per le conversioni offline e le conversioni avanzate per i lead.
  • Aggiunto il campo user_properties a Event. Imposta questo campo su un oggetto UserProperties per aggiungere informazioni valutate dall'inserzionista su un utente quando si è verificato l'evento.
  • È stato aggiunto un campo ripetuto destination_references a CustomVariable. Utilizza questo campo per applicare un valore di variabile personalizzata solo a un sottoinsieme delle destinazioni per un Event.
  • Sono stati aggiunti i seguenti errori per le conversioni offline e le conversioni avanzate per i lead:
    • 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

  • Aggiunto il metodo IngestEvents a IngestionService. Utilizza IngestEvents come origine dati aggiuntiva per le conversioni dei tag, per massimizzare gli indicatori di interazione con gli annunci e rafforzare i dati e il rendimento complessivo.

2/04/2025 v1.0

  • Prima release dell'API Data Manager, con supporto per l'invio dei dati sul pubblico a Google Ads e Display & Video 360.
  • Aggiunto il supporto per gRPC e REST.
  • È stato aggiunto IngestionService con i metodi IngestAudienceMembers e RemoveAudienceMembers per la gestione dei membri del pubblico utilizzando i seguenti tipi di dati:
  • I segmenti di pubblico gestiti utilizzando l'API Data Manager sono idonei al targeting solo se hanno almeno 1000 membri.