Conecta-seEntrar na plataforma

Meta Ads

Consultar contas, campanhas e desempenho de anúncios Meta e cruzar IDs com a origem registrada no CRM.

Integrações e ferramentasDados e análisesConexão: OAuth

O que faz

Consulte contas, campanhas e anúncios. Cruze o ID do anúncio com a origem registrada no CRM.

Quando usar: Use quando o seu fluxo precisar consultar contas, campanhas e desempenho de anúncios Meta e cruzar IDs com a origem registrada no CRM.

Exemplo de situação: Consultar indicadores e usar o resultado em uma decisão do fluxo.

Antes de começar

Conexão necessária: OAuth.

Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.

Passo a passo

  1. Adicione Meta Ads ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
  3. Escolha a operação. O painel mostra só os campos que essa operação usa.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Operações

OperaçãoO que faz
Consultar contas de anúnciosConsulta contas de anúncios com o bloco Meta Ads.
Consultar campanhasConsulta campanhas com o bloco Meta Ads.
Identificar campanha de um anúncioIdentifica campanha de um anúncio com o bloco Meta Ads.
Consultar desempenho de anúnciosConsulta desempenho de anúncios com o bloco Meta Ads.

Campos

Mostrar campos de

  • Operação

    Escolhe qual ação este bloco executará.

    Opções:
    Consultar contas de anúncios · Consultar campanhas · Identificar campanha de um anúncio · Consultar desempenho de anúncios
    Padrão:
    Consultar contas de anúncios

  • Conta Meta Ads

    Obrigatório

    Seleciona a conta já conectada que autoriza o acesso ao serviço.

    Exemplo:
    (escolha a conta conectada)

  • ID da conta de anúncios

    Obrigatório conforme a operação

    Seleciona a conta ou conexão autorizada que será usada nesta ação.

    Aparece em:
    Consultar campanhas, Consultar desempenho de anúncios
    Exemplo:
    id-do-recurso

  • ID do anúncio

    Obrigatório conforme a operação

    Informa o identificador exato do recurso na plataforma conectada.

    Aparece em:
    Identificar campanha de um anúncio
    Exemplo:
    id-do-recurso

  • De

    Obrigatório conforme a operação

    Data inicial inclusiva no formato YYYY-MM-DD, no fuso da conta Meta.

    Aparece em:
    Consultar desempenho de anúncios
    Exemplo:
    cliente@exemplo.com

  • Até

    Obrigatório conforme a operação

    Data final inclusiva no formato YYYY-MM-DD. Consulte no máximo 31 dias por execução.

    Aparece em:
    Consultar desempenho de anúncios
    Exemplo:
    cliente@exemplo.com

  • Próxima página

    Em campos adicionais

    Use nextCursor da resposta anterior, preservando período e conta.

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <metaads.data>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<metaads.data>jsonDados retornados pela Meta. IDs de anúncio, conjunto e campanha são distintos.
<metaads.nextCursor>stringCursor para a próxima página; vazio indica fim.
<metaads.hasMore>booleanHá mais registros. Nunca interpretar esta página como o total.
<metaads.notice>stringLimites e definição das métricas.

Exemplo de uso

Objetivo: Consultar indicadores e usar o resultado em uma decisão do fluxo.

InícioMeta Adspróxima etapa
Operação
Consultar contas de anúncios
Conta Meta Ads
(escolha a conta conectada)

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <metaads.data>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O campo que eu procuro não aparece
Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
Erro de autorização ou permissão (401/403)
A conta conectada perdeu o acesso ou não tem permissão para esta operação. Reconecte a conta no campo de credencial e confirme as permissões pedidas.
O serviço recusou a chamada ou devolveu erro
Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.

Blocos relacionados