Commandes d’insertion et éléments de ligne

Une fois que l’annonceur est correctement configuré, nous pouvons commencer à créer la hiérarchie côté vente.  

Ordre d’insertion

Pour démarrer la hiérarchie, un ordre d’insertion doit d’abord être créé. Pour toute commande d’insertion, vous devez fournir les informations suivantes :

• ID de l’annonceur ("advertiser_id").
• Nom ("name").
• Dates de vol ("start_date" et "end_date") - Facultatif.
• Budget ("lifetime_budget", , "daily_budget""lifetime_budget_imps", "daily_budget_imps") - Facultatif.
• Rythme () :"enable_pacing"facultatif.
• Devise () :"currency"facultatif (valeur par défaut définie au niveau de l’annonceur).

Exemple d’ordre d’insertion

Créez un fichier contenant JSON et ajoutez les valeurs correctes. Les champs nécessaires incluent l’ID et le nom de l’annonceur.

$ cat insertion_order
{
  "insertion-order": {
    "name": "Q1 2011",
    "advertiser_id": 1234,
    "lifetime_budget": 10000,
    "daily_budget": 1000,
    "enable_pacing": true,
    "currency": "USD"
  }
}

Ensuite, pour créer l’ordre d’insertion, envoyez une POST requête à l’API.

$ curl -b cookies -c cookies -X POST --data-binary @insertion_order 'https://api.appnexus.com/insertion-order?advertiser_id=1234'
{
   "response":{
      "status": "OK",
      "id": 53
   }
}

Cette opération retourne l’ID de l’ordre d’insertion (dans ce cas, l’ID d’ordre d’insertion est 53). Pour afficher l’ordre d’insertion nouvellement ajouté, envoyez une GET demande au service de commande d’insertion, y compris l’ID de l’annonceur et l’ID de commande d’insertion.

$ curl -b cookies -c cookies 'https://api.appnexus.com/insertion-order?id=53&advertiser_id=1234'
{
  "response": {
    "status": "OK",
    "insertion-order": {
      "id": 53,
      "name": "Q1 2011",
      "code": null,
      "state": "inactive",
      "advertiser_id": 1234,
      "start_date": null,
      "end_date": null,
      "last_modified": "2011-07-13 11:58:03",
      "line_items": null,
      "users": null,
      "timezone": "EST5EDT",
      "lifetime_budget": 10000,
      "lifetime_budget_imps": null,
      "daily_budget": 1000,
      "daily_budget_imps": null,
      "enable_pacing": true,
      "currency": "USD",
      "labels": null,
      "broker_fees": null
    },
    "count": 1,
    "start_element": null,
    "num_elements": null,
    "dbg_info": {
      ...
    }
  }
}

Élément de ligne

Le niveau suivant de la hiérarchie consiste à configurer l’élément de ligne. L’élément de ligne doit être associé à un ordre d’insertion, sinon il ne sera pas servi. Pour n’importe quel élément de ligne, vous devez fournir les détails suivants :

• ID de l’annonceur ("advertiser_id").
• Nom ("name").
• Dates de vol ("start_date" et "end_date") - Facultatif.
• Budget ("lifetime_budget", , "daily_budget""lifetime_budget_imps", "daily_budget_imps") - Facultatif.
• Rythme () :"enable_pacing"facultatif.
• Devise () :"currency"facultatif (valeur par défaut définie au niveau de l’annonceur ou de l’ordre d’insertion).
• Chiffre d’affaires ("revenue_type", "revenue_value"et "pixels").
• ID de l’ordre d’insertion ("insertion_orders[{id}]").

Exemple d’élément de ligne

Créez un fichier contenant JSON et ajoutez les valeurs correctes. Les champs nécessaires incluent l’ID de l’annonceur, le nom et le chiffre d’affaires.

$ cat line-item
{
  "line-item": {
    "name": "Q1 2011 - CPM Revenue",
    "advertiser_id": 1234,
    "lifetime_budget": 7500,
    "daily_budget": 750,
    "enable_pacing": true,
    "currency": "USD",
    "revenue_type": "cpm",
    "revenue_value": 5,
    "insertion_order": [{
        "id": 53
    }]
  }
}

Ensuite, pour créer l’élément de ligne, envoyez une POST requête à l’API.

$ curl -b cookies -c cookies -X POST --data-binary @line-item 'https://api.appnexus.com/line-item?advertiser_id=1234'
{
   "response":{
      "status": "OK",
      "id": 205
   }
}

Cette opération renvoie l’ID de l’élément de ligne (dans ce cas, l’ID d’élément de ligne est 205). Pour afficher l’élément de ligne qui vient d’être ajouté, envoyez une GET demande au service d’élément de ligne, y compris l’ID de l’annonceur et l’ID d’élément de ligne.

$ curl -b cookies -c cookies 'https://api.appnexus.com/line-item?id=205&advertiser_id=1234'
{
  "response": {
    "status": "OK",
    "line-item": {
      "id": 205,
      "code": null,
      "name": "Q1 2011 - CPM Revenue",
      "advertiser_id": 1234,
      "state": "inactive",
      "start_date": null,
      "end_date": null,
      "timezone": "EST5EDT",
      "lifetime_budget": 7500,
      "lifetime_budget_imps": null,
      "daily_budget": 750,
      "daily_budget_imps": null,
      "enable_pacing": true,
      "publishers_allowed": "all",
      "lifetime_spend": null,
      "lifetime_imps": null,
      "daily_spend": null,
      "daily_imps": null,
      "revenue_value": 5,
      "revenue_type": "cpm",
      "pixels": null,
      "insertion_orders": 53,
      "goal_type": "none",
      "goal_value": null,
      "insertion_orders": [
          {
              "id": 53,
              "state": "inactive",
              "code": null,
              ...
           }
      ],
      "goal_pixels": null,
      "last_modified": "2011-07-13 19:17:21",
      "click_url": null,
      "currency": "USD",
      "require_cookie_for_tracking": true,
      "labels": null,
      "advertiser": {
        "id": 1234,
        "name": "Advertiser ABC"
      },
      "broker_fees": null,
      "profile_id": 0,
      "member_id": 123
    },
    "count": 1,
    "start_element": null,
    "num_elements": null,
    "dbg_info": {
      ...
    }
  }
}