Procurando documentação detalhada de endpoints?
A referência completa da API (todos os endpoints, exemplos de requisição/resposta e tabelas de parâmetros para Accounts, Campaigns, Line Items, Funding Instruments, Targeting, etc.) foi movida para a página dedicada Referência da API de Gerenciamento de Campanhas. Links profundos antigos (por exemplo,
A referência completa da API (todos os endpoints, exemplos de requisição/resposta e tabelas de parâmetros para Accounts, Campaigns, Line Items, Funding Instruments, Targeting, etc.) foi movida para a página dedicada Referência da API de Gerenciamento de Campanhas. Links profundos antigos (por exemplo,
#get-accounts-account-id-campaigns) redirecionarão automaticamente para lá.Links rápidos
- O que você pode promover?
- Criando uma campanha – Passo a passo
- Guias
- Referência completa da API — Todos os endpoints, parâmetros e exemplos para Accounts, Campaigns, Line Items, Funding Instruments, Targeting e mais.
Advertiser API
Agende campanhas e gerencie anúncios no X programaticamente através deste conjunto de APIs.O que você pode promover
Promoted Ads
- Promoted Ads são anúncios comuns adquiridos por anunciantes que desejam atingir um grupo mais amplo de usuários ou gerar engajamento de seus seguidores existentes.
- Promoted Ads são claramente rotulados como Promoted quando um anunciante paga pela posição no X. Em todos os outros aspectos, os Promoted Ads agem como anúncios normais e podem ser repostados, respondidos, curtidos e mais. Eles têm regras de entrega típicas e são criados usando POST statuses/update.
- Tweets “Promoted-only”, criados via POST accounts/:account_id/tweet, podem ser usados em campanhas de Promoted Tweets, mas não serão exibidos para seguidores nem aparecerão na timeline pública. Para obter uma lista de tweets promoted-only para uma determinada conta, use GET accounts/:account_id/scoped_timeline.
Promoted Accounts
- Promoted Accounts fazem parte do Who to Follow, que sugere contas que as pessoas não seguem atualmente e podem achar interessantes. Promoted Accounts ajudam a apresentar uma variedade ainda maior de contas de que as pessoas podem gostar.
- Promoted Accounts for Timeline associam um Promoted Tweet a uma campanha de Promoted Account e serão exibidos nas timelines dos usuários.
Campanhas e Ad Groups (Line Items)
Campanhas definem o cronograma e o orçamento de um anúncio. O anunciante especifica um orçamento diário e um orçamento total. A campanha pode ser vinculada a um horário específico de início e fim ou rodar continuamente até que o orçamento seja gasto. O orçamento vem de um dos Funding Instruments da conta de anúncios. Os identificadores de campanha (:campaign_id) são a representação base-36 do valor base-10 que apresentamos na UI do X Ads. Contas de anúncios são limitadas a um máximo de 200 campanhas ativas. Este limite pode ser aumentado manualmente para 4.000 campanhas ativas pelo X Account Manager do anunciante mediante solicitação. Uma campanha é considerada ativa até atingir seu horário de término ou ser excluída. Campanhas pausadas são consideradas ativas até seu horário de término designado. Line items gastam o orçamento definido por uma campanha. Line items reúnem o lance por engajamento, o Tweet ou conta a ser promovida e as regras de segmentação.Analytics
A X Ads API oferece um conjunto de endpoints de analytics para acompanhar e otimizar o desempenho dos anúncios. Consulte Analytics e Analytics Best Practices para mais informações. Para a métrica de faturamento, os dados podem não estar finalizados até três dias após o evento. Antes desse ponto, os dados devem ser considerados especulativos. O número final faturável sempre será menor que o valor especulativo. O número faturável é corrigido para spam e tráfego de baixa qualidade relacionado. Consulte Timezones para outras considerações sobre tempo.Criando uma campanha - Passo a passo
O exemplo abaixo assume que você instalou, configurou e autorizou seu app e usuário usando twurl. twurl é uma ferramenta de linha de comando no espírito do cURL que lida elegantemente com a autenticação OAuth do X. twurl é uma ótima ferramenta para testar e depurar rapidamente a funcionalidade da Ads API (e da REST API). Para ver os headers completos da requisição e resposta, use-t para rastrear a chamada, aproximadamente equivalente à opção -v do cURL.
Para este exemplo, criaremos uma campanha de Promoted Ads segmentada por keyword.
- Recuperar o account id.
Exemplo de resposta