Centro de ayuda
Cómo funciona SOA, con el detalle detrás de cada pantalla.
Cada sección de esta página responde una sola duda, tomada del código y de la documentación del producto — nada aquí está inventado. Si llegaste desde la app, el enlace que te trajo ya apunta a la sección exacta.
Conectar Search Console
Qué permisos usa SOA, y qué diferencia hay entre los dos tipos de propiedad.
- Iniciar sesión solo pide tu nombre y tu correo de Google. El acceso a Search Console es un permiso aparte, de solo lectura (
webmasters.readonly): SOA nunca escribe nada en tu cuenta de Google ni en tu propiedad. - Search Console exige permiso de Propietario o Usuario completo sobre esa propiedad para que su API entregue datos a una herramienta externa. Un Usuario restringido ve la propiedad dentro de Google, pero SOA no puede leerla hasta que el permiso cambie; SOA te dice cuál de los dos te falta y con qué cuenta lo tienes hoy.
- Propiedad de dominio (
sc-domain:) cubre todos los subdominios y protocolos de una vez. Propiedad de prefijo de URL cubre exactamente la dirección y el protocolo que diste de alta, nada más. Cuando las dos existen para el mismo sitio, se recomienda la de dominio — y pueden coexistir sin conflicto. - Si conectaste la cuenta de Google equivocada, no hace falta desconectar primero: se puede conectar otra cuenta directamente desde la pantalla de Search Console.
- Si el acceso se revoca desde Google o deja de renovarse, el sitio lo muestra apenas se intenta la siguiente sincronización, con un botón para reconectar en el mismo lugar donde se nota el problema.
La importación
Qué se trae de Search Console, qué se rastrea del sitio, y cuánto tarda cada parte.
- Se importan las consultas y páginas de los últimos 28 días en dos ventanas (para poder comparar), hasta 16 meses de totales diarios y hasta el historial semanal por página que el plan permite.
- Además, un rastreo propio visita las páginas del sitio y lee lo mismo que vería cualquier visitante: título, meta description, encabezados, enlaces internos y estado HTTP. Nada del código fuente ni de tu cuenta de Google se lee más allá de eso.
- Una propiedad real de unas 1.000 páginas tardó cerca de 4 minutos de punta a punta (sincronización más rastreo), medido sobre el producto en funcionamiento. Mientras corre, no se escribe nada de vuelta en tu cuenta de Google, y puedes explorar el sitio de demostración o invitar a tu equipo mientras esperas.
- Search Console tiene su propio retraso de 2 a 3 días: la fecha que muestra «datos hasta…» nunca incluye hoy ni ayer, aunque la importación ya haya terminado.
- El estado de un sitio siempre nombra su causa y, si aplica, una acción: reconectar (la conexión se revocó), nueva importación o importando (la primera vez, o una sincronización recurrente en curso), sincronización fallida (con reintentar), sin tráfico (Search Console no reporta nada para esa propiedad), desactualizado hace más de 48 horas (con sincronizar ahora), sin oportunidades (hay tráfico, pero el motor no encontró nada activo hoy) y al día.
Prioridad y confianza
La fórmula exacta, no una descripción aproximada.
Cada oportunidad recibe un puntaje:
puntaje = clics_potenciales_por_mes × peso_de_confianza × accionabilidad
- Clics potenciales: la propia estimación del detector que encontró la oportunidad, mostrada siempre como estimación de un modelo sobre tus datos — nunca como una promesa de tráfico.
- Confianza: alta, media o baja, según una suma de puntos que cada detector explica con su propia frase (por ejemplo, más de 1.000 impresiones en 28 días suma 2 puntos; entre 300 y 999, suma 1; menos, suma 0). En la fórmula, alta pesa 1, media 0.6 y baja 0.3 — dos oportunidades con los mismos clics potenciales pueden ordenarse distinto si su confianza difiere.
- Accionabilidad: qué tan directo es el cambio, puesta por el propio detector con su razón — reescribir un título pesa 1.0, fusionar dos páginas pesa 0.5.
- La versión del algoritmo que produjo cada oportunidad queda grabada en ella (hoy,
engine@1.4.0): si una fórmula o un umbral cambia más adelante, lo ya calculado conserva la versión que lo produjo, para que una recalculación se pueda comparar con la anterior en vez de leerse como el mismo número movido en silencio.
La entrega al editor
Por qué el enlace que recibe quien edita el sitio no pide cuenta.
- Cualquier oportunidad se puede convertir en una entrega: a quién se asigna (un correo o un nombre libre — nunca una cuenta de SOA), la instrucción (por defecto, la que ya trae la oportunidad), la URL exacta a cambiar y, si hace falta, una fecha límite.
- El enlace generado (
/h/<token>) vive fuera de la sesión de SOA a propósito: es una ruta pública que solo lee y escribe a través de ese token. Quien lo recibe puede leer la tarea y marcarla como hecha con una nota — nada más, nunca puede ver otro dato del sitio o de otras entregas. - El token se muestra una única vez, al crear la entrega; SOA guarda solo su huella (SHA-256), nunca el valor. Expira a los 30 días y se puede revocar en cualquier momento — un enlace vencido o revocado responde exactamente igual que uno que nunca existió, para no dejar adivinar si hubo una entrega ahí.
- Al crear la entrega, SOA guarda una foto de la página (título, meta description, encabezado, canonical y estado HTTP, tomados del último rastreo) — es la foto contra la que se compara la verificación de publicación (siguiente sección).
Verificación de publicación
Qué mira SOA para confirmar un cambio, y qué hace cuando no puede saberlo.
- Cuando la entrega se marca como hecha, SOA vuelve a leer la página en vivo — una solicitud nueva cada vez, nunca una copia guardada — y compara solo el elemento que la tarea pedía cambiar contra la foto tomada al crear la entrega. Un cambio de maquetación que no toca ese elemento nunca se lee como el cambio pedido.
- Reintenta al día siguiente y a los tres días antes de dar un resultado final, porque una caché o un CDN externo puede tardar en mostrar el cambio.
- Hay seis resultados posibles, cada uno con su propia frase explicando por qué:
- Verificado — el elemento pedido cambió.
- Parcial — cambió una parte de un pedido con varias partes (por ejemplo, uno de varios enlaces internos sugeridos, o el título pero no el H1).
- No encontrado — todavía no cambió.
- Inaccesible — la página no respondió o el robots.txt la bloquea; nunca se lee como que el cambio falló, sino como que no se pudo comprobar.
- No verificable — el HTML servido tiene muy poco texto porque el contenido se arma con JavaScript en el navegador, o el problema técnico necesita el grafo de rastreo completo (por ejemplo, un título duplicado) en vez de una sola URL.
- Pendiente — todavía no se revisó, o sigue esperando su próximo intento.
Una redirección se informa siempre, sea cual sea el resultado: «la URL pedida redirige a…».Medición
Contra qué se compara un cambio, y cuándo el resultado se declara inconcluso en vez de forzarlo.
- Al marcar una acción como hecha se fijan dos ventanas de 28 días: antes y después. El resultado se compara contra lo que hizo el resto del sitio (el total del sitio menos la propia página) en esas mismas ventanas — nunca contra un porcentaje fijo — para no confundir un cambio de la página con una tendencia de todo el sitio.
- La prueba es un z de Poisson sobre los clics observados contra los esperados; si los clics son muy pocos, se repite sobre impresiones. Con menos de 10 del valor esperado en las dos métricas, el resultado es «datos insuficientes» en vez de un número que parece preciso sin serlo.
- Un resultado se declara no concluyente — aunque la prueba haya encontrado una mejora o una caída — si: otra acción se registró sobre la misma página dentro de la misma ventana, o el sitio entero tuvo un salto de más del 40% en cualquier dirección (más parecido a una actualización de Google o un pico estacional que a un cambio parejo).
- Los cinco resultados posibles: mejoró, empeoró, sin cambio claro, datos insuficientes, no concluyente. Solo mejoró/empeoró sin ninguna de las dos condiciones de arriba mueve la oportunidad a ganada o perdida; el resto queda como acción hecha y medida — no como una medición que no se hizo.
Límites de cada plan
Los mismos datos que sirve
/api/public/plans, con lo que significa cada columna.- Free — gratis1 sitio · 500 páginas rastreadas por sitio, hasta 4 saltos de profundidad · 60 semanas de historial por página · un cupo mensual de IA equivalente a 0,50 USD · 2 sincronizaciones manuales por día · 1 rastreo completo por semana.
- Pro — precio por confirmar10 sitios · 1.000 páginas rastreadas por sitio, hasta 6 saltos de profundidad · 69 semanas de historial por página · un cupo mensual de IA equivalente a 10 USD · 6 sincronizaciones manuales por día · 2 rastreos completos por semana.
«Precio por confirmar» significa exactamente eso: todavía no hay un precio real cargado para ese plan. Nunca se muestra un monto inventado.
Eliminar un sitio
Qué desaparece al instante, qué se borra después, y qué se conserva.
- Solo el dueño o un administrador del espacio de trabajo puede eliminar un sitio — un permiso de escritura normal no alcanza, porque es irreversible.
- Se confirma escribiendo el nombre exacto de la propiedad de Search Console del sitio, no con un solo clic: así no se borra por error ni por adivinar cuál era.
- El sitio desaparece de toda la aplicación en el momento — su detalle, sus oportunidades, sus páginas — aunque el borrado de los datos todavía esté en curso; nunca vuelve a sincronizarse ni a rastrearse desde ese instante.
- Se borra, en segundo plano y por partes: todas sus oportunidades, páginas y el historial de consultas, sus entregas y verificaciones, las mediciones registradas, y los archivos guardados (capturas de rastreo, contenido archivado).
- No se borra: la conexión de Google (puede servir a otro sitio del mismo espacio de trabajo), el registro de auditoría que ya menciona al sitio (un registro que se pudiera borrar no sería una auditoría), y los contadores de uso agregados del espacio de trabajo, que no están ligados a un sitio en particular.
- El sitio de demostración no se puede eliminar, para ningún rol.
Contacto
Si algo de esta página no coincide con lo que ves en el producto, escríbenos.