Passer au contenu principal
L’exemple suivant suppose que vous avez installé, configuré et autorisé votre application et votre utilisateur à l’aide de twurl. twurl est un outil en ligne de commande, dans l’esprit de cURL, qui gère efficacement 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 la REST API). Pour afficher les en-têtes complets de la requête et de la réponse, utilisez -t pour tracer l’appel, ce qui est à peu près équivalent à l’option -v de cURL. Pour cet exemple, nous allons créer une campagne Dynamic Product Ads (DPA). Récupérez l’id du compte. 
twurl -H ads-api.x.com /12/accounts/

{
  "request": {
    "params": {}
  },
  "data": [
    {
      "name": "Compte de test pour @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’id de l’instrument de financement.
Appelez l’API GET accounts/:account_id/funding_instruments en utilisant l’id du compte récupéré dans 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.
Indiquez une date/heure de début et un budget pour la campagne.
  • Champs requis : instrument de financement, nom de la campagne, budget (total/quotidien), date/heure de début et id de 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 requis : id de campagne (à partir de l’étape 1), type de produit, emplacements, objectif, objectif secondaire, statut de l’entité, balise d’événement web principale, id de catalogue, id d’ensemble de produits, creative_source, ads_account_id
  • catalog_id et product_set_id se trouvent dans votre gestionnaire d’achats
  • 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 le Gestionnaire de publicités de X.

​
Étape 3 : Créer une carte DPA

Créez une carte DPA.
  • Paramètres requis : id du compte publicitaire et URL :
  • L’URL doit commencer par https://twitter.com ; tout paramètre UTM supplémentaire peut être ajouté ensuite, 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 aucun format n’est spécifié, 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 de compte publicitaire, ID utilisateur, URI de carte (à partir de l’étape 3), texte, nom et publicité pour 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 ligne

Associez la Publication à l’élément de ligne.
  • Paramètres requis : id du compte publicitaire, id de l’élément de ligne (à partir de l’étape 2) et id de la Publication (id_str 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 afficher la carte dans l’interface, elle sera également disponible.