Skip to main content
Gerencie todos os tipos de conteúdo promocionável (Tweets, mídia, cards, enquetes etc.) para suas campanhas publicitárias no X.
  • Referência completa da API — Referência completa para todos os endpoints e objetos de criativos
  • Guias — Media Library, Scheduled Tweets, Identifying Cards/Media, Carousels, etc.

​
Visão geral

Criativos são qualquer entidade que pode ser promovida em uma campanha. Posts podem incluir texto, imagens, GIFs, vídeos ou cards. Cards podem incluir imagens ou vídeos. Criativos de imagem, GIF ou vídeo são enviados usando o endpoint POST media/upload — um endpoint de upload simples que suporta apenas imagens — ou os endpoints POST media/upload (chunked). Estes podem ser adicionados a: cards:
  • POST accounts/:account_id/cards
Tweets:
  • POST accounts/:account_id/tweets - Para adicionar cards a Tweets, use o parâmetro card_uri.
Scheduled Tweets:
  • POST accounts/:account_id/scheduled_tweets
Para mais detalhes sobre cards, consulte a página Cards. A página Promoted Video fornece detalhes sobre associar vídeos a cards ou Tweets.

​
Cards

A Ads API suporta vários tipos de card que podem ser usados em Tweets, os quais podem então ser promovidos em campanhas. Nota: uma vez postado, os detalhes do card são publicamente visíveis. Isso pode incluir informações sobre o usuário que possui o card.

​
Imagem

As seguintes especificações de imagem se aplicam a assets usados em Cards. As imagens devem ter 3MB ou menos e largura de pelo menos 800px. Além disso, suportamos os seguintes aspectos de largura:altura.
  • Website: 1:1 e 1.91:1
  • Image App Download: 1:1 e 1.91:1
  • Poll: 1.91:1
  • Image Conversation: 1.91:1
  • Image Direct Message: 1.91:1
Suportamos os seguintes formatos de imagem: .bmp, .jpeg e .png.

​
Vídeo

As seguintes especificações de vídeo se aplicam a assets usados em Cards. Suportamos os seguintes aspectos de largura:altura.
  • Video Website: 16:9 e 1:1
  • Video App Download: 16:9 e 1:1
  • Poll: 16:9
  • Video Conversation: 16:9
  • Video Direct Message: 16:9
Este é um guia técnico extenso que cobre Promoted Video, Media Library, Scheduled Tweets, Draft Tweets, Video View Objective, Video Conversation Cards, In-Stream Video Ads, Identifying Cards, Identifying Media Types e Carousels. Para o conteúdo detalhado, consulte a documentação em inglês em /x-ads-api/creatives. Todos os exemplos de código, valores de parâmetros e estruturas JSON permanecem os mesmos.

​
Referência completa da API

Para a referência completa (todos os endpoints de criativos com exemplos de requisição/resposta e tabelas de atributos), consulte a página Referência da API de Creatives.