Fundamentos
Hierarquia e terminologia da X Ads API
Para ter sucesso com a X Ads API, é importante entender como as entidades no X Ads se relacionam. Este tutorial aborda os fundamentos da hierarquia de objetos do X Ads.
Grupos de anúncios, conhecidos como line items na X Ads API, ficam dentro de campanhas e são usados para segmentar e dar lances em um conjunto de usuários do X. Anunciantes promovem Posts ou mídia (por exemplo, vídeos promovidos como anúncios In-stream) ao associá-los a um line item. Veja também Grupo de anúncios.
Uma coleção de criativos enviados para uma conta de anúncios como mídia da conta, que pode incluir ativos de pré-roll de vídeo promovido — também chamados de anúncios in-stream — e imagens que podem ser promovidas na X Audience Platform.
No topo da hierarquia do X Ads estão as contas de anúncios. Uma conta de anúncios pode ser gerenciada por vários usuários do X. @Furni, nossa loja de móveis de demonstração, é um exemplo de usuário que gerencia uma conta de anúncios. Identificamos contas de anúncios por um account_id, que é uma string alfanumérica em base36.
Em cada conta, armazenamos vários tipos de entidades que podem ser reutilizados em campanhas, como audiências personalizadas que podem ser usadas para segmentação, mídia da conta (vídeos ou imagens) e cards, que são criativos expandidos que você pode adicionar a um Post.
Ao enviar um ativo de vídeo, a entidade que está fazendo o upload pode definir uma categoria para o vídeo (por exemplo, Tweet Video, Tweet Gif, Tweet Image e Amplify Video). A categoria Amplify Video é obrigatória ao tentar enviar um vídeo que será veiculado como um anúncio in-stream. Esses vídeos exigem processamento especial para garantir que possam ser veiculados e, portanto, a categoria de mídia Amplify Video é necessária.
As metrics de Analytics ajudam parceiros e anunciantes a entender o desempenho do conteúdo que promovem no X. Isso inclui informações como impressões, cliques, visualizações de vídeo e gastos. Além disso, parceiros e anunciantes podem obter metrics detalhadas para vários segmentos das audiências que alcançam.
A X Ads API oferece duas maneiras de recuperar metrics detalhadas de desempenho de campanha: de forma síncrona e assíncrona.
Com solicitações de synchronous analytics, as metrics solicitadas são retornadas na resposta. O endpoint síncrono oferece suporte a intervalos de tempo curtos e é ideal para consultar o desempenho de campanhas em tempo real.
Com os endpoints de asynchronous analytics, as metrics solicitadas ficam disponíveis em um arquivo de resultados para download após a conclusão do processamento do “job” associado. Os endpoints assíncronos oferecem suporte à solicitação de metrics ao longo de um intervalo de tempo muito maior, permitem retornar data segmentados e destinam-se à busca de muito mais data — ideal para gerar relatórios ou preenchimentos históricos.
Cada campanha executada pelo anunciante deve ser criada sob um instrumento de financiamento existente. Uma campanha permite definir elementos como nome, programação e orçamento de uma campanha de anúncios. Mantendo o exemplo da Furni, poderíamos criar uma campanha chamada “Furni home decor”.
Vale destacar que uma conta de anúncios está limitada a, no máximo, 200 campanhas ativas; esse limite pode ser ampliado pelo gerente de contas do anunciante. Uma campanha é considerada ativa até que seu horário de término seja alcançado ou seu orçamento seja esgotado. Uma campanha pausada ainda é considerada ativa para fins de limites de campanha.
Cards oferecem uma maneira de estender visualmente um Tweet para incluir imagem, vídeo ou elementos de UI. A X Ads API oferece suporte a vários tipos de cards que podem ser usados em Tweets e posteriormente promovidos em campanhas.
Anunciantes podem promover Tweets em campanhas que incluem criativos, como imagens, GIFs e vídeos. Esses criativos podem ser associados a cartões do X, que permitem anexar fotos, vídeos e experiências de mídia ricas aos Tweets. Os criativos também podem ser anexados diretamente aos Tweets. Por exemplo, é possível incluir texto e um vídeo (ou até 3 imagens) e criar um Tweet promovido.
Cada item de linha precisa ter pelo menos um criativo associado para ser veiculado. Há várias opções de criativos disponíveis, incluindo Contas Promovidas para conquistar novos seguidores, criativos de mídia, como imagem ou vídeo, para itens de linha em toda a TX Audience Platform, ou Posts Promovidos.
Na conta de anúncios também há instrumentos de financiamento, que são as diferentes fontes de pagamento que o anunciante configurou para usar com o X Ads. Eles incluem desde ordens de inserção assinadas com a X até um cartão de crédito vinculado à conta.
Dentro de uma campanha, você pode ter um ou mais grupos de anúncios, também conhecidos como itens de linha na X Ads API. Os itens de linha podem ser entendidos como diferentes segmentos de uma campanha, cada um com seu próprio conjunto de segmentação e seu próprio criativo. Campanhas que contêm vários itens de linha são frequentemente chamadas de “campanhas de grupo de anúncios”.
Um dos benefícios de ter vários itens de linha em uma única campanha é poder criar uma variedade maior de combinações de segmentação e criativos.
Na nossa campanha “Furni home decor”, talvez queiramos criar dois itens de linha: um poderia ser “Compradores de imóveis em San Francisco” e o outro poderia ser “Compradores de imóveis em Londres”.
São permitidos até 100 itens de linha por campanha, e uma conta de anúncios é limitada a um total de 4.000 itens de linha ativos em todas as campanhas.
Mobile App Promotion, ou MAP, é um conjunto de produtos que permite aos anunciantes promover Apps móveis no X. Isso inclui instalações de App, conversões e reengajamento.
A mensuração de promoção de apps para dispositivos móveis do X permite que anunciantes acompanhem o desempenho de campanhas publicitárias no X projetadas para impulsionar instalações ou outras conversões dentro do app. Um parceiro de mensuração móvel do X permite ao anunciante gerenciar quais conversões deseja rastrear nos apps que está promovendo no X. Visão geral do MACT
Os endpoints da Biblioteca de Mídia permitem gerenciar imagens, GIFs e vídeos para contas do X Ads. Os ativos de mídia na biblioteca podem ser usados em Posts e na criação de cards. Eles também podem ser reutilizados em várias peças criativas, eliminando a necessidade de fazer upload do mesmo ativo várias vezes.
Contas Promovidas (campanhas de seguidores) fazem parte do Who to Follow, que sugere contas que as pessoas ainda não seguem e que podem achar interessantes. Contas Promovidas ajudam a apresentar uma variedade ainda maior de contas que as pessoas podem gostar.
Contas Promovidas permitem que anunciantes promovam sua conta e ampliem seu público no X. As campanhas de seguidores são exibidas em vários locais na plataforma X — incluindo as Timelines Iniciais, o Who to Follow e os resultados de pesquisa — e essa sugestão é identificada como Promovida para diferenciá-la de outras contas recomendadas.
Cada conta do X Ads pode ter um ou mais usuários promovíveis, que são usuários que podemos promover por meio da conta de anúncios. O @Furni da Furni seria um exemplo de um usuário promovível COMPLETO na conta de anúncios da Furni, o que significa que podemos executar todos os tipos de campanhas para @Furni e seus tweets. Só pode haver um usuário promovível COMPLETO por conta de anúncios.
Observe que também pode haver outros usuários promovíveis em uma conta de anúncios. Por exemplo, se quisermos promover os Tweets de @Jack sobre produtos da Furni, ele se tornaria um usuário promovível somente para Retweet na conta, o que é indicado por RETWEETS_ONLY. Os anunciantes devem entrar em contato com seu gerente de conta da X para obter informações sobre como adicionar usuários de Retweet à sua conta de anúncios.
Vídeos promovidos são vídeos em Promoted Tweets pelos quais os anunciantes pagam. Eles aparecem na timeline Inicial, no topo dos resultados de busca no X e em outros locais da plataforma, e são claramente marcados como “Promoted”.
Consulte a X Audience Platform.
Tweets agendados permitem que um anunciante ou usuário crie um Tweet que pode ser programado para ir ao ar em uma data posterior. Além de criar e gerenciar esses Tweets, a API permite associá-los a um item de linha, para serem promovidos assim que o Tweet for ao ar. Isso permite que anunciantes preparem Tweets nativos e planejem os criativos de campanha com antecedência de iniciativas-chave. Por exemplo, preparar um criativo de Tweet para entrar no ar imediatamente após o anúncio de um novo produto.
A segmentação permite que parceiros e anunciantes obtenham metrics detalhadas por valores específicos de segmentação — como idade, dispositivos ou idiomas — e está disponível apenas por meio de nossos endpoints de analytics assíncronos. Para solicitar metrics segmentadas, use o parâmetro de requisição segmentation_type. Para mais detalhes sobre as opções de segmentação, consulte Metrics and Segmentation.
As audiências personalizadas com base em listas são um dos três tipos de Tailored Audiences, criadas por meio do upload de um arquivo contendo seus próprios dados de usuários e clientes. Suas listas são alinhadas aos usuários na X para que você possa segmentá-los diretamente em suas campanhas. Revise estas restrições.
O Público Personalizado da web, um dos três tipos de Públicos Personalizados, é um conjunto de usuários do X que visitaram seu site. Para usar Públicos Personalizados da web, você deve ter o pixel da X instalado no seu site ou usar um de nossos parceiros aceitos de gerenciadores de tags. Confira estas restrições.
Como mencionado anteriormente, os critérios de segmentação estão associados a um line item. Oferecemos uma variedade de segmentações que você pode usar — de localização, palavras-chave e gênero a atributos mais granulares, como comportamentos e interesses de usuários. Para o line item “Home Buyers in San Francisco”, podemos segmentar o comportamento “home buying” juntamente com a localização “San Francisco”.
Para obter informações sobre os diferentes tipos de segmentação disponíveis, visite a página Visão geral da segmentação em nosso site para desenvolvedores.
O Twitter Object Nest (TON) armazena mídias e diversos ativos enviados pelos endpoints de Media Upload para uso como Creatives.
Cada item de linha precisa ter pelo menos um criativo associado para ser veiculado. Há várias opções de criativos disponíveis, incluindo Contas Promovidas para ganhar novos seguidores, Criativos de Mídia — como imagem ou vídeo — para itens de linha em toda a X Audience Platform, ou Posts Promovidos. Aqui está um exemplo de Post que @Furni poderia promover e usar como criativo.
⌘I