Cómo solucionar problemas relacionados con las listas de clientes
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Usa esta guía para solucionar problemas relacionados con las tasas de coincidencias bajas y los errores comunes que pueden surgir en tu integración de la Segmentación por clientes.
Valida el porcentaje de coincidencias
Asegúrate de que se haya completado el trabajo de carga antes de intentar validar tu porcentaje de coincidencias.
Tu porcentaje de coincidencias podría ser más bajo de lo esperado por varios motivos, entre ellos los siguientes:
Los datos no se codificaron con hash antes de subirse.
Los datos no se formatearon correctamente antes de generar el hash.
Estás comparando los porcentajes de coincidencias con los de otro sistema.
Estás intentando agregar varios identificadores de usuario a un solo objeto UserIdentifier. En su lugar, agrega varios objetos UserIdentifier a un solo objeto UserData, como se muestra en este ejemplo de código.
Es posible que un anunciante llegue a entre el 1% y el 99% de su lista, según el nivel de actividad de sus usuarios en la Búsqueda de Google, Gmail o YouTube. Si quieres obtener una guía más detallada para solucionar problemas relacionados con los porcentajes de coincidencia bajos, visita el Centro de ayuda.
Diferencias entre el porcentaje de coincidencias y el tamaño de la lista
Ten en cuenta que el tamaño de la lista y el porcentaje de coincidencias reflejan valores diferentes. El porcentaje de coincidencias incluye a todos los usuarios que tienen una Cuenta de Google, incluso si no se puede llegar a ellos con la lista de Segmentación por clientes. Los recuentos de tamaño de la lista incluyen a los usuarios activos que coincidieron con una Cuenta de Google y a los que se puede llegar con la personalización de anuncios.
Depura errores comunes
| Error |
USER_PERMISSION_DENIED
|
Es posible que se produzcan errores de permisos si intentas modificar una lista que creó otra cuenta. Solo puedes editar las listas que creó tu cuenta.
|
EXTERNAL_UPDATE_ID_ALREADY_EXISTS
|
Este error puede ocurrir si intentas crear varios trabajos con el mismo external_id.
|
CONFLICTING_OPERATION
|
Este error puede ocurrir si las operaciones remove se mezclan con las operaciones create en un solo trabajo.
|
TOO_MANY_USER_IDENTIFIERS
|
Las operaciones create en un solo trabajo contienen más de 100,000 user_identifiers en total. Divide la solicitud en varias solicitudes que no superen ese límite.
|
CONCURRENT_MODIFICATION
|
Este error puede ocurrir si intentas operar en la misma lista al mismo tiempo.
|
RESOURCE_EXHAUSTED
|
Este error puede ocurrir si intentas enviar demasiadas solicitudes. Puedes mitigar este problema si agrupas tus operaciones en lotes según el
flujo de uso recomendado. También puedes consultar la guía de prácticas recomendadas para los límites y las cuotas de la API.
|
Asistencia adicional para solucionar problemas
Si los problemas persisten, comunícate con nosotros a través del solucionador de problemas de la Segmentación por clientes.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-09-05 (UTC)
[null,null,["Última actualización: 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)."]]
