Ads
Crie e gerencie anúncios no Meta Ads, no Google Ads e no TikTok Ads dos seus clientes por uma API
Tudo nasce pausado, toda escrita é idempotente e uma falha no meio desfaz o que já tinha sido criado. Seu produto opera a conta de anúncios do cliente sem passar pela revisão de app da Meta.
POST /api/ads/campaigns?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>
{
"name": "Black Friday",
"budget": {
"amount": 50,
"type": "daily"
},
"facebook_ads": {
"objective": "traffic",
"special_ad_categories": []
}
}O que dá para fazer
Criar campanha no Meta Ads, no Google Ads e no TikTok AdsCrie campanhas no Meta Ads, Demand Gen e Performance Max no Google Ads ou de Tráfego, Alcance e Visualizações de vídeo no TikTok Ads com um POST. Nasce pausada e é idempotente.
Criar conjunto ou grupo de anúncios no Meta, Google e TikTok AdsCrie conjuntos no Meta Ads e grupos de anúncios no Google Ads (Demand Gen) e no TikTok Ads (Tráfego, Alcance e Visualizações de vídeo) por API. Nasce pausado e idempotente.
Criar anúncio no Meta Ads, no Google Ads e no TikTok AdsCrie o anúncio e a árvore acima dele (campanha e conjunto) no Meta Ads, no Google Ads ou no TikTok Ads com um POST. Tudo nasce pausado.
Impulsionar post do Instagram pela APIImpulsione um post do Instagram do seu cliente com um POST: o Connect cria campanha, conjunto e anúncio a partir do post. Nasce pausado, idempotente.
Validar anúncio do Meta Ads, Google Ads ou TikTok Ads sem criarValide a árvore campanha, conjunto e anúncio no Meta Ads, no Google Ads ou no TikTok Ads com o mesmo corpo do POST /ads, sem criar nada.
Duplicar anúncio, conjunto ou campanha no Meta AdsDuplique anúncios, conjuntos ou campanhas do Meta Ads com um POST, trocando nome, orçamento ou agenda. A cópia nasce pausada por padrão.
Pausar e ativar campanhas, conjuntos e anúnciosPause ou ative campanhas, conjuntos e anúncios do Meta Ads do seu cliente com um PATCH de status. Funciona mesmo para objetos criados fora do Connect.
Editar orçamento de campanha ou conjunto no Meta AdsAltere o orçamento de uma campanha (CBO) ou de um conjunto (ABO) do Meta Ads por API, na moeda da conta, com um PATCH.
Apagar campanhas, conjuntos e anúncios do Meta AdsApague uma campanha, um conjunto ou um anúncio do Meta Ads com um DELETE. A campanha leva os conjuntos e anúncios junto. Sem app review.
Listar campanhas, conjuntos e anúncios do Meta AdsListe campanhas, conjuntos e anúncios do Meta Ads de um cliente, com status e orçamento, direto da conta ao vivo ou do que o Connect já guarda.
Ver os anúncios de todos os clientes do Meta AdsListe campanhas, conjuntos e anúncios do Meta Ads de todos os seus clientes numa só chamada, só com a chave do merchant e filtros por cliente.
Enviar imagem e vídeo para o Meta Ads, o Google Ads e o TikTok AdsEnvie imagens e vídeos por URL para a conta do cliente no Meta Ads, no Google Ads ou no TikTok Ads e receba o que os anúncios usam para citá-los.
Buscar interesses, locais e idiomas no Meta Ads e no Google AdsTransforme um termo como "corrida" nos ids de interesse, local ou comportamento do Meta Ads, ou de local e idioma do Google Ads, que a segmentação espera.
Listar públicos do Meta Ads e listas de usuários do Google AdsListe os públicos personalizados do Meta Ads ou as listas de usuários do Google Ads do cliente, com id e tamanho aproximado, pela mesma rota.
Listar pixels e eventos de conversão do Meta AdsListe os pixels da conta de anúncios do Meta Ads do cliente e os eventos que cada um registrou nos últimos 90 dias, para otimizar por conversão.
Criar conversões personalizadas no Meta AdsCrie e liste conversões personalizadas do Meta Ads por regra de URL ou de evento do pixel, e use o id para otimizar um conjunto de anúncios.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
