Risolvere i problemi relativi agli elenchi di clienti
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Utilizza questa guida per risolvere i problemi relativi ai tassi di corrispondenza bassi e agli errori comuni che
potrebbero verificarsi nell'integrazione di Customer Match.
Convalidare il tasso di corrispondenza
Assicurati che il job di caricamento sia stato completato prima di tentare di convalidare il tasso di corrispondenza.
Il tasso di corrispondenza potrebbe essere inferiore al previsto per diversi motivi, tra cui:
I dati non sono stati sottoposti ad hashing prima del caricamento.
I dati non sono stati formattati correttamente prima di essere sottoposti ad hashing.
Il confronto viene effettuato con i tassi di corrispondenza in un sistema diverso.
Stai tentando di aggiungere più identificatori utente a un singolo oggetto UserIdentifier. Aggiungi invece più UserIdentifier a un singolo oggetto UserData come mostrato in questo esempio di codice.
Un inserzionista può raggiungere una percentuale compresa tra l'1% e il 99% del proprio elenco,
in base al livello di attività degli utenti sulla rete di ricerca Google, su Gmail o su YouTube. Per una guida più dettagliata alla risoluzione dei problemi relativi ai tassi di corrispondenza bassi, visita il Centro assistenza.
Differenze tra tasso di corrispondenza e dimensioni dell'elenco
Tieni presente che le dimensioni dell'elenco e il tasso di corrispondenza riflettono valori diversi. Il tasso di corrispondenza
conta tutti gli utenti con un Account Google anche se non possono essere
raggiunti con l'elenco Customer Match. Il conteggio delle dimensioni dell'elenco
attivi
che corrispondono a un Account Google e che possono essere raggiunti dalla personalizzazione degli annunci.
Eseguire il debug degli errori comuni
| Errore |
USER_PERMISSION_DENIED
|
Potresti riscontrare errori relativi alle autorizzazioni se tenti di modificare un elenco creato da un altro account. Puoi modificare solo un elenco creato dal tuo account.
|
EXTERNAL_UPDATE_ID_ALREADY_EXISTS
|
Questo errore può verificarsi se tenti di creare più job con lo stesso
external_id.
|
CONFLICTING_OPERATION
|
Questo errore può verificarsi se le operazioni remove vengono combinate con
le operazioni create in un unico job.
|
TOO_MANY_USER_IDENTIFIERS
|
Le create operazioni in un singolo job contengono più di
100.000 user_identifiers in totale. Suddividi la richiesta in più richieste che non superino questo limite.
|
CONCURRENT_MODIFICATION
|
Questo errore può verificarsi se tenti di operare sullo stesso elenco contemporaneamente.
|
RESOURCE_EXHAUSTED
|
Questo errore può verificarsi se tenti di inviare troppe richieste. Puoi mitigare
questo problema raggruppando le operazioni in batch in base al
flusso di utilizzo consigliato. Puoi anche consultare la guida alle best practice per limiti e quote delle API.
|
Assistenza aggiuntiva per la risoluzione dei problemi
Se continui a riscontrare problemi, contattaci tramite lo strumento per la risoluzione dei problemi di Customer Match.
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-09-05 UTC.
[null,null,["Ultimo aggiornamento 2025-09-05 UTC."],[[["\u003cp\u003eThis guide helps you troubleshoot low Customer Match rates and debug common errors during integration.\u003c/p\u003e\n"],["\u003cp\u003eLow match rates can stem from data formatting issues, hashing problems, or comparing against different systems.\u003c/p\u003e\n"],["\u003cp\u003eMatch rate and list size differ: match rate includes all matched Google Accounts, while list size only includes active, reachable users.\u003c/p\u003e\n"],["\u003cp\u003eCommon errors like permission issues, conflicting operations, and exceeding user identifier limits are addressed with solutions.\u003c/p\u003e\n"],["\u003cp\u003eFor persistent issues, consult the Customer Match troubleshooter or Help Center for detailed guidance.\u003c/p\u003e\n"]]],[],null,["# Troubleshoot customer list issues\n\nUse this guide to help you troubleshoot low match rates and common errors that\nmight come up in your Customer Match integration.\n\nValidate match rate\n-------------------\n\nEnsure that your upload job has completed before attempting to validate your\nmatch rate.\n\nYour match rate might be lower than expected for a number of reasons, including:\n\n- The data was not hashed before it was uploaded.\n\n- The data was not correctly formatted before it was hashed.\n\n- You are comparing against match rates in a different system.\n\n- You are trying to add multiple user identifiers to a single `UserIdentifier`\n object. Instead, add multiple `UserIdentifier`s to a single `UserData`\n object as shown in this\n [code example](/google-ads/api/docs/remarketing/audience-segments/customer-match/get-started#code_example).\n\nIt's possible for an advertiser to reach anywhere from 1% to 99% of their list,\nbased on how active their users are on Google Search, Gmail, or YouTube. For a\nmore detailed guide on troubleshooting low match rates, visit the [Help\nCenter](//support.google.com/google-ads/answer/7474166).\n\n### Differences between match rate and list size\n\nNote that list size and match rate reflect different values. Match rate\ncounts all users with a Google Account even if they are not actually able to be\nreached with the Customer Match list. List size counts\n[active](//support.google.com/google-ads/answer/7474166?#zippy=%2Ctroubleshoot-low-traffic)\nusers that matched a Google Account and are able to be reached by Ads\npersonalization.\n\nDebug common errors\n-------------------\n\n| Error ||\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [`USER_PERMISSION_DENIED`](/google-ads/api/reference/rpc/v21/AuthorizationErrorEnum.AuthorizationError#user_permission_denied) | You might run into permissions errors if you attempt to modify a list that was created by another account. You can only edit a list that your own account created. |\n| [`EXTERNAL_UPDATE_ID_ALREADY_EXISTS`](/google-ads/api/reference/rpc/v21/OfflineUserDataJobErrorEnum.OfflineUserDataJobError#external_update_id_already_exists) | This error can occur if you attempt to create multiple jobs with the same [`external_id`](/google-ads/api/reference/rpc/v21/OfflineUserDataJob#external_id). |\n| [`CONFLICTING_OPERATION`](/google-ads/api/reference/rpc/v21/OfflineUserDataJobErrorEnum.OfflineUserDataJobError#conflicting_operation) | This error can occur if `remove` operations are mixed with `create` operations in a single job. |\n| [`TOO_MANY_USER_IDENTIFIERS`](/google-ads/api/reference/rpc/v21/OfflineUserDataJobErrorEnum.OfflineUserDataJobError#too_many_user_identifiers) | The `create` operations in a single job contain more than 100,000 `user_identifiers` in total. Split the request into multiple requests that don't exceed that limit. |\n| [`CONCURRENT_MODIFICATION`](/google-ads/api/reference/rpc/v21/DatabaseErrorEnum.DatabaseError#concurrent_modification) | This error can occur if you try to operate on the same list at the same time. |\n| [`RESOURCE_EXHAUSTED`](/google-ads/api/reference/rpc/v21/QuotaErrorEnum.QuotaError#resource_exhausted) | This error can occur if you try to send too many requests. You can mitigate this by batching your operations as per the recommended [usage flow](/google-ads/api/docs/remarketing/audience-segments/customer-match/get-started#usage-flow). You can also refer to the best practices guide for [API limits and quotas](/google-ads/api/docs/best-practices/quotas). |\n\nAdditional troubleshooting support\n----------------------------------\n\nIf you're still having issues, reach out to us through the Customer Match\n[troubleshooter](//support.google.com/google-ads/troubleshooter/10028577)."]]
