次の方法で共有

開発者データ サービス

  • [アーティクル]

注:

このサービスは現在、限られた一連のクライアントと Microsoft の従業員のみが利用できます。

開発者データ サービスは、API オブジェクトに関するデータを追加するために使用されます。 Developer Data Service は柔軟性が高く、開発者は、ユーザーがオブジェクトに再度アクセスするときに役立つ可能性のあるものを格納できます。 このサービスの使用方法の例を次に示します。

  • Xandr はそれを使用して、広告配信で使用されていないユーザーにデータを格納します (たとえば、ユーザーが特定の通知を表示または却下した場合など)。
  • Xandr は、ユーザーがキャンペーンを作成する際に特定のキャンペーンの状態を追跡するために使用します。

Developer Data Service に書き込むには、次の手順を実行する必要があります。

  • は、有効で認証された開発者である必要があります。

  • は、データを追加するオブジェクトを所有します。

  • と object_id の一意の組み合わせのデータをobject_type追加します (たとえば、プロファイル 1234 のデータ セットを 1 つだけ追加できます)。

  • データ オブジェクトを 500 文字以下に制限します。

  • ユーザーに切り替えることができます。

    注:

    をコマンド ラインまたはオブジェクト JSON に渡 developer_id してサービスに書き込むことはできません。 ユーザーに切り替える必要があります。

Developer Data Service は、次のオブジェクトでのみ使用できます。

  • Creative
  • Profile
  • Segment
  • Member

REST API

HTTP メソッド エンドポイント 説明
POST https://api.appnexus.com/developer-data 新しい開発者データを追加する
PUT https://api.appnexus.com/developer-data 既存の開発者データを変更する
GET https://api.appnexus.com/developer-data?id=ID

https://api.appnexus.com/developer-data?object_id=OBJECT_ID		 特定の開発者データを表示する
GET https://api.appnexus.com/developer-data すべての開発者データを表示する
DELETE https://api.appnexus.com/developer-data 開発者データを削除する
GET https://api.appnexus.com/developer-data/meta フィルター処理および並べ替え可能なフィールドを確認する

JSON フィールド

フィールド 種類 説明
id int 開発者データ オブジェクトの ID。
既定値: 自動生成された数値。
object_id int データを追加するオブジェクトの ID。
必須:POST 、、PUT。DELETE
既定値: N/A
object_type string データを追加するオブジェクトの種類。 使用可能な値:
- creative
- profile
- segment
- member

必須:POST 、、PUT。DELETE
既定値: N/A
data string オブジェクトに追加されるデータ。 オブジェクトとして書式設定する必要があります。
既定値: N/A
注: 500 文字未満にする必要があります。

注:

次の表は、Xandr 従業員向けです。

フィールド 種類 説明
developer_id string 管理のみ。 開発者の ID。
既定値: 自動生成された数値

例

新しい開発者データを追加する

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

すべての開発者データを表示する

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

特定の開発者データを表示する

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