Pedidos de inserción y elementos de línea

Una vez que el anunciante está configurado correctamente, podemos empezar a crear la jerarquía del lado de la venta.  

Orden de inserción

Para iniciar la jerarquía, primero debe crearse un orden de inserción. Para cualquier orden de inserción, debe proporcionar los detalles siguientes:

• Id. de anunciante ("advertiser_id").
• Nombre ("name").
• Fechas de vuelo ("start_date" y "end_date") - Opcional.
• Budget ("lifetime_budget", "lifetime_budget_imps", "daily_budget", "daily_budget_imps") - Opcional.
• Ritmo ("enable_pacing"): opcional.
• Moneda ("currency"): opcional (valor predeterminado establecido en el nivel de anunciante).

Ejemplo de orden de inserción

Cree un archivo que contenga JSON y agregue los valores correctos. Los campos necesarios incluyen el identificador y el nombre del anunciante.

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

A continuación, para crear el nuevo orden de inserción, envíe una POST solicitud a la 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
   }
}

Esto devuelve el identificador del orden de inserción (en este caso, el identificador del orden de inserción es 53). Para ver el pedido de inserción recién agregado, envíe una GET solicitud al servicio de pedido de inserción, incluidos el identificador del anunciante y el identificador del pedido de inserción.

$ 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": {
      ...
    }
  }
}

Elemento de línea

El siguiente nivel de la jerarquía es configurar el elemento de línea. El elemento de línea debe estar asociado a un pedido de inserción o no servirá. Para cualquier elemento de línea, debe proporcionar los detalles siguientes:

• Id. de anunciante ("advertiser_id").
• Nombre ("name").
• Fechas de vuelo ("start_date" y "end_date") - Opcional.
• Budget ("lifetime_budget", "lifetime_budget_imps", "daily_budget", "daily_budget_imps") - Opcional.
• Ritmo ("enable_pacing"): opcional.
• Moneda ("currency") : opcional (valor predeterminado establecido en el nivel de pedido de inserción o anunciante).
• Ingresos ("revenue_type", "revenue_value"y "pixels").
• Identificador del pedido de inserción ("insertion_orders[{id}]").

Ejemplo de elemento de línea

Cree un archivo que contenga JSON y agregue los valores correctos. Los campos necesarios incluyen el identificador del anunciante, el nombre y los ingresos.

$ 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
    }]
  }
}

A continuación, para crear el nuevo elemento de línea, envíe una POST solicitud a la 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
   }
}

Esto devuelve el identificador del elemento de línea (en este caso, el identificador de elemento de línea es 205). Para ver el elemento de línea recién agregado, envíe una GET solicitud al servicio de artículos de línea, incluidos el identificador del anunciante y el id. de elemento de línea.

$ 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": {
      ...
    }
  }
}