外部インベントリ コード サービス

一部の販売者は、パブリッシャー > サイト > の配置よりも詳細にインベントリを分割するために独自のコードを使用します。 外部インベントリ コード サービスを使用すると、このようなコードを Xandr に登録して、広告呼び出しに渡してレポートすることができます。

次に、動作のしくみを示します。

1. このサービスを POST 呼び出して、手順 2 と 3 の前に外部インベントリ コードを Xandr に登録する必要があります。
2. タグベースの広告呼び出しのクエリ文字列のようにコードext_inv_codeを渡すか (以下の例を参照)、または AST の defineTag API または Mobile SDK の API を使用して値を定義extInvCodeします。
3. その後、(このページで説明されている API サービスを介して外部インベントリ コードからマップされた) 外部インベントリ ID/名前を、次のいずれかのレポート/フィード (アクセス権を持つ) でレポートできます。
   • レポート UI の Network Analytics レポート
   • Reporting API を使用した Network Analytics
   • レポート UI の Publisher Analytics レポート
   • Reporting API を使用したネットワーク パブリッシャー分析
   • 一括レポート API を使用した Network Analytics フィード
   • LLD を使用したログ レベルの標準フィード

外部インベントリ コードを含む配置タグの例

<script src="https://ib.adnxs.com/ttj?id=1234&ext_inv_code=ABC" type="text/javascript"></script>

REST API

JSON フィールド

例

特定の発行元の外部インベントリ コードを追加する

$ cat ext_inv_code.json
{
   "external_inv_code": {
      "publisher_id": 103764,
      "code":"55",
      "name":"Code 55"
   }
}
$ curl -b cookies -c cookies -X POST -d @ext_inv_code.json 'https://api.appnexus.com/external-inv-code'
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 102,
        "start_element": 0,
        "num_elements": 100,
        "external_inv_code": {
            "member_id": 1066,
            "id": 102,
            "publisher_id": 103764,
            "name": "55",
            "code": "Code 55"
        }
        }
    }
}

複数の発行元間で使用する外部インベントリ コードの追加

$ cat ext_inv_code.json
{
   "external_inv_code": {
      "publisher_id": 0,
      "code":"74",
      "name":"Code 74"
   }
}
$ curl -b cookies -c cookies -X POST -d @ext_inv_code.json 'https://api.appnexus.com/external-inv-code'
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 102,
        "start_element": 0,
        "num_elements": 100,
        "external_inv_code": {
            "member_id": 1066,
            "id": 103,
            "publisher_id": 0,
            "name": "74",
            "code": "Code 74"
        }
    }
}

外部インベントリ コードの更新

$ cat ext_inv_code_update
{
   "external_inv_code": {
      "name":"Fresh new name"
   }
}
$ curl -b cookies -c cookies -X PUT -d @ext_inv_code_update.json 'https://api.appnexus.com/external-inv-code?id=102'
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": "102",
        "start_element": 0,
        "num_elements": 100,
        "external_inv_code": {
            "member_id": 1066,
            "id": 102,
            "publisher_id": 103764,
            "name": "Fresh new name",
            "code": "Code 5"
        }
    }
}

外部インベントリ コードの削除

$ curl -b cookies -c cookies -X DELETE 'https://api.appnexus.com/external-inv-code?id=102'
{
    "response": {
        "status": "OK"
    }
}