次の方法で共有

仲介ネットワーク サービス

  • [アーティクル]

注:

Microsoft 収益化広告サーバーのお客様のみが利用できます。

このサービスは、仲介されたネットワークを作成および管理するために使用されます。 このサービスを使用して、外部ネットワークとの統合を定義します。

REST API

HTTP メソッド エンドポイント 説明
POST https://api.appnexus.com/mediated-network
(+ JSON ペイロード)		 新しい仲介ネットワークを追加する
PUT https://api.appnexus.com/mediated-network?id=ID
(+ JSON ペイロード)		 仲介ネットワークを変更する
GET https://api.appnexus.com/mediated-network 仲介されたすべてのネットワークを表示する
GET https://api.appnexus.com/mediated-network?id=ID 特定の仲介ネットワークを表示する
DELETE https://api.appnexus.com/mediated-network?id=ID 仲介ネットワークを削除する
GET https://api.appnexus.com/mediated-network/meta フィルター処理および並べ替え可能なフィールドを確認する

JSON フィールド

フィールド 種類 説明
id int このネットワークのシステムによって生成された一意の ID。

必須:PUT
name string ユーザーが指定したネットワークの名前。

必須:POST
credentials string 読み取り専用。 ネットワークを安全に識別するシステム生成の一意の値。 資格情報は、 または PUT の後でPOST暗号化され、復号化できません。
advertiser_id int 読み取り専用。 この仲介ネットワークに関連付けられている広告主の一意のシステム生成 ID。
member_id int 読み取り専用。 システム内のすべての広告主オブジェクトは、親メンバーに関連付 けられています。 広告主が記述 advertiser_id したメンバーの一意のシステム生成 ID。 (また、拡張によって、この仲介されたネットワークも同様です)。
active ブール値 アクティブな仲介ネットワークは、オークションでメディアをターゲットにして購入します。

既定値: false
is_data_integration_active ブール値 レポート データが現在、このネットワークのシステムから Microsoft に取り込まれているかどうか。

既定値: false
creative_custom_request_partner_id int この仲介されたネットワークが関連付けられている クリエイティブ カスタム リクエスト パートナー 。

必須:POST
default_bid_currency string このネットワークからの入札に使用する通貨。

既定値: USD
processed_on date 読み取り専用。 この仲介されたネットワークの関連する行項目が、外部ネットワークのレポート システムから取得されたメトリック (収益、imps、クリック数) で更新された日時。
last_modified date 読み取り専用。 仲介されたネットワーク オブジェクトが最後に変更された日時。
network_type string 仲介されたネットワークの種類です。 有効な値は次のとおりです。
- mobile: このネットワークは、モバイル (アプリ内)インベントリの購入に重点を置きます。
- banner: このネットワークは、Web インベントリの購入に重点を置きます。

既定値: mobile

例

仲介ネットワークを追加する

$ cat add-network
{
    "mediated-network": {
        "name": "JMS Test 2",
        "creative_custom_request_partner_id": 1
    }
} 

$ curl -b cookies -c cookies -X POST -d @add-network.json 'https://api.appnexus.com/mediated-network

{
    "response":{
        "status":"OK",
        "count":1,
        "id":371,
        "start_element":0,
        "num_elements":100,
        "mediated-network":{
            "id":371,
            "name":"JMS Test 2",
            "credentials":null,
            "advertiser_id":110692,
            "member_id":4209,
            "active":true,
            "is_data_integration_active":false,
            "creative_custom_request_partner_id":1,
            "default_bid_currency": "USD",
            "processed_on":"1970-01-01 00:00:01",
            "last_modified":"2014-04-28 14:59:11",
            "bid_count":0,
            "network_type":"mobile"
        }
    }
}

仲介ネットワークを更新する

$ cat add-network

{
    "mediated-network": {
        "id": 368,
      "active": false   
    }
}

$ curl -b cookies -c cookies -X PUT -d @update-network.json 'https://sand.api.appnexus.com/mediated-network?member_id=4209' | json-pp

{
    "response":{
        "status":"OK",
        "count":1,
        "id":368,
        "start_element":0,
        "num_elements":100,
        "mediated-network":{
            "id":368,
            "name":"Integration Test TEST1398457680380",
            "credentials":"OlkWxzZaQjVpgMRd\/\/o6cbUgjuNYkrP\/toKzFRdR9gnpQ2upKNhDu5mQrr871RCjBbjsNlyO6hN2fVNg4VV
             LiMix2mrky38F\/M30uEIVo0zQzmVJ8K4Uz0UyLVagVwdsgNPx9sAN0LZD+ZskyXQx6R4dZCjQD9mKHLT+nJ2Usfs=",
            "advertiser_id":110648,
            "member_id":4209,
            "active":false,
            "is_data_integration_active":false,
            "creative_custom_request_partner_id":1,
            "default_bid_currency": "USD",
            "processed_on":"1970-01-01 00:00:01",
            "last_modified":"2014-04-28 14:56:48",
            "bid_count":0,
            "network_type":"mobile"
        }
    }
}

仲介されたすべてのネットワークを表示する

$ curl -b cookies -c cookies 'https://api.appnexus.com/mediated-network

{
    "response":{
        "status":"OK",
        "count":20,
        "start_element":0,
        "num_elements":100,
        "mediated-networks":[
            {
                "id":89,
                "name":"Doubleclick for Publishers",
                "credentials":null,
                "advertiser_id":110021,
                "member_id":4209,
                "active":false,
                "is_data_integration_active":false,
                "creative_custom_request_partner_id":28,
                "default_bid_currency": "USD",
                "processed_on":"1970-01-01 00:00:01",
                "last_modified":"2014-04-18 23:37:01",
                "bid_count":0,
                "network_type":"mobile"
            },
            {
                "id":90,
                "name":"Tim's Custom Network",
                "credentials":null,
                "advertiser_id":110022,
                "member_id":4209,
                "active":false,
                "is_data_integration_active":false,
                "creative_custom_request_partner_id":22,
                "default_bid_currency": "EUR",
                "processed_on":"1970-01-01 00:00:01",
                "last_modified":"2014-04-18 23:37:01",
                "bid_count":0,
                "network_type":"mobile"
            },
            {
                "id":210,
                "name":"Amazon",
                "credentials":null,
                "advertiser_id":110203,
                "member_id":4209,
                "active":false,
                "is_data_integration_active":false,
                "creative_custom_request_partner_id":25,
                "default_bid_currency": "EUR",
                "processed_on":"1970-01-01 00:00:01",
                "last_modified":"2014-04-18 23:32:36",
                "bid_count":1,
                "network_type":"mobile"
            }
      ]
  }
}

特定の仲介ネットワークを表示する

$ curl -b cookies -c cookies 'https://api.appnexus.com/mediated-network?id=368' | json-pp

{
    "response":{
        "status":"OK",
        "count":1,
        "start_element":0,
        "num_elements":100,
        "mediated-network":{
            "id":368,
            "name":"Integration Test TEST1398457680380",
            "credentials":"OlkWxzZaQjVpgMRd\/\/o6cbUgjuNYkrP\/toKzFRdR9gnpQ2upKNhDu5mQrr871RCjBbjsNlyO6hN2fVNg4VVL
             iMix2mrky38F\/M30uEIVo0zQzmVJ8K4Uz0UyLVagVwdsgNPx9sAN0LZD+ZskyXQx6R4dZCjQD9mKHLT+nJ2Usfs=",
            "advertiser_id":110648,
            "member_id":4209,
            "active":true,
            "is_data_integration_active":false,
            "creative_custom_request_partner_id":1,
            "default_bid_currency": "USD",
            "processed_on":"1970-01-01 00:00:01",
            "last_modified":"2014-04-25 20:28:07",
            "bid_count":0,
            "network_type":"mobile"
        }
    }
}

仲介ネットワークを削除する

$ curl -b cookies -c cookies -X DELETE 'https://api.appnexus.com/mediated-network?id=371

{
    "response":{
        "status":"OK",
        "count":1,
        "start_element":null,
        "num_elements":null
    }
}