Auditar colocações patrocinadas em respostas de IA

Uma colocação patrocinada, uma recomendação orgânica e uma fonte citada podem surgir na mesma resposta. Reuni-las num único número produz um relatório difícil de justificar. Ao separá-las, obtém uma lista ordenada das perguntas pelas quais um concorrente paga enquanto a sua marca está organicamente ausente.

O problema GEO que resolve

A presença de anúncios é interpretada como força: um concorrente surge três vezes, logo presume-se investimento e alcance. O que a recolha devolve são linhas de anúncios detetados no conjunto de dados monitorizados. Não há impressões, despesa nem segmentação; um anúncio pode gerar várias linhas. Contar linhas como volume de meios transforma um contador de registos numa afirmação infundada sobre quota de mercado.

As linhas incluem anunciante, produto, pergunta monitorizada e modelo, mas não um identificador de resposta. A relação entre dados pagos e orgânicos permanece uma correspondência contextual possível: suficiente para escolher perguntas a trabalhar editorialmente, não para descrever um plano de meios.

As etapas do fluxo de trabalho

1. Obter as deteções. get_sponsored_content cobre até 365 dias e devolve totais de anúncios, anunciantes, prompts e produtos, seguidos dos principais anunciantes e dos anúncios mais recentes. Um só limite controla ambas as listas, até 20, sem paginação; compare o tamanho de cada lista com o respetivo total. O campo do fornecedor contém o identificador de modelo guardado. Se não houver deteções, devolve zeros e duas listas vazias, o que encerra o fluxo de trabalho.

2. Identificar os anunciantes. Os nomes de anunciantes e produtos são devolvidos sem alterações. O indicador de concorrente assinala que uma deteção foi associada a um domínio de concorrente monitorizado, não indica qual. Obtenha get_competitors para consultar IDs, domínios e classes de relação e compare os nomes, aumentando o limite predefinido de 20 linhas até receber o conjunto completo.

3. Associar perguntas e ler respostas. get_prompts percorre a carteira por páginas, com 50 linhas por predefinição e 100 no máximo, um deslocamento e um total. Percorra até cobrir o total; um texto de anúncio que corresponda a vários prompts permanece sem associação e fora da classificação. Para cada prompt associado sem ambiguidade, get_prompt_answers devolve as respostas mais recentes com modelo, data, texto truncado e indicação de menção da sua marca. get_answer_details abre uma resposta completa com posições dos concorrentes e fontes citadas.

Como aproveitar os resultados

O campo de menção da marca define dois níveis. Um prompt associado a que nenhuma das respostas devolvidas atribui uma menção da sua marca entra no primeiro nível: um concorrente paga por uma pergunta em que está ausente, o que justifica um plano editorial com responsável. Uma ou mais menções colocam-no no segundo nível, a lista de acompanhamento. Em cada nível, ordene pelo número de anunciantes distintos e depois pela data da deteção mais recente.

O teste faz-se por pergunta. Modelo e data pertencem à linha de dados, não à atribuição do nível. «Nunca referida» aplica-se apenas às respostas recolhidas; indique esta limitação junto da classificação.

Guarde a marca, o período e os limites com os resultados; um URL citado não é o destino do anúncio.

O prompt completo

Quero auditar as colocações patrocinadas detetadas em torno dos meus prompts monitorizados. Se monitorizar mais do que uma marca, enumera-as e pergunta qual devo usar. Mantém colocações pagas, menções orgânicas e citações em colunas separadas e nunca inventes despesa, impressões ou causalidade.

1. Obtém os conteúdos patrocinados dos últimos 30 dias com limite 20. Apresenta os parâmetros da execução, o resumo completo e todas as linhas de anunciantes e anúncios recentes; assinala qualquer lista menor do que o seu total como amostra parcial. O campo do fornecedor é um identificador de modelo guardado. Se o resumo não apresentar anúncios, indica que não houve deteções no período e pára: é um resultado normal, não motivo para procurar dados orgânicos.
2. Regista todos os nomes originais de anunciantes e produtos com o texto do prompt e a data. Obtém os meus concorrentes com um limite suficiente para devolver o conjunto completo e compara os nomes; o indicador de concorrente nunca identifica qual. Depois, pergunta-me que nomes de anunciantes são meus ou de um revendedor, pois nada os distingue, e exclui-os da classificação.
3. Percorre os meus prompts, 100 por pedido, até cobrir o total devolvido e associa cada texto de prompt do anúncio a um único prompt; os textos com várias correspondências ficam excluídos. Para cada um, obtém as respostas com um limite explícito que deves indicar e abre a mais relevante na íntegra, com posições dos concorrentes e fontes citadas.
4. Classifica os prompts associados em dois níveis, testados por pergunta e não por modelo. Primeiro nível: nenhuma resposta devolvida refere a minha marca. Segundo nível: pelo menos uma refere. Ordena cada nível pelo número de anunciantes distintos e depois pela data da deteção mais recente; indica o limite de respostas usado no cálculo. As linhas do primeiro nível recebem um responsável e uma primeira ação; as do segundo, uma data para nova verificação.

Todas as ligações entre dados pagos e orgânicos são correspondências apenas por pergunta, modelo e data, sem identificador de resposta comum; nunca as apresentes como uma associação comprovada.