サードパーティの Pixel サービス

サードパーティのピクセル サービスを使用すると、サードパーティのクリエイティブ ピクセルをアップロードおよび変更し、広告主またはクリエイティブに添付することができます。 メンバーにサード パーティのクリエイティブ ピクセルを添付することもできます。

REST API

JSON フィールド

例

特定のサードパーティ ピクセルを表示する

この例では、ID 123を持つサードパーティのピクセルを表示します。

$ curl -b cookies -X GET 'https://api.appnexus.com/thirdparty-pixel?id=123'
 
{
    "thirdparty-pixel":{
        "id":123,
        "active":true,
        "member_id":456,
        "advertiser_id": 789,
        "format":"raw-js",
        "content":"var img = new Image(); img.src="https://url.com/event/js?self=" + data;"
        "url":null,
        "secure_url":null,
        "members":null,
        "advertisers":[{"id":789}], 
        "creatives":null
        "audit_status":"unaudited" // admin only
        "supply_exceptions":[
            {"name":"AdX"},
        ]
        "adservers":[
            {"id":123}
        ]
  }
}

新しいサードパーティ ピクセルを追加する

この例では、ID 123 を持つ新しいセルサイドのサードパーティ ピクセルを作成します。 API に渡した JSON ファイルではピクセルの親オブジェクトが指定されていないため、親オブジェクト情報が "null" であることに注意してください。

$ cat thirdparty-pixel.json
{
  "thirdparty-pixel":
    {
      "format":"url-html",
      "secure_url":"https://secureurl.com"
    }
}  

$ curl -b cookies -c cookies -X POST -d @thirdparty_pixel 'https://api.appnexus.com/thirdparty-pixel'

{
    "response":{
        "status":"OK",
        "count":1,
        "id":123,
        "start_element":0,
        "num_elements":100,
        "thirdparty-pixel":{
            "id":123,
            "active":true,
            "name":null,
            "member_id":456,
            "advertiser_id":789,
            "publisher_id":null,
            "format":"url-html",
            "audit_status":"pending",
            "created_on":"2014-11-05 19:51:44",
            "last_modified":"2014-11-05 19:51:44",
            "url":null,
            "secure_url":"https://secureurl.com",
            "members":null,
            "advertisers":null,
            "publishers":null,
            "creatives":null,
            "supply_exceptions":null,
            "adservers":null
       
    }
}

サードパーティのピクセルを更新する

この例では、サードパーティのピクセルを ID 123 で更新し、所有している広告主のすべてのクリエイティブに適用します。

$ cat pixelupdate.json

{
  "thirdparty-pixel":
    {
      "advertisers":[{"id":789}]
    }
}  

$ curl -b cookies -c cookies -X PUT -d @pixelupdate 'https://api.appnexus.com/thirdparty-pixel?id=123'

{
   "response":{
      "status":"OK",
      "id":123
   }
}

サードパーティ製ピクセルを削除する

この例では、ID が 123 のサードパーティのピクセルを削除します。

$ curl -b cookies -X DELETE 'https://api.appnexus.com/thirdparty-pixel?id=123'

{
   "response":{
      "status":"OK"
   }
}

関連トピック

• API セマンティクス
• API のベスト プラクティス
• クリエイティブ サービス
• 広告主サービス