Business Management APIs

Referência

Publicação

Ponto de extremidade	Descrição
`/{ad-account-id}/ads`	Criar um anúncio.
`/{business-id}/initiated_sharing_agreements`	Aprovar ou recusar uma solicitação de acordo comercial pendente.
`/{business-creative-folder-id}`	Criar e atualizar uma pasta de criativos da empresa.
`/{business-id}/creative_folders`	Fornecer uma pasta de criativos da empresa.
`/{business-id}/images`	Carregar imagens a uma pasta de criativos.
`/{business-id}/videos`	Carregar vídeos a uma pasta de criativos.
`/{business-creative-folder-id}/agencies`	Adicionar parceiro a uma pasta de criativos.
`/{business-creative-folder-id}/assigned_users`	Obter uma lista de pessoas que acessaram a pasta de criativos da empresa.

Ler

Ponto de extremidade	Descrição
`/{business-creative-folder-id}`	Obter detalhes de uma pasta de criativos da empresa.
`/{business-id}/creative_folders`	Obter uma lista de pastas de criativos que uma empresa pode acessar.
`/{business-id}/creatives`	Obter imagens e vídeos comerciais da empresa.
`/{business-id}/initiated_sharing_agreement`	Obter uma lista de solicitações de acordo pendentes. Este ponto de extremidade foi relançado em maio de 2020. Antes, `/initiated_sharing_agreement` havia sido descontinuado com o lançamento da Graph API V6.0.
`/{business-image-id}`	Obter detalhes de uma imagem.
`/{business-image-id}/insights`	Obter informações de uma imagem compartilhada.
`/{business-video-id}`	Obter detalhes do vídeo compartilhado.
`/{business-video-id}/insights`	Obter insights do vídeo compartilhado.
`/{business-creative-folder-id}/agencies`	Obter uma lista de empresas que têm acesso à sua pasta de criativos.
`/{business-creative-folder-id}/assigned_users`	Obter uma lista de pessoas que têm acesso à sua pasta de criativos.

Excluir

Ponto de extremidade	Descrição
`/{business-creative-folder-id}`	Excluir uma pasta de criativos.
`/{business-creative-folder-id}/agencies`	Remover um parceiro da pasta de criativos.
`/{business-creative-folder-id}/assigned_users`	Remover um usuário da pasta de criativos.
`/{business-image-id}`	Remover uma imagem compartilhada.
`/{business-video-id}`	Remover um vídeo compartilhado.

Tarefas permitidas

Tarefa permitida de usuário comercial	Descrição
`CREATE_CONTENT`	Este usuário pode criar pastas.
`MANAGE_CONTENT`	Este usuário pode gerenciar ativos da pasta de criativos.
`MANAGE_PERMISSIONS`	Este usuário pode gerenciar permissões da pasta de criativos da empresa.
`VIEW_CONTENT`	Este usuário pode visualizar ativos de uma pasta de criativos.
`VIEW_INSIGHTS`	Este usuário pode visualizar as informações de um ativo de criativo.

Insights

Estas métricas estão em desenvolvimento.

Nome da métrica	Descrição
`impressions`	Número de vezes que sua imagem ou vídeo foi exibido em um anúncio.
`inline_link_clicks`	Número de cliques em links no seu anúncio. Cliques em link em linha usam uma janela de atribuição de clique de 1 dia.
`video_play_actions`	Número de vezes que seu vídeo começou a ser reproduzido. Este dado mede cada impressão do vídeo, excluindo repetições.
`actions`	Total de ações atribuídas aos seus anúncios que as pessoas executaram. Essas ações podem envolver engajamento, cliques ou conversões. Consulte este documento para ver uma lista completa de tipos compatíveis.
`video_thruplay_watched_actions`	Número de vezes que seu vídeo foi reproduzido até o fim ou por, pelo menos, 15 segundos.
`quality_ranking`	Uma classificação da qualidade percebida do anúncio. A qualidade é medida a partir do feedback do anúncio e da experiência pós-clique. Para determinar a pontuação, o anúncio é comparado com outros que competiram pelo mesmo público. Os possíveis valores incluem os seguintes: `BELOW_AVERAGE_10` `BELOW_AVERAGE_20` `BELOW_AVERAGE_35` `AVERAGE` `ABOVE_AVERAGE` `UNKNOWN`, se não houver informação suficiente sobre o anúncio. Este caso tem relação com o diagnóstico de relevância do anúncio.

Os seguintes detalhamentos estão disponíveis:

age
gender
country
objective
publisher_platform
platform_position
device_platform
optimization_goal