Service de données de développeur

Remarque

Ce service est actuellement disponible pour un ensemble limité de clients et d’employés Microsoft uniquement.

Le service de données du développeur est utilisé pour ajouter des données sur les objets API. Le service de données du développeur est flexible, ce qui permet aux développeurs de stocker tout ce qui peut être utile lorsque l’utilisateur accède à nouveau à l’objet. Voici quelques exemples d’utilisation de ce service :

Xandr l’utilise pour stocker des données sur les utilisateurs non utilisés par la diffusion de publicités (par exemple, si l’utilisateur a vu ou ignoré certaines notifications dans).
Xandr l’utilise pour effectuer le suivi de l’état d’une campagne au fur et à mesure que l’utilisateur crée une campagne.

Pour écrire dans le service de données du développeur, vous devez :

être un développeur valide et authentifié.
possède l’objet pour lequel vous ajoutez des données.
ajouter des données pour une combinaison unique de object_type et object_id (par exemple, vous ne pouvez ajouter qu’un seul jeu de données pour le profil 1234).
limiter l’objet de données à 500 caractères ou moins.
être basculé dans un utilisateur.

Remarque

Vous ne pouvez pas écrire dans le service en passant le developer_id via la ligne de commande ou dans l’objet JSON. Vous devez être basculé dans un utilisateur.

Le service de données du développeur est disponible uniquement pour les objets suivants :

Creative
Profile
Segment
Member

API REST

HTTP, méthode	Endpoint	Description
`POST`	`https://api.appnexus.com/developer-data`	Ajouter de nouvelles données de développeur
`PUT`	`https://api.appnexus.com/developer-data`	Modifier les données de développeur existantes
`GET`	`https://api.appnexus.com/developer-data?id=ID` `https://api.appnexus.com/developer-data?object_id=OBJECT_ID`	Afficher des données de développeur spécifiques
`GET`	`https://api.appnexus.com/developer-data`	Afficher toutes les données du développeur
`DELETE`	`https://api.appnexus.com/developer-data`	Supprimer les données du développeur
`GET`	`https://api.appnexus.com/developer-data/meta`	Découvrez les champs que vous pouvez filtrer et trier par

Champs JSON

Champ	Type	Description
`id`	int	ID de l’objet de données développeur. Valeur par défaut : nombre généré automatiquement.
`object_id`	int	ID de l’objet auquel vous ajoutez des données. Obligatoire sur : `POST`, `PUT`, `DELETE` Valeur par défaut : N/A
`object_type`	string	Type d’objet auquel vous ajoutez des données. Valeurs possibles : - `creative` - `profile` - `segment` - `member` Obligatoire sur : `POST`, `PUT`, `DELETE` Valeur par défaut : N/A
`data`	string	Données ajoutées à l’objet . Doit être mis en forme en tant qu’objet. Valeur par défaut : N/A Remarque : doit contenir moins de 500 caractères.

Remarque

Le tableau ci-dessous s’adresse aux employés de Xandr.

Champ	Type	Description
`developer_id`	string	Administration uniquement. ID du développeur. Par défaut : nombre généré automatiquement

Exemples

Ajouter de nouvelles données de développeur

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

Afficher toutes les données du développeur

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

Afficher des données de développeur spécifiques

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

Last updated on 2025-10-22

Partager via