Ad
ads.adUnifiedEm breveUm anúncio com o criativo, o resultado da revisão, o gasto e os resultados. Anúncios de bibliotecas públicas de anúncios também voltam.
chave plataforma + ID do anúncio12 chamadas planejadas2 endpoints Direct hoje
12 chamadas planejadasEm breve
Nosso primeiro rascunho dos caminhos, ainda sem revisão. Cada chamada age nas plataformas listadas pela Connection que você concede, e nenhuma está implantada ainda.
- GET
/Anúncios com status, resultado da revisão e gastoTodas as 8 plataformas de anúnciosRascunhov1/ ads - GET
/Um anúncio com o criativoTodas as 8 plataformas de anúnciosRascunhov1/ ads/ {adId} - GET
/Resultados de um anúncio por diaTodas as 8 plataformas de anúnciosRascunhov1/ ads/ {adId}/ analytics - GET
/O resultado da revisão da plataforma, com cada motivo de reprovaçãoMeta · Google · TikTokRascunhov1/ ads/ {adId}/ review - POST
/Mostrar como um anúncio aparece em cada posicionamentoMetaRascunhov1/ ads/ preview - POST
/Criar um anúncio, com uma nova campanha e um novo conjunto de anúncios quando necessárioTodas as 8 plataformas de anúnciosRascunhov1/ ads/ create - POST
/Transformar um post existente em anúncioMeta · TikTok · LinkedIn · Pinterest · X · RedditRascunhov1/ ads/ boost - PUT
/Mudar o criativo ou a segmentação de um anúncioMeta · Google · TikTok · LinkedIn · RedditRascunhov1/ ads/ {adId} - PUT
/Pausar ou retomar um anúncioTodas as 8 plataformas de anúnciosRascunhov1/ ads/ {adId}/ status - DELETE
/Excluir ou cancelar um anúncioTodas as 8 plataformas de anúnciosRascunhov1/ ads/ {adId} - GET
/Comentários em um anúncio, incluindo anúncios que nunca foram publicados como postMeta · TikTokRascunhov1/ ads/ {adId}/ comments - GET
/Buscar na biblioteca pública de anúncios os anúncios de qualquer anuncianteMeta · LinkedInRascunhov1/ ads/ library
CamposRascunho · os campos podem mudar
Uma primeira versão do schema, a partir dos objetos das próprias plataformas de anúncios. Nomes, tipos e cobertura podem mudar antes do lançamento da camada Unified.
Observável
Um snapshot recente, se houver; se não, uma leitura em tempo real; se não, a próxima fontead_setAdSetReportadocreativeCreativeReportadopostPostReportadoPreenchido quando o anúncio impulsiona um Post existentestatusStatusReportadoreview_statusStatusReportadoO resultado da revisão do anúncio pela plataforma e o motivospendMoneyReportadoimpressionsintegerReportadoclicksintegerReportadoctrnumberReportadocpmMoneyReportadoconversionsnumberReportadolibraryLibraryEntryObservadoDa biblioteca pública de anúncios, para anúncios que não são seus
Chame hoje pelo DirectDisponível
Endpoints de fornecedores que já retornam esse tipo de objeto, no formato do próprio fornecedor. Seu código indica o fornecedor, então trocar de fornecedor significa alterar o código.
2 endpoints de 1 API · a partir de US$0.88
Entidades ligadas a Ad
Cada link é um campo que você pode pedir na mesma chamada.
AdSet
plataforma + ID do conjunto de anúnciosA segmentação, o orçamento e os posicionamentos que um grupo de anúncios compartilha. No Google, ele se chama grupo de anúncios.
Creative
plataforma + ID do criativoA mídia, o texto e a chamada para ação que um anúncio exibe, reutilizáveis em vários anúncios.
Post
plataforma + ID do postUm post em uma plataforma, com o link e as métricas.
Comment
plataforma + ID do comentárioUm comentário, uma resposta ou uma avaliação de página. Leia, responda, oculte ou exclua.