skills.rest
ReadyToGo-Education
ReadyToGo-EducationOFFICIAL
Explore all skills by this author →
GitHub

trafego-insights

Pull Meta Ads performance metrics via Graph API and compute derived KPIs.

15|16|Updated May 6, 2026
Search Tags:#marketing analytics#graph api#funnel metrics#meta ads#attribution windows#cache ttl#derived kpis
One-click install
npx skills add https://github.com/ReadyToGo-Education/fluxo_criativo --skill trafego-insights
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: trafego-insights
Source: https://github.com/ReadyToGo-Education/fluxo_criativo/tree/main/.claude/skills/trafego-insights
Command: npx skills add https://github.com/ReadyToGo-Education/fluxo_criativo --skill trafego-insights

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Centraliza a leitura de performance do Meta Ads (Facebook + Instagram) em uma base única e confiável, calculando métricas derivadas e conectando cada número com a janela de atribuição correta para facilitar diagnóstico e comparação entre períodos.

Core Features & Use Cases

  • Leitura de dados nativos + métricas derivadas: busca métricas da Graph API e calcula connect rate, taxas de conversão por etapa e custos por etapa (ex.: CPA/CPL, custo por LP view e checkout).
  • Saída estruturada para outras skills: entrega payload padronizado que alimenta /trafego-otimizar, /trafego-escalar e /trafego-analise, incluindo ranking e drill-down quando solicitado.
  • Diagnóstico temporal com 3 janelas: cruza automaticamente janelas curta/média/longa da trilha (quando tipo_funil e ticket_brl permitem), para identificar tendência e não só fotografia do dia.
  • Proteção contra rate limit com cache: aplica cache em memória (5 min) e cache em arquivo com TTL adaptativo, com invalidação automática após ações de edição.

Quick Start

Use a skill para obter um diagnóstico por janela de atribuição e com métricas derivadas lendo uma campanha específica, pedindo: “puxe insights da campanha 120203456789 para a janela 7d_click”.

Frequently Asked Questions about trafego-insights

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I calculate derived KPIs and connect rates from Meta Ads Graph API insights?▼

Calculating derived KPIs from Meta Ads involves pulling raw metrics via the Graph API and computing connect rate, funnel conversion rates, and costs per stage. This process enforces explicit attribution window handling to ensure accurate performance diagnostics.

What is the best way to diagnose Meta Ads performance across different attribution windows?▼

Diagnosing Meta Ads performance across attribution windows involves automatically crossing short, medium, and long temporal trails. This multi-window approach identifies performance trends over time rather than just providing a single-day snapshot, ensuring accurate period comparisons.

Can I pull Graph API breakdowns for individual ad sets without failing the entire request?▼

You can pull Graph API breakdowns for ad sets with partial-failure resilience. This means if specific breakdown requests encounter errors, the process continues and returns available data rather than failing the entire diagnostic pull.

How do I avoid Graph API rate limits when pulling funnel metrics for full accounts?▼

Avoiding Graph API rate limits when pulling funnel metrics requires applying memory caching for five minutes and adaptive file caching with TTL controls. Cache is automatically invalidated after edit actions to maintain data freshness without exceeding request limits.

Does this approach support single campaign scopes or do I need to pull full account data?▼

This approach supports both single-campaign and full-account scopes. You can target specific campaigns using their IDs or request broader account-level diagnostics, with optional entity level filtering for campaigns, adsets, or individual ads.

Related Skills

Explore More Data & Analytics Skills→
portermetricsampleportermetricsample
17

meta-ads-leadform

Create and retrieve Meta Instant lead-generation forms via the Meta Graph API.

Community
Intermediate
portermetricsampleportermetricsample
17

budget-pacing

Analyze Google Ads campaign spend trajectories to project end-of-period budget outcomes.

Community
Advanced
FunnelEnvyFunnelEnvy
1

data-export-formats

Standardizes CSV export formats for Google Ads and Meta platforms.

Official
Basic
trungdo9trungdo9
3

analytics

Process GA4, GSC, and attribution data into dashboards and KPI trees.

Community
Intermediate