Redes sociais

Métricas das contas Xperiun no Instagram, YouTube e LinkedIn. A infra do Reports já tá pronta — falta liberar credenciais.

Instagram · setup pendente

Liberar dados das 3 contas

Contas: @xperiun · @leokarpa · @xperiun.corporate API: Meta Graph API v21 App: Ads Meta Xperiun (2441359252992340)

@xperiun e @leokarpa já estão configuradas como Instagram Business. Falta liberar a permissão de Insights no token e configurar @xperiun.corporate.

  1. Gerar token com permissão de Insights. Acessa developers.facebook.com/tools/explorer, seleciona o App Ads Meta Xperiun, adiciona as permissões instagram_basic e instagram_manage_insights, clica em Generate Access Token, autoriza no popup, copia o token e manda pro time técnico substituir o META_ADS_TOKEN em .claude/skills/ads-meta-xperiun/.env. O token novo continua funcionando pra Ads, ganha Instagram Insights no pacote.
  2. Garantir que @xperiun.corporate está como Instagram Business. Hoje a API não retorna métricas dessa conta — provavelmente porque ainda está como perfil pessoal/criador, não Business. No app do Instagram, abre Configurações → Tipo de conta → escolhe Comercial (Business). Depois, no Meta Business Suite, adiciona a conta dentro da Conta Comercial da Xperiun pra ficar visível na API.
Quando estiver pronto: seguidores, alcance, impressões, engajamento por post, top posts (likes + comments + saves), métricas de Stories, demografia da audiência (idade + gênero + cidade) das 3 contas — atualizado diário.
YouTube · setup pendente

Liberar dados do canal @xperiun

Canal: @xperiun (Sayuri) API: YouTube Data v3 + YouTube Analytics v2 Project: Google Cloud Xperiun (mesmo do GA4)

Setup único via OAuth: pega tudo — dados públicos (inscritos, views, top vídeos) + analytics privados (CTR, retention, watch time, fontes de tráfego, demografia). Sem fazer 2 setups.

  1. Habilitar as 2 APIs no Google Cloud. No project Xperiun (mesmo do GA4), abre YouTube Data API v3 e YouTube Analytics API → clica em Enable em cada uma.
  2. Adicionar scope yt-analytics no OAuth existente. Edita o OAuth Client do ads-google-xperiun em Credentials → adiciona o scope https://www.googleapis.com/auth/yt-analytics.readonly. (Opcional: scope youtube.readonly também, pra cobrir dados de canal sem ambiguidade.)
  3. Re-autorizar OAuth com conta dona do canal. A conta autorizada precisa ser owner ou manager do canal @xperiun (provavelmente a conta do Leo). Roda o fluxo OAuth de novo, gera novo refresh token, manda pro time técnico substituir o GOOGLE_ADS_REFRESH_TOKEN (ou criar var dedicada YOUTUBE_REFRESH_TOKEN) no .env da skill.
Quando estiver pronto: inscritos, total views, top vídeos, CTR de thumbnail, retention médio, watch time, fontes de tráfego (YouTube search / suggested / external / playlists), demografia (idade + gênero + país) e dispositivos (mobile/TV/desktop) — atualizado diário.
LinkedIn · setup pendente

Liberar dados Leo Karpinski + Página Xperiun

Perfis: Leo Karpinski · Página Xperiun API: LinkedIn Marketing Developer Platform Prazo aprovação: 2-4 semanas

LinkedIn é a plataforma mais fechada do trio — não dá pra "pegar uma API key e rodar". Tem que se cadastrar no programa de developers e esperar aprovação manual. Enquanto não sai, dá pra fazer um fallback com export CSV semanal/mensal manual.

  1. Criar app no LinkedIn Developers. Acessa linkedin.com/developers/apps, clica em Create app, associa à Página Xperiun, preenche logo + termos + descrição (LinkedIn analisa o conteúdo manualmente).
  2. Solicitar acesso ao Marketing Developer Platform. Dentro do app criado, aba Products → procura Marketing Developer Platform → Request access. Preenche o formulário descrevendo o caso de uso (relatório interno de métricas). LinkedIn revisa em 2-4 semanas, pode pedir documentos adicionais.
  3. (Enquanto não aprova) Fallback CSV manual. Quem gerencia a Página Xperiun no LinkedIn pode exportar Visitor Analytics e Update Analytics como CSV mensalmente, e a gente sobe um conversor que transforma em HTML no mesmo padrão dos outros relatórios. Trabalho manual: ~10min/mês.
Quando estiver pronto: seguidores da página, impressões/cliques por post, engajamento, demografia da audiência (cargo, indústria, senioridade), top posts. Página Xperiun + atividade do Leo.
Instagram
Em construção Education

@xperiun

Conta institucional, Sayuri. Dados + negócios. Aguardando token IG.

Em construção Education

@leokarpa

Conta do founder Leo Karpinski. Power BI + liderança. Aguardando token IG.

Em construção Corporate

@xperiun.corporate

Vertical B2B. Aguarda token + conta configurada como Instagram Business.

Outras plataformas
Em construção

YouTube · @xperiun

Canal Sayuri. Aguarda API Key (rota A) ou OAuth com yt-analytics (rota B).

Em construção

LinkedIn

Leo + Página Xperiun. Aguarda aprovação Marketing Developer Platform.