Cómo solucionar problemas relacionados con las listas de clientes

Usa esta guía para solucionar problemas de porcentajes de coincidencias bajos y 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, como los siguientes:

  • No se generó un hash para los datos antes de subirlos.
  • Los datos no tenían el formato correcto antes de que se les aplicara el algoritmo hash.
  • Estás comparando con porcentajes de coincidencias de un sistema diferente.
  • 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.

Un anunciante puede llegar a un porcentaje de 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. Para obtener una guía más detallada sobre cómo solucionar problemas relacionados con los porcentajes de coincidencias bajos, visita el Centro de ayuda.

Diferencias entre el porcentaje de coincidencias y el tamaño de la lista

El tamaño de la lista y el porcentaje de coincidencias reflejan valores diferentes. El porcentaje de coincidencias incluye a todos los usuarios con una Cuenta de Google, incluso si no se puede llegar a ellos con la lista de Segmentación por clientes. El tamaño de la lista cuenta los usuarios activos que coincidieron con una Cuenta de Google y a los que se puede llegar a través de la personalización de anuncios.

Depura los 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 una lista que haya creado tu propia 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. Para mitigar este problema, puedes agrupar tus operaciones por lotes según el flujo de uso recomendado. También puedes consultar la guía de prácticas recomendadas para conocer los límites y las cuotas de la API.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE Este error se produce si tu proyecto de Google Cloud (o token de desarrollador heredado, que dejó de estar disponible el 9 de septiembre de 2026) no tuvo solicitudes de Segmentación por clientes entre el 1 de octubre de 2025 y el 31 de marzo de 2026. En su lugar, debes usar la API de Data Manager para los flujos de trabajo de Segmentación por clientes.

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.