Guia de Configuração

Configurar Mídia Paga (Meta Ads)

Conecte sua conta Meta Ads ao Strato em minutos. Acompanhe spend, CPL e ROAS diretamente no dashboard de cada campanha, com sync automático todo dia.

~15 minutos OAuth 2.0 Sync diário automático

Pré-requisitos

Conta no Meta Business Manager com acesso às contas de anúncio que deseja conectar
Acesso ao Meta for Developers ( developers.facebook.com) — o mesmo login do Facebook é suficiente
Permissão de Gestor de Integrações no painel Strato do seu tenant
A conta de anúncios deve ter a Marketing API habilitada no app Meta que você criar

Como funciona

1.Criar app no Meta for Developers

Você cria um app do tipo Business e adiciona a Marketing API. Isso gera um App ID e App Secret exclusivos para seu tenant.

2.Configurar credenciais no Strato

Cole o App ID e App Secret na tela Integrações → Mídia Paga. As credenciais são criptografadas (AES-256-GCM) e isoladas por tenant.

3.Conectar conta Meta Ads via OAuth

Clique em "Conectar Meta Ads". Você será redirecionado ao Facebook para autorizar. Ao retornar, todas as suas contas de anúncio são importadas automaticamente.

4.Mapear campanhas externas → internas

Expanda uma conta de anúncio e vincule cada campanha do Meta (ex: "Dentistas SP") a uma campanha interna do Strato.

5.Sync automático diário

Toda madrugada (02:00 UTC), o Strato puxa automaticamente spend, impressões e cliques do dia anterior via Meta API. Os dados aparecem no dashboard da campanha.

Criar app no Meta for Developers

Cada tenant do Strato usa suas próprias credenciais Meta. Isso garante que seus dados de anúncio ficam isolados e sob seu controle.

1
Acesse developers.facebook.com
Faça login com a conta que tem acesso ao Business Manager e às contas de anúncio desejadas.
2
Clique em "My Apps" → "Create App"
3
Selecione o tipo "Business"
Este tipo permite acesso à Marketing API. Se você já tem um app Business existente, pode reutilizá-lo.
4
Preencha o nome do app e o email de contato
Sugestão: "Strato – [Nome do seu tenant]" para facilitar identificação.
5
No dashboard do app, clique em "Add Product"
6
Encontre "Marketing API" e clique em "Set Up"
Isso habilita os escopos ads_read e ads_management, necessários para o Strato buscar insights e campanhas.

developers.facebook.com › apps › [seu-app-id] › dashboard

App Dashboard

Strato – Meu Tenant

Live

App ID

1234567890123456

App Secret

••••••••••••••••

Products Added

✓ Marketing API

Modo Live vs. Development

O app deve estar em modo Live (não Development) para acessar contas de anúncio reais. No canto superior do dashboard, troque o toggle de Development → Live. Para isso, seu app precisará passar pela revisão básica do Facebook.

Registrar a URL de callback

Para o OAuth funcionar, a URL de callback do Strato precisa estar registrada como redirect URI válida no seu app Meta.

1
No app, vá em "Facebook Login" → "Settings"
Se "Facebook Login" não aparecer, adicione-o via "Add Product" também.
2
Localize o campo "Valid OAuth Redirect URIs"
3
Adicione a URL de callback do Strato
Copie a URL exibida no painel Integrações → Mídia Paga do Strato (campo "URL de Callback"). Cole aqui sem nenhuma alteração.
4
Clique em "Save Changes"

Formato da URL de callback

https://api.seudominio.com/v1/media/meta/callback

A URL exata é exibida no painel Strato em Integrações → Mídia Paga → Configuração do App Meta.

Por que registrar a URL?

O Facebook valida que a URL de redirecionamento após o login corresponde exatamente ao que está cadastrado no app. É uma medida de segurança do protocolo OAuth 2.0 que impede que tokens sejam redirecionados para domínios não autorizados.

Configurar credenciais no Strato

De volta ao Strato, insira as credenciais do app Meta. Elas ficam armazenadas criptografadas e são exclusivas do seu tenant.

1
Acesse Integrações → Mídia Paga
No menu lateral do Strato, clique em "Integrações" e depois na aba "Mídia Paga".
2
No bloco "Configuração do App Meta", copie a URL de Callback
Use essa URL no passo anterior (registrar no Meta).
3
Cole o App ID
Encontre no dashboard do seu app Meta em "Settings → Basic".
4
Cole o App Secret
No mesmo lugar, clique em "Show" ao lado do App Secret e copie. O Strato criptografa esse valor com AES-256-GCM antes de salvar.
5
Clique em "Salvar credenciais"
O botão "Conectar Meta Ads" ficará ativo após salvar.

Configuração do App Meta

Crie um app em developers.facebook.com, adicione o produto Marketing API e cole as credenciais abaixo.

URL de Callback (registrar no Meta App)

https://api.seudominio.com/v1/media/meta/callback

App ID

1234567890123456

App Secret • já configurado

••••••••••••••

Segurança das credenciais

O App Secret é criptografado com AES-256-GCM usando uma chave mestre exclusiva do servidor. Nunca fica armazenado em texto puro. Nem a equipe Strato tem acesso ao valor original após salvo.

Conectar conta Meta Ads

Com as credenciais salvas, o botão "Conectar Meta Ads" estará disponível. Ao clicar, você será levado ao Facebook para autorizar o acesso.

1
Clique em "Conectar Meta Ads"
Na tela Integrações → Mídia Paga, clique no botão azul no canto superior direito.
2
Faça login no Facebook (se necessário)
Use a conta que tem acesso às contas de anúncio do Business Manager.
3
Revise e confirme as permissões solicitadas
O Strato solicitará: ads_read (leitura de campanhas e insights) e ads_management (listar contas).
4
Clique em "Continue" → "OK"
Você será redirecionado de volta ao Strato. Todas as contas de anúncio vinculadas ao seu Business Manager serão importadas automaticamente.

Conta Meta Ads conectada com sucesso!

Suas contas de anúncio foram importadas. Mapeie as campanhas abaixo.

Token expirado

O access token do Meta Ads tem validade de 60 dias por padrão. Quando expirar, o sync diário irá falhar silenciosamente. Nesse caso, clique novamente em "Conectar Meta Ads" para renovar a autorização.

Mapear campanhas

Para que o spend apareça no dashboard correto, você precisa vincular cada campanha do Meta a uma campanha interna do Strato.

1
Clique em "Campanhas" na linha da conta de anúncio
A lista de campanhas ativas e pausadas será carregada diretamente da Meta API.
2
Para cada campanha externa, selecione a campanha interna correspondente
Use o dropdown na coluna direita. Campanhas não mapeadas não terão spend propagado.
3
O vínculo é salvo automaticamente ao selecionar
Não é necessário clicar em "Salvar". O mapeamento fica ativo imediatamente para o próximo sync.

Minha Conta de Anúncios — act_123456789

3 mapeadas

Campanhas Meta → Campanhas Strato

Dentistas SP – Awareness

ACTIVE · Meta Ads

Campanha Dentistas SP

Clínicas RJ – Conversão

ACTIVE · Meta Ads

Lead Clínicas RJ

Retenção Nacional – Retargeting

ACTIVE · Meta Ads

— não mapeado —

Acompanhar métricas no dashboard

Após o primeiro sync (ou na próxima madrugada), as métricas de spend aparecem automaticamente no dashboard de cada campanha interna mapeada.

Dashboard — Campanha Dentistas SP

Visão Geral

Leads

248

+12% vs mês ant.

Investimento

R$ 3.840

Meta Ads spend

CPL

R$ 15,48

Custo por lead

ROAS

4.2x

Receita / Spend

Horário do sync

Todo dia às 02:00 UTC (23:00 BRT / 01:00 horário de verão). Dados do dia anterior são processados.

Métricas disponíveis

Spend (R$), Impressões, Cliques, Reach, CPC, CPM e CTR — por campanha, por dia.

CPL e ROAS calculados

CPL = Spend ÷ Leads. ROAS = Receita ÷ Spend. Atualizados automaticamente após cada sync.

Problemas comuns

"App ID da Meta não configurado"

Você ainda não salvou as credenciais no Strato. Complete o Passo 3 antes de clicar em Conectar.

"Invalid OAuth redirect URI"

A URL de callback não está registrada no app Meta. Verifique se você copiou e colou a URL exata no campo "Valid OAuth Redirect URIs" (Passo 2).

Botão "Conectar" desabilitado

As credenciais (App ID + App Secret) precisam ser salvas primeiro. O botão fica ativo automaticamente após salvar com sucesso.

Spend não aparece no dashboard

Verifique se a campanha está mapeada (Passo 5). O spend só é propagado para campanhas com vínculo ativo. O sync roda às 02:00 UTC — aguarde o próximo ciclo.

Nenhuma campanha listada ao expandir a conta

Confirme que o app Meta está em modo Live (não Development) e que a conta de anúncio está ativa no Business Manager.

Token expirado após 60 dias

Clique novamente em "Conectar Meta Ads" para gerar um novo token. O fluxo é idêntico à conexão inicial.

Precisa de ajuda com a configuração?

Nossa equipe configura tudo para você, do app Meta ao primeiro relatório de ROAS.

Falar com a equipe