Skip to main content

​
API pour les annonceurs

Planifiez des campagnes et gérez des publicités sur X de façon programmatique grâce à cette suite d’API.

​
Que pouvez-vous promouvoir ?

  • Les annonces sponsorisées sont des publicités classiques achetées par des annonceurs qui souhaitent toucher un groupe d’utilisateurs plus large ou susciter l’engagement de leurs abonnés existants.
  • Les annonces sponsorisées sont clairement identifiées comme sponsorisées lorsqu’un annonceur paie pour leur diffusion sur X. À tous les autres égards, les annonces sponsorisées se comportent comme des publicités classiques et peuvent être repartagées, recevoir des réponses, être aimées (likées), etc. Elles suivent des règles de diffusion classiques et sont créées à l’aide de POST statuses/update.
  • Les Tweets « promoted-only », créés via POST accounts/:account_id/tweet, peuvent être utilisés dans des campagnes de Tweets sponsorisés, mais ne seront pas diffusés auprès des abonnés ni affichés sur le fil public. Pour récupérer la liste des Tweets « promoted-only » pour un certain compte, utilisez GET accounts/:account_id/scoped_timeline.
  • Les comptes sponsorisés font partie de Who to Follow (Qui suivre), qui suggère des comptes que les utilisateurs ne suivent pas encore et qu’ils peuvent trouver intéressants. Les comptes sponsorisés permettent de présenter une gamme encore plus large de comptes susceptibles de leur plaire.
  • Les comptes sponsorisés pour la Timeline associent un Tweet sponsorisé à une campagne de compte sponsorisé et s’affichent dans les timelines des utilisateurs.
Les Tendances sponsorisées ne sont pas disponibles dans l’API Ads.

​
Campagnes et groupes d’annonces (line items)

Les campagnes définissent le calendrier et le budget d’une campagne publicitaire. L’annonceur spécifie un budget quotidien et global. La campagne peut être liée à une heure de début et de fin spécifiques ou se dérouler en continu jusqu’à épuisement du budget. Le budget provient de l’un des Funding Instruments du compte publicitaire. Les identifiants de campagne (:campaign_id) sont la représentation en base 36 de la valeur en base 10 que nous présentons dans l’interface X Ads. Les comptes publicitaires sont limités à un maximum de 200 campagnes actives. Cette limite peut être portée manuellement à 4 000 campagnes actives par le X Account Manager de l’annonceur sur demande. Une campagne est considérée comme active jusqu’à ce qu’elle atteigne son heure de fin ou qu’elle soit supprimée. Les campagnes en pause sont considérées comme actives jusqu’à leurs dates de fin prévues. Les line items consomment le budget défini par une campagne. Les line items regroupent l’enchère par engagement, le Tweet ou le compte à promouvoir, ainsi que les règles de ciblage.

​
Analytics

L’API X Ads propose un ensemble d’endpoints d’analytics pour suivre et optimiser les performances des publicités. Veuillez consulter Analytics et Analytics Best Practices pour plus d’informations. Pour la métrique de facturation, les données peuvent ne pas être finalisées avant trois jours après l’événement. Avant ce délai, les données doivent être considérées comme provisoires. La valeur finale facturable sera toujours inférieure au montant provisoire. La valeur facturable est corrigée pour tenir compte du spam et du trafic de faible qualité associé. Consultez Timezones pour d’autres considérations liées au temps.

​
Création d’une campagne - étape par étape

L’exemple suivant part du principe que vous avez installé, configuré et autorisé votre App et votre utilisateur à l’aide de twurl. twurl est un outil en ligne de commande, dans l’esprit de cURL, qui gère proprement l’authentification OAuth de X. twurl est un excellent outil pour tester et déboguer rapidement les fonctionnalités de l’Ads API (et de l’API REST). Pour afficher l’intégralité des en-têtes de la requête et de la réponse, utilisez -t pour tracer l’appel, ce qui revient à peu près à l’option -v de cURL. Pour cet exemple, nous allons créer une campagne de Promoted Ads ciblée par mot-clé.
  1. Récupérer l’id du compte.
  1. Récupérez l’identifiant de l’instrument de financement.
Appelez l’API GET accounts/:account_id/funding_instruments en utilisant l’identifiant du compte récupéré à l’étape précédente.
  1. Créez une campagne et associez-la à l’instrument de financement.
Indiquez une date et une heure de début ainsi qu’un budget pour la campagne. Pour cet exemple, nous allons utiliser un budget de 500 et,pourlalimitequotidienne,50  et, pour la limite quotidienne, 50 .
  1. Créez un élément de campagne (line item) associé à la campagne.
Maintenant que nous avons un id de campagne, nous pouvons créer un élément de campagne à lui associer. L’élément de campagne regroupe le montant de l’enchère, le ciblage et la partie créative proprement dite de la campagne. Pour cet élément de campagne, nous allons promouvoir des Tweets avec une enchère de 1,50 $.
  1. Créez un profil de ciblage associé à l’élément de campagne.
Une fois l’élément de campagne créé, nous pouvons lui attribuer des critères de ciblage. Nous voulons cibler les mots-clés de l’expression « grumpy cat » dans la région de la baie de San Francisco. Cela va nécessiter une recherche de l’id de localisation et deux requêtes POST vers targeting_criteria.
  1. Enfin, réactivez l’élément de campagne.
Et voilà ! Nous avons maintenant une campagne de Tweets sponsorisés dans les timelines, active, ciblée et dotée d’un budget, qui est en cours de diffusion.

​
Campagnes basées sur un objectif

Les campagnes et la tarification basées sur un objectif permettent aux annonceurs de payer pour les actions qui sont alignées sur leurs objectifs marketing. Pour ce faire, définissez l’objective approprié sur les line items. Le paramètre utilisé dans les endpoints d’écriture de line item, et renvoyé dans les endpoints de lecture, est objective. Ce champ peut actuellement prendre les valeurs suivantes :
  • APP_ENGAGEMENTS
  • APP_INSTALLS
  • FOLLOWERS
  • ENGAGEMENTS
  • REACH
  • VIDEO_VIEWS
  • PREROLL_VIEWS
  • WEBSITE_CLICKS
Les objectifs ont un impact sur la façon dont nous optimisons les campagnes dans nos enchères et sur la façon dont nous facturons ces campagnes. Nous permettons une tarification basée sur l’objectif, comme le CPAC pour APP_ENGAGEMENTS, le CPAC ou le CPI pour APP_INSTALLS, le CPLC pour WEBSITE_CLICKS, le CPF pour FOLLOWERS, le CPE pour ENGAGEMENTS et le CPM pour REACH. Les campagnes de promotion d’applications mobiles doivent obligatoirement contenir l’objectif APP_ENGAGEMENTS ou APP_INSTALLS. Remarque : Les line items avec des objectifs différents ne sont pas autorisés au sein d’une même campagne.

​
Instruments de financement

Les instruments de financement sont la source du budget d’une campagne. Les instruments de financement ne peuvent pas être créés via l’Ads API ; ils doivent déjà être configurés par le responsable de compte de l’annonceur chez X (pour les lignes de crédit) ou via ads.x.com (pour les cartes de crédit) pour être disponibles. Pour obtenir la liste de tous les funding_instruments d’un compte, consultez GET accounts/:account_id/funding_instruments et GET accounts/:account_id/funding_instruments/:funding_instrument_id pour les détails d’un instrument spécifique.

​
Attributs de l’instrument de financement

Descriptifs : account_id, id de l’instrument de financement, type de l’instrument de financement, description et io_header (ID d’en‑tête d’ordre d’insertion). Notez qu’un même io_header peut être associé à plusieurs instruments de financement. Capacité de financement : able_to_fund et reasons_not_able_to_fund. Temps : created_at, updated_at, start_time et end_time représentés par une chaîne de caractères, au format « %Y-%m-%dT%l:%M:%S%z ». Statut booléen : paused, deleted et cancelled (true ou false). Financier : currency (format ISO-4217), credit_limit_local_micro, credit_remaining_local_micro et funded_amount_local_micro. La valeur d’une devise est représentée en micros. Pour l’USD, 5,50 $ est encodé comme 5.50*1e6, soit 5 500 000. Pour représenter une « valeur entière », vous devez multiplier la valeur locale en micros par 1e6 (1_000_000) pour toutes les devises.

​
Détails des attributs

credit_limit_local_micro n’est valide que pour les instruments de financement de type CREDIT_CARD ou CREDIT_LINE et représente la limite de crédit de cet instrument. funded_amount_local_micro n’est valide que pour les instruments de financement de type INSERTION_ORDER et représente le budget alloué. credit_remaining_local_micro est valide pour les instruments de financement de type CREDIT_LINE et AGENCY_CREDIT_LINE. Il représente credit_limit_local_micro moins le montant déjà dépensé au titre de cet instrument de financement. Il ne représente pas la différence entre funded_amount_local_micro et le montant dépensé. Nous établissons une distinction entre la limite de crédit et le montant financé, car ils correspondent à différentes méthodes de financement sous-jacentes et à différents accords de dépenses conclus avec les annonceurs.

​
Types de moyens de financement

Cartes de crédit Généralement utilisées par les annonceurs en libre-service (sans responsable de compte). Lignes de crédit Elles prennent la forme d’ordres d’insertion (IO) et sont fixées par les responsables de compte. Lignes de crédit multi-handle Les annonceurs peuvent financer des campagnes sur plusieurs handles avec ce type de ligne de crédit. Cette fonctionnalité est activée par leur X Account Manager, qui associe les différents @handles à une ligne de crédit spécifique. Par exemple, @NikeSB et @NikeFuel peuvent tous deux avoir accès à la ligne de crédit @Nike. Ce moyen de financement est disponible comme n’importe quel autre. Vous pouvez récupérer les données en envoyant une requête GET à l’endpoint funding_instrument. Voici un exemple de réponse (notez le type CREDIT_LINE).
La seule particularité de cet instrument de financement est son type et le fait qu’il soit disponible pour tous les comptes qui lui sont associés. Bien entendu, le crédit restant est affecté par toutes les campagnes financées par cet instrument, sur l’ensemble des comptes qui le partagent. Les détails concernant les comptes associés à une ligne de crédit spécifique ne sont pas disponibles via l’API (ni via ads.x.com). Pour plus d’informations sur les valeurs d’énumération de Funding Instrument, veuillez cliquer ici.

​
Ciblage

Le ciblage est un concept central de l’Ads API. Le ciblage est défini au niveau de l’élément de campagne, et les options varient selon les emplacements publicitaires. Pour définir de nouveaux critères de ciblage, vous devez utiliser POST accounts/:account_id/targeting_criteria et PUT accounts/:account_id/targeting_criteria pour les mettre à jour. Utilisez GET accounts/:account_id/line_items pour obtenir la liste de tous les éléments de campagne et GET  accounts/:account_id/line_items/:line_item_id pour récupérer un élément de campagne spécifique.

​
Options de ciblage par emplacement

Les produits Promoted Tweets et Promoted Accounts sont disponibles sur différents emplacements. Les Promoted Trends (PTr) ne sont pas disponibles via l’API. Pour connaître les combinaisons d’emplacements possibles, consultez le point de terminaison GET line_items/placements. Chaque emplacement propose différentes options de ciblage. La localisation, la plateforme et le sexe sont disponibles pour tous. Les autres options dépendent du type d’emplacement.
  • X Search : Ciblage par âge, Appareils, Événements, Sexe, Types de mots-clés (tous), Langue, Lieux, Activation du réseau, Opérateurs réseau, Plateforme, Version de la plateforme, Audiences personnalisées, Wi-Fi uniquement
  • X Timeline : Ciblage par âge, Appareils, Événements, Abonnés de, Similaire aux abonnés de, Sexe, Centres d’intérêt, Langue, Lieux, Activation du réseau, Opérateurs réseau, Types de mots-clés non exacts, Types d’audience partenaire, Plateforme, Version de la plateforme, Types de reciblage, Audiences personnalisées, Types de ciblage TV, Wi-Fi uniquement
  • X Profiles & Tweet Details : Ciblage par âge, Appareils, Événements, Abonnés de, Similaire aux abonnés de, Sexe, Centres d’intérêt, Langue, Lieux, Activation du réseau, Opérateurs réseau, Types de mots-clés non exacts, Types d’audience partenaire, Plateforme, Version de la plateforme, Types de reciblage, Audiences personnalisées, Types de ciblage TV, Wi-Fi uniquement

​
Comprendre les types de ciblage

Ciblage par âge : Ciblez les utilisateurs en fonction de tranches d’âge spécifiques. La liste des énumérations de tranches d’âge est disponible sur la page Enumerations. Événements : Indiquez un événement à cibler. Un seul événement peut être utilisé pour le ciblage (par élément de campagne). Utilisez le endpoint GET targeting_criteria/events pour trouver les événements disponibles pour le ciblage. Genre : Ciblez les hommes (1) ou les femmes (2). Laissez null pour cibler tout le monde. Catégories de boutiques d’applications installées : utilisez ce type de ciblage pour cibler les utilisateurs en fonction des catégories d’apps qu’ils ont installées ou pour lesquelles ils ont indiqué un intérêt. Voir GET targeting_criteria/app_store_categories. Centres d’intérêt : Ciblez les utilisateurs par centre d’intérêt. Récupérez la liste des centres d’intérêt via GET targeting_criteria/interests. Vous pouvez cibler jusqu’à 100 centres d’intérêt. Abonnés de : Ciblez les abonnés de tout utilisateur entièrement promotable pour le compte actuel (notez qu’actuellement, le titulaire principal du compte est le seul utilisateur entièrement promotable de ce compte). Utilisez GET accounts/:account_id/promotable_users pour obtenir une liste d’utilisateurs promotables. Similaire aux abonnés de : Ciblez des personnes ayant les mêmes centres d’intérêt que les abonnés d’utilisateurs spécifiques. Vous pouvez utiliser jusqu’à 100 Users. Emplacements : Indiquez jusqu’à 2 000 emplacements à cibler. Récupérez la liste via GET targeting_criteria/locations. Il existe des exigences supplémentaires pour les annonces qui ciblent certains pays. Voir Country Targeting and Display Requirements pour plus d’informations. Mots-clés : Les options de ciblage par mots-clés sont spécifiques au type d’emplacement publicitaire. Vous pouvez utiliser jusqu’à 1 000 mots-clés pour le ciblage (par élément de campagne). Voir la section « Types de mots-clés » pour connaître les options. Ciblage par langue : Ciblez les utilisateurs qui comprennent des langues spécifiques. Ciblage par opérateur de réseau mobile : Permet aux annonceurs de cibler les utilisateurs en fonction de leur opérateur mobile, en utilisant le type de ciblage NETWORK_OPERATOR depuis GET targeting_criteria/network_operators. Ciblage des nouveaux appareils mobiles : Atteignez les utilisateurs en fonction de la date à laquelle ils ont accédé pour la première fois à X via leur appareil, en utilisant le type de ciblage NETWORK_ACTIVATION_DURATION avec un operator_type de LT pour « moins de » et GTE pour « supérieur ou égal ». Plateformes, Versions de plateforme, Appareils et Wifi uniquement : Permettent de cibler les appareils mobiles selon différents axes. Les plateformes constituent un type de ciblage de haut niveau qui peut viser de larges catégories de téléphones. Des valeurs d’exemple sont iOS et Android. Les appareils vous permettent de cibler les utilisateurs de modèles d’appareils mobiles spécifiques, par exemple iPhone 5s, Nexus 4 ou Samsung Galaxy Note. Les versions de plateforme permettent de cibler les utilisateurs de versions spécifiques de systèmes d’exploitation mobiles, jusqu’à la version de correctif. Des exemples incluent iOS 7.1 et Android 4.4. Wifi uniquement vous permet de cibler uniquement les utilisateurs qui utilisent leurs appareils sur un réseau WiFi ; si ce paramètre n’est pas défini, les utilisateurs utilisant la connexion opérateur ainsi que le WiFi seront ciblés.
  • Les utilisateurs peuvent cibler des plateformes et des appareils s’il n’y a pas de chevauchement. Je peux cibler Blackberry comme plateforme et iPad Air comme appareil simultanément.
  • Les utilisateurs peuvent cibler des appareils et des versions d’OS simultanément. Je peux cibler iPad Air et iOS >= 7.0.
  • Les utilisateurs ne peuvent pas cibler des plateformes plus larges que les appareils. Je ne peux pas cibler iOS et iPad Air.
[Tailored Audiences]/x-ads-api/audiences : atteignez des utilisateurs via un partenaire publicitaire approuvé pour cibler des groupes de clients et entrer en contact avec eux sur X. TV Targeting TV Show Targeting : atteignez des personnes qui interagissent avec des programmes TV spécifiques. Ce critère de ciblage peut être configuré pour cibler en continu tant qu’une campagne est active avec le type de ciblage TV_SHOW. Utilisez les points de terminaison GET targeting_criteria/tv_markets et GET targeting_criteria/tv_shows pour déterminer les émissions TV disponibles. Tweet Engager Retargeting Le Tweet engager retargeting permet aux annonceurs de cibler, sur plusieurs appareils, des audiences qui ont déjà été exposées à leurs Tweets sponsorisés ou organiques sur X, ou qui ont interagi avec eux. Avec ce ciblage, les annonceurs peuvent relancer les personnes qui ont vu ou interagi avec le contenu d’un annonceur sur X et qui sont les plus susceptibles d’interagir de nouveau ou de convertir après des messages ou des offres ultérieurs. Les utilisateurs deviennent éligibles au ciblage quelques minutes après l’exposition ou l’engagement et le restent jusqu’à 90 jours après pour les engagements et 30 jours pour les expositions. Types de ciblage Tweet Engager :
  • ENGAGEMENT_TYPE, qui accepte soit IMPRESSION, soit ENGAGEMENT comme valeur de ciblage. Cela précise si vous souhaitez cibler des utilisateurs exposés (IMPRESSION) ou des utilisateurs engagés (ENGAGEMENT).
  • CAMPAIGN_ENGAGEMENT utilise un id de campagne comme valeur de ciblage. Les utilisateurs qui ont interagi avec cette campagne ou y ont été exposés (en fonction de ENGAGEMENT_TYPE) sont ceux qui seront ciblés.
  • USER_ENGAGEMENT, qui utilise l’id d’utilisateur promu comme valeur de ciblage pour cibler les utilisateurs qui ont été exposés au contenu organique d’un annonceur ou qui ont interagi avec celui‑ci (en fonction de ENGAGEMENT_TYPE). Il doit s’agir de l’id d’utilisateur promu associé au compte Ads.
Remarque : ENGAGEMENT_TYPE est requis en plus d’au moins une valeur CAMPAIGN_ENGAGEMENT ou USER_ENGAGEMENT valide. Les deux types de ciblage Tweet engager peuvent être présents et plusieurs campagnes peuvent être ciblées sur un même line item. Video Viewer Targeting : le ciblage Video viewer s’appuie sur le ciblage Tweet engager pour permettre aux annonceurs de cibler les audiences qui ont déjà regardé une partie ou la totalité d’une vidéo sur X. Les annonceurs peuvent cibler des vidéos organiques, des vidéos sponsorisées, ou les deux. Les vidéos sponsorisées ne sont pas limitées aux campagnes ou line items avec objectif de vues de vidéo. Types de ciblage Video Viewer :
  • VIDEO_VIEW pour les utilisateurs qui ont cliqué pour lancer la vidéo ou ont regardé 3 secondes de lecture automatique
  • VIDEO_VIEW_PARTIAL pour les utilisateurs qui ont regardé 50 % de la vidéo
  • VIDEO_VIEW_COMPLETE pour les utilisateurs qui ont regardé au moins 95 % de la vidéo
Comme pour le ciblage Tweet engager, un ou les deux éléments suivants doivent également être présents dans les critères de ciblage du line item lorsque ENGAGEMENT_TYPE est utilisé :
  • CAMPAIGN_ENGAGEMENT utilise un id de campagne comme valeur de ciblage. Les utilisateurs qui ont regardé une vidéo (en fonction de ENGAGEMENT_TYPE) dans le cadre de cette campagne sont ceux qui seront ciblés.
  • USER_ENGAGEMENT, qui utilise l’id d’utilisateur promu comme valeur de ciblage pour cibler les utilisateurs qui ont regardé une vidéo (en fonction de ENGAGEMENT_TYPE) dans le contenu organique d’un annonceur. Il doit s’agir de l’id d’utilisateur promu associé au compte Ads.
Keyword Types Consultez notre document d’aide sur le keyword targeting pour une vue d’ensemble conceptuelle.
  • Broad (valeur par défaut) : fait correspondre tous les mots, indépendamment de l’ordre. Insensible à la casse, aux pluriels ou au temps. Sera automatiquement étendu lorsque possible (par exemple, « car repair » correspondra également à « automobile fix »). Si vous souhaitez cibler sans extension, vous devez ajouter un signe + devant les mots‑clés, comme « +boat +jet ». L’utilisation de mots‑clés sans le + correspond par défaut à Broad Match.
  • Unordered (obsolète) : fait correspondre tous les mots, indépendamment de l’ordre. Insensible à la casse, aux pluriels ou au temps.
  • Phrase : fait correspondre exactement la chaîne de mots‑clés, d’autres mots‑clés peuvent être présents.
  • Exact : fait correspondre exactement la chaîne de mots‑clés, et aucune autre.
  • Negative : évite de faire correspondre les recherches qui incluent tous ces mots‑clés quelque part dans la requête, quel que soit l’ordre dans lequel ils sont écrits, même si d’autres mots sont présents.
  • Negative Phrase : évite de faire correspondre les recherches qui incluent exactement cette chaîne de mots‑clés quelque part dans la requête, même si d’autres mots sont présents.
  • Negative Exact : évite de faire correspondre les recherches qui correspondent exactement à ces mots‑clés et ne contiennent aucun autre mot.  
Ciblage par emoji Le ciblage par emoji est pris en charge au moyen du ciblage par mots-clés. Pour utiliser le ciblage par emoji, créez simplement un ciblage par mots-clés pour les points de code Unicode représentant cet emoji, comme U+1F602 (xF0x9Fx98x82 en UTF-8) pour l’emoji « visage avec des larmes de joie » (😂). Les emoji que nous acceptons peuvent être consultés dans la liste twemoji. Le ciblage d’un emoji applique le ciblage à toutes ses variantes. Pour un récapitulatif de toutes les valeurs avec les informations sur les champs obligatoires/facultatifs et les détails spécifiques pour chacune, consultez PUT accounts/:account_id/targeting_criteria.

​
Combinaisons de critères de ciblage

Workflow de campagne mis à jour Créez des campagnes avec un ciblage large basé sur des critères de zone géographique, de genre, de langue et d’appareil/plateforme. Les annonceurs peuvent ensuite combiner ce ciblage large avec des critères de ciblage supplémentaires (par exemple centres d’intérêt, mots-clés, abonnés, audiences personnalisées, TV). Si aucun critère de ciblage n’est spécifié pour un élément de campagne, l’élément de campagne ciblera tous les utilisateurs dans le monde entier. Les critères de ciblage seront combinés pour votre groupe de publicités de la façon suivante :
  • Les types de ciblage « principaux » seront combinés par ∪ (c.-à-d. placés dans une union logique).
  • Les autres types de ciblage seront combinés avec AND.
  • Les types identiques seront combinés avec OR.
Quelques exemples En un coup d’œil : [(Abonnés) ∪ (Audiences personnalisées) ∪ (Centres d’intérêt) ∪ (Mots-clés)] AND (Lieu) AND (Genre) AND (Langues) AND (Appareils et plateformes) Un exemple géographique : Disons que nous voulons qu’un groupe de publicités pour notre campagne diffuse en ciblant :
  • les utilisateurs de X aux États-Unis, en Angleterre et au Canada (Lieu)
  • qui sont des femmes (Genre)
  • issus d’une liste d’audiences personnalisées (type « principal »)
  • avec des mots-clés (type « principal »)
Les critères de ciblage seront : [US OR GB OR CA] AND [Female] AND [Audiences personnalisées ∪ Mots-clés]

​
Exemples supplémentaires

  • Sélectionnez le genre et la zone géographique mais aucun critère principal : (Homme) ET (US OU GB)
  • Sélectionnez le genre, la zone géographique, les centres d’intérêt : (Femme) ET (CA) ET (Informatique OU Technologie OU Startups)
  • Sélectionnez le genre, la zone géographique, les centres d’intérêt, les Tailored Audiences et les mots-clés : (Homme) ET (GB) ET (Voitures ∪ Tailored Audiences for CRM ∪ autocross)

​
Rythme de dépense du budget

Les annonceurs disposent désormais d’un meilleur contrôle sur la vitesse à laquelle leurs budgets quotidiens sont dépensés pour vos campagnes de Tweets sponsorisés et de Comptes sponsorisés. L’activation de la diffusion standard, qui est l’option par défaut, garantit un rythme de dépense uniforme tout au long de la journée. En désactivant la diffusion standard, nous diffuserons des impressions et générerons des interactions aussi rapidement que possible jusqu’à épuisement de votre budget quotidien, ce qui peut se produire assez tôt dans la journée selon le ciblage et la concurrence. Cela s’appelle la diffusion accélérée. Pour commencer La diffusion standard est l’option par défaut pour toutes les campagnes, aucune action n’est donc requise sauf si vous souhaitez la désactiver. Pour dépenser votre budget quotidien de campagne aussi rapidement que possible, définissez le paramètre standard_delivery sur false afin de passer à un rythme de diffusion accéléré (voir GET accounts/:account_id/campaigns). Remarques
  • Le « jour » est défini par le fuseau horaire du compte annonceur X (par exemple America/Los_Angeles).
  • Les premiers résultats indiquent que la diffusion standard améliore le eCPE/CPF pour les annonceurs, avec une couverture plus régulière tout au long de la journée.
Pour plus d’informations sur les budgets et le rythme de dépense, veuillez consulter la page FAQ sur les enchères et les offres.

​
Enchères ciblées

Gestion de campagnes

​
Stratégie d’enchère

Nous avons introduit le concept de Stratégie d’enchère afin de simplifier le processus de création de campagnes et de réduire la confusion liée aux combinaisons de plusieurs paramètres. Toutes les anciennes combinaisons de paramètres (marquées comme obsolètes) peuvent être reproduites en définissant un paramètre goal équivalent. Vous trouverez plus d’informations dans l’annonce ici. Par exemple :

​
Enchères cibles

Avec les enchères cibles, vous pouvez définir un coût cible que vous souhaitez payer et la plateforme publicitaire X Ads optimisera les performances de votre campagne tout en restant proche ou en dessous de ce coût cible. Cette fonctionnalité vous donne la flexibilité d’atteindre les utilisateurs particulièrement susceptibles d’effectuer l’action souhaitée (comme un clic sur un lien, un lead ou un abonnement) tout en gardant le contrôle de vos coûts. Il s’agit d’une fonctionnalité puissante pour les annonceurs qui souhaitent davantage d’options pour la configuration et l’optimisation de leurs campagnes (y compris les options d’enchères). Pour les line items avec des objectifs de campagne compatibles, nous avons introduit un nouveau mécanisme de tarification du montant de l’enchère qui vous permet de définir un coût cible que vous souhaitez payer. Notre plateforme publicitaire enchérit dynamiquement en votre nom pour vous aider à générer davantage de résultats, tout en s’efforçant de maintenir votre coût moyen dans une fourchette de 20 % autour de la cible que vous avez spécifiée. Le paramètre bid_strategy sur les line items peut être défini sur la valeur TARGET pour activer les enchères cibles sur des objectifs de campagne pertinents, tels que :
  • WEBSITE_CLICKS
  • WEBSITE_CONVERSIONS 
  • APP_INSTALLS 
  • APP_ENGAGEMENTS
  • REACH

​
Exigences de ciblage par pays et d’affichage

Gestion des campagnes Les exigences de ciblage et d’affichage propres à chaque pays sont présentées sur cette page. Tous les partenaires doivent s’y conformer.

​
Russie

Les Règles publicitaires de X interdisent aux annonceurs de cibler la Russie avec des publicités qui ne sont pas en russe. Lorsque vos utilisateurs ciblent spécifiquement la Russie, vous devez afficher l’avertissement suivant à vos utilisateurs : Les publicités ciblant la Russie doivent être en russe.

​
Instruments de financement gérés par le partenaire

Le flux d’onboarding configure un compte ads.x.com pour le compte X, que le partenaire peut gérer via l’Ads API et dont les dépenses publicitaires sont facturées au partenaire.  

​
Configuration initiale du partenaire

Le processus de configuration initiale d’un nouveau partenaire Ads API PMFI peut prendre jusqu’à 3 semaines à partir de l’échange des informations requises. Les éléments suivants doivent être partagés avec vos contacts techniques chez X, ainsi qu’avec le contact X qui gère l’intégration avec le partenaire afin de lancer le processus :
  • Le partenaire doit partager sa clé publique PGP/GPG. Une clé secrète partagée doit être échangée entre le partenaire Ads API et X. Elle sera utilisée pour vérifier les données lors du processus d’intégration.
  • Le app_id ou le consumer_secret pour l’App X qui sera utilisée pour l’accès à l’Ads API. Vous pouvez afficher et modifier vos Apps X existantes via le tableau de bord des apps si vous êtes connecté à votre compte X sur developer.x.com. Si vous devez créer une App X, vous devrez disposer d’un compte développeur approuvé. X autorise une app pour la production + sandbox et une app facultative pour un accès sandbox uniquement. L’App X doit être créée sur un handle X d’entreprise contrôlé par le partenaire.  

​
Parcours d’onboarding de l’annonceur

Le parcours d’onboarding de l’annonceur se déroule via un navigateur web de la manière suivante :
  1. L’utilisateur démarre le parcours d’onboarding sur le site web du partenaire et saisit le handle qu’il souhaite intégrer.
  2. Le partenaire redirige l’utilisateur vers une URL sur ads.x.com avec une charge utile signée. Cette charge utile contient l’app_id API du partenaire, le user_id X du handle X à intégrer, ainsi qu’une URL de rappel et d’autres champs documentés ci‑dessous.
  3. Il est demandé à l’utilisateur de se connecter à ads.x.com en utilisant la page de connexion standard de x.com.
  4. Une fois l’utilisateur connecté, le processus d’onboarding est lancé. Cette étape inclut l’examen des annonces, la validation du compte et d’autres vérifications.
  5. Lorsque toutes les tâches d’onboarding sont terminées, l’utilisateur est redirigé vers l’URL de rappel fournie par le partenaire Ads API, avec une charge utile qui indique la réussite ou l’échec. Cela inclut le processus d’autorisation en 3 étapes.  

​
Charge utile de redirection d’intégration

URL de redirection : https://ads.x.com/link_managed_account L’URL de redirection sera appelée avec les paramètres suivants :

​
Charge utile de l’URL de rappel

L’URL de redirection de base est fournie à l’aide du paramètre callback_url dans la requête de lien de compte (voir ci‑dessus). Les paramètres ajoutés par ads.x.com sont : Pour garantir que l’URL de rappel n’est valide que pour le X user_id auquel le processus de lien de compte est destiné, le X user_id doit être concaténé au secret partagé (en utilisant &) lors de la signature de la requête.  

​
Signature de la requête et des URL de rappel

Afin de s’assurer que les requêtes vers /link_managed_account et l’URL de rappel sont valides, les requêtes doivent être signées à la source et vérifiées par le destinataire avant que celui‑ci n’agisse en conséquence. Signer la requête avec un secret partagé entre X et le partenaire gestionnaire garantit que chaque partie n’accepte que les requêtes envoyées par la contrepartie autorisée. L’algorithme de génération de la signature est similaire à celui utilisé par OAuth. Créez une chaîne de base de la signature comme suit :
  • Convertissez la méthode HTTP en majuscules et définissez la chaîne de base égale à cette valeur.
  • Ajoutez le caractère « & » à la chaîne de base.
  • Encodez en pourcentage l’URL (sans paramètres) et ajoutez‑la à la chaîne de base.
  • Ajoutez le caractère « & » à la chaîne de base.
  • Ajoutez la chaîne de requête encodée en pourcentage, construite comme suit :
  • Encodez en pourcentage chaque clé et chaque valeur qui sera signée.
  • Triez la liste des paramètres par ordre alphabétique selon la clé.
  • Pour chaque paire clé/valeur (et avec primary_promotable_user_id pour l’URL de redirection du partenaire) :
  • Ajoutez la clé encodée en pourcentage à la chaîne de requête.
  • Ajoutez le caractère « = » à la chaîne de base.
  • Ajoutez la valeur encodée en pourcentage à la chaîne de requête.
  • Séparez les paires clé=valeur encodées en pourcentage avec le caractère « & ».
  • Utilisez l’algorithme HMAC-SHA1, en utilisant comme clé le secret partagé échangé précédemment et comme valeur la chaîne de base pour générer la signature.
  • Encodez en Base64 la sortie de l’étape 2, supprimez le caractère de nouvelle ligne final, encodez en pourcentage la signature générée à l’étape 3 et ajoutez‑la à l’URL dans un paramètre de signature.  

​
Exemples de signature

Signature d’une requête de liaison de compte URL à signer, en supposant une requête GET : https://ads.x.com/link_managed_account?callback_url=https%3A%2F%2Fmanagingpartner.com%2Flink_account_callback&client_app_id=12345&fi_description=some%20name&promotable_user_id=1 Cette URL comporte les paramètres suivants : callback_url = https://managingpartner.com/link_account_callback client_app_id = 12345 fi_description = some name promotable_user_id = 1 La chaîne de base composée de la méthode HTTP et de l’URL sans paramètres, étapes a - d, est la suivante : GET https://ads.x.com/link_managed_account La chaîne de requête, produite par les sous-étapes de e, est la suivante : callback_url=https://managingpartner.com/link_account_callback&client_app_id=12345&fi_description=some name&promotable_user_id=1 Notez que les paires clé-valeur sont triées par nom de clé. La chaîne de requête encodée en pourcent est la suivante : callback_url%3Dhttps%253A%252F%252Fmanagingpartner.com%252Flink_account_callback%26client_app_id%3D12345%26fi_description%3Dsome%2520name%26promotable_user_id%3D1 La chaîne de base complète, combinant les étapes a - d et e : GET https://ads.x.com/link_managed_account&callback_url%3Dhttps%253A%252F%252Fmanagingpartner.com%252Flink_account_callback%26client_app_id%3D12345%26fi_description%3Dsome%2520name%26promotable_user_id%3D1 En utilisant l’algorithme hmac-sha1, nous allons signer cette chaîne avec le mot « secret » comme clé. Le résultat est encodé en Base64 et présenté sans le « \n » final (étapes 2 et 3) : KBxQMMSpKRrtg9aw3qxK4fTXvUc= Cette signature est ensuite ajoutée (encodée en pourcent) à la fin de l’URL d’origine dans le paramètre signature (étape 4) : https://ads.x.com/link_managed_account?callback_url=https%3A%2F%2Fmanagingpartner.com%2Flink_account_callback&client_app_id=12345&fi_description=some%20name&promotable_user_id=1&signature=KBxQMMSpKRrtg9aw3qxK4fTXvUc%3D Signature d’une URL de redirection du partenaire (rappel de requête de liaison de compte) L’URL à signer, en supposant une requête GET : https://managingpartner.com/link_account_callback?status=OK&account_id=ABC&funding_instrument_id=DEF Cette URL comporte les paramètres suivants : account_id = ABC, funding_instrument_id = DEF et status = OK La chaîne de base composée de la méthode HTTP et de l’URL sans paramètres, étapes a - d, est la suivante : GET https%3A%2F%2Fmanagingpartner.com%2Flink_account_callback&“ La chaîne de requête, produite par les sous-étapes de e, est la suivante : account_id=ABC&funding_instrument_id=DEF&status=OK La chaîne de requête encodée en pourcent est la suivante : account_id%3DABC%26funding_instrument_id%3DDEF%26status%3DOK La chaîne de base complète, combinant les étapes a - d et e : GET https%3A%2F%2Fmanagingpartner.com%2Flink_account_callback&account_id%3DABC%26funding_instrument_id%3DDEF%26status%3DOK En utilisant l’algorithme hmac-sha1, nous allons signer cette chaîne avec le mot « secret » et l’id de l’utilisateur X pour lequel la requête de liaison d’origine a été effectuée, 1 (promotable_user_id = 1 ci-dessus) comme clé, « secret&1 ». Le résultat est encodé en Base64 et présenté sans le « \n » final (étapes 2 et 3) : jDSHDkHJIFXpPLVxtA3a9d4bPjM= Cette signature est ensuite ajoutée, après encodage en pourcentage, à la fin de l’URL d’origine dans le paramètre signature (étape 4) : https://managingpartner.com/link_account_callback?&status=OK&account_id=ABC&funding_instrument_id=DEF&signature=jDSHDkHJIFXpPLVxtA3a9d4bPjM%3D

​
Utilisation / renouvellement de la clé partagée

L’algorithme de signature doit pouvoir être réutilisé avec plusieurs clés. Cela permet d’utiliser plusieurs clés partagées et de procéder à leur rotation périodique.  

​
Création de partner_managed_funding_instrument

Si le paramètre fi_description est fourni et qu’aucun partner_managed_funding_instrument existant portant le même nom n’existe dans le compte, un nouveau partner_managed_funding_instrument sera créé et tous les partner_managed_funding_instruments existants seront mis en pause. Si un partner_managed_funding_instrument portant le même nom existe, aucun nouveau ne sera créé.  

​
Appels répétés du flux d’onboarding / actualisation du jeton

Le flux d’onboarding peut être relancé si le jeton d’accès à l’API a été perdu. L’implémentation du flux d’onboarding nécessitera que l’utilisateur soit connecté. Si l’utilisateur correspond au promotable_user_id, que le compte publicitaire associé est trouvé et que tout est en ordre, l’utilisateur sera redirigé vers l’URL de rappel, et le partenaire pourra initier le flux OAuth pour obtenir un jeton d’accès.  

​
Flux d’erreur sans redirection

Si l’URL de liaison de compte est appelée avec des paramètres invalides, une page similaire à celle affichée dans le flux OAuth lorsque des paramètres invalides ou expirés sont fournis sera présentée à l’utilisateur.  

​
Mises à jour en continu du PMFI

Une fois que l’annonceur a été intégré, l’instrument de financement peut être géré via le point de terminaison PUT accounts/:account_id/funding_instruments/:funding_instrument_id uniquement par le partenaire qui le gère.

​
Emplacements

Les publicités X peuvent être diffusées à plusieurs emplacements. Cela se configure au niveau de l’élément de campagne (line item) à l’aide du paramètre placements. Les valeurs possibles sont :
  • ALL_ON_TWITTER
  • PUBLISHER_NETWORK
  • TWITTER_PROFILE
  • TWITTER_SEARCH
  • TWITTER_TIMELINE
  • SPOTLIGHT
  • TREND
Le product_type et l’objective de l’élément de campagne déterminent quels emplacements sont autorisés. L’endpoint GET line_items/placements permet de récupérer les options d’emplacement valides pour chaque type de produit. Par ailleurs, le tableau suivant répertorie les combinaisons valides d’emplacement et d’objectif. Remarque : il n’est pas possible de spécifier uniquement l’emplacement TWITTER_PROFILE. Remarque : TWITTER_SEARCH nécessite un ciblage par mots-clés. Remarque : l’objectif REACH doit inclure l’emplacement TWITTER_TIMELINE. Il peut comporter ALL_ON_TWITTER, n’importe quelle combinaison d’emplacements qui inclut TWITTER_TIMELINE, ou TWITTER_TIMELINE seul.

​
FAQ sur les groupes d’annonces

Ce document regroupe une série de questions fréquemment posées au sujet des groupes d’annonces dans l’API Ads de X.

​
Qu’est-ce qu’un Ad Group ?

Les Ad Groups, appelés line items dans l’Ads API, sont rattachés aux campagnes et sont utilisés pour le ciblage et les enchères auprès d’un ensemble d’utilisateurs de X. Les annonceurs font la promotion de Tweets ou de médias (par exemple, des vidéos diffusées en tant que publicités In-stream) en les associant à un line item.

​
Comment créer un groupe de publicités ?

Les groupes de publicités sont créés en appelant POST accounts/:account_id/line_items plusieurs fois pour le même id de campagne, en conservant pour chaque élément de campagne son propre ciblage (éventuellement complètement différent) et les Tweets qui y sont associés. La limite est de 100 éléments de campagne par campagne et de 200 campagnes actives pour un même compte publicitaire. Pour l’ensemble des campagnes, la limite est de 8 000 éléments de campagne actifs par compte publicitaire.

​
Pourquoi devrions-nous ajouter la prise en charge des Ad Groups ?

Les Ad Groups sont conçus pour faciliter l’organisation, l’optimisation et la gestion des campagnes pour les annonceurs. L’avantage des Ad Groups est de permettre de comparer et de contrôler différentes stratégies en matière d’enchères, de budget, de créations publicitaires et de ciblage. Lorsque plusieurs Tweets sponsorisés sont associés à un seul line item, le système d’enchères sélectionne le meilleur Tweet de ce groupe, puis sélectionne le meilleur Tweet pour cette campagne parmi tous les line items. Si vous avez plusieurs Ad Groups contenant chacun un seul Tweet, cela revient à sélectionner, pour chaque Ad Group, le Tweet qui a le plus de chances de mieux performer. L’utilisation des Ad Groups permet à un annonceur de répartir le ciblage et les enchères en un nombre beaucoup plus élevé de combinaisons possibles et, de manière générale, de segmenter le ciblage en groupes logiques. Les outils Ads API, en particulier, peuvent être conçus autour de règles d’optimisation très fines basées sur les Ad Groups, ce qui serait plus difficile à réaliser via des modifications manuelles en raison du grand nombre de combinaisons de line items et de créations.

​
Quel est le lien entre le budget de l’élément de campagne (line item) et le budget de la campagne dans une campagne Ad Groups ?

La valeur de total_budget_amount_local_micro pour un élément de campagne ne peut pas dépasser le budget total de sa campagne parente. De même, la valeur de bid_amount_local_micro de l’élément de campagne ne doit pas dépasser daily_budget_amount_local_micro ou total_budget_amount_local_micro de la campagne parente. Un paramétrage incorrect de ces valeurs peut entraîner la mise en pause de la campagne et la rendre non diffusable. Notez que le budget total de la campagne peut être inférieur à la somme des budgets de ses éléments de campagne enfants, et que la répartition du budget entre les éléments de campagne dépend en partie de l’outil Ads API, chargé de l’optimiser et de l’ajuster efficacement, car les performances quotidiennes du ciblage (élément de campagne) peuvent varier sensiblement d’un jour à l’autre en raison de la nature en temps réel de X.

​
Les groupes d’annonces offrent-ils de meilleures performances qu’un seul élément de campagne ?

Les performances d’une campagne dépendent de nombreux facteurs et, en fin de compte, le Tweet est le facteur décisif en matière de performance. Un élément de campagne est considéré comme un facteur déterminant pour savoir si un Tweet est même en lice pour être diffusé à un utilisateur. Les éléments de campagne qui ciblent les mêmes ensembles d’utilisateurs sont considérés comme ayant un chevauchement d’audience. Il est recommandé, comme bonne pratique, de réduire ce chevauchement de ciblage entre les éléments de campagne afin que les ensembles d’utilisateurs les plus performants puissent être clairement identifiés.

​
Guides

​
Objectif de vues pour les pré-roll vidéo

Le guide suivant décrit les étapes nécessaires pour configurer une campagne PREROLL_VIEWS sur l’API Ads. De manière générale, ces campagnes sont réparties en deux types : « Curated Categories » et « Content Categories » (appelées « Standard Categories » dans l’interface utilisateur Ads).  

​
Points de terminaison requis

​
Étapes

​
Téléverser la vidéo

Le téléversement de la vidéo comporte 2 étapes :

​
Importer le média vidéo

Tout d’abord, à l’aide de l’endpoint Chunked media upload, vous allez téléverser la vidéo sur X pour traitement. Vous devez transmettre media_category=amplify_video lors de l’appel initial INIT en utilisant cet endpoint. Vous téléverserez la vidéo en plusieurs segments. Une fois que la réponse STATUS renvoie un state égal à succeeded, vous pouvez poursuivre avec les étapes suivantes. Vous trouverez davantage d’informations sur le téléversement de médias avec l’endpoint segmenté dans notre page Présentation de la vidéo sponsorisée.

​
Ajouter la vidéo au compte publicitaire

Une fois que l’état renvoyé par la commande STATUS est succeeded, vous utiliserez le media_key renvoyé par cet endpoint pour ajouter la vidéo à la bibliothèque de médias de l’annonceur, en utilisant l’endpoint POST accounts/:account_id/media_library.

​
Configurer la campagne

​
Création de campagne

Créez la campagne et le line item/groupe d’annonces. Les line items doivent être créés avec l’objective VIDEO_VIEWS_PREROLL et le product_type MEDIA. Le paramètre categories doit également être renseigné avec les catégories d’activité de l’annonceur appropriées.

​
Création de line item

Les line items doivent avoir le paramètre categories défini sur l’ensemble approprié de catégories IAB, récupérées via l’endpoint GET content_categories. Chacune de ces catégories de contenu correspond à une ou plusieurs catégories IAB. Pour utiliser ces valeurs, les partenaires doivent sélectionner une catégorie de contenu appropriée et utiliser l’ensemble complet de iab_categories renvoyé dans la réponse, afin de définir le paramètre categories sur l’endpoint des line items. Toute application partielle de iab_categories entraînera l’application de l’ensemble du groupe au line item. Par exemple,
Maintenant, afin de définir le paramètre categories sur la valeur “Science & Education”, l’ensemble des iab_categories, c’est‑à‑dire "IAB5", "IAB15", doit être défini pour le line item, comme suit :

​
Sélection de l’éditeur

Un annonceur peut choisir de cibler soit une catégorie de contenu, soit une catégorie organisée, avec des informations supplémentaires décrites ci‑dessous.  Remarque : Les éléments de campagne peuvent cibler soit des catégories organisées, soit des catégories de contenu, mais pas les deux. 

​
Catégories sélectionnées

Les catégories sélectionnées permettent aux annonceurs de cibler un groupe prédéfini d’éditeurs et peuvent être récupérées via l’endpoint GET curated_categories. Ces catégories sont propres à chaque pays et nécessitent donc que le line item cible le pays approprié en fonction du country_code de la catégorie. Pour utiliser l’une de ces catégories, les étapes suivantes doivent être effectuées dans l’ordre indiqué :
  1. Le line item doit cibler le pays approprié en fonction du country_code de la catégorie sélectionnée.
  2. L’endpoint POST line_item_curated_categories doit être utilisé pour associer le line item à un curated_category_id spécifique. 
Remarque : Associer un line item à une catégorie sélectionnée limite également à 5 le nombre d’éditeurs pouvant être ajoutés à la denylist. La liste complète des user_id utilisés pour placer certains éditeurs sur la denylist peut être récupérée depuis l’endpoint GET publishers. De plus, un line item donné ne peut cibler qu’une seule catégorie sélectionnée à la fois. L’exemple suivant illustre comment associer un id de catégorie sélectionnée : b0xt, qui n’est disponible qu’aux États-Unis, avec le line item créé à l’étape précédente. Tout d’abord, les critères de ciblage du line item sont définis sur la valeur 96683cc9126741d

​
Catégories de contenu

Les catégories de contenu, également appelées Catégories standard, peuvent être obtenues à partir de l’endpoint GET curated_categories. Ces catégories peuvent ensuite être ciblées par le line item à l’aide des endpoints de critères de ciblage par lot. L’exemple suivant illustre comment sélectionner une catégorie de contenu spécifique, id: sr, qui correspond à « Actualités et événements récents », et l’appliquer au line item.
Remarque : L’ensemble des iab_categories dans la réponse GET curated_categories doit être ciblé via l’endpoint de critères de ciblage. Dans le cas contraire, une erreur de validation sera renvoyée. 
Associer le média du compte (vidéo) à l’élément de campagne
Utilisez le point de terminaison POST accounts/:account_id/media_creatives pour associer la vidéo à un groupe d’annonces.

​
Définir l’appel à l’action (CTA) et l’URL de destination

Il est important de noter que, contrairement à la plupart des autres campagnes sur X, l’objectif VIDEO_VIEWS_PREROLL n’utilise pas de Tweets sponsorisés ni de Cards. À la place, le créatif vidéo est associé à votre groupe d’annonces (line item) et les informations de CTA sont associées à une entité preroll_call_to_action. L’endpoint POST accounts/:account_id/preroll_call_to_action vous permet de contrôler le bouton d’appel à l’action (CTA) et l’URL de destination.

​
Définir les critères de ciblage

Le critère de ciblage utilisé pour les publicités vidéo pré-roll n’est disponible qu’en utilisant notre endpoint de critères de ciblage par lots POST batch/accounts/:account_id/targeting_criteria. Utilisez CONTENT_PUBLISHER_USER en ciblage négatif pour empêcher que la publicité soit associée à un ensemble d’utilisateurs. Indiquez le user_id X ou le publisher_user_id correspondant aux comptes à exclure. L’endpoint GET publishers peut être utilisé pour récupérer la liste des user_id à exclure pour les catégories de contenu (Content Categories). Le publisher_user_id retourné dans la réponse de GET curated_categories peut être utilisé pour récupérer une liste d’exclusion similaire pour les catégories organisées (Curated Categories). Remarque : Un maximum de 5 publisher_user_id peuvent être exclus pour les catégories organisées (Curated Categories) et 50 user_id pour les catégories de contenu (Content Categories).

​
Lancer la campagne

Lorsque vous êtes prêt à lancer votre campagne, il vous suffit de la réactiver en utilisant PUT accounts/:account_id/campaigns/:id. PUT https://ads-api.x.com/8/accounts/55w3kv/campaigns/f2rp3? entity_status=ACTIVE

​
Analytics

Les statistiques des campagnes VIDEO_VIEWS_PREROLL sont disponibles via nos points de terminaison de statistiques.

​
Ciblage par mots-clés dans les fils

Le ciblage par mots-clés est fondamental pour nos produits de Tweets sponsorisés, en améliorant la portée des campagnes. Le ciblage par mots-clés dans les fils permet aux plateformes de cibler les utilisateurs de X en fonction des mots-clés présents dans leurs Tweets récents. Par exemple, si un annonceur cible la combinaison de mots-clés non ordonnée « plan + trip » et qu’un utilisateur publie un Tweet disant « I’m starting to plan my trip to Cabo, any suggestions? » pendant que la campagne est active, cet utilisateur pourra voir peu de temps après le Tweet sponsorisé de l’annonceur.

​
Comment ça fonctionne ?

En bref : d’un point de vue API, ce changement est assez simple : vous pouvez désormais cibler des mots-clés pour les Tweets sponsorisés dans la Timeline. Il suffit de définir targeting_type sur unordered_keywords ou phrase_keywords pour les line items (éléments de campagne).

​
Guide de démarrage rapide

​
Référence de l’API

​
Comptes

​
GET accounts

Récupérer les détails de certains ou de tous les comptes pour lesquels la publicité est activée et auxquels l’utilisateur authentifié a accès. Resource URL https://ads-api.x.com/12/accounts Parameters

​
Exemple de requête

Exemple de réponse

​
GET accounts/:account_id

Récupère un compte spécifique auquel l’utilisateur authentifié a accès. URL de la ressource https://ads-api.x.com/12/accounts/:account_id Paramètres Exemple de requête GET https://ads-api.x.com/12/accounts/18ce54d4x5t Exemple de réponse

​
POST accounts

Remarque : ENVIRONNEMENT SANDBOX UNIQUEMENT Créez un compte publicitaire dans l’environnement sandbox. URL de la ressource https://ads-api-sandbox.x.com/12/accounts Paramètres Aucun Exemple de requête POST https://ads-api-sandbox.x.com/12/accounts Exemple de réponse

​
PUT accounts/:account_id

Met à jour le nom du compte et/ou le secteur d’activité. URL de la ressource https://ads-api.x.com/12/accounts/:account_id Paramètres Exemple de requête PUT https://ads-api.x.com/12/accounts/18ce54d4x5t?name='API McTestface 2'&industry_type=TECHNOLOGY Exemple de réponse

​
DELETE accounts/:account_id

Remarque : SANDBOX UNIQUEMENT Supprime un compte publicitaire dans l’environnement sandbox. URL de la ressource https://ads-api-sandbox.x.com/12/accounts/:account_id Paramètres Requête d’exemple DELETE https://ads-api-sandbox.x.com/12/accounts/gq12fh Réponse d’exemple

​
Apps du compte

Exécuter dans Postman ❯

​
GET account_apps

Récupérez les détails de toutes les applications mobiles associées au compte publicitaire spécifié. Resource URL https://ads-api.x.com/12/accounts/:account_id/account_apps Parameters Example Request GET https://ads-api.x.com/12/accounts/18ce54d4x5t/account_apps Example Response

​
Historique du compte

​
GET accounts/:account_id/account_history

Récupérer un récapitulatif des modifications apportées à l’entity_id spécifié dans la requête. Remarque : Cet endpoint est actuellement en bêta et nécessite un ajout à une liste d’autorisation (allowlisting). URL de la ressource https://ads-api.x.com/12/accounts/:account_id/account_history Paramètres Exemple de requête GET https://ads-api.x.com/12/accounts/18ce54d4x5t/account_history?entity_type=CAMPAIGN&entity_id=fc3h5&count=1 Exemple de réponse

​
Catégories d’activité des annonceurs

​
GET advertiser_business_categories

Récupérez les categories d’activité commerciales valides pour les groupes de publicités (line_items) afin de décrire la marque d’un annonceur aux éditeurs. Remarque : ces catégories s’appliquent uniquement aux line_items avec l’objectif PREROLL_VIEWS et sont distinctes des content_categories utilisées pour les critères de ciblage. Chaque advertiser_business_categories représente un ensemble de catégories IAB. Lors de la création d’un groupe de publicités avec l’objectif PREROLL_VIEWS, une ou deux advertiser_business_categories doivent être définies pour ce groupe. Cela peut être fait en définissant, pour le paramètre de requête categories de l’endpoint line item, l’ensemble des iab_categories correspondantes disponibles via cet endpoint. Des informations supplémentaires sont disponibles dans le guide sur l’objectif Video Views Preroll URL de la ressource https://ads-api.x.com/12/advertiser_business_categories Paramètres Aucun paramètre de requête Exemple de requête GET https://ads-api.x.com/12/advertiser_business_categories Exemple de réponse

​
Estimation de l’audience

POST accounts/:account_id/audience_estimate

​
Déterminer la taille approximative de l’audience de vos campagnes.

Ce point de terminaison accepte un tableau d’objets JSON contenant les paramètres des objets de critères de ciblage. Une liste des paramètres de critères de ciblage obligatoires et facultatifs est disponible sur le point de terminaison POST accounts/:account_id/targeting_criteria. Les requêtes doivent être des requêtes HTTP POST avec un corps JSON et un en-tête Content-Type: application/json. Remarque : vous devez spécifier au moins un critère de ciblage principal ; vous pouvez consulter la liste de tous les critères de ciblage principaux sur notre page de ciblage des campagnes. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/audience_estimate Paramètres Exemple de requête POST https://ads-api.x.com/12/accounts/18ce54d4x5t/audience_estimate
Exemple de réponse

​
Accès de l’utilisateur authentifié

​
GET accounts/:account_id/authenticated_user_access

Récupère les autorisations de l’utilisateur actuellement authentifié (access_token) en lien avec le compte publicitaire spécifié. Ces autorisations correspondent à celles exposées sur ads.x.com. Les valeurs possibles incluent :
  • ACCOUNT_ADMIN : Accès complet pour modifier les campagnes et consulter les statistiques, y compris la possibilité d’ajouter ou de supprimer des utilisateurs et de modifier les paramètres
  • AD_MANAGER : Accès complet pour modifier les campagnes et consulter les statistiques, mais ne peut pas ajouter ou supprimer des utilisateurs ni modifier les paramètres
  • CREATIVE_MANAGER : Accès pour modifier les créations publicitaires et afficher les aperçus, mais aucun accès pour créer ou modifier des campagnes
  • CAMPAIGN_ANALYST : Accès pour afficher les campagnes et consulter les statistiques, mais aucun accès pour créer ou modifier des campagnes
  • ANALYST (« Organic Analyst » sur ads.x.com) : Accès pour consulter les analyses organiques et les informations sur l’audience, mais aucun accès pour créer, modifier ou afficher des campagnes
  • PARTNER_AUDIENCE_MANAGER : Accès réservé à l’API pour consulter et modifier les audiences des partenaires de données, mais aucun accès aux campagnes, créations ou autres types d’audiences.
De plus, l’autorisation TWEET_COMPOSER indique que l’utilisateur authentifié peut créer des Tweets nullcastés (ou « Promoted-only ») au nom de l’annonceur. Ceci n’est disponible que pour les utilisateurs disposant des accès ACCOUNT_ADMIN, AD_MANAGER ou CREATIVE_MANAGER. Resource URL https://ads-api.x.com/12/accounts/:account_id/authenticated_user_access Parameters Aucun Example Request GET https://ads-api.x.com/12/accounts/18ce54d4x5t/authenticated_user_access Example Response

​
Règles d’enchères

​
GET bidding_rules

Récupérer les règles d’enchères pour certaines devises ou pour toutes. La réponse indiquera les enchères CPE (coût par interaction) minimales et maximales. Bien que ces règles d’enchères changent rarement, il est recommandé que vos systèmes rafraîchissent ces endpoints au moins une fois par mois. URL de la ressource https://ads-api.x.com/12/bidding_rules Paramètres Exemple de requête GET https://ads-api.x.com/12/bidding_rules?currency=USD Exemple de réponse

​
Campagnes

​
GET accounts/:account_id/campaigns

Récupère les détails de certaines ou de toutes les campagnes associées au compte actuel. Resource URL https://ads-api.x.com/12/accounts/:account_id/campaigns Parameters Example Request GET https://ads-api.x.com/12/accounts/18ce54d4x5t/campaigns?campaign_ids=8wku2 Example Response

​
GET accounts/:account_id/campaigns/:campaign_id

Récupérer une campagne spécifique associée au compte actuel. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/campaigns/:campaign_id Paramètres Exemple de requête GET https://ads-api.x.com/12/accounts/18ce54d4x5t/campaigns/8wku2 Exemple de réponse

​
POST accounts/:account_id/campaigns

Crée une nouvelle campagne associée au compte courant. Remarque : il existe une limite par défaut de 200 campagnes actives par compte. Cependant, il n’y a aucune limite pour le nombre de campagnes inactives. Cette limite peut être portée à 8 000 campagnes actives. Pour activer cette limite plus élevée, l’annonceur doit en faire la demande à son X Account Manager. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/campaigns Paramètres Exemple de requête POST https://ads-api.x.com/12/accounts/18ce54d4x5t/campaigns?funding_instrument_id=lygyi&name=demo&daily_budget_amount_local_micro=140000000&entity_status=PAUSED&budget_optimization=CAMPIAGN&standard_delivery=false Exemple de réponse

​
POST batch/accounts/:account_id/campaigns

Permet la création en lot de nouvelles campagnes avec une seule requête. Requêtes par lot
  • La taille maximale actuelle d’un lot est de 40.
  • Tous les paramètres sont envoyés dans le corps de la requête et un Content-Type de application/json est requis.
  • Les requêtes par lot échouent ou réussissent ensemble en tant que groupe et toutes les réponses de l’API, qu’il s’agisse d’erreur ou de succès, préservent l’ordre des éléments de la requête initiale.
Réponses par lot Les réponses de l’API par lot renvoient une collection ordonnée d’éléments. Pour le reste, elles sont identiques en structure à leurs endpoints équivalents pour un seul élément. Erreurs par lot
  • Les erreurs au niveau de la requête (par ex. taille maximale du lot dépassée) sont indiquées dans la réponse sous l’objet errors.
  • Les erreurs au niveau de l’élément (par ex. paramètre de campagne requis manquant) sont indiquées dans la réponse sous l’objet operation_errors.
Resource URL https://ads-api.x.com/12/batch/accounts/:account_id/campaigns Parameters Example Request POST 'Content-Type: application/json' https://ads-api.x.com/12/batch/accounts/18ce54d4x5t/campaigns
Exemple de réponse

​
PUT accounts/:account_id/campaigns/:campaign_id

Met à jour la campagne spécifiée associée au compte actuel. Resource URL https://ads-api.x.com/12/accounts/:account_id/campaigns/:campaign_id Parameters Example Request PUT https://ads-api.x.com/12/accounts/18ce54d4x5t/campaigns/8wku2?total_budget_amount_local_micro=140000000 Example Response

​
DELETE accounts/:account_id/campaigns/:campaign_id

Supprime la campagne spécifiée appartenant au compte actuel. Remarque : la suppression d’une campagne est irréversible et toute tentative ultérieure de suppression de la ressource renverra un code d’état HTTP 404. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/campaigns/:campaign_id Paramètres Exemple de requête DELETE https://ads-api.x.com/12/accounts/18ce54d4x5t/campaigns/8yn7m Exemple de réponse

​
Catégories de contenu

​
GET content_categories

Récupère les categories de contenu valides à définir comme targeting_criteria pour un line item. Chaque content_category correspond à une ou plusieurs catégories IAB. Pour ce faire, définissez targeting_type sur IAB_CATEGORY sur le endpoint batch targeting_critera afin d’inclure l’ensemble des iab_categories correspondantes renvoyées par la requête content_categories. Le non‑respect de cette étape entraînera une erreur de validation. Les informations éditeur pour chacune de ces catégories de contenu peuvent être récupérées via le endpoint GET publishers. Des informations supplémentaires sont disponibles dans le guide sur l’objectif pré-roll vues de vidéo. URL de la ressource https://ads-api.x.com/12/content_categories Paramètres Aucun paramètre de requête Exemple de requête GET https://ads-api.x.com/12/content_categories Exemple de réponse

​
Catégories sélectionnées

​
GET accounts/:account_id/curated_categories

Récupérer une liste de catégories sélectionnées disponibles pour les country_codes fournis. Chaque curated_category n’est disponible que dans certains pays, indiqués par les country_codes dans la réponse. Des informations supplémentaires sont disponibles dans le Guide sur l’objectif Video Views Pre-roll. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/curated_categories Paramètres Exemple de requête GET https://ads-api.x.com/12/accounts/18ce54d4x5t/curated_categories?country_codes=US Exemple de réponse

​
GET accounts/:account_id/curated_categories/:curated_category_id

Récupérer les détails d’un curated_category_id spécifique Chaque curated_category n’est disponible que dans certains pays, spécifiés par les country_codes dans la réponse. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/curated_categories/:curated_category_id Paramètres Exemple de requête GET https://ads-api.x.com/12/accounts/18ce54d4x5t/curated_categories/9ddrgesiap6o Exemple de réponse

​
Fonctionnalités

​
GET accounts/:account_id/features

Récupère l’ensemble des fonctionnalités accordées et accessibles par ce compte publicitaire. Les fonctionnalités sont indiquées par une clé de fonctionnalité descriptive et ne sont exposées sur ce point de terminaison que si elles sont introduites en version bêta ou dans le cadre d’une diffusion limitée et qu’elles sont disponibles dans l’Ads API. Les fonctionnalités qui ne répondent pas à ces critères ne seront pas exposées sur ce point de terminaison. Remarque : ce point de terminaison sert à faciliter le développement de l’écosystème de l’Ads API en améliorant la visibilité sur l’accès des clients aux versions bêta. Les développeurs d’API ne peuvent pas demander l’accès à des fonctionnalités au nom d’un annonceur. Ces demandes ne peuvent être faites que par l’annonceur auprès de son responsable de compte X. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/features Paramètres Exemple de requête GET https://ads-api.x.com/12/accounts/18ce54d4x5t/features Exemple de réponse

​
POST accounts/:account_id/features

SANDBOX UNIQUEMENT Ajoute une fonctionnalité à un compte sandbox. La liste à jour des fonctionnalités de compte peut être récupérée via le endpoint GET accounts/:account_id/features. URL de la ressource https://ads-api-sandbox.x.com/12/accounts/:account_id/features Paramètres Exemple de requête POST https://ads-api-sandbox.x.com/12/accounts/gq180y/features?feature_keys=VALIDATED_AGE_TARGETING Exemple de réponse

​
DELETE accounts/:account_id/features

SANDBOX UNIQUEMENT Supprimer une fonctionnalité d’un compte sandbox. La liste actualisée des fonctionnalités de compte peut être récupérée via le point de terminaison GET accounts/:account_id/features. URL de la ressource https://ads-api-sandbox.x.com/12/accounts/:account_id/features Paramètres Requête d’exemple DELETE https://ads-api-sandbox.x.com/12/accounts/gq180y/features?feature_keys=PREROLL_VIEWS_OBJECTIVE Réponse d’exemple

​
Instruments de financement

​
GET accounts/:account_id/funding_instruments

Récupère les détails de certains ou de l’ensemble des instruments de financement associés au compte actuel. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/funding_instruments Paramètres Exemple de requête GET https://ads-api.x.com/12/accounts/18ce54d4x5t/funding_instruments Exemple de réponse

​
GET accounts/:account_id/funding_instruments/:funding_instrument_id

Récupère un instrument de financement spécifique associé au compte actuel. Resource URL https://ads-api.x.com/12/accounts/:account_id/funding_instruments/:id Parameters Example Request GET https://ads-api.x.com/12/accounts/18ce54d4x5t/funding_instruments/lygyi Example Response

​
POST accounts/:account_id/funding_instruments

SANDBOX UNIQUEMENT Crée un instrument de financement dans l’environnement sandbox. Il n’y a aucun risque d’engendrer des coûts lors de l’utilisation d’un instrument de financement dans le sandbox. URL de ressource https://ads-api-sandbox.x.com/12/accounts/:account_id/funding_instruments Paramètres Exemple de requête POST https://ads-api-sandbox.x.com/12/accounts/gq1844/funding_instruments?currency=USD&start_time=2017-07-10T00:00:00Z&type=INSERTION_ORDER&end_time=2018-01-10T00:00:00Z&funded_amount_local_micro=140000000000 Exemple de réponse

​
DELETE accounts/:account_id/funding_instruments/:funding_instrument_id

SANDBOX UNIQUEMENT Supprime un instrument de financement dans l’environnement sandbox. Resource URL https://ads-api-sandbox.x.com/12/accounts/:account_id/funding_instruments/:funding_instrument_id Parameters Example Request DELETE https://ads-api-sandbox.x.com/12/accounts/gq1844/funding_instruments/hxt82 Example Response

​
Catégories IAB

​
GET iab_categories

Récupérez les categories d’applications valides pour les groupes d’annonces (line_items). URL de la ressource https://ads-api.x.com/12/iab_categories Paramètres Exemple de requête GET https://ads-api.x.com/12/iab_categories?count=2 Exemple de réponse

​
Éléments de campagne

​
GET accounts/:account_id/line_items

Récupère les détails de certains ou de l’ensemble des line items associés au compte actuel. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/line_items Paramètres Exemple de requête GET https://ads-api.x.com/12/accounts/18ce54d4x5t/line_items?line_item_ids=itttx Exemple de réponse

​
GET accounts/:account_id/line_items/:line_item_id

Récupérer un line item spécifique associé au compte actuel. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/line_items/:line_item_id Paramètres Exemple de requête GET https://ads-api.x.com/12/accounts/18ce54d4x5t/line_items/itttx Exemple de réponse

​
POST accounts/:account_id/line_items

Créez un élément de campagne associé à la campagne spécifiée appartenant au compte actuel. Tous les éléments de campagne au sein d’une campagne doivent avoir le même product_type et le même objective. Lorsque vous utilisez le type de produit PROMOTED_ACCOUNT, associer un Tweet au line_item ajoutera des emplacements dans le fil mobile en plus de l’emplacement PROMOTED_ACCOUNT standard. Le fait de définir android_app_store_identifier ou ios_app_store_identifier ajoutera automatiquement les critères de ciblage pour l’élément de campagne correspondant à l’application mobile promue ; par exemple, fournir ios_app_store_identifier ajouterait le critère de ciblage PLATFORM (critères de ciblage) pour iOS. Remarque : la limite est de 100 éléments de campagne par campagne et de 256 éléments de campagne actifs pour l’ensemble des campagnes. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/line_items Paramètres Exemple de requête POST https://ads-api.x.com/12/accounts/18ce54d4x5t/line_items?campaign_id=hwtq0&objective=ENGAGEMENTS&product_type=PROMOTED_TWEETS&placements=ALL_ON_TWITTER&bid_amount_local_micro=3210000&entity_status=PAUSED&daily_budget_amount_local_micro=1000000&start_time=2022-06-15 Exemple de réponse

​
POST batch/accounts/:account_id/line_items

Permet la création par lot de nouvelles line items avec une seule requête. Requêtes par lot
  • La taille maximale actuelle d’un lot est de 40.
  • Tous les paramètres sont envoyés dans le corps de la requête et un Content-Type de application/json est requis.
  • Les requêtes par lot échouent ou réussissent ensemble en tant que groupe et toutes les réponses de l’API, qu’il s’agisse d’erreurs ou de succès, préservent l’ordre des éléments de la requête initiale.
Réponses par lot Les réponses de l’API par lot renvoient une collection ordonnée d’éléments. Pour le reste, elles sont identiques, en termes de structure, à leurs endpoints à élément unique correspondants. Erreurs de lot
  • Les erreurs au niveau de la requête (par exemple, taille maximale du lot dépassée) sont indiquées dans la réponse sous l’objet errors.
  • Les erreurs au niveau d’un élément (par exemple, paramètre de line item requis manquant) sont indiquées dans la réponse sous l’objet operation_errors.
Resource URL https://ads-api.x.com/12/batch/accounts/:account_id/line_items Parameters Example Request POST 'Content-Type: application/json' https://ads-api.x.com/12/batch/accounts/18ce54d4x5t/line_items
Exemple de réponse

​
PUT accounts/:account_id/line_items/:line_item_id

Met à jour la ligne publicitaire spécifiée pour le compte actuel. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/line_items/:line_item_id Paramètres Exemple de requête PUT https://ads-api.x.com/12/accounts/18ce54d4x5t/line_items/9cqi0?bid_amount_local_micro=140000 Exemple de réponse

​
DELETE accounts/:account_id/line_items/:line_item_id

Supprime l’élément de campagne spécifié appartenant au compte en cours. Remarque : la suppression d’un élément de campagne est irréversible et toute tentative ultérieure de suppression de la ressource renverra une réponse HTTP 404. Remarque : lorsqu’un élément de campagne est supprimé, ses promoted_tweets enfants ne sont renvoyés par les endpoints GET accounts/:account_id/promoted_tweets et GET accounts/:account_id/promoted_tweets/:promoted_tweet_id que si with_deleted=true est spécifié dans la requête. Ces promoted_tweets ne sont toutefois pas réellement supprimés ("deleted": false dans la réponse). Nous n’effectuons pas de suppressions en cascade. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/line_items/:line_item_id Paramètres Exemple de requête DELETE https://ads-api.x.com/12/accounts/18ce54d4x5t/line_items/9f2ix Exemple de réponse

​
Catégories sélectionnées pour les éléments de campagne

Des informations supplémentaires sur l’utilisation sont disponibles dans le guide de l’objectif « Vues de vidéo pre-roll ».

​
GET accounts/:account_id/line_item_curated_categories

Récupère les détails de certaines ou de toutes les catégories d’éléments de campagne sélectionnées associées au compte actuel. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/line_item_curated_categories Paramètres Exemple de requête GET https://ads-api.x.com/12/accounts/abc1/line_item_curated_categories Exemple de réponse

​
GET accounts/:account_id/line_item_curated_categories/:line_item_curated_category_id

Récupère les détails d’une catégorie organisée d’élément de campagne spécifique associée au compte actuel. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/line_item_curated_categories/:line_item_curated_category_id Paramètres Exemple de requête GET https://ads-api.x.com/12/accounts/abc1/line_item_curated_categories/yav Exemple de réponse

​
POST accounts/:account_id/line_item_curated_categories

Associer un objet curated category à l’élément de campagne (line item) spécifié. URL de ressource https://ads-api.x.com/12/accounts/:account_id/line_item_curated_categories Paramètres Exemple de requête POST https://ads-api.x.com/12/accounts/18ce54d4x5t/line_item_curated_categories?line_item_id=iqwka&curated_category_id=9ddrgesiap6o Exemple de réponse

​
PUT accounts/:account_id/line_item_curated_categories/:line_item_curated_category_id

Met à jour la catégorie sélectionnée de l’élément de campagne spécifié. Resource URL https://ads-api.x.com/12/accounts/:account_id/line_item_curated_categories/:line_item_curated_category_id Parameters Example Request PUT https://ads-api.x.com/12/accounts/18ce54d4x5t/line_item_curated_categories/xq?curated_category_id=8tujl1p3yn0g Example Response

​
DELETE accounts/:account_id/line_item_curated_categories/:line_item_curated_category_id

Supprime la catégorie de line item organisée spécifiée. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/line_item_curated_categories/:line_item_curated_category_id Paramètres Exemple de requête DELETE https://ads-api.x.com/12/accounts/18ce54d4x5t/line_item_curated_categories/xq Exemple de réponse

​
Emplacements des éléments de campagne

​
GET line_items/placements

Récupère les combinaisons valides de placement et de product_type. Resource URL https://ads-api.x.com/12/line_items/placements Parameters Example Request GET https://ads-api.x.com/12/line_items/placements?product_type=PROMOTED_ACCOUNT Example Response

​
Créations média

​
GET accounts/:account_id/media_creatives

Récupérer les détails de certaines ou de l’ensemble des créations média associées au compte actuel. Resource URL https://ads-api.x.com/12/accounts/:account_id/media_creatives Parameters Example Request GET https://ads-api.x.com/12/accounts/18ce54d4x5t/media_creatives?media_creative_ids=1bzq3 Example Response

​
GET accounts/:account_id/media_creatives/:media_creative_id

Renvoie les détails d’un media creative spécifique associé au compte actuel. Resource URL https://ads-api.x.com/12/accounts/:account_id/media_creatives/:media_creative_id Parameters Example Request GET https://ads-api.x.com/12/accounts/18ce54d4x5t/media_creatives/1bzq3 Example Response

​
POST accounts/:account_id/media_creatives

Associez un objet account media à l’élément de campagne (line item) spécifié. Utilisez cet endpoint pour promouvoir des publicités in-stream (quand le creative_type de l’account media est PREROLL) ou des publicités image (telles que BANNER ou INTERSTITIAL) sur la Twitter Audience Platform. Remarque : pour ajouter des ressources média à la ressource Account Media, utilisez l’endpoint POST accounts/:account_id/media_library. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/media_creatives Paramètres Exemple de requête POST https://ads-api.x.com/12/accounts/18ce54d4x5t/media_creatives?line_item_id=8v7jo&account_media_id=10miy Exemple de réponse

​
DELETE accounts/:account_id/media_creatives/:media_creative_id

Supprime la création média spécifiée associée au compte actuel. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/media_creatives/:media_creative_id Paramètres Exemple de requête DELETE https://ads-api.x.com/12/accounts/18ce54d4x5t/media_creatives/1bzq3 Exemple de réponse

​
Comptes sponsorisés

​
GET accounts/:account_id/promoted_accounts

Récupérer les détails de certains ou de tous les comptes sponsorisés associés à un ou plusieurs éléments de campagne (line items) du compte actuel. Utilisez GET users/lookup pour obtenir les données des comptes utilisateur identifiés par user_id dans la réponse. Un code HTTP 400 sera renvoyé si aucun des éléments de campagne spécifiés n’est configuré pour contenir des comptes sponsorisés. Resource URL https://ads-api.x.com/12/accounts/:account_id/promoted_accounts Parameters Example Request GET https://ads-api.x.com/12/accounts/18ce54d4x5t/promoted_accounts?promoted_account_ids=19pl2 Example Response

​
GET accounts/:account_id/promoted_accounts/:promoted_account_id

Récupérer une référence spécifique à un compte associé à un line item du compte actuel. Resource URL https://ads-api.x.com/12/accounts/:account_id/promoted_accounts/:promoted_account_id Parameters Example Request GET https://ads-api.x.com/12/accounts/18ce54d4x5t/promoted_accounts/19pl2 Example Response

​
POST accounts/:account_id/promoted_accounts

Associe un compte (user_id) à l’élément de campagne (line item) spécifié. Si l’élément de campagne spécifié n’est pas configuré pour être associé à des comptes sponsorisés (Promoted Accounts), une erreur HTTP 400 INCOMPATIBLE_LINE_ITEM sera renvoyée. Si l’utilisateur spécifié n’est pas éligible à la promotion, une erreur HTTP 400 sera renvoyée et aucun utilisateur ne sera promu. Si l’utilisateur fourni est déjà promu, la requête sera ignorée. Pour plus d’informations sur les Promoted Accounts, consultez notre page de gestion de campagnes. Remarque : il n’est pas possible de mettre à jour (PUT) des entités de comptes promus. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/promoted_accounts Paramètres Exemple de requête POST https://ads-api.x.com/12/accounts/18ce54d4x5t/promoted_accounts?line_item_id=9bpb2&user_id=756201191646691328 Exemple de réponse

​
DELETE accounts/:account_id/promoted_accounts/:promoted_account_id

Dissocie un compte de l’élément de campagne (line item) spécifié. Resource URL https://ads-api.x.com/12/accounts/:account_id/promoted_accounts/:promoted_account_id Parameters Example Request DELETE https://ads-api.x.com/12/accounts/18ce54d4x5t/promoted_accounts/19pl2 Example Response

​
GET accounts/:account_id/promoted_tweets

Récupérer les références aux Tweets associés aux éléments de ligne (line items) du compte actuel. Utilisez le point de terminaison GET accounts/:account_id/tweets pour récupérer les objets Tweet. Utilisez les valeurs tweet_id pour chaque objet promoted_tweets. Remarque : lorsque les éléments de ligne (line items) parents sont supprimés, les promoted_tweets ne sont renvoyés que si with_deleted=true est spécifié dans la requête. Ces promoted_tweets ne sont toutefois pas réellement supprimés ("deleted": false dans la réponse). URL de la ressource https://ads-api.x.com/12/accounts/:account_id/promoted_tweets Paramètres Exemple de requête GET https://ads-api.x.com/12/accounts/18ce54d4x5t/promoted_tweets?promoted_tweet_ids=1efwlo Exemple de réponse

​
GET accounts/:account_id/promoted_tweets/:promoted_tweet_id

Récupérer une référence spécifique à un Tweet associé à un élément de campagne pour le compte actuel. Remarque : lorsque les éléments de campagne parents sont supprimés, les promoted_tweets ne sont renvoyés que si with_deleted=true est spécifié dans la requête. Ces promoted_tweets ne sont toutefois pas réellement supprimés ("deleted": false dans la réponse). URL de la ressource https://ads-api.x.com/12/accounts/:account_id/promoted_tweets/:promoted_tweet_id Paramètres Exemple de requête GET https://ads-api.x.com/12/accounts/18ce54d4x5t/promoted_tweets/1efwlo Exemple de réponse

​
POST accounts/:account_id/promoted_tweets

Associer un ou plusieurs Tweets à l’élément de campagne (line item) spécifié. Tous les Tweets ne sont pas adaptés à la promotion, selon l’objectif de la campagne. Veuillez consulter la page Objective-based Campaigns pour plus d’informations. Lorsque vous utilisez le type de produit PROMOTED_ACCOUNT, le fait d’associer un Tweet au line_item ajoutera des emplacements dans le fil (timeline) sur mobile en plus de l’emplacement PROMOTED_ACCOUNT standard. Remarque : il n’est pas possible de mettre à jour (PUT) des entités de Tweets promus. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/promoted_tweets Paramètres Exemple de requête POST https://ads-api.x.com/12/accounts/18ce54d4x5t/promoted_tweets?line_item_id=8v7jo&tweet_ids=822333526255120384 Exemple de réponse

​
DELETE accounts/:account_id/promoted_tweets/:promoted_tweet_id

Dissocie un Tweet de l’élément de campagne (line item) spécifié. Remarque : une entité promoted_tweets supprimée sera indiquée comme « Paused » dans l’interface ads.x.com. De même, le fait de la mettre en « pause » depuis l’interface dissociera le Tweet de son élément de campagne. URL de ressource https://ads-api.x.com/12/accounts/:account_id/promoted_tweets/:promoted_tweet_id Paramètres Exemple de requête DELETE https://ads-api.x.com/12/accounts/18ce54d4x5t/promoted_tweets/1gp8a5 Exemple de réponse

​
Utilisateurs pouvant être promus

​
GET accounts/:account_id/promotable_users

Récupérer les détails pour certains ou tous les utilisateurs promouvables associés au compte actuel. Le type d’utilisateur promouvable est soit FULL, soit RETWEETS_ONLY. Cela détermine le type de contenu que le compte est autorisé à promouvoir. Les annonceurs doivent obtenir l’autorisation de promouvoir le contenu d’un autre utilisateur et contacter X pour que cet utilisateur soit ajouté à votre compte en tant qu’utilisateur promouvable RETWEETS_ONLY. À condition que les autorisations soient correctement définies, vous pouvez effectuer des requêtes vers les endpoints de produits promus qui font directement référence à l’ID du Tweet que vous souhaitez promouvoir. Vous pouvez utiliser l’endpoint POST accounts/:account_id/promoted-tweets pour promouvoir des Tweets publiés et l’endpoint POST accounts/:account_id/scheduled-promoted-tweets pour promouvoir les Tweets programmés d’un autre compte Twitter Ads. Vous n’êtes pas obligé de retweeter le Tweet cible. Lorsque vous faites la promotion d’un Tweet avec cette approche, le tweet_id renvoyé sera différent de l’ID du Tweet fourni. En coulisses, le Tweet est retweeté comme un Tweet « nullcasted », puis promu. Le tweet_id renvoyé correspond à ce nouveau Tweet. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/promotable_users Paramètres Exemple de requête GET https://ads-api.x.com/12/accounts/18ce54d4x5t/promotable_users?promotable_user_ids=l310s Exemple de réponse

​
GET accounts/:account_id/promotable_users/:promotable_user_id

Récupérer un utilisateur promouvable spécifique associé au compte actuel. Le type d’utilisateur promouvable est soit FULL, soit RETWEETS_ONLY. Cela détermine le type de contenu que le compte est autorisé à promouvoir. Les annonceurs doivent obtenir l’autorisation de promouvoir le contenu d’un autre utilisateur. À condition que les autorisations soient correctement définies, vous pouvez envoyer des requêtes aux endpoints de produits promus qui font directement référence à l’ID du Tweet que vous souhaitez promouvoir. Vous n’êtes pas obligé de retweeter le Tweet cible. Lorsque vous faites la promotion d’un Tweet avec cette approche, le tweet_id renvoyé sera différent de l’ID du Tweet fourni. En coulisses, le Tweet est retweeté en tant que Tweet nullcasté, puis promu. Le tweet_id renvoyé correspond à ce nouveau Tweet. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/promotable_users/:promotable_user_id Paramètres Exemple de requête GET https://ads-api.x.com/12/accounts/18ce54d4x5t/promotable_users/l310s Exemple de réponse

​
Éditeurs

​
GET publishers

Récupérer une liste d’informations sur les éditeurs de catégories de contenu Des informations supplémentaires sont disponibles dans le guide sur l’objectif Vues de vidéos en pré‑roll URL de la ressource https://ads-api.x.com/12/publishers Paramètres Aucun paramètre de requête Exemple de requête GET https://ads-api.x.com/12/publishers Exemple de réponse

​
Recommandations

​
GET accounts/:account_id/recommendations

Statut : bêta fermée Récupère les recommandations de campagne associées à ce compte publicitaire. Actuellement, une seule recommandation est disponible par instrument de financement. URL de la ressource https://ads-api.x.com/5/accounts/:account_id/recommendations Paramètres Exemple de requête GET https://ads-api.x.com/5/accounts/18ce54d4x5t/recommendations Exemple de réponse

​
GET accounts/:account_id/recommendations/:recommendation_id

Statut : bêta fermée Récupère une recommandation de campagne spécifique associée à ce compte publicitaire. La recommandation de campagne contient un ensemble complet de modifications suggérées pour la structure de la campagne, représentée sous forme d’arborescence d’objets. L’arborescence de réponse est conçue pour fonctionner avec les endpoints de la Batch API, mais elle peut également être associée à des endpoints de mise à jour individuels selon le cas (Create pour POST, Update pour PUT, Delete pour DELETE). URL de ressource https://ads-api.x.com/5/accounts/:account_id/recommendations/:recommendation_id Paramètres Exemple de requête GET https://ads-api.x.com/5/accounts/18ce54d4x5t/recommendations/62ce8zza1q0w Exemple de réponse

​
GET accounts/:account_id/scheduled_promoted_tweets

Récupérer les détails de certains ou de l’ensemble des Tweets sponsorisés programmés associés au compte actuel. Resource URL https://ads-api.x.com/12/accounts/:account_id/scheduled_promoted_tweets Parameters Example Request GET https://ads-api.x.com/12/accounts/18ce54d4x5t/scheduled_promoted_tweets?scheduled_promoted_tweet_ids=1xboq Example Response

​
GET accounts/:account_id/scheduled_promoted_tweets/:scheduled_promoted_tweet_id

Récupérer un Tweet promu programmé spécifique associé au compte actuel. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/scheduled_promoted_tweets/:scheduled_promoted_tweet_id Paramètres Exemple de requête GET https://ads-api.x.com/12/accounts/18ce54d4x5t/scheduled_promoted_tweets/1xboq Exemple de réponse

​
POST accounts/:account_id/scheduled_promoted_tweets

Associe un Tweet programmé à l’élément de campagne (line item) spécifié. Remarque : il n’est pas possible de mettre à jour (PUT) les entités de Tweets promus programmés. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/scheduled_promoted_tweets Paramètres Exemple de requête POST https://ads-api.x.com/12/accounts/18ce54d4x5t/scheduled_promoted_tweets?line_item_id=8xdpe&scheduled_tweet_id=870358555227860992 Exemple de réponse

​
DELETE accounts/:account_id/scheduled_promoted_tweets/:scheduled_promoted_tweet_id

Dissocie un Tweet programmé de l’élément de campagne spécifié. Remarque : scheduled_promoted_tweets ne peuvent être supprimés qu’avant l’heure scheduled_at du Tweet programmé. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/scheduled_tweets/:scheduled_tweet_id Paramètres Exemple de requête DELETE https://ads-api.x.com/12/accounts/18ce54d4x5t/scheduled_promoted_tweets/1xtfl Exemple de réponse

​
Critères de ciblage

​
GET accounts/:account_id/targeting_criteria

Récupérer les détails de certains ou de l’ensemble des critères de ciblage associés aux éléments de campagne du compte actuel. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/targeting_criteria Paramètres Example Request GET https://ads-api.x.com/12/accounts/18ce54d4x5t/targeting_criteria?line_item_ids=8u94t Example Response

​
GET accounts/:account_id/targeting_criteria/:targeting_criterion_id

Récupère un critère de ciblage spécifique associé au compte actuel. Resource URL https://ads-api.x.com/12/accounts/:account_id/targeting_criteria/:targeting_criterion_id Parameters Example Request GET https://ads-api.x.com/12/accounts/18ce54d4x5t/targeting_criteria/eijd4y Example Response

​
POST accounts/:account_id/targeting_criteria

Consultez la page Targeting Options pour trouver les targeting_value correspondant à des types de ciblage spécifiques. Nous vous recommandons d’actualiser toutes les données chaque semaine afin de vous assurer que vous utilisez l’ensemble le plus récent de valeurs de types de ciblage. Nous modifions les valeurs et les critères de ciblage disponibles de temps à autre ; bien que la majorité ne change pas souvent, certains oui. Il n’y a aucune garantie que ces valeurs ne changeront pas. Utilisez les types de ciblage BROAD_KEYWORD, EXACT_KEYWORD, PHRASE_KEYWORD ou UNORDERED_KEYWORD avec les mots-clés spécifiés dans targeting_value. Excluez des mots-clés en utilisant le paramètre de requête operator_type défini sur NE. Consultez les types de mots-clés de ciblage pour une description détaillée de chaque type. Remarque : il n’est possible de cibler qu’un seul segment d’âge par élément de campagne. Remarque : pour cibler une Custom Audience, cette audience doit être ciblable. C’est-à-dire que targerable doit être égal à true. Remarque : lorsque vous utilisez le type de ciblage TV_SHOW, il doit y avoir au moins un critère de ciblage LOCATION sur l’élément de campagne avant de définir le ciblage TV_SHOW, et tous les LOCATION doivent se trouver dans la même zone géographique que le TV_SHOW ciblé. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/targeting_criteria Paramètres Exemple de requête POST https://ads-api.x.com/12/accounts/18ce54d4x5t/targeting_criteria?line_item_id=619jl&targeting_type=BROAD_KEYWORD&targeting_value=technology Exemple de réponse

​
POST batch/accounts/:account_id/targeting_criteria

Permet la création en lot de nouveaux critères de ciblage avec une seule requête. Requêtes par lot
  • La taille maximale actuelle d’un lot est de 500.
  • Tous les paramètres sont envoyés dans le corps de la requête et un Content-Type de application/json est requis.
  • Les requêtes par lot échouent ou réussissent ensemble en tant que groupe et toutes les réponses de l’API, en cas d’erreur comme de succès, conservent l’ordre des éléments de la requête initiale.
Réponses par lot Les réponses de l’API par lot renvoient une collection ordonnée d’éléments. Pour le reste, elles sont identiques, en termes de structure, aux points de terminaison correspondants ne traitant qu’un seul élément. Erreurs de lot
  • Les erreurs au niveau de la requête (par exemple, taille de lot maximale dépassée) apparaissent dans la réponse sous l’objet errors.
  • Les erreurs au niveau de l’élément (par exemple, paramètre de critère de ciblage requis manquant) apparaissent dans la réponse sous l’objet operation_errors.
URL de ressource https://ads-api.x.com/12/batch/accounts/:account_id/targeting_criteria Paramètres Exemple de requête POST https://ads-api.x.com/12/batch/accounts/18ce54d4x5t/targeting_criteria
Exemple de réponse

​
DELETE accounts/:account_id/targeting_criteria/:targeting_criterion_id

Supprime le critère de ciblage spécifié appartenant au compte en cours. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/targeting_criteria/:targeting_criterion_id Paramètres Exemple de requête DELETE https://ads-api.x.com/12/accounts/18ce54d4x5t/targeting_criteria/dpl3a6 Exemple de réponse

​
Options de ciblage

​
GET targeting_criteria/app_store_categories

Découvrez les critères de ciblage disponibles basés sur les catégories de magasins d’applications pour les Produits sponsorisés. Les catégories de magasins d’applications sont disponibles uniquement pour l’App Store iOS et le Google Play Store. Le ciblage par catégorie d’applications installées permet de cibler les utilisateurs en fonction des catégories d’applications qu’ils ont installées ou pour lesquelles ils ont indiqué un intérêt. URL de la ressource https://ads-api.x.com/12/targeting_criteria/app_store_categories Paramètres Exemple de requête GET https://ads-api.x.com/12/targeting_criteria/app_store_categories?q=music&os_type=IOS Exemple de réponse

​
GET targeting_criteria/conversations

Découvrez les critères de ciblage disponibles basés sur les conversations pour les produits sponsorisés. Resource URL https://ads-api.x.com/12/targeting_criteria/conversations Parameters Example Request GET https://ads-api.x.com/12/targeting_criteria/conversations?count=2 Example Response

​
GET targeting_criteria/devices

Découvrez les critères de ciblage disponibles basés sur les appareils pour les produits sponsorisés. Le ciblage par appareil est disponible pour les Tweets sponsorisés. URL de la ressource https://ads-api.x.com/12/targeting_criteria/devices Paramètres Exemple de requête GET https://ads-api.x.com/12/targeting_criteria/devices?count=2&q=iphone Exemple de réponse

​
GET targeting_criteria/events

Découvrez les critères de ciblage basés sur des événements disponibles pour les produits sponsorisés (Promoted Products). Un seul événement peut être ciblé par line item. Remarque : les événements existent souvent sur plusieurs fuseaux horaires, ce qui complique la prise en compte des heures d’événement dans une perspective multi‑fuseaux. Pour simplifier cela, toutes les valeurs start_time et end_time des événements pour cet endpoint sont représentées en UTC±00:00, indépendamment de la langue et du fuseau horaire de l’événement. Il convient de garder cette conception à l’esprit lors de l’interrogation et de l’utilisation des valeurs start_time et end_time des événements. Par exemple, la fête de l’Indépendance aux États‑Unis est représentée comme start_time=2017-07-04T00:00:00Z et end_time=2017-07-05T00:00:00Z en UTC±00:00, ce qui évite ainsi le problème de l’existence de cette fête sur plusieurs fuseaux horaires au sein des États‑Unis. Resource URL https://ads-api.x.com/12/targeting_criteria/events Parameters Example Request GET https://ads-api.x.com/12/targeting_criteria/events?count=1 Example Response

​
GET targeting_criteria/interests

Découvrez les critères de ciblage par centres d’intérêt disponibles pour les Produits sponsorisés. Les centres d’intérêt changent rarement ; nous vous recommandons néanmoins d’actualiser cette liste au moins une fois par semaine. URL de la ressource https://ads-api.x.com/12/targeting_criteria/interests Paramètres Exemple de requête GET https://ads-api.x.com/12/targeting_criteria/interests?q=books Exemple de réponse

​
GET targeting_criteria/languages

Découvrez les langues disponibles pour le ciblage. URL de la ressource https://ads-api.x.com/12/targeting_criteria/languages Paramètres Exemple de requête GET https://ads-api.x.com/12/targeting_criteria/languages?q=english Exemple de réponse

​
GET targeting_criteria/locations

Découvrez les critères de ciblage géographiques disponibles pour les Promoted Products. Le ciblage géographique est disponible pour les Promoted Accounts et les Promoted Tweets au niveau du pays, de l’État/région, de la ville et du code postal. Le ciblage par code postal doit être utilisé si vous souhaitez récupérer des statistiques au niveau du code postal. Remarque : pour récupérer des villes spécifiques pouvant être ciblées, comme San Francisco ou New York, utilisez l’énumération CITIES avec le paramètre de requête location_type. Pour cibler des Designated Market Areas (DMA), utilisez l’énumération METROS. Resource URL https://ads-api.x.com/12/targeting_criteria/locations Parameters Example Request GET https://ads-api.x.com/12/targeting_criteria/locations?location_type=CITIES&q=los angeles Example Response

​
GET targeting_criteria/network_operators

Découvrez les critères de ciblage disponibles basés sur les opérateurs réseau pour les produits sponsorisés. Cet endpoint vous permet de rechercher les opérateurs mobiles pouvant être ciblés, tels que AT&T, Verizon, Sprint, T-Mobile, etc., dans plusieurs pays. URL de la ressource https://ads-api.x.com/12/targeting_criteria/network_operators Paramètres Exemple de requête GET https://ads-api.x.com/12/targeting_criteria/network_operators?count=5&country_code=US Exemple de réponse

​
GET targeting_criteria/platform_versions

Découvrez les critères de ciblage disponibles en fonction de la version du système d’exploitation mobile pour les produits sponsorisés (Promoted Products). Le ciblage par version de plateforme est disponible pour les comptes sponsorisés (Promoted Accounts) et les Tweets sponsorisés (Promoted Tweets). Cela permet de cibler jusqu’à la version mineure d’un système d’exploitation mobile, comme Android 8.0 ou iOS 10.0. Resource URL https://ads-api.x.com/12/targeting_criteria/platform_versions Parameters Example Request GET https://ads-api.x.com/12/targeting_criteria/platform_versions Example Response

​
GET targeting_criteria/platforms

Découvrez les critères de ciblage par plateforme disponibles pour les produits sponsorisés. URL de la ressource https://ads-api.x.com/12/targeting_criteria/platforms Paramètres Exemple de requête GET https://ads-api.x.com/12/targeting_criteria/platforms Exemple de réponse

​
GET targeting_criteria/tv_markets

Permet de découvrir les marchés TV disponibles où il est possible de cibler des émissions TV. Renvoie les marchés par paramètre de langue (locale) qui peuvent être utilisés pour interroger le point de terminaison GET targeting_criteria/tv_shows. URL de la ressource https://ads-api.x.com/12/targeting_criteria/tv_markets Paramètres Aucun Exemple de requête GET https://ads-api.x.com/12/targeting_criteria/tv_markets Exemple de réponse

​
GET targeting_criteria/tv_shows

Découvrez les critères de ciblage disponibles basés sur les émissions TV pour les produits sponsorisés. Le ciblage par émission TV est disponible pour les Tweets sponsorisés sur certains marchés. Consultez le point de terminaison GET targeting_criteria/tv_markets pour les marchés disponibles. Remarque : toute audience contenant moins de 1 000 utilisateurs apparaîtra avec une valeur estimated_users de 1000. Remarque : les options de ciblage par chaîne TV et par genre ne sont plus prises en charge. Resource URL https://ads-api.x.com/12/targeting_criteria/tv_shows Parameters Example Request GET https://ads-api.x.com/12/targeting_criteria/tv_shows?locale=en-US&q=news&count=1 Example Response

​
Suggestions de ciblage

​
GET accounts/:account_id/targeting_suggestions

Obtenez jusqu’à 50 suggestions de ciblage par mots-clés ou utilisateurs pour compléter votre sélection initiale. Resource URL https://ads-api.x.com/12/accounts/:account_id/targeting_suggestions Parameters Example Request GET https://ads-api.x.com/12/accounts/18ce54d4x5t/targeting_suggestions?suggestion_type=KEYWORD&targeting_values=developers&count=2" Example Response

​
Paramètres fiscaux

​
GET accounts/:account_id/tax_settings

Récupère les détails des paramètres fiscaux associés au compte actuel. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/tax_settings Paramètres Exemple de requête GET https://ads-api.x.com/12/accounts/18ce54d4x5t/tax_settings Exemple de réponse

​
PUT accounts/:account_id/tax_settings

Met à jour les paramètres fiscaux du compte actuel. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/tax_settings Paramètres Exemple de requête PUT https://ads-api.x.com/12/accounts/18ce54d4x5t/tax_settings?address_name=ABC, Co. Exemple de réponse

​
Balises de suivi

​
GET accounts/:account_id/tracking_tags

Récupérer les détails de certaines ou de l’ensemble des balises de suivi associées au compte actuel. Resource URL https://ads-api.x.com/12/accounts/:account_id/tracking_tags Parameters Example Request GET https://ads-api.x.com/12/accounts/18ce54d4x5t/tracking_tags?tracking_tag_ids=3m82 Example Response

​
GET accounts/:account_id/tracking_tags/:tracking_tag_id

Récupérer une balise de suivi spécifique associée au compte actuel. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/tracking_tags/:tracking_tag_id Paramètres Exemple de requête GET https://ads-api.x.com/12/accounts/18ce54d4x5t/tracking_tags/555j Exemple de réponse

​
POST accounts/:account_id/tracking_tags

Associer une balise de suivi à l’élément de campagne spécifié. Resource URL https://ads-api.x.com/12/accounts/:account_id/tracking_tags Parameters Example Request POST https://ads-api.x.com/12/accounts/18ce54d4x5t/tracking_tags?line_item_id=fdwcl&tracking_tag_type=IMPRESSION_TAG&tracking_tag_url=https://ad.doubleclick.net/ddm/trackimp/N1234.2061500TWITTER-OFFICIAL/B9156151.125630439;dc_trk_aid=1355;dc_trk_cid=8675309 Example Response

​
PUT accounts/:account_id/tracking_tags/:tracking_tag_id

Associe une balise de suivi à l’élément de campagne spécifié. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/tracking_tags/:tracking_tag_id Paramètres Exemple de requête PUT https://ads-api.x.com/12/accounts/18ce54d4x5t/tracking_tags/3m82?tracking_tag_url=https://ad.doubleclick.net/ddm/trackimp/N1234.2061500TWITTER-OFFICIAL/B9156151.125630439;dc_trk_aid=1355;dc_trk_cid=8675309 Exemple de réponse

​
DELETE accounts/:account_id/tracking_tags/:tracking_tag_id

Dissocie une balise de suivi de l’élément de campagne spécifié. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/tracking_tags/:tracking_tag_id Paramètres Exemple de requête DELETE https://ads-api.x.com/12/accounts/18ce54d4x5t/tracking_tags/555j Exemple de réponse

​
Paramètres utilisateur

(https://app.getpostman.com/run-collection/1d12b9fc623b8e149f87)

​
GET accounts/:account_id/user_settings/:user_id

Récupère les paramètres utilisateur. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/user_settings/:user_id Paramètres Exemple de requête GET https://ads-api.x.com/12/accounts/18ce54d4x5t/user_settings/756201191646691328 Exemple de réponse

​
PUT accounts/:account_id/user_settings/:user_id

Met à jour les paramètres de l’utilisateur. Nécessite un contexte utilisateur. Non accessible par les administrateurs de compte. URL de la ressource https://ads-api.x.com/12/accounts/:account_id/user_settings/:user_id Paramètres Exemple de requête PUT https://ads-api.x.com/12/accounts/18ce54d4x5t/user_settings/756201191646691328?notification_email='user@domain.com'&subscribe_email_types=ACCOUNT_PERFORMANCE,PERFORMANCE_IMPROVEMENT" Exemple de réponse