Servicio de datos para desarrolladores
Nota:
Este servicio está disponible actualmente para un conjunto limitado de clientes y empleados de Microsoft.
Developer Data Service se usa para agregar datos sobre objetos de API. Developer Data Service es flexible, lo que permite a los desarrolladores almacenar cualquier cosa que pueda resultar útil cuando el usuario vuelva a acceder al objeto. Algunos ejemplos de cómo se puede usar este servicio:
- Xandr lo usa para almacenar datos sobre los usuarios que no usan la publicación de anuncios (por ejemplo, si el usuario ha visto o descartado ciertas notificaciones dentro de ).
- Xandr lo usa para realizar un seguimiento de cierto estado de campaña mientras el usuario está creando una campaña.
Para escribir en developer data service, debe:
ser un desarrollador válido y autenticado.
posee el objeto para el que va a agregar datos.
agregar datos para una combinación única de
object_type
yobject_id
(por ejemplo, puede agregar solo un conjunto de datos para el perfil 1234).restringir el objeto de datos a 500 caracteres o menos.
se cambia a un usuario.
Nota:
No se puede escribir en el servicio pasando a través de
developer_id
la línea de comandos o en el objeto JSON. Debe cambiar a un usuario.
Developer Data Service solo está disponible para los objetos siguientes:
Creative
Profile
Segment
Member
API de REST
Http (método) | Endpoint | Description |
---|---|---|
POST |
https://api.appnexus.com/developer-data |
Adición de nuevos datos para desarrolladores |
PUT |
https://api.appnexus.com/developer-data |
Modificación de datos de desarrollador existentes |
GET |
https://api.appnexus.com/developer-data?id=ID https://api.appnexus.com/developer-data?object_id=OBJECT_ID |
Visualización de datos de desarrollador específicos |
GET |
https://api.appnexus.com/developer-data |
Visualización de todos los datos de desarrollador |
DELETE |
https://api.appnexus.com/developer-data |
Eliminación de datos para desarrolladores |
GET |
https://api.appnexus.com/developer-data/meta |
Averigüe por qué campos puede filtrar y ordenar |
Campos JSON
Campo | Tipo | Description |
---|---|---|
id |
Entero | Identificador del objeto de datos del desarrollador. Valor predeterminado: número generado automáticamente. |
object_id |
Entero | Identificador del objeto al que va a agregar datos. Obligatorio activado: POST , , PUT DELETE Valor predeterminado: N/A |
object_type |
string | Tipo de objeto al que va a agregar datos. Posibles valores: - creative - profile - segment - member Obligatorio activado: POST , , PUT DELETE Valor predeterminado: N/A |
data |
string | Datos que se agregan al objeto . Debe tener formato de objeto. Valor predeterminado: N/A Nota: Debe tener menos de 500 caracteres. |
Nota:
La tabla siguiente es para los empleados de Xandr.
Campo | Tipo | Descripción |
---|---|---|
developer_id |
string | solo Administración. Identificador del desarrollador. Valor predeterminado: número generado automáticamente |
Ejemplos
Adición de nuevos datos para desarrolladores
$ cat developer_data
{
"developer_data": {
"object_id": 10,
"object_type": "profile",
"data": "{\"plugin_ids\":{\"segment\":1}}"
}
}
$ curl -b cookies -X POST -d @developer_data 'https://api.appnexus.com/developer-data'
{
"response": {
"status": "OK",
"count": 6118352,
"start_element": 0,
"num_elements": 1,
"developer-datas": [
{
"id": 1,
"object_id": 10,
"object_type": "profile",
"data": "{\"plugin_ids\":{\"segment\":1}}"
}
]
}
Visualización de todos los datos de desarrollador
$ curl -b cookies 'https://api.appnexus.com/developer-data'
{
"response": {
"status": "OK",
"count": 6118352,
"start_element": 0,
"num_elements": 100,
"developer-datas": [
{
"id": 1,
"object_id": 726837,
"object_type": "profile",
"data": {
"plugin_ids": {
"segment": "2"
},
"usergroup_targeting": null
}
},
{
"id": 3,
"object_id": 735066,
"object_type": "profile",
"data": {
"plugin_ids": {
"segment": "2"
},
"usergroup_targeting": null
}
},
...
],
"dbg_info": {
"instance": "61.bm-hbapi.prod.nym2",
"s1ave_hit": false,
"db": "master",
"awesomesauce_cache_used": false,
"count_cache_used": false,
"warnings": [],
"time": 5967.670917511,
"start_microtime": 1437417138.3324,
"version": "1.15.568",
"s1ave_miss": "no_service_index",
"s1ave_lag": 0,
"member_last_modified_age": 1437417138,
"output_term": "developer-datas"
}
}
}
Visualización de datos de desarrollador específicos
$ curl -b cookies 'http:api.appnexus.com/developer-data?id=3'
{
"response": {
"status": "OK",
"count": 1,
"start_element": 0,
"num_elements": 100,
"developer-data": {
"id": 3,
"object_id": 735066,
"object_type": "profile",
"data": {
"plugin_ids": {
"segment": "2"
},
"usergroup_targeting": null
}
},
"dbg_info": {
"instance": "65.bm-hbapi.prod.nym2",
"s1ave_hit": false,
"db": "master",
"awesomesauce_cache_used": false,
"count_cache_used": false,
"warnings": [],
"time": 44.665098190308,
"start_microtime": 1437418438.3285,
"version": "1.15.568",
"s1ave_miss": "no_service_index",
"s1ave_lag": 0,
"member_last_modified_age": 1437418438,
"output_term": "developer-data"
}
}
}