Leer en inglés

Compartir a través de


16 de junio de 2015

Nos complace anunciar las siguientes mejoras en la versión 1.16 de la API ImpBus de AppNexus.

Advertencia

Además de las nuevas características, esta versión incluye cambios importantes. Por lo tanto, admitiremos dos versiones de la API durante los próximos 60 días, como se indica en nuestra directiva de cambios importantes .

Versión 1.15: Esta versión no incluye cambios importantes. El https://api.adnxs.com punto de conexión seguirá apuntando a la versión 1.15 durante 60 días. Después de ese tiempo, este punto de conexión apuntará a la versión 1.16.

Versión 1.16: esta versión incluye cambios importantes y nuevas características. Durante los próximos 60 días, para usar esta versión, debe apuntar directamente a ella en las llamadas, por ejemplo, https://api.adnxs.com/v1.16.

Cambios importantes

Todos los cambios descritos en esta sección solo están presentes en la versión 1.16.

Un punto de conexión SSL compatible

A partir de la versión 1.16, el único punto de conexión admitido para los usuarios de la API de ImpBus será (habilitado para SSL). https://api.adnxs.com Ya no se admitirán puntos de conexión HTTP no seguros. Ya no se admitirán otras direcciones URL.

Comprobación de tipos JSON más estricta

La versión 1.16 seguirá convirtiendo automáticamente (convertir) cadenas "enteros" en enteros. Por ejemplo, "123" se seguirá convirtiendo en 123.

Sin embargo, a partir de la versión 1.16, la API ya no advertirá al convertir automáticamente una cadena "que no es de enteros", como "foo" cuando 0 dicha cadena se pasa a un campo que espera un entero. En su lugar, se producirá un error y se producirá un error en la llamada.

Mensajes de error modificados

Los siguientes mensajes de error están cambiando:

  • En cualquier lugar donde aparezca el mensaje "Error occured while processing your request" , se está cambiando para corregir el error ortográfico en "occurred". El nuevo mensaje será "Error occurred while processing your request".
  • Si se produce un error en una transacción de base de datos, el mensaje de error es actualmente "SYSTEM::updating". Estos mensajes se han cambiado para proporcionar más detalles, en función del tipo de error. Los nuevos mensajes son:
    • SYSTEM::DEADLOCK_MAX_ATTEMPTS::A database error occurred. Please try your request again.
    • SYSTEM::DB_UNKNOWN::A database error occurred. Please try your request again.

Servicios modificados

Servicio creativo

Se están realizando los siguientes cambios en creative service:

  • El thirdparty_page_id campo está ahora dentro del thirdparty_page objeto tanto en la solicitud como en la respuesta.
  • Ahora se requiere una plantilla para cada creatividad. Las creatividades configuradas con los elementos que ya estaban en desuso format y media_subtype ya no funcionarán. Ahora se requiere un valor distinto de NULL id en el templateobjeto para cualquiera PUT o POST.

Servicio de perfil de licitador

Se están realizando los siguientes cambios en el servicio de perfil del licitador heredado.

Campos quitados

El inventory_source_targets campo se está quitando:

La región, el país y la ciudad de destino serán por identificador

Estamos cambiando la segmentación basada en la región, el país y la ciudad a destino por identificador. Se están actualizando los campos siguientes.

Destinos de país

El country_targets campo se pasará mediante identificadores como se indica a continuación:

"country_targets": [
    {
        "id": 1 // id of US
    },
    {
        "id": 2 // id of AS
    }
]

Además, el contenido de este campo en respuesta a una GET llamada se convertirá en:

"country_targets": [
        {
          "id": 1,
          "name": "United States",
          "code": "US"
        }
      ]

Para ver una lista de todos los países disponibles para la selección de destino, realice una GET solicitud a https://api.adnxs.com/country/meta.

Destinos de región

El region_targets campo se pasará mediante identificadores como se indica a continuación:

"region_targets": [
    {
        "id": 1 // ID of NJ region in US
    },
    {
        "id": 2 // ID of NY region in US
    }
]

Además, el contenido de este campo en respuesta a una GET llamada se convertirá en:

"region_targets": [
       {
          "id": 1,
          "name": "New York",
          "code": "NY",
          "country_name": "United States",
          "country_code": "US"
        }
      ]

Para obtener una lista de las regiones admitidas, puede comprobar la meta Servicio de región realizando una GET solicitud a https://api.adnxs.com/region/meta.

Destinos de ciudad

El city_targets campo cambiará ligeramente a lo siguiente ("region_id", un entero, se va a reemplazar por "region_code", una cadena):

"city_targets": [
       {
          "id": 123,
          "name": "Queens",
          "region_name": "New York",
          "region_code": "NY",
          "country_name": "United States",
          "country_code": "US"
        }
      ]

Para buscar en city service las ciudades que le interesen como destino, llame al servicio con un nombre (o parte de un nombre) como se muestra a continuación. En este ejemplo se buscarán ciudades con la cadena "New" en sus nombres.

curl -bc https://api.``adnxs``.com/city?like_city=New

Servicio de acceso a páginas de terceros

Tipo de campo modificado

En el servicio de acceso a páginas de terceros, el tipo del thirdparty_page_id campo cambia de cadena a entero. Esto es necesario porque Facebook solo acepta valores numéricos en este campo.

Servicio de informes

Nuevo método para recuperar informes

El método para recuperar un informe del servicio de informes está cambiando. A partir de la versión 1.16, el flujo de trabajo cambiará a ser el mismo que el que usa la API de consola. En concreto, los pasos serán:

  1. Create un informe mediante POSTla implementación de JSON en el servicio de informes. Esto devuelve un identificador de informe.
  2. Compruebe el estado del informe realizando una GET solicitud al servicio mediante el identificador de informe que recibió en el paso 1.
  3. Cuando el "execution_status" de la solicitud del paso 2 es "ready", la dirección URL para descargar el informe estará en el "url" campo .
  4. Por último, realizará una GET llamada al servicio de descarga de informes con el contenido del "url" campo para recuperar los datos del informe.

Servicio de descarga de informes

El report-download servicio ahora devuelve encabezados más coherentes y precisos en sus respuestas. Para estas respuestas, no se devuelve ningún json. Los valores devueltos posibles son:

  • 200: Ok.
  • 202: Solicitud de informe aceptada y pendiente de procesamiento.
  • 404: No se proporcionó el identificador del informe.
  • 405: Se solicitó un método no compatible (POST, PUT, DELETE).
  • 410: Purgado; se ha eliminado el informe.
  • 500: Error interno. La API de informes devolvió una respuesta con formato incorrecto, no pudo notificar datos ni ninguna otra excepción no detectada.
Servicio quitado

El 16 de junio de 2015 se está quitando.

Cambios en el protocolo de licitación

Estamos actualizando nuestra solicitud de puja para quitar los campos siguientes:

  • inventory_class
  • inventory_source_id

Cambios no importantes

Los cambios de esta sección se aplican a la versión 1.15 de la API.

Nuevos servicios

Oferta desde el servicio de paquetes

Nuevo servicio

El servicio Deal From Package permite a los compradores crear una oferta a partir de un paquete existente.