IDENTITY Type サービス

Identity Management Framework の Identity Type サービスを使用して、プラットフォーム内の識別子の取得、作成、更新、削除を行うことができます。 さらに、このサービスを使用すると、所有者は ID ソリューションのアクセス許可を管理できます。 このサービスを使用すると、ID 所有者は次のことができます。

• bidstream 内で識別子を利用することが許可されている発行元を決定します。
• 識別子を使用してデータを組み込むことができるパートナーをプラットフォーム上で決定します。
• 識別子にアクセスできる外部入札者を選択します。
• プラットフォームで、ログ レベルのデータ フィードで識別子の値を受け取る資格があるパートナーを選択します。

REST API

JSON フィールド

管理者専用コントロールを使用した登録フィールド

識別子所有者のマスター コントロール設定

オークション参加制御

他のパブリッシャーがこの識別子を使用できるかどうかを制御し、許可される識別子を指定するためのマスター設定。 要求のこのフィールドは、オークションが有効になっているメンバーの一覧を定義します。 オークションが有効なメンバーは、フレームワーク内の識別子の参加者になります。

対象ユーザーのセグメント化コントロール

識別子を使用して対象ユーザーのセグメント化のために他のメンバーへのアクセス許可を制御するマスター設定。 要求のこのフィールドは、登録済み識別子に対してセグメントオンボードを許可するメンバーの一覧を定義します。

外部入札者コントロール

識別子を外部入札者に送信できるかどうかを制御し、適格な外部入札者を指定するマスター設定。 このフィールドは、新しく登録されたソースと識別子を受け取る入札者の既定のリストを定義します。 既定では、メンバー参加者は識別子レベルで定義された入札者を使用するか、ID タイプの参加者 API を使用してオーバーライドできます。

ログ レベルのデータ公開制御

識別子をログ レベル データ (LLD) で使用できるかどうかを制御し、承認された受信者を決定するマスター設定。 このフィールドは、新しく登録されたソースと識別子の実際の ID 値を LLD フィードに表示できるメンバーの一覧を定義します。 既定では、メンバーの参加者は識別子レベルで定義されたメンバーを使用できます。または、パブリッシャーが参加者サービスを利用して、提供する識別子の採用方法とプラットフォームによる表示方法を追加制御するオプションがある ID 型の参加者 API をオーバーライドできます。

例

識別子を作成する

$ cat new_identifier.json
{
  "identity_type": {
      "source": "test.com",
      "member_owner_id": 958,
      "requires_platform_resolution": true,
      "identity_resolver_check": true,
      "is_auction_usage_single_context": true,
      "is_passthrough": true,
      "requires_seat_resolution": false,
      "requires_rti_partner_match": false,
      "rti_partner": "",
      "is_experimental": false,
      "opt_out_default": false,
      "status": "active",
      "enforce_adx_specification": false,
      "auction_participation_control": {
        "allow_participation": "include_subset",
        "participant_member_list": [
          123,
          456
        ]
      },
      "audience_segmentation_control": {
        "allow_segmentation": "include_subset",
        "segmentation_member_list": [
          456
        ]
      },
      "external_bidder_control": {
        "allow_bidders": "all",
        "external_bidder_list": [
          111,
          112
        ]
      },
      "lld_exposure_control": {
        "lld_exposure_allowed": "include_subset",
        "exposure_member_list": [
          311,
          312
        ]
      }
    }
  }
$ curl -b cookie -c cookie -X POST  'https://api.appnexus.com/identity-type'
{
    "response": {
        "status":"OK",
        "id":IDENTITY_ID_001
        }
        }

特定の識別子の詳細を表示する

$ curl -b cookies -c cookies 'https://api.appnexus.com/identity-type?id=IDENTITY_ID_001'
{
  "response": {
    "status": "OK",
    "identity_type": {
        "id": IDENTITY_ID_001,
        "source": "test.com",
        "member_owner_id": 958,
        "requires_platform_resolution": true,
        "identity_resolver_check": true,
        "is_auction_usage_single_context": true,
        "is_passthrough": true,
        "requires_seat_resolution": false,
        "requires_rti_partner_match": false,
        "rti_partner": "",
        "is_experimental": false,
        "opt_out_default": false,
        "status": "active",
        "enforce_adx_specification": false,
        "auction_participation_control": {
          "allow_participation": "include_subset",
          "participant_member_list": [
            123,
            456
          ]
        },
        "audience_segmentation_control": {
        "allow_segmentation": "include_subset",
        "segmentation_member_list": [
          456
         ]
        },
        "external_bidder_control": {
        "allow_bidders": "all",
        "external_bidder_list": [
          111,
          112
         ]
        },
        "lld_exposure_control": {
        "lld_exposure_allowed": "include_subset",
        "exposure_member_list": [
          311,
          312
        ]
      }
    }
  }
}

関連トピック

ID の種類の参加者サービス