Mandir Suite
mais-consciente
Entrar
Menuabrir

Marketing Hub

Observatório multi canal. Hub.2 deste sprint conecta Meta Ads (Observe). Próximos plugs: GA4, Google Ads, YouTube, Instagram.

Conectar Meta Ads

Cole o access token (Marketing API) e o Ad Account ID (formato act_NNNNN). Token fica cifrado no DB (AES-256-GCM com KEK derivada por tenant).

Token de longa duração. Validade típica: 60 dias. Renovar pelo Graph API Explorer ou Business Manager quando expirar.

GA4, tráfego web

Ground truth de conversão. Sessions, users, conversions e revenue do site, com origem (source/medium/campaign) preservada.

Conectar GA4

Pra Mais Consciente: Property ID 290167437, Measurement ID G-ZXVEYKL5TZ. Cole o JSON da Service Account (Google Cloud, com Analytics Data API e permissão na property).

Conteúdo completo do arquivo JSON da Service Account. Será cifrado no DB. A SA precisa ter sido adicionada à property no GA4 (com permissão Viewer ou superior).

Google Ads

Paid search e display. Campanhas, ad groups, keywords, search terms (o que usuários digitam de fato) e métricas diárias por dimensão.

Conectar Google Ads

Mais Consciente: Customer ID 707-605-9490, MCC 622-845-8762. Credenciais em 1Password (Mandir - Tech), item Google Ads — API Completa. Os 5 campos vêm do arquivo ~/google-ads.yaml.

Refresh token persistente do OAuth Google Ads. Não expira.

Instagram (orgânico)

Conta IG Business via Graph API. Posts, reels, stories, demographics, hashtags. Stories são capturadas antes de expirarem.

Conectar conta IG Business
Use o mesmo System User Token do Meta Ads (escopos instagram_basic + instagram_manage_insights + pages_read_engagement) ou um Page Token. A IG Business precisa estar linkada à mesma Página do FB.

YouTube (canal)

Data API v3 (catálogo) + Analytics API v2 (watch time, retention, traffic sources, demographics, revenue).

Conectar canal YouTube
OAuth Client do projeto GCP mais-consciente-mandir com scopes youtube.readonly, yt-analytics.readonly, yt-analytics-monetary.readonly.