Principes fondamentaux
Hiérarchie et terminologie de la X Ads API
Pour réussir avec la X Ads API, il est important de comprendre la relation entre les entités dans X Ads. Ce tutoriel présente les bases de la hiérarchie des objets X Ads.
Les groupes d’annonces, appelés line items dans la X Ads API, sont rattachés aux campagnes et servent au ciblage et aux enchères sur un ensemble d’utilisateurs de X. Les annonceurs promeuvent des Posts ou des médias (par exemple des vidéos diffusées en tant que publicités In-stream) en les associant à un line item. Voir aussi Groupe d’annonces.
Un ensemble de créations publicitaires importées dans un compte publicitaire en tant que médias du compte, pouvant inclure des ressources de pré‑roll vidéo sponsorisées, également appelées publicités in‑stream, ainsi que des images pouvant être diffusées 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 boutique 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.
Pour chaque compte, nous stockons plusieurs types d’entités réutilisables à travers les campagnes, comme des audiences personnalisées pouvant être utilisées pour le ciblage, des médias de compte (vidéos ou images) et des cards, c’est‑à‑dire des créations enrichies que vous pouvez ajouter à un Post.
Lors du téléversement d’une ressource vidéo, l’entité qui la téléverse 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 tentez de téléverser une vidéo destinée à être diffusée en publicité in‑stream. Ces vidéos nécessitent un traitement spécifique pour garantir leur diffusabilité ; par conséquent, la catégorie média Amplify Video est obligatoire.
Les métriques d’analytics aident les partenaires et les annonceurs à comprendre les performances du contenu qu’ils promeuvent sur X. Cela inclut 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.
La X Ads API prend en charge deux méthodes pour récupérer des métriques détaillées de performance des campagnes : de manière synchrone et asynchrone.
Avec les requêtes d’analytics synchrones, les métriques demandées sont renvoyées dans la réponse. L’endpoint synchrone prend en charge des plages temporelles courtes et est idéal pour interroger les performances des campagnes en temps réel.
Avec les analytics asynchrones, 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, d’obtenir des données segmentées et sont conçus pour récupérer un volume de données bien plus important — idéal pour générer des rapports ou alimenter des historiques.
Chaque campagne menée par l’annonceur doit être créée sous un instrument de financement existant. Une campagne vous permet de définir des éléments tels que le nom, la planification et le budget d’une campagne publicitaire. En poursuivant l’exemple de Furni, nous pourrions créer une campagne intitulée « Furni home decor ».
Il convient de noter qu’un compte publicitaire est limité à 200 campagnes actives au maximum ; cette limite peut être relevée par le responsable 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 active aux fins des limites de campagnes.
Les cartes permettent d’enrichir visuellement un Tweet en y ajoutant une image, une vidéo ou des éléments d’interface utilisateur. La X Ads API prend en charge plusieurs types de cartes utilisables dans des Tweets, qui peuvent ensuite être promus dans des campagnes.
Les annonceurs peuvent promouvoir des Tweets dans des campagnes incluant des créatifs, tels que des images, des GIF et des vidéos. Ces créatifs peuvent être associés à des cartes X qui permettent d’ajouter aux Tweets des photos, des vidéos et des expériences média enrichies. Les créatifs peuvent également être directement associés 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 ligne doit avoir au moins un créatif associé pour pouvoir être diffusé. Plusieurs options de créatifs sont disponibles, notamment des Comptes sponsorisés pour gagner de nouveaux abonnés, des Créatifs média tels qu’une image ou une vidéo pour des éléments de ligne sur la plateforme TX Audience, ou des Posts sponsorisés.
Également associés au compte publicitaire, les instruments de financement correspondent aux différentes sources de financement que l’annonceur a configurées pour les utiliser avec X Ads. Elles vont des ordres d’insertion signés avec X à une carte de crédit rattachée au compte.
Au sein d’une campagne, vous pouvez avoir un ou plusieurs groupes d’annonces, également appelés éléments de campagne (line items) dans la X Ads API. Les éléments de campagne peuvent être considérés comme différents segments d’une campagne, chacun avec son propre ciblage et sa propre création. Les campagnes qui contiennent plusieurs éléments de campagne sont souvent appelées « campagnes à groupes d’annonces ».
L’un des avantages d’inclure plusieurs éléments de campagne dans une même campagne est de pouvoir créer une plus grande variété de combinaisons de ciblage et de créations.
Dans le cadre de notre campagne « Furni home decor », nous pourrions vouloir créer deux éléments de campagne : l’un pourrait être « Acheteurs immobiliers à San Francisco », et l’autre « Acheteurs immobiliers à 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’App mobile, ou MAP, est une suite de produits qui permet aux annonceurs de promouvoir des apps mobiles sur X. Elle inclut l’installation d’apps, les conversions et le réengagement.
La mesure des promotions d’applications mobiles sur X permet aux annonceurs d’évaluer la performance des campagnes publicitaires sur X visant à générer des installations ou d’autres conversions in‑app. Un partenaire de mesure mobile X permet à l’annonceur de définir et de gérer les conversions qu’il souhaite suivre pour les apps qu’il promeut sur X. Présentation de MACT
Les endpoints de la Bibliothèque de médias permettent de gérer des images, des GIF et des vidéos pour les comptes X Ads. Les ressources média de la bibliothèque peuvent être utilisées dans des Posts et pour créer des cartes. Elles peuvent aussi être réutilisées dans plusieurs créations, évitant d’avoir à téléverser plusieurs fois le même élément.
Les comptes sponsorisés (campagnes d’abonnés) font partie de Qui suivre, qui suggère des comptes que les utilisateurs ne suivent pas encore et qu’ils pourraient trouver intéressants. Les comptes sponsorisés contribuent à faire découvrir une plus large variété de comptes susceptibles de leur plaire.
Les comptes sponsorisés permettent aux annonceurs de promouvoir leur compte et de développer leur audience sur X. Les campagnes d’abonnés sont diffusées à plusieurs emplacements sur la plateforme X — notamment dans la page d’accueil, la section Qui suivre et les résultats de recherche — et ces suggestions portent la mention Sponsorisé pour les 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 handle @Furni de Furni serait un exemple d’utilisateur promouvable COMPLET dans le compte publicitaire de Furni, ce qui signifie que nous pouvons lancer tous types de campagnes pour @Furni et ses tweets. Il ne peut y avoir qu’un seul utilisateur promouvable COMPLET par compte publicitaire.
Notez qu’il peut également y avoir d’autres utilisateurs promouvables dans un compte publicitaire. Par exemple, si nous voulions promouvoir les Tweets de @Jack au sujet des produits Furni, il deviendrait un utilisateur promouvable « retweet‑only » sur le compte, ce qui est indiqué par RETWEETS_ONLY. Les annonceurs doivent contacter leur responsable 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 incluses dans des Tweets sponsorisés et payées par les annonceurs. Elles 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 dont la publication est planifiée à une date ultérieure. Outre la création et la gestion de ces Tweets, l’API permet de les associer à un line item afin qu’ils puissent être promus une fois le Tweet publié. Cela permet aux annonceurs de préparer des Tweets natifs et de planifier leurs créations de campagne en amont d’initiatives clés. Par exemple, préparer une création de Tweet pour qu’elle soit mise en ligne immédiatement lors de l’annonce d’un nouveau produit.
La segmentation permet aux partenaires et aux annonceurs d’obtenir des métriques ventilées selon certaines valeurs de ciblage — comme l’âge, les appareils ou les langues — et n’est disponible qu’au moyen de nos endpoints d’analytique asynchrones. Pour demander des métriques segmentées, utilisez le paramètre de requête segmentation_type. Pour plus d’informations sur les options de segmentation, consulter Metrics and Segmentation.
Les audiences personnalisées à partir de listes sont l’un des trois types d’audiences personnalisées, créées en téléversant un fichier contenant vos propres données d’utilisateurs et de clients. Vos listes sont mises en correspondance avec les utilisateurs sur X afin que vous puissiez les cibler directement dans vos campagnes. Veuillez consulter ces restrictions.
L’Audience personnalisée Web, l’un des trois types d’Audiences personnalisées, est un ensemble d’utilisateurs X qui ont visité votre site. Pour utiliser les Audiences personnalisées Web, vous devez avoir installé notre pixel X sur votre site ou utiliser l’un de nos partenaires gestionnaires de balises approuvés. Veuillez consulter ces restrictions.
Comme indiqué précédemment, les critères de ciblage sont associés à un élément de campagne. Nous proposons une variété d’options de ciblage, allant de la localisation, des mots-clés et du genre à des attributs plus précis, tels que les comportements et les 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 » ainsi que la localisation « San Francisco ».
Pour en savoir plus sur les différents types de ciblage disponibles, consultez la page Présentation du ciblage sur notre site pour développeurs.
Le Twitter Object Nest (TON) héberge les médias et divers éléments téléversés via les endpoints Media Upload pour être utilisés comme créations.
Chaque élément de campagne doit comporter au moins une création associée pour pouvoir être diffusé. Plusieurs options de créations sont disponibles, notamment des Comptes promus pour gagner de nouveaux abonnés, des créations médias telles qu’une image ou une vidéo pour les éléments de campagne sur la X Audience Platform, ou des Posts promus. Voici un exemple de Post que @Furni pourrait promouvoir et utiliser comme création.
⌘I