O que preciso para ligar o Piano Analytics ao LLM Pulse?

Só precisa de uma chave da Piano Data API (no formato `accesskey_secretkey`) e do ID numérico do site. Gere a chave em https://my.piano.io/profile/#/apikeys, qualquer utilizador Piano com a permissão «Handle data» pode criá-la. A chave herda as permissões do seu utilizador para os sites, pelo que não precisa de conceder ao LLM Pulse mais acesso do que aquele de que já dispõe.

Onde encontro o ID de site do Piano?

Abra a sua área de trabalho Piano, aceda a Configuration → Sites e copie o `Site ID` numérico. É o mesmo identificador que indicaria em `space.s` numa chamada à API Data Query. No LLM Pulse, o nome do site é opcional. Se quiser, pode indicar um nome fácil de reconhecer, como `my-blog.com`, para ser apresentado nas definições do projeto, mas não é necessário para a integração funcionar.

Posso usar o meu cluster privado do Piano (api-eu.atinternet.io ou um endpoint personalizado)?

Sim. A secção avançada do formulário de ligação aceita um URL base HTTPS personalizado, como `https://api-eu.atinternet.io`, ou o endpoint do seu cluster empresarial dedicado. Exigimos HTTPS para que as chaves da API sejam enviadas no cabeçalho `x-api-key` e nunca seja aceite um endpoint sem encriptação.

Que assistentes de IA detetam nos dados do Piano?

Acompanhamos todos os principais assistentes de IA, incluindo ChatGPT, Perplexity, Gemini, Claude, Copilot, Grok, Mistral, Meta AI e DeepSeek, filtrando os valores da dimensão `src_source` da Piano pelos domínios `chatgpt.com`, `perplexity.ai`, `gemini.google.com`, `copilot.microsoft.com` e `chat.deepseek.com`. Os totais da pesquisa orgânica são obtidos a partir de `src_source_type = "search-engines"`, para podermos apresentar o tráfego de IA, orgânico e restante.

Posso escolher que eventos do Piano contam como conversões?

Sim. Depois de ligar o site, obtemos automaticamente os valores de `event_name` mais usados nos últimos 30 dias. Em Project Settings → Conversions, pode escolher quais contam para a taxa de conversão de IA e voltamos a sincronizar as métricas afetadas. É o mesmo modelo usado para os eventos principais do Google Analytics 4.

Que planos do LLM Pulse incluem a integração com o Piano?

A integração da Piano com o LLM Pulse está incluída a partir do plano Growth. Os clientes Enterprise que usam whitelabel podem ligar um site Piano por projeto, o que é útil para agências que gerem a Piano para vários clientes do setor editorial.

Integração com o Piano Analytics

Tráfego de IA para Piano Analytics , em piloto automático

Ligue o Piano Analytics (anteriormente AT Internet) com uma única chave da Data API e um ID de site. Veja quanto do seu tráfego vem do ChatGPT, Perplexity, Gemini, Claude e Copilot, sem escrever um relatório Data Query.

Iniciar teste gratuito

Teste gratuito de 14 dias

Cancele quando quiser

Funcionalidades

Tudo o que o Piano oferece, sem qualquer configuração de Data Query

Utilize a sua própria chave da API

Ligue-se com a chave da Piano Data API que gera no seu perfil Piano. Sem OAuth, sem convidar utilizadores adicionais nem pedir ajuda aos administradores: basta colar accesskey_secretkey e o ID numérico do site para começar.

Filtre src_source para cada assistente de IA

Transformamos as dimensões `src_source` e `src_source_type` da Piano numa divisão clara por ChatGPT, Perplexity, Gemini, Claude, Copilot, Grok, Mistral, Meta AI e DeepSeek, sem precisar de configurar o Data Query.

Utilize os seus eventos Piano

Escolha que eventos Piano contam como conversões. Filtramos `event_name` em tempo real para que a taxa de conversão do tráfego de IA reflita os mesmos objetivos que os analistas já acompanham no Data Query.

Suporte para clusters privados

Para utilizar api-eu.atinternet.io ou um cluster empresarial dedicado, indique o endpoint HTTPS na secção avançada. Todas as chamadas serão encaminhadas através desse endpoint.

Só de leitura e revogável

As chaves de API herdam as permissões do Piano, pelo que, se perder o acesso a um site, a chave deixa de funcionar nesse site. Substitua ou revogue a chave no Piano para terminar a ligação corretamente.

Importação retroativa de 395 dias

Na primeira ligação, importamos até 395 dias de tráfego histórico para identificar quando o ChatGPT, a Perplexity e o Gemini começaram a encaminhar utilizadores para o seu site acompanhado pela Piano.

Do ID de site do Piano ao painel de tráfego de IA

Traga a sua própria chave da Data API, cole o seu ID de site e mapeamos automaticamente as dimensões de origem do Piano para assistentes de IA.

1

Gere uma chave da Piano Data API

No seu perfil Piano (https://my.piano.io/profile/#/apikeys) crie uma chave da Data API. Copie a cadeia `accesskey_secretkey`; só precisa de a usar uma vez.
2

Cole o ID do site e a chave da API

Em Reports → AI Traffic, escolha «Connect Piano Analytics». Introduza o ID numérico do site, que encontra em Configuration → Sites, a chave da API e, opcionalmente, um nome fácil de reconhecer para o site ou o URL de um cluster personalizado.
3

Validamos as credenciais

Antes de guardar a ligação, fazemos uma chamada `getData` mínima a api.atinternet.io para confirmar que a chave e o site funcionam. Se algo falhar, recebe uma mensagem de erro específica de imediato e não guardamos uma configuração incompleta.
4

Importamos 395 dias e obtemos os seus eventos

Importamos o tráfego histórico, obtemos os valores de `event_name` mais usados para filtrar conversões e abrimos o painel AI Traffic, com sessões, utilizadores, taxa de conversão e principais páginas de destino discriminados por plataforma de IA.

Feito para organizações que privilegiam o Piano

Criado para as equipas que já têm o Piano Analytics como padrão e querem que o tráfego de IA se integre no resto dos seus relatórios.

Grupos de media e editores europeus

A Piano é predominante no ecossistema europeu de media. O LLM Pulse acrescenta a camada de tráfego de IA que cada vez mais redações procuram, sem exigir que os analistas mantenham outro relatório Data Query.

Marcas empresariais num cluster Piano privado

Para utilizar api-eu.atinternet.io ou um endpoint empresarial dedicado, indique o URL na secção avançada. A integração encaminhará todas as chamadas através do seu cluster.

Equipas de SEO e AEO em conjunto com equipas de conteúdos

Relacione as métricas de visibilidade de IA com os mesmos eventos Piano que a equipa editorial já acompanha para medir interação, subscrições e objetivos de receita.

Agências que gerem vários sites Piano

Cada projeto do LLM Pulse liga-se a um site Piano, para que uma agência que use a Piano para vários clientes do setor editorial mantenha os painéis de tráfego de IA isolados por marca.

"Depois de notarmos um aumento das visitas provenientes de vários LLMs no GA4, precisávamos de visibilidade sobre essas caixas negras: que modelos nos mencionavam, em que respostas e como isso evoluía ao longo do tempo. O LLM Pulse deu-nos a clareza para compreender a evolução da nossa marca nos modelos de IA e para definir novas estratégias que aumentem a nossa exposição."

Victor Hernández

Casa Batlló

Perguntas frequentes

Tudo o que precisa de saber sobre como ligar o Piano Analytics (anteriormente AT Internet) ao LLM Pulse para monitorizar o tráfego de IA.

: Só precisa de uma chave da Piano Data API (no formato `accesskey_secretkey`) e do ID numérico do site. Gere a chave em https://my.piano.io/profile/#/apikeys, qualquer utilizador Piano com a permissão «Handle data» pode criá-la. A chave herda as permissões do seu utilizador para os sites, pelo que não precisa de conceder ao LLM Pulse mais acesso do que aquele de que já dispõe.
: Abra a sua área de trabalho Piano, aceda a Configuration → Sites e copie o `Site ID` numérico. É o mesmo identificador que indicaria em `space.s` numa chamada à API Data Query. No LLM Pulse, o nome do site é opcional. Se quiser, pode indicar um nome fácil de reconhecer, como `my-blog.com`, para ser apresentado nas definições do projeto, mas não é necessário para a integração funcionar.
: Sim. A secção avançada do formulário de ligação aceita um URL base HTTPS personalizado, como `https://api-eu.atinternet.io`, ou o endpoint do seu cluster empresarial dedicado. Exigimos HTTPS para que as chaves da API sejam enviadas no cabeçalho `x-api-key` e nunca seja aceite um endpoint sem encriptação.
: Acompanhamos todos os principais assistentes de IA, incluindo ChatGPT, Perplexity, Gemini, Claude, Copilot, Grok, Mistral, Meta AI e DeepSeek, filtrando os valores da dimensão `src_source` da Piano pelos domínios `chatgpt.com`, `perplexity.ai`, `gemini.google.com`, `copilot.microsoft.com` e `chat.deepseek.com`. Os totais da pesquisa orgânica são obtidos a partir de `src_source_type = "search-engines"`, para podermos apresentar o tráfego de IA, orgânico e restante.
: Sim. Depois de ligar o site, obtemos automaticamente os valores de `event_name` mais usados nos últimos 30 dias. Em Project Settings → Conversions, pode escolher quais contam para a taxa de conversão de IA e voltamos a sincronizar as métricas afetadas. É o mesmo modelo usado para os eventos principais do Google Analytics 4.
: A integração da Piano com o LLM Pulse está incluída a partir do plano Growth. Os clientes Enterprise que usam whitelabel podem ligar um site Piano por projeto, o que é útil para agências que gerem a Piano para vários clientes do setor editorial.

Monitorize o tráfego de IA no Piano Analytics hoje mesmo

Gere uma chave da Data API do Piano, cole o seu ID de site e comece a ver o tráfego de IA em minutos, sem relatórios Data Query para manter.