Jerarquía de Cuentas Administrador (MCC) en Google Ads y sus APIs

Qué es una MCC y qué no es

Una cuenta administrador permite gestionar varias cuentas de Google Ads desde un solo lugar. Es útil para agencias, pero no es una cuenta publicitaria. No tiene campañas, no tiene presupuesto y no registra impresiones, clics ni conversiones.

Cuando una agencia conecta Google Ads vía OAuth, la lista de cuentas accesibles puede incluir tanto la MCC como las cuentas operativas. Si se elige la MCC para un cliente, el reporte queda vacío o falla.

• MCC: nodo de gestión jerárquico.
• Cuenta operativa: donde viven campañas y métricas.
• El gasto siempre se registra en la cuenta operativa.

El error REQUESTED_METRICS_FOR_MANAGER

La API de Google Ads devuelve este error cuando se solicita un informe de rendimiento usando el customer ID de una cuenta administrador. No es un bug: es una restricción del modelo de datos.

La solución no es reintentar la consulta. Es identificar que el ID corresponde a una MCC, excluirlo del pipeline y usar la cuenta operativa correcta. Si el cliente ya estaba configurado con una MCC, hay que reasignar la fuente.

Cómo descubrir y seleccionar cuentas operativas

El endpoint de cuentas accesibles devuelve los customer IDs vinculados. Para cada uno, hay que consultar la jerarquía y verificar el campo que indica si es administrador. Solo las cuentas con estado habilitado y sin rol de administrador deben ofrecerse para reportes.

Si una cuenta devuelve un error de acceso, se omite en lugar de asumir que está vacía. Mostrar una cuenta inaccesible como si tuviera cero gasto es peor que no mostrarla.

• Listar cuentas accesibles con el token de la agencia.
• Consultar la jerarquía y filtrar `manager = false`.
• Omitir cuentas inaccesibles o deshabilitadas.
• Permitir varias cuentas operativas por cliente.

Qué hacer con las MCC existentes

Si una agencia ya tiene una MCC conectada, no hace falta desconectarla: se usa para descubrir las cuentas hijas. Lo que hay que evitar es asignarla como fuente de un cliente. En la interfaz, la MCC debe aparecer identificada y deshabilitada para selección.

Cuando el error ya ocurrió, el pipeline debe devolver un conjunto vacío controlado y registrar el motivo. Un reporte vacío con una alerta es más útil que una página de error.

• Mantener la MCC como conexión de agencia.
• Asignar solo cuentas operativas a cada cliente.
• Registrar y alertar si se detecta una MCC en el pipeline.