Visão geral

A API de Marketing é baseada em HTTP e pode ser usada para consultar dados de forma programática, criar e gerenciar anúncios, bem como realizar diversas outras tarefas. Esta seção fornece informações gerais sobre as APIs de Marketing, o acesso, o controle de versões e muito mais.

Por ser baseada em HTTP, a API funciona com todos os softwares e linguagens compatíveis com HTTP, incluindo cURL e a maioria dos navegadores da web modernos. A API de Marketing foi criada com base na Graph API da Meta. Por isso, quase todas as solicitações devem ser passadas para a URL de hospedagem graph.facebook.com.

Conceitos básicos

Conceitos essenciais para você usar a API de Marketing:

Estrutura da campanha de anúncios

A Meta organiza os anúncios em uma estrutura de três níveis: campanha, conjunto de anúncios e anúncio. Na API, os desenvolvedores têm acesso a um quarto nível, que é chamado de criativo.

Autorização

Para acessar pontos de extremidade da API de Marketing, o app precisa passar por múltiplas camadas de autorização da Graph API.

Autenticação

Saiba como obter e armazenar o token de acesso necessário para as chamadas de API.

Limitação de volume

A API de Marketing tem a própria lógica de limitação de volume e está excluída de todos os limites de volume da Graph API.

Controle de versões

A plataforma da Meta tem um modelo de controle de versões principal e um ampliado. Saiba mais sobre as próximas mudanças e desativações usando nossos sistemas de controle de versões e de migração. Consulte Controle de versões, Migrações e Registro de alterações.

Análise do app

Para usar a API de Marketing, é necessário enviar seu app para a análise, com algumas exceções para a API do lado do servidor e conversões offline.

Permissões

Há duas permissões de anúncios principais: ads_management e ads_read. As permissões devem ser concedidas ao app que você usa para fazer chamadas. Você pode solicitá-las durante o processo de análise do app. Veja a lista de permissões disponíveis para apps de empresa.

Códigos de erro

Talvez você veja códigos de erro quando estiver usando a API. Consulte a referência para saber mais sobre cada um deles.

Post-Processing for Ad Creation and Edits

Entenda a fase de pós-processamento que ocorre quando uma solicitação é recebida pela Meta.