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.
Convalida 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ù oggettiUserIdentifiera un singolo oggettoUserDatacome 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 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
Le dimensioni dell'elenco e il tasso di corrispondenza riflettono valori diversi. Il tasso di corrispondenza conteggia tutti gli utenti con un Account Google anche se non possono essere raggiunti con l'elenco Customer Match. La dimensione dell'elenco conteggia gli utenti 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 di autorizzazione 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 operazioni create 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 sulla stessa lista 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 API. |
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE
|
Questo errore si verifica se il tuo progetto Google Cloud (o token sviluppatore legacy, ritirato il 9 settembre 2026) non ha ricevuto richieste Customer Match tra il 1° ottobre 2025 e il 31 marzo 2026. Devi utilizzare l' API Data Manager per i workflow Customer Match. |
Assistenza aggiuntiva per la risoluzione dei problemi
Se i problemi persistono, contattaci tramite lo strumento per la risoluzione dei problemi di Customer Match.