Google Atualizações API de análise de pesquisa para esclarecer a frescura dos dados

O Google adicionou um novo campo de metadados à API de análise de pesquisa, facilitando a identificação de desenvolvedores e profissionais de SEO quando estão trabalhando com dados incompletos ou ainda processadores.

A atualização introduz uma nova transparência nos resultados da frescura dos consultas, uma melhoria para os profissionais de marketing que dependem de métricas atualizadas para informar as decisões em tempo real.

O que há de novo na API

O campo de metadados aparece quando os pedidos incluem o dataState parâmetro definido como all ou hourly_allpermitindo o acesso a dados que ainda podem estar no processo de coletado.

Dois valores de metadados estão agora disponíveis:

• first_incomplete_date: Indica a data mais antiga para a qual os dados ainda estão incompletos. Aparece apenas quando os dados são agrupados por data.
• first_incomplete_hour: Indica a primeira hora em que os dados permanecem incompletos. Aparece apenas quando os dados são agrupados por hora.

Ambos os valores ajudam a esclarecer se as métricas recentes podem ser consideradas estáveis ou se ainda podem mudar à medida que o Google finaliza seu processamento.

Por que isso importa para o relatório de SEO

Esse aprimoramento permite distinguir melhor as mudanças legítimas no desempenho da pesquisa e as lacunas temporárias causadas por dados incompletos.

Para ajudar a reduzir o risco de interpretar mal as flutuações de curto prazo, a documentação do Google afirma:

“Todos os valores após o first_incomplete_date ainda pode mudar visivelmente. ”

Para aqueles que executam relatórios automatizados, o novo metadado permite a lógica mais inteligente, como sinalização ou exclusão de dados frescos, mas incompletos, para evitar as partes interessadas.

Consistência do fuso horário

Todos os registros de data e hora fornecidos no campo de metadados usam o fuso horário da América/Los_angeles, independentemente da origem da solicitação ou da propriedade da propriedade. Os desenvolvedores podem precisar explicar isso ao integrar os dados nos sistemas locais.

Implementação compatível com atraso

Os novos metadados são devolvidos como um objeto opcional e não altera as respostas da API existentes, a menos que solicitado. Isso significa que não há mudanças de ruptura para as implementações atuais, e os desenvolvedores podem começar a usar o recurso conforme necessário.

Melhores práticas para implementação

Para aproveitar ao máximo esta atualização:

• Inclua a lógica para verificar o objeto Metadata ao solicitar dados recentes.
• Considere exibir avisos ou notas de rodapé nos relatórios quando os metadados indicarem períodos incompletos.
• Agendar os dados atualizados após a passagem da janela incompleta para garantir a precisão.

O Google também lembra aos usuários que a API de análise de pesquisa continua retornando apenas linhas principais, não um conjunto de dados completo, devido às limitações do sistema.

Olhando para o futuro

Essa adição pequena, mas significativa, oferece às equipes de SEO mais clareza em torno da frescura dos dados, um ponto de dor frequente ao trabalhar com métricas de desempenho a cada hora ou quase em tempo real.

É uma melhoria bem -vinda para qualquer pessoa que construa ferramentas ou painéis no topo da API do console de pesquisa.

O campo de metadados está disponível agora por meio de solicitações de API padrão. Os detalhes completos da implementação estão disponíveis na documentação da API de análise de análise.

---

Imagem em destaque: Roman Samborskyi/Shutterstock