Servicio de datos para desarrolladores

Artículo
05/18/2024

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"
    }
  }
}

Compartir a través de