RankMyGEO Ads - Auditoria do Sistema

O que e o RankMyGEO Ads

RankMyGEO Ads e uma plataforma de inteligencia que cruza dados de visibilidade organica em AI/GEO (de motores como Google AI, Perplexity, ChatGPT) com performance de campanhas pagas (de ad accounts conectadas) para identificar oportunidades de investimento em midia por intent de busca.

Arquitetura

• SPA com SSO (Samurai) - autenticacao com email/senha + 2FA TOTP opcional
• Multi-cliente: cada cliente tem ad accounts, intents, campanhas e integracoes proprias
• Sidebar com 2 niveis: PLATFORM (Command Center, Clients) e CLIENT (8 sub-paginas)
• Integracao bidirecional: conecta com RankMyGEO (organico) e provedores de ads (pago)
• AI Opportunity Map: classificacao automatica de intents cruzando organico x pago

Fluxo de Login

O sistema usa SSO via Samurai com suporte a 2FA TOTP. O fluxo padrao e:

• Passo 1: Email + Senha com botao "Entrar"
• Passo 2 (se MFA ativo): Codigo de verificacao de 6 digitos (Google Authenticator / Authy)
• Pos-login: redireciona para /app (Command Center)

Tela de login - E-mail e Senha

Formulario preenchido

Dashboard Principal

URL: /app — "What needs your attention"

O Command Center e o painel global da plataforma com 3 secoes:

Metricas Globais

Clients Requiring Attention

Tabela com colunas: Client, Ad Accounts, Campaigns, Critical, Warnings, Info, Connector Issues. Estado atual: "All Clear — No clients require immediate attention."

Active Signals

"No Active Signals — All campaigns are operating within normal parameters."

Connector Issues

"No Connector Issues — All connectors are operating normally."

Command Center - metricas globais e tabela de clientes

Active Signals e Connector Issues - tudo ok

Lista de Clientes

URL: /app/clients

Tabela com colunas: Client, Slug, Status, Created. Botao "New Client" para adicionar.

Criar Novo Cliente

O botao "New Client" abre um formulario inline com campos:

• Name * (texto obrigatorio)
• Slug * (texto obrigatorio)
• Botao "Create Client"

Lista de clientes - RankMyApp ACTIVE

Formulario de criacao de cliente - Name e Slug

Pagina de Visao Geral do Cliente

URL: /app/clients/{id}

Badges no header: ACTIVE Data Incomplete

Quick links no topo: Recommendations, Paid Performance, Intent Intelligence, Opportunity Map, Campaigns, Integrations

Secao PAID

Secao ORGANIC / GEO

Intents (4 active)

Opportunity Summary

Recommendations (5 active, 1 High Impact)

Lista resumida com Impact, Title, Type. Link "View all recommendations (5 active)".

Observations

"No open observations."

Data Readiness

Badges: Setup: Complete Data: Partial

Overview - PAID e ORGANIC/GEO integrations

Intents table e Opportunity Summary

Recommendations e Data Readiness

Data Readiness completo - 13 dimensoes

Pagina de Intents

URL: /app/clients/{id}/intents

Botao "New Intent" para criar novos intents.

Intent Coverage

Filtros

• Search: "Search intents..."
• All States: Untapped Opportunity / Paid Compensation / Organic Strength / AI Dominance / Possible Overinvestment / Awaiting Data
• All Paid: Insufficient / Weak / Strong
• All Organic: Insufficient / Weak / Strong

Tabela de Intents (4 ativos)

Intent Intelligence - coverage metrics, filtros e tabela com 4 intents

Mapa de Oportunidades

URL: /app/clients/{id}/opportunity-map

Cruza visibilidade organica AI com performance paga para classificar intents. Periodo: Aug 4-11, 2026.

"How It Works" (Documentacao Integrada)

O botao "How It Works" revela um painel explicativo:

• "The Opportunity Map classifies each intent by crossing organic AI visibility (from GEO engine results) with paid campaign performance (from connected ad accounts) within the selected period."
• "Classification is fully determined by the backend using fixed thresholds. The frontend displays the result — it never reclassifies."
• Organic sufficiency: requires at least 2 mapped queries, 4 results, and 2 engines
• Paid sufficiency: requires at least 1 campaign and 1,000 impressions in the period
• When either side lacks sufficient data: Awaiting Data

6 Estados de Classificacao

Filtros

• Search intents, All States, All Paid, All Organic, All Freshness (Fresh/Stale)
• Botoes de filtro rapido por estado (clicaveis, funcionais)

Tabela de Intents

Colunas: Intent, State, Organic, Paid, Mention Rate, Avg Position, Impressions, CTR, Spend, Freshness

Todos os 4 intents estao como "Awaiting Data" / Organic "Weak" / Paid "Insufficient" / Freshness "Fresh"

AI Opportunity Map - summary cards e tabela completa

"How It Works" expandido - documentacao de classificacao

Pagina de Recomendacoes

URL: /app/clients/{id}/recommendations

"Evidence-backed recommendations based on current product data. Each recommendation explains what to investigate, why, and with what confidence."

Botao "Generate Recommendations" para gerar novas recomendacoes via AI.

Filtros

• Status: All statuses / Active / Closed / Open / Acknowledged / Accepted / Rejected / Completed / Dismissed
• Type: All types / Data Setup / Organic Visibility
• Intent: All intents / Alternativas a Concorrentes / Avaliacao de Concorrentes / Comparacao com Concorrentes / Dores e Limitacoes de Concorrentes

Lista de Recomendacoes

Recommendations - 5 recomendacoes ativas com filtros e Generate button

Performance Paga

URL: /app/clients/{id}/paid-performance

Mostra metricas da conta de anuncios conectada. Quick links: Campaigns, Opportunity Map, Intent Intelligence, Integrations.

Dados da Conexao

"No Campaign Performance Data" — "The ad connector is connected, but this Ad Account does not currently have campaign performance data. This is normal for new accounts or accounts without active campaigns."

Intent Paid Coverage

"No campaigns to map to intents. View intents in Intent Intelligence."

Paid Performance - OpenAI Ads connected, sem campanhas ativas

Pagina de Campanhas

URL: /app/clients/{id}/campaigns

Filtros: Search campaigns + Status (All statuses / Active / Paused / Archived)

"No Campaigns — No campaigns found for this ad account."

Campaigns - empty state com filtros funcionais

Pagina de Observacoes

URL: /app/clients/{id}/observations

"System-detected conditions and notable events across campaigns."

Filtros: Search + Severity (All / Critical / Warning / Info) + Status (All / Open / Resolved)

"No Observations — No observations have been detected for this client."

Observations - empty state com filtros de severidade e status

Pagina de Integracoes

URL: /app/clients/{id}/integrations

"Data sources and configuration for this client."

Esta e a pagina mais densa do sistema, com 5 secoes e dezenas de acoes.

1. Paid Data Source

2. RankMyGEO Connection

Acoes: Test Connection, Replace Credential, Disable

Teste executado com sucesso: "Connection Successful — Projects available: 22"

3. GEO Project

Switch Project dropdown com 22 projetos: RankMyApp, Magazine Luiza, Bradesco, Amazon, PicPay, Esportes da Sorte, Genial, Americanas, etc.

4. GEO Query Mappings

Filtros: Search queries + Filter (All / Mapped / Unmapped)

Tabela: Query, Mapped Intent, Status, Actions (Deactivate / Map)

Exemplos de queries mapeadas:

• "diferenças entre RankMyApp e Sensor Tower" → Comparacao com Concorrentes
• "substitutos para data.ai em tecnologia" → Alternativas a Concorrentes
• "data.ai (App Annie) e bom" → Avaliacao de Concorrentes
• "Sensor Tower problemas comuns" → Dores e Limitacoes de Concorrentes

5. Data Readiness

Mesma tabela de 13 dimensoes do Overview (ver secao 05).

Integrations - Paid Source, RankMyGEO Connection, GEO Project

Test Connection - "Connection Successful, Projects available: 22"

GEO Query Mappings - queries mapeadas e nao mapeadas com acoes

Estrutura da Sidebar

A sidebar tem dois niveis — PLATFORM (global) e CLIENT (aparece ao entrar num cliente).

Barra Inferior

Avatar "RC" (Rodrigo ...) com role "Admin" e link "Sign out".

Breadcrumbs

Todas as paginas de cliente possuem breadcrumbs: Clients / RankMyApp / [pagina atual]

Quick Links no Overview

O Overview possui links rapidos no topo: Recommendations, Paid Performance, Intent Intelligence, Opportunity Map, Campaigns, Integrations.

Rotas Adicionais Testadas

11 rotas adicionais foram testadas (/settings, /admin, /users, /accounts, /connectors, /reports, /analytics, /dashboard, /signals, /audit, /logs) — todas redirecionam para /app (Command Center). Nao existem paginas ocultas.

Funcionalidades Implementadas

Observacoes e Gaps

Resumo Final