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
.
Todos los cambios descritos en esta sección solo están presentes en la versión 1.16.
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.
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.
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.
Se están realizando los siguientes cambios en creative service:
- El
thirdparty_page_id
campo está ahora dentro delthirdparty_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
ymedia_subtype
ya no funcionarán. Ahora se requiere un valor distinto de NULLid
en eltemplate
objeto para cualquieraPUT
oPOST
.
Se están realizando los siguientes cambios en el servicio de perfil del licitador heredado.
El inventory_source_targets
campo se está quitando:
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.
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
.
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
.
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
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.
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:
- Create un informe mediante
POST
la implementación de JSON en el servicio de informes. Esto devuelve un identificador de informe. - Compruebe el estado del informe realizando una
GET
solicitud al servicio mediante el identificador de informe que recibió en el paso 1. - 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 . - 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.
El 16 de junio de 2015 se está quitando.
Estamos actualizando nuestra solicitud de puja para quitar los campos siguientes:
inventory_class
inventory_source_id
Los cambios de esta sección se aplican a la versión 1.15 de la API.
El servicio Deal From Package permite a los compradores crear una oferta a partir de un paquete existente.