Configuración del anunciante

Antes de crear cualquier parte de la jerarquía de campañas a través de la API, se recomienda configurar completamente el anunciante primero. La razón es que hay valores predeterminados que se pueden especificar en un nivel de anunciante que se convierten en cascada a objetos secundarios bajo el anunciante.

Hay una serie de parámetros diferentes que se pueden configurar en el nivel de anunciante:

Dirección de facturación

Esta configuración, almacenada en el parámetro del ejemplo siguiente, especifica la dirección de facturación del anunciante. En el json de ejemplo siguiente se muestra cómo establecer este parámetro.

{
  "advertiser": {
    "billing_address1": "123 Main Street",
    "billing_address2": "Floor 4",
    "billing_city": "Smallville",
    "billing_state": "PA",
    "billing_country": "United States",
    "billing_zip": "12345"
  }
  }

Timezone

Este parámetro, almacenado en el "timezone" campo, define la zona horaria predeterminada que se aplicará a los objetos recién creados a menos que se especifique lo contrario en el momento de su creación. Para obtener la lista de zonas horarias válidas, consulte Zonas horarias de API. En el json de ejemplo siguiente se muestra cómo establecer este parámetro.

{
  "advertiser"a: {
    "timezone": "EST5EDT"
  }
  }

Formato de hora

Este parámetro, almacenado en el "time_format" campo, define si las horas se mostrarán en el formato de 12 o 24 horas en los informes. En el json de ejemplo siguiente se muestra cómo establecer este parámetro.

{
  "advertiser": {
    "time_format": "12-hour"
  }
  }

Moneda predeterminada

La moneda predeterminada, como la zona horaria, se aplica a los elementos de línea a menos que se especifique lo contrario al crear esos objetos. En el json de ejemplo siguiente se muestra cómo establecer este parámetro.

{
  "advertiser": {
    "default_currency": "USD"
  }
  }

Uso de pedidos de inserción

Esta configuración, almacenada en el "use_insertion_orders" parámetro , especifica si se deben usar o no pedidos de inserción dentro de este anunciante. En el json de ejemplo siguiente se muestra cómo establecer este parámetro.

{
  "advertiser": {
    "use_insertion_orders": true
  }
  }

Ejemplo de resumen

A continuación se muestra un resumen de los ejemplos JSON anteriores en un único objeto miembro. En este caso, la especificación del anunciante está en un archivo.

$ cat advertiser
{
  "advertiser": {
    "name": "Advertiser ABC",
    "billing_address1": "123 Main Street",
    "billing_address2": "Floor 4",
    "billing_city": "Smallville",
    "billing_state": "PA",
    "billing_country": "United States",
    "billing_zip": "12345",
    "timezone": "EST5EDT",
    "time_format": "12-hour",
    "default_currency": "USD",
    "use_insertion_orders": true
  }
}

Para crear el anunciante, debe POST especificar la API.

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

A continuación, para comprobar que el anunciante se creó correctamente, puede extraerlo de la API mediante el identificador del anunciante.

$ curl -b cookies -c cookies 'https://api.appnexus.com/advertiser?id=1234'
{
  "response": {
    "status": "OK",
    "advertiser": {
      "id": 1234,
      "code": null,
      "name": "Advertiser ABC",
      "state": "inactive",
      "default_brand_id": 0,
      "remarketing_segment_id": null,
      "lifetime_budget": null,
      "lifetime_budget_imps": null,
      "daily_budget": null,
      "daily_budget_imps": null,
      "enable_pacing": true,
      "profile_id": null,
      "control_pct": 0,
      "timezone": "EST5EDT",
      "last_modified": "2011-07-13 14:41:49",
      "stats": null,
      "member_id": 123,
      "billing_internal_user": null,
      "billing_address1": "123 Main Street",
      "billing_address2": "Floor 4",
      "billing_city": "Smallville",
      "billing_state": "PA",
      "billing_country": "United States",
      "billing_zip": "12345",
      "default_category": null,
      "default_currency": "USD",
      "labels": null,
      "use_insertion_orders": true,
      "time_format": "12-hour",
      "default_brand": null
    },
    "count": 1,
    "start_element": null,
    "num_elements": null,
    "dbg_info": {
      ...
    }
  }
}