Giovedì 30 luglio 2026
L'ultima release dell'API Data Manager introduce funzionalità che semplificano la gestione dei segmenti di pubblico, migliorano i workflow di importazione con avvisi a livello di campo e consentono di fornire dati più granulari forniti dagli utenti per Google Analytics.
Rimuovi tutti i membri del segmento di pubblico
Utilizza il nuovo metodo RemoveAllAudienceMembers per cancellare tutti i membri dagli elenchi di utenti specificati in un'unica operazione.
Il parametro facoltativo removeAsOfTime consente di scegliere come target solo i membri aggiunti prima di un timestamp specifico.
Questa opzione è particolarmente utile quando devi eseguire un aggiornamento completo (o "sostituisci tutto") dei dati del segmento di pubblico, in modo da cancellare l'elenco esistente e compilarlo con un nuovo insieme di utenti.
Avvisi relativi ai campi di importazione
Le risposte di importazione dell'API Data Manager ora includono avvisi dettagliati a livello di campo per i problemi di convalida nei campi facoltativi. Se l'API rileva problemi di convalida con i campi facoltativi, la richiesta di importazione andrà a buon fine e il resto dei dati di importazione verrà comunque elaborato. Gli errori di convalida per i campi obbligatori continueranno a causare l'errore dell'intera richiesta seguendo il modello di errore rapido.
Se un campo facoltativo fornito non è valido, la risposta di
IngestEventsRequest
o
IngestAudienceMembersRequest
include un campo field_warnings con un elenco di oggetti
FieldWarning. Ogni avviso fornisce un motivo specifico (WarningReason), un messaggio descrittivo e la posizione del campo nella richiesta in cui si è verificato il problema.
Dati aggiuntivi sull'indirizzo per gli eventi di Google Analytics
Ora puoi fornire informazioni aggiuntive sull'indirizzo dell'utente durante l'importazione degli eventi
nelle destinazioni di Google Analytics. Oltre ai campi given_name, family_name, region_code e postal_code, la risorsa AddressInfo ora supporta:
address_line(via)cityadministrative_area(stato o provincia)
Inoltre, ora puoi utilizzare il campo dei dati forniti dagli utenti (user_data) esistente per soddisfare il requisito degli identificatori per gli eventi multiorigine inviati agli stream di dati web. In questo modo, hai un'altra opzione quando non hai
ad_identifiers.gclid, user_id o
client_id per un evento con più origini.
Inizia
-
Scopri come implementare il nuovo metodo
RemoveAllAudienceMembersper il tuo flusso di lavoro: - Consulta la sezione Avvisi di importazione della guida Informazioni sugli errori dell'API per scoprire come controllare le risposte per individuare eventuali avvisi.
- Inizia a inviare eventi a Google Analytics con l'API Data Manager:
Sviluppa più velocemente con le competenze degli agenti AI: di recente abbiamo introdotto nuove competenze degli agenti API Data Manager per aiutarti ad accelerare le integrazioni. Esplora le nuove skill nel repository GitHub di Google Skills per ricevere indicazioni più accurate ed efficienti direttamente nel tuo ambiente di programmazione assistita dall'AI.
Se hai domande o vuoi discutere di questo post, contattaci sul nostro server Discord "Google Advertising and Measurement Community". Puoi anche contattarci tramite la pagina di assistenza se hai un problema o hai bisogno di aiuto con l'API.
Se ti interessa diventare un partner di dati, compila il modulo di interesse per i partner.
- Lindsey Volta, per conto del team API Data Manager
Labels: analytics, data-manager-api