Notions de base
Hiérarchie et terminologie de l’Ads API
Pour réussir avec l’Ads API, il est important de comprendre comment les entités X Ads sont reliées entre elles. Ce tutoriel couvre les bases de la hiérarchie des objets X Ads.
Les groupes d’annonces, appelés line items dans l’Ads API, sont rattachés aux campagnes et utilisés pour le ciblage et les enchères auprès d’un ensemble d’utilisateurs de X. Les annonceurs font la promotion de Publications ou de médias (par exemple, des vidéos promues en tant que publicités In-Stream) en les associant à un line item. Voir également Groupe d’annonces.
Un ensemble d’éléments créatifs qui ont été importés dans un compte publicitaire en tant que médias du compte, pouvant inclure des vidéos sponsorisées de type ressources de pré-roll, également appelées publicités in-stream, ainsi que des images pouvant être promues sur la X Audience Platform.
Au sommet de la hiérarchie X Ads se trouvent les comptes publicitaires. Un compte publicitaire peut être géré par plusieurs utilisateurs X. @Furni, notre magasin de meubles de démonstration, est un exemple d’utilisateur qui gère un compte publicitaire. Nous identifions les comptes publicitaires par un account_id, qui est une chaîne alphanumérique en base36.
Sous chaque compte, nous stockons un certain nombre de types d’entités qui peuvent être réutilisés dans plusieurs campagnes, comme les audiences personnalisées qui peuvent être utilisées pour le ciblage, les médias du compte, qui sont des vidéos ou des images, et les cards, qui sont des créations publicitaires enrichies que vous pouvez ajouter à une publication.
Lors du téléversement d’une ressource vidéo, l’entité qui procède au téléversement peut définir une catégorie pour la vidéo (par exemple, Tweet Video, Tweet Gif, Tweet Image et Amplify Video). La catégorie Amplify Video est requise lorsque vous téléversez une vidéo destinée à être diffusée en tant que publicité in-stream. Ces vidéos nécessitent un traitement spécifique pour garantir qu’elles peuvent être diffusées et, par conséquent, la catégorie de média Amplify Video est requise.
Les métriques Analytics permettent aux partenaires et aux annonceurs de comprendre les performances du contenu qu’ils promeuvent sur X. Elles incluent des informations telles que les impressions, les clics, les vues vidéo et les dépenses. De plus, les partenaires et les annonceurs peuvent obtenir des métriques détaillées pour différents segments des audiences qu’ils atteignent.
L’API Ads prend en charge deux façons de récupérer des métriques détaillées de performance de campagne : de manière synchrone et asynchrone.
Avec les requêtes synchronous analytics, les métriques demandées sont renvoyées dans la réponse. L’endpoint synchrone prend en charge de courtes plages temporelles et est idéal pour interroger les performances des campagnes en temps réel.
Avec les endpoints asynchronous analytics, les métriques demandées sont disponibles dans un fichier de résultats téléchargeable une fois que le « job » associé a terminé son traitement. Les endpoints asynchrones permettent de demander des métriques sur une plage temporelle beaucoup plus longue, permettent de renvoyer des données segmentées et sont conçus pour récupérer beaucoup plus de données — idéal pour générer des rapports ou des reconstitutions historiques.
Chaque campagne lancée par l’annonceur doit être créée sous un instrument de financement existant. Une campagne vous permet de définir des éléments comme le nom, le calendrier et le budget d’une campagne publicitaire. Pour reprendre l’exemple de Furni, nous pourrions créer une campagne intitulée « Furni home decor ».
Il est important de noter qu’un compte publicitaire est limité à un maximum de 200 campagnes actives ; cette limite peut être augmentée par le chargé de compte de l’annonceur. Une campagne est considérée comme active jusqu’à ce que son heure de fin soit atteinte ou que son budget soit épuisé. Une campagne mise en pause est toujours considérée comme une campagne active pour le calcul des limites de campagnes.
Les cartes permettent d’étendre visuellement un Tweet en y ajoutant une image, une vidéo ou des éléments d’interface utilisateur. L’API Ads prend en charge plusieurs types de cartes qui peuvent être utilisés dans des Tweets, puis promus dans des campagnes.
Les annonceurs peuvent promouvoir des Tweets dans des campagnes qui incluent des créations publicitaires, telles que des images, des GIF et des vidéos. Ces créations peuvent être associées à des cartes X qui permettent d’ajouter des photos enrichies, des vidéos et des expériences média aux Tweets. Les créations peuvent également être directement jointes aux Tweets. Par exemple, vous pouvez inclure du texte et une vidéo (ou jusqu’à 3 images) et créer un Tweet sponsorisé.
Chaque élément de campagne doit avoir au moins une création publicitaire associée pour pouvoir être diffusé. Plusieurs types de créations sont disponibles, notamment les Comptes sponsorisés pour acquérir de nouveaux abonnés, les créations média telles qu’une image ou une vidéo pour les éléments de campagne sur l’ensemble de la TX Audience Platform, ou les Publications sponsorisées.
Au sein du compte publicitaire se trouvent également les instruments de financement, qui sont les différentes sources de financement que l’annonceur a configurées pour les utiliser avec X Ads. Cela va des ordres d’insertion signés avec X à une carte de crédit associée au compte.
Au sein d’une campagne, vous pouvez avoir un ou plusieurs groupes d’annonces, également appelés éléments de campagne dans l’Ads API. Les éléments de campagne peuvent être considérés comme différents segments d’une campagne, chacun avec son propre ensemble de ciblage et sa propre création publicitaire. Les campagnes qui contiennent plusieurs éléments de campagne sont souvent appelées « campagnes de groupes d’annonces ».
L’un des avantages de disposer de plusieurs éléments de campagne au sein d’une même campagne est que vous pouvez créer une plus grande variété de combinaisons de ciblage et de créations publicitaires.
Dans le cadre de notre campagne « Furni home decor », nous pourrions vouloir créer deux éléments de campagne : l’un pourrait être « Acheteurs de maison à San Francisco », et l’autre « Acheteurs de maison à Londres ».
Jusqu’à 100 éléments de campagne sont autorisés par campagne, et un compte publicitaire est limité à 4 000 éléments de campagne actifs au total, toutes campagnes confondues.
La promotion d’applications mobiles, ou MAP, est une suite de produits qui permet aux annonceurs de promouvoir des applications mobiles sur X. Elle comprend les installations d’applications, les conversions et le réengagement.
La mesure de la promotion d’applications mobiles sur X permet aux annonceurs de suivre les performances des campagnes publicitaires sur X conçues pour générer des installations ou d’autres conversions in‑app. Un partenaire X de mesure mobile permet à un annonceur de gérer les conversions qu’il souhaite suivre à partir des Apps qu’il promeut sur X. Vue d’ensemble de MACT
Les endpoints de la Médiathèque permettent de gérer les images, GIFs et vidéos pour les comptes X Ads. Les ressources média de la Médiathèque peuvent être utilisées dans des Publications et pour créer des Cards. Elles peuvent également être réutilisées dans plusieurs créations publicitaires, ce qui évite d’avoir à téléverser plusieurs fois la même ressource.
Les Comptes sponsorisés (campagnes de followers) font partie de Who to Follow, qui suggère des comptes que les utilisateurs ne suivent pas encore et qu’ils peuvent trouver intéressants. Les Comptes sponsorisés contribuent à faire découvrir une variété encore plus large de comptes susceptibles de plaire aux utilisateurs.
Les Comptes sponsorisés permettent aux annonceurs de promouvoir leur compte et de développer leur audience sur X. Les campagnes de followers sont diffusées à différents emplacements sur la plateforme X — notamment dans les chronologies d’accueil, dans Who to Follow et dans les résultats de recherche — et cette suggestion est identifiée comme « Sponsorisé » afin de la distinguer des autres comptes recommandés.
Chaque compte X Ads peut avoir un ou plusieurs utilisateurs promouvables, c’est-à-dire des utilisateurs que nous pouvons promouvoir via le compte publicitaire. Le nom d’utilisateur @Furni de Furni serait un exemple d’utilisateur promouvable FULL rattaché au compte publicitaire de Furni, ce qui signifie que nous pouvons lancer tous les types de campagnes pour @Furni et ses Tweets. Il ne peut y avoir qu’un seul utilisateur promouvable FULL pour un compte publicitaire.
Notez qu’il peut également y avoir d’autres utilisateurs promouvables associés à un compte publicitaire. Par exemple, si nous voulions promouvoir les Tweets de @Jack concernant les produits Furni, il deviendrait un utilisateur promouvable limité aux Retweets sur le compte, ce qui est indiqué par RETWEETS_ONLY. Les annonceurs doivent contacter leur chargé de compte X pour obtenir des informations sur l’ajout d’utilisateurs de retweet à leur compte publicitaire.
Les vidéos sponsorisées sont des vidéos dans des Tweets sponsorisés, payées par les annonceurs. Ces vidéos apparaissent dans le fil d’Accueil, en haut des résultats de recherche sur X et ailleurs sur la plateforme, et sont clairement identifiées comme « Sponsorisé ».
Voir X Audience Platform.
Les Tweets programmés permettent à un annonceur ou à un utilisateur de créer un Tweet qui pourra être publié à une date ultérieure. En plus de pouvoir créer et gérer ces Tweets, l’API permet d’associer ces Tweets à un élément de campagne, afin de les promouvoir une fois le Tweet publié. Cela permet aux annonceurs de préparer des Tweets natifs et de planifier à l’avance les créations de leurs campagnes pour toute initiative clé. Par exemple, préparer la création d’un Tweet pour qu’il soit publié immédiatement au moment de l’annonce d’un nouveau produit.
La segmentation permet aux partenaires et aux annonceurs d’obtenir des métriques ventilées selon des valeurs de ciblage spécifiques — comme l’âge, les appareils ou les langues — et n’est disponible que via nos endpoints d’analytics asynchrones. Pour obtenir des métriques segmentées, utilisez le paramètre de requête segmentation_type. Pour plus de détails sur les options de segmentation, consultez Metrics and Segmentation.
Les audiences personnalisées à partir de listes sont l’un des trois types d’audiences personnalisées, créées en important un fichier contenant vos propres données d’utilisateurs et de clients. Vos listes sont mises en correspondance avec des utilisateurs sur X afin que vous puissiez les cibler directement dans vos campagnes. Veuillez passer en revue ces restrictions.
La fonctionnalité Tailored Audience from web, l’un des trois types de Tailored Audiences, correspond à un groupe d’utilisateurs X qui ont visité votre site web. Pour utiliser Tailored Audiences from web, vous devez avoir installé notre pixel X sur votre site web ou utiliser l’un de nos partenaires gestionnaires de balises acceptés. Veuillez prendre connaissance de ces restrictions.
Comme nous l’avons mentionné précédemment, les critères de ciblage sont associés à un élément de campagne (line item). Nous proposons une large gamme d’options de ciblage que vous pouvez utiliser, allant de la localisation, des mots-clés et du genre à des attributs plus granulaires, comme les comportements et centres d’intérêt des utilisateurs. Pour l’élément de campagne « Home Buyers in San Francisco », nous pourrions cibler le comportement « home buying » associé à la localisation « San Francisco ».
Pour plus d’informations sur les différents types de ciblage disponibles, consultez la page Targeting Overview sur notre site pour développeurs.
Le Twitter Object Nest (TON) stocke les médias et diverses ressources chargés via les endpoints Media Upload pour être utilisés comme Creatives.
Chaque élément de campagne doit avoir au moins une création publicitaire associée pour pouvoir être diffusé. Plusieurs types de créations publicitaires sont disponibles, notamment des Promoted Accounts pour gagner de nouveaux abonnés, des Media Creatives comme une image ou une vidéo pour les éléments de campagne sur la X Audience Platform, ou des Promoted Posts. Voici un exemple de Publication qu’@Furni pourrait promouvoir et utiliser comme création publicitaire.