Tieni presente le seguenti best practice quando utilizzi l'API Data Manager.
Invia tutti gli identificatori dell'utente
Che tu invii membri del segmento di pubblico o eventi con UserData, includi il maggior numero possibile di user_identifiers, anche inviando più identificatori dello stesso tipo.
Ad esempio, se hai più indirizzi email per un utente, includi un elemento UserIdentifier separato per ogni indirizzo email. Analogamente, se hai identificatori di tipi diversi per un utente, ad esempio indirizzi email, numeri di telefono e indirizzi, aggiungi un UserIdentifier separato per ogni identificatore, fino al numero massimo di identificatori.
Richieste di ottimizzazione
Per ridurre la probabilità di superare i limiti di richieste giornaliere, raggruppa il maggior numero possibile di elementi in ogni richiesta, fino ai limiti per richiesta.
Ad esempio, se vuoi aggiungere 10.000 membri del segmento di pubblico a un segmento di pubblico, aggiungi tutti i 10.000 membri del segmento di pubblico nell'elenco audience_members in un'unica IngestAudienceMembersRequest. L'invio in batch di tutti i 10.000 membri in un'unica richiesta è più efficiente dell'invio di una richiesta separata per aggiungere ogni membro del segmento di pubblico.
Invia richieste in parallelo
Per ridurre il tempo complessivo necessario per l'importazione dei dati, invia richieste in parallelo
all'IngestionService. Ti consigliamo di inviare fino a 10 richieste contemporaneamente per ridurre la probabilità di superare il limite di richieste al minuto.
Puoi inviare richieste in parallelo anche se hanno lo stesso destinations.
Utilizza validateOnly per verificare la presenza di errori di fail-fast
Invia richieste con validateOnly impostato su true per rilevare gli errori di fail-fast. L'API Data Manager esegue gli stessi controlli di convalida di una richiesta normale, ma non importa né rimuove dati.
Una richiesta di sola convalida riuscita non garantisce che non si verificheranno errori durante l'elaborazione, quindi continua a controllare la diagnostica dopo aver inviato una richiesta normale.
Controlla la diagnostica
Acquisisci e raccogli l'request_id da ogni
IngestAudienceMembersResponse o
IngestEventsResponse e utilizza gli ID richiesta per
controllare la diagnostica.
Monitora e genera avvisi sulle quote
Per evitare rifiuti imprevisti delle richieste, configura gli avvisi quota e il monitoraggio nella console Google Cloud. Il monitoraggio dell'utilizzo della quota ti aiuta a monitorare i pattern di consumo e a ottimizzare il raggruppamento delle richieste prima che l'applicazione raggiunga i limiti giornalieri o al minuto.
Distribuzione in produzione
Quando passi dai test locali ai workload di produzione, utilizza le Credenziali predefinite dell'applicazione con un service account collegato o la federazione delle identità per i workload per eseguire l'autenticazione in modo non interattivo e sicuro.
Per informazioni dettagliate sulla configurazione dell'autenticazione per diversi ambienti di produzione, consulta Esegui il deployment in produzione.