The Data Manager API is in closed beta. To express interest in joining the closed beta, fill out
this form.
Best practice
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Tieni presente le seguenti best practice quando utilizzi l'API Data Manager.
Invia tutti gli identificatori degli utenti
Che tu stia inviando membri del segmento di pubblico o eventi con UserData, includi il maggior numero possibile di user_identifiers, inclusa l'invio di più identificatori dello stesso tipo.
Ad esempio, se hai più indirizzi email per un utente, includi un 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.
Ottimizza le richieste
Per ridurre la probabilità di superare i limiti giornalieri di richieste, raggruppa il maggior numero possibile di elementi in ogni richiesta, fino ai limiti per richiesta.
Ad esempio, se vuoi aggiungere 10.000 membri a un segmento di pubblico, aggiungi tutti i 10.000 membri nell'elenco audience_members in un unico IngestAudienceMembersRequest. Raggruppare tutti i 10.000 membri
in una singola richiesta è molto più efficiente rispetto all'invio di una richiesta distinta per aggiungere
ogni membro del segmento di pubblico.
Inviare richieste in parallelo
Per ridurre il tempo complessivo necessario per l'importazione dei dati, invia richieste contemporaneamente
al 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 concorrenti anche se hanno lo stesso
destinations.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-07-25 UTC."],[],[],null,["# Best practices\n\nKeep the following best practices in mind when using the Data Manager API.\n\nSend all user identifiers\n-------------------------\n\nWhether sending audience members or events with [`UserData`](/data-manager/api/reference/rpc/google.ads.datamanager.v1#userdata), include as many\n`user_identifiers` as possible, including sending multiple identifiers of the\nsame type.\n\nFor example, if you have multiple email addresses for a user, include a separate\n[`UserIdentifier`](/data-manager/api/reference/rpc/google.ads.datamanager.v1#useridentifier) for each email address. Similarly, if you have identifiers of\ndifferent types for a user, such as email addresses, phone numbers, and\naddresses, add a separate `UserIdentifier` for each identifier, up to the\n[maximum identifier count](/data-manager/api/limits#request_limits).\n\nOptimize requests\n-----------------\n\nTo reduce the likelihood of exceeding daily request limits, batch as many\nitems as possible in each request, up to the [per-request\nlimits](/data-manager/api/limits#request_limits).\n\nFor example, if you want to add 10,000 audience members to an audience, add all\n10,000 members in the `audience_members` list in one\n[`IngestAudienceMembersRequest`](/data-manager/api/reference/rpc/google.ads.datamanager.v1#ingestaudiencemembersrequest). Batching all 10,000 members\nin a single request is far more efficient than sending a separate request to add\neach audience member.\n\nSend concurrent requests\n------------------------\n\nTo reduce the overall time required to ingest data, send concurrent requests\nto the [`IngestionService`](/data-manager/api/reference/rpc/google.ads.datamanager.v1#ingestionservice). We recommend sending up to 10\nrequests concurrently to reduce the likelihood of exceeding the [requests per\nminute limit](/data-manager/api/limits#project_limits).\n\nYou can send concurrent requests even if the requests have the same\n`destinations`."]]
