Partager via

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