Compartir a través de


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 y object_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, , PUTDELETE
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, , PUTDELETE
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"
    }
  }
}