Crie alertas para a perda de citações com registos comparáveis

Uma página com poucas citações de IA no período atual pode tê-las perdido ou nunca as ter tido. Um único estado não distingue as duas situações. Compare dois períodos explícitos da mesma duração e guarde o resultado com data, para que as execuções futuras continuem auditáveis.

O problema GEO que resolve

Uma contagem baixa de citações parece uma queda e a página entra na lista de conteúdos a atualizar. Mas cada estado de presença de página descreve apenas o período solicitado: WORKING, NEEDS_ATTENTION, NOT_CITED e DISCOVERED indicam quanta evidência existe nele, não por que razão a contagem mudou. Programar uma atualização com base num único período pode ocupar a equipa editorial numa página que não foi citada em nenhum dos dois períodos.

Um período mostra o que é citado agora; dois períodos contíguos e iguais mostram o que mudou. É também o que distingue este fluxo da medição de uma campanha: não pressupõe uma intervenção nem uma data de lançamento. Corre regularmente e verifica se a presença já conquistada está a diminuir.

As etapas do fluxo de trabalho

1. Mapeie o estado atual das citações. get_page_presence devolve URLs monitorizados e descobertos com estado, total de citações, perguntas únicas, posição média e fornecedores no período solicitado. Use os últimos 30 dias completos.

2. Reconstitua o período anterior. Volte a chamar get_page_presence com datas explícitas de início e fim para os 30 dias imediatamente anteriores e compare URL a URL. A ferramenta não devolve uma série temporal e o registo das páginas monitorizadas é o atual. Guarde, por isso, o par de resultados para permitir auditoria e preservar alterações de configuração posteriores.

3. Leia a alteração calculada pela ferramenta. get_source_trends compara os domínios das fontes com o período anterior da mesma duração e devolve, por domínio, menções atuais, menções anteriores e variação percentual. A linha do seu domínio dá a direção para o site; os domínios de terceiros com crescimento mais rápido podem ter ganho espaço. A ordenação usa as citações atuais, pelo que um domínio que caiu muito pode desaparecer das linhas. Se não havia citações no período anterior, a variação é null.

4. Analise as evidências relacionadas. get_source_urls filtrado para o seu domínio mostra as páginas citadas, get_source_domains mostra as restantes fontes e get_content_opportunities os prompts em que os concorrentes aparecem e a sua marca não. Aplique aos três as mesmas datas e filtros do período atual. Uma página concorrente muito presente pode ter ganho espaço, mas não é um substituto comprovado.

O que uma execução realmente devolve

Uma execução válida devolve uma linha atual e uma anterior por URL normalizado, cada uma com datas, contagem de citações e estado. Uma página com uma citação agora e uma antes está estável; com uma agora e quarenta antes, está em queda. O estado atual sozinho não permite distingui-las.

As chamadas reconstituem os períodos de evidência, mas não a configuração histórica das páginas monitorizadas. Guarde a exportação emparelhada quando os URLs mudarem, para não interpretar uma alteração no registo como perda de citações.

Como aproveitar os resultados

Encomende texto apenas quando a comparação confirmar a queda. Um URL entra na lista de atualizações quando dois registos separados por pelo menos 30 dias mostram que as citações diminuíram para metade ou menos, ou caíram de três ou mais para zero. Ordene a lista pela contagem do registo mais antigo, em ordem decrescente: é essa a presença efetivamente perdida. Quedas menores e casos com um só registo vão para a lista de observação e não são trabalhados neste ciclo.

Guarde cada execução como um par datado de períodos. Pode repetir a consulta enquanto as evidências originais forem conservadas, mas o par guardado preserva o conjunto exato de páginas monitorizadas e a justificação da decisão.

Antes de escrever, verifique se algum URL da lista foi redirecionado ou renomeado desde o registo anterior. Uma página deslocada perde citações sem perder valor. Preserve os excertos citados e os URLs estáveis ao editar.

O prompt completo

Quero detetar perdas de citações e criar um plano de atualização de conteúdo. Lista as marcas que monitorizo e, se houver mais do que uma, pergunta qual usar. Explica o que cada passo revela.

1. Define dois períodos contíguos de 30 dias completos em UTC: o atual e o imediatamente anterior. Chama get_page_presence uma vez para cada um, com startDate e endDate explícitos, mantendo quaisquer filtros de tema, etiqueta, fornecedor ou etapa do funil. Agrupa os resultados por estado e guarda o URL, a contagem de citações, as perguntas únicas, os fornecedores e as datas exatas. Se ambas as chamadas não devolverem páginas, indica que a marca não tem páginas monitorizadas ou domínio configurado e para.
2. Compara os dois resultados de presença página a página, pelo URL, no conjunto atualmente monitorizado. Lista alterações de contagem e de estado. Assinala os URLs presentes em apenas um resultado para investigar o registo ou o URL, sem lhes chamar perdas de citações. Pede um registo guardado apenas para detetar alterações na configuração da monitorização, não por falta dos períodos de evidência.
3. Chama get_source_trends para o período atual de 30 dias com os mesmos filtros. Indica as menções atuais e anteriores e a variação do meu domínio, depois os domínios de terceiros com maiores ganhos como possíveis concorrentes pela presença. Interpreta uma variação null como ausência de citações no período anterior, não como estabilidade. Se o meu domínio não aparecer nas linhas, indica-o e usa apenas a comparação entre períodos por página como evidência de tendência. Chama depois get_topics e repete a análise para os dois ou três IDs dos temas que mais me interessam.
4. Obtém URLs de fontes filtrados pelo meu domínio, depois domínios de fontes e oportunidades de conteúdo, sempre com as datas e os filtros exatos do período atual. Identifica as fontes concorrentes mais presentes e os prompts em que tenho margem. Marca qualquer substituição ou causalidade como hipótese não confirmada. Uma lista vazia significa falta de evidências nesse âmbito, não melhoria.
5. Cria a lista de tarefas. Um URL só apresenta queda confirmada se dois registos estiverem separados por pelo menos 30 dias e a sua contagem tiver caído para metade ou menos, ou de três ou mais para zero. Ordena esses URLs pela contagem do registo mais antigo, em ordem decrescente; os restantes ficam como candidatos a análise ou na lista de observação. Inclui as evidências e uma atualização concreta a testar em cada entrada.
6. Pergunta que URLs da lista foram redirecionados, fundidos ou renomeados desde o registo anterior e retira-os das quedas confirmadas: uma página deslocada perde citações sem perder valor.