Note di rilascio

Scopri le modifiche apportate a ogni release dell'API Data Manager.

2026-07-30 v1.8

• È stato aggiunto il RemoveAllAudienceMembers metodo a IngestionService per rimuovere o sostituire tutti i membri del pubblico per gli elenchi utenti specificati.
  • Per iniziare, consulta la guida alla rimozione di tutti i membri di un pubblico per la tua integrazione specifica. Ad esempio, consulta le guide a Customer Match per Google Ads o Display & Video 360.
• È stato aggiunto il supporto per la restituzione di avvisi dettagliati durante l'inserimento di eventi e segmenti di pubblico.
  • Sono stati aggiunti i campi field_warnings a IngestEventsResponse e IngestAudienceMembersResponse che contengono un elenco di FieldWarning oggetti.
  • È stata aggiunta la FieldWarning risorsa, che contiene un percorso reason (WarningReason ), description, e field.
  • È stata aggiunta l'WarningReason enumerazione per definire i motivi degli avvisi, ad esempio se le variabili personalizzate non sono attivate o se mancano gli ID commerciante nei dati del carrello.
• È stato aggiunto il supporto per l'invio di campi di indirizzo aggiuntivi per l'inserimento di eventi di Google Analytics.
  • Sono stati aggiunti i campi address_line, city e administrative_area a AddressInfo (utilizzato in UserData).
• Sono stati aggiunti i motivi di errore INVALID_REMOVE_AS_OF_TIME e REQUIRED_PREREQUISITE_LINK_MISSING all'enumerazione ErrorReason.

2026-05-28 v1.7

• È stato aggiunto il supporto per l'invio di eventi di conversione offline ai prodotti Google Marketing Platform, tra cui Campaign Manager 360, Search Ads 360 e Display & Video 360, utilizzando un IngestEventsRequest.

  • È stato aggiunto FLOODLIGHT_CONFIG all'AccountType enumerazione per supportare le destinazioni Floodlight.
  • Sono stati aggiunti i campi dclid, impression_id, match_id, e encrypted_user_ids a AdIdentifiers.
  • È stato aggiunto il campo conversion_count alla Event risorsa per supportare il monitoraggio delle quantità di conversioni.

  Per iniziare, consulta la guida all'invio di eventi oppure scopri come eseguire l'upgrade dall'API Campaign Manager 360.

• È stato aggiunto il campo composite_data alla risorsa AudienceMember, che accetta un oggetto CompositeData e consente di combinare più tipi di identificatori, come UserData e IpData. Per ulteriori informazioni, consulta Dati compositi.

  • Sono stati aggiunti i nuovi stati IngestCompositeDataStatus e RemoveCompositeDataStatus che includono informazioni diagnostiche (record_count e data_type_counts) per le richieste dei membri del pubblico che utilizzano CompositeData.

• È stato aggiunto il supporto per l'inserimento degli indirizzi IP per Customer Match di Google Ads inviando IpData nei dati compositi.

• Sono stati aggiunti i nuovi motivi di errore FIELD_VALUE_TOO_SHORT, TOO_FEW_ELEMENTS, BASELINE_LOCATION_AUTO_DETECTION_FAILED, e INSIGHTS_MISSING_FOR_DIMENSION all'ErrorReason enumerazione.

• Sono stati aggiunti nuovi valori diagnostici a ProcessingErrorReason per fornire feedback più granulari per gli errori durante l'inserimento degli eventi.

2026-05-07 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.
  • È stato aggiunto il campo third_party_user_data a Event, che consente di contrassegnare esplicitamente i dati inseriti come di proprietà di una terza parte.
    • Il completamento di questo campo è consentito solo per i dati partner.
  • 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 ItemCustomVariable oggetti)
  • Per iniziare, consulta le seguenti guide:
    • Eseguire l'upgrade da Google Ads
    • Inviare eventi
• È 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 campo app_instance_id alla risorsa Event.
  • Sono stati aggiunti campi a DeviceInfo per fornire metadati sul dispositivo dell'utente.
  • È stato aggiunto il campo mobile_device_id a AdIdentifiers.
  • È stato aggiunto il campo event_location a Event per acquisire campi come city, subdivision_code, region_code, subcontinent_code e continent_code.
  • Per iniziare, consulta le seguenti guide:
    • Inviare eventi consigliati e personalizzati
    • Eseguire l'upgrade da Measurement Protocol
    • Riferimento agli eventi consigliati
• È stato aggiunto il supporto per l'invio di qualsiasi evento con un ID transazione ai flussi di dati web e app come origine dati aggiuntiva per le implementazioni di tag o 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 di utilizzo 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 partner.
• Sono stati aggiunti nuovi valori all'enumerazione ErrorReason per supportare la convalida dettagliata per l'inserimento di eventi di vendite in negozio e Google Analytics.
• Sono stati aggiunti i campi youtube_members_count e gmail_members_count alla risorsa SizeInfo.

2026-03-26

• È stato aggiunto EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED all' ErrorReason enumerazione.

  Per rispettare il Regolamento dell'Unione europea sugli annunci politici (Regolamento UE sugli annunci politici), Google richiede a tutti i clienti di dichiarare se i loro annunci sono considerati politici ai sensi di questo regolamento. Scopri che cosa si intende per annuncio politico nell'UE e le restrizioni di Google sugli annunci politici nell' UE.

  A partire dal 1° aprile 2026, le seguenti operazioni sugli account che non dispongono di questa dichiarazione potrebbero essere limitate o non riuscire con l'errore EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED.

  • UserListService (create, update, e delete)
  • IngestionService (ingestAudienceMembers)

  Per risolvere l'errore, gli inserzionisti devono fornire la dichiarazione obbligatoria nell'interfaccia utente di Google Ads. Scopri di più su come confermare per il tuo account.

• È stato aggiunto INVALID_MERCHANT_ID all' ErrorReason enumerazione.

2026-02-17 v1.5

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

• Sono state aggiunte la UserList risorsa e UserListService per consentire la creazione, il recupero, l'aggiornamento e l'eliminazione degli elenchi utenti.
  • Consulta le guide di Google Ads o Display & Video 360 per una procedura dettagliata end-to-end su come creare, popolare e verificare i segmenti di pubblico Customer Match utilizzando l'API Data Manager.
  • Per i passaggi di migrazione, consulta le guide all'upgrade di Google Ads o Display & Video 360.
• È stato aggiunto il supporto per l'invio dell'ID utente tramite l'inserimento dei membri del pubblico, consentendone l'utilizzo con Customer Match in Google Ads.
  • È stato aggiunto UserIdData a AudienceMember.
  • Sono stati aggiunti IngestUserIdDataStatus e RemoveUserIdDataStatus agli stati restituiti dal metodo RetrieveRequestStatus. Utilizza questi campi per recuperare le informazioni diagnostiche sull'inserimento e la rimozione dell'ID utente.
• Sono state aggiunte la PartnerLink risorsa e PartnerLinkService per creare e gestire i link tra gli account inserzionista e partner di dati.
  • Per iniziare, consulta le guide ai link partner.

2026-02-10

L'invio di conversioni con più origini dati per migliorare il rendimento e la solidità 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 i segnali di interazione con gli annunci e migliorare la qualità dei dati e il rendimento complessivo.

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

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

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

• Sono stati aggiunti i seguenti valori di enumerazione 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 la solidità dei dati è ancora disponibile solo per gli account 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 partner di dati.

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

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

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

• I segmenti di pubblico inseriti con l'API sono ora 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 si inviano conversioni offline o conversioni avanzate per i lead. Il transaction_id è ancora obbligatorio quando si inviano conversioni offline come origine dati aggiuntiva per migliorare il rendimento e la qualità dei dati.

2025-08-06 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. Per informazioni su come configurare la crittografia per queste conversioni, consulta la guida alla crittografia aggiornata.
• 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.
• È stato 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

2025-06-25 v1.1

• È stato aggiunto il IngestEvents metodo a IngestionService. Utilizza IngestEvents come origine dati aggiuntiva per le conversioni dei tag, per massimizzare i segnali di interazione con gli annunci e migliorare la qualità dei dati e il rendimento complessivo.

2025-04-02 v1.0

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