Passer au contenu principal
L’exemple suivant suppose 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 de manière transparente l’authentification OAuth pour 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 correspond à peu près à l’option -v de cURL. Dans cet exemple, nous allons créer une campagne de publicités produits dynamiques (Dynamic Product Ads, DPA). Récupérez l’id du compte. 
twurl -H ads-api.x.com /12/accounts/

{
  "request": {
    "params": {}
  },
  "data": [
    {
      "name": "Test account for @AdsAPI",
      "timezone": "America/Los_Angeles",
      "timezone_switch_at": null,
      "id": "xxxxxx",
      "created_at": "2014-03-09T00:41:49Z",
      "salt": "f9f9d5a5f23075c618da5eb1d1a9df57",
      "updated_at": "2015-01-29T00:41:49Z",
      "approval_status": "ACCEPTED",
      "deleted": false
    }
  ],
  "data_type": "account",
  "total_count": 1,
  "next_cursor": null
}
Récupérez l’identifiant de l’instrument de financement. Appelez l’API GET accounts/:account_id/funding_instruments en utilisant l’id du compte récupéré avec la commande précédente. 
twurl -H ads-api.x.com /12/accounts/xxxxxx/funding_instruments

{
  "data": [
    {
      "cancelled": true,
      "created_at": "2014-03-09T00:41:49Z",
      "credit_limit_local_micro": null,
      "currency": "USD",
      "deleted": false,
      "description": null,
      "end_time": null,
      "funded_amount_local_micro": null,
      "id": "yyyy",
      "type": null,
      "updated_at": "2014-05-29T00:41:49Z"
    }
  ],
  "data_type": "funding_instrument",
  "next_cursor": null,
  "request": {
    "params": {
      "account_id": "xxxxxx"
    }
  },
  "total_count": 1
}

​
Étape 1 : Créer une campagne

Créez une campagne et associez-la à l’instrument de financement. Spécifiez une heure de début et un budget pour la campagne.
  • Champs obligatoires : instrument de financement, nom de la campagne, budget (total/quotidien), heure de début et ID du compte publicitaire
twurl -H ads-api.x.com -d "funding_instrument_id={FUNDING_INSTRUMENT_ID}&name={CAMPAIGN_NAME}&total_budget_amount_local_micro={TOTAL_BUDGET}&daily_budget_amount_local_micro={DAILY_BUDGET}&start_time={START_TIME}" /12/accounts/{ADS_ACCOUNT_ID}/campaigns | jq

​
Étape 2 : Créer un line item avec l’objectif « Sales »

Créez un line item associé à la campagne.
  • Champs obligatoires : campaign id (à partir de l’étape 1), product type, placements, objective, goal, entity status, primary web event tag, catalog id, product set id, creative_source, ads_account_id
  • catalog_id et product_set_id se trouvent dans votre Shopping Manager
  • creative_source doit toujours être DYNAMIC_PRODUCT_CREATIVE
  • objective doit toujours être WEBSITE_CLICKS
  • goal doit toujours être WEBSITE_CONVERSIONS
twurl -H ads-api.x.com -d "campaign_id={CAMPAIGN_ID}&product_type={product_type}&placements={PLACEMENTS}&objective=WEBSITE_CLICKS&goal=WEBSITE_CONVERSIONS&entity_status={entity_status}&primary_web_event_tag={WEB_EVENT_TAG}&catalog_id={catalog_id}&product_set_id={product_set_id}&creative_source=DYNAMIC_PRODUCT_CREATIVE" /12/accounts/{ADS_ACCOUNT_ID}/line_items | jq
  • Après cette étape, la campagne sera visible dans l’Ads Manager de X.

​
Étape 3 : Créer une carte DPA

Créez une carte DPA.
  • Paramètres requis : ID de compte publicitaire et URL :
  • L’URL doit commencer par https://twitter.com ; vous pouvez ensuite ajouter tout paramètre UTM supplémentaire, comme dans l’exemple ci‑dessous :
    • https://twitter.com?utm_source=%7B%7Bsite_source%7D%7D
  • En option, vous pouvez choisir le format de votre carte en spécifiant creative_type avec l’une des valeurs suivantes : “CAROUSEL”, “SINGLE”, “COLLECTION”. Si vous ne le spécifiez pas, votre carte sera créée au format carrousel.
twurl -X POST -H ads-api.twitter.com -A "Content-Type: application/json" "/12/accounts/{ADS_ACCOUNT_ID}/dynamic_product_cards" -d '{"url": "{URL}", "creative_type": "{CREATIVE_TYPE}"}' | jq

​
Étape 4 : Créer une Publication

Créez une publication.
  • Paramètres requis : ID du compte Ads, ID de l’utilisateur, URI de carte (de l’étape 3), texte, nom et publicité produit dynamique
  • dynamic_product_ad doit toujours être défini sur true
twurl -X POST -H "https://ads-api.twitter.com" "/12/accounts/{ADS_ACCOUNT_ID}/tweet?as_user_id={USER_ID}1&card_uri=card%3A%2F%2F{CARD_URI}&text={POST_TEXT}&name={POST_NAME}%201&dynamic_product_ad=true" | jq

​
Étape 5 : Associer la publication à l’élément de campagne

Associez la publication à l’élément de campagne.
  • Paramètres requis : id du compte publicitaire, id de l’élément de campagne (à partir de l’étape 2) et id du Tweet (id_str à partir de l’étape 4)
twurl -X POST -H "https://ads-api.twitter.com" "/12/accounts/{ADS_ACCOUNT_ID}/promoted_tweets?line_item_id={line_item_id}&tweet_ids={tweet_id}" | jq
Si les annonceurs souhaitent voir la carte dans l’interface, elle y sera également disponible.