広告主サービス

広告主サービスを使用すると、ネットワークは Xandr と対話する広告主を追加、変更、表示できます。 直接マーケティング担当者は、広告主が 1 人 (それ自体) しかないため、広告主サービスを使用することはめったにありません。

REST API

JSON フィールド

サード パーティ製ピクセル

配列には thirdparty_pixels 、次の表のフィールドが含まれています。 これらのフィールドは読み取り専用です。 サードパーティのピクセルを更新または作成したり、広告主が所有するすべてのクリエイティブにサードパーティのピクセルをアタッチしたりするには、 サードパーティの Pixel サービスを使用します。 個々のクリエイティブにサードパーティのピクセルをアタッチするには、 Creative Service を使用します。

統計

オブジェクトは stats 非推奨になりました (2016 年 10 月 17 日現在)。 代わりに Report Service を使用して統計情報を取得します。

ラベル

読み取り専用 ラベル サービス を使用すると、広告主、広告掲載オーダー、広告申込情報、キャンペーン、パブリッシャーの可能なすべてのラベルを表示できます。 このサービスを使用すると、オブジェクトに既に適用されているラベルを表示できます。

改ページ

次のフィールドを使用して、特定の数のオブジェクトを要求できます。

"count": 8,
    "start_element": null,
    "num_elements": null

既定のブランド

依存オブジェクトのタイムゾーン

広告主のタイムゾーンを変更する場合は、子オブジェクト (キャンペーン、広告申込情報、クリエイティブ) に変更を "トリクルダウン" するかどうかを選択できます。 これを行うには、要求中に URL のクエリ文字列を渡 set_child_timezone=true して、タイムゾーンを作成または更新する必要があります。

以下に例を示します。

$ curl -b cookies -X PUT -d @advertiser 'https://api.appnexus.com
/advertiser?id=111&set_child_timezone=true'

• の場合 true、すべての子オブジェクトのタイムゾーンが広告主のタイムゾーンに設定されます。 下位レベルのオブジェクト (挿入注文、広告申込情報、キャンペーンなど) のタイムゾーン設定は、広告主のタイムゾーンでオーバーライドされることに注意してください。
• の場合 false、タイムゾーンは広告主にのみ設定されます。

例

広告主を追加する

$ cat advertiser.json

{
   "advertiser":
   {
      "name":"Advertiser B",
      "legal_entity_name":"Toyota UK",
      "state":"active"
   }
}

$ curl -b cookies -c cookies -X POST --data-binary @advertiser.json 'https://api.appnexus.com/advertiser'

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

広告主を更新する

$ cat advertiser_update

{
   "advertiser":
   {
      "name":"Advertiser B",
      "legal_entity_name":"Toyota UK",
      "state":"active",
      "code":"PSS"
   }
}

$ curl -b cookies -c cookies -X PUT --data-binary @advertiser_update 'https://api.appnexus.com/advertiser?id=51'

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

すべての広告主を表示する

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

{
  "response": {
    "status": "OK",
    "advertisers": [
      {
        "id": 51,
        "code": null,
        "name": "Advertiser B",
        "legal_entity_name":"Toyota France",
        "state": "active",
        "default_brand_id": 0,
        "remarketing_segment_id": null,
        "lifetime_budget": null,
        "lifetime_budget_imps": null,
        "daily_budget": null,
        "daily_budget_imps": null,
        "enable_pacing": true,
        "profile_id": null,
        "thirdparty_pixels": [
          {
            "id":145,
            "name":"sample pixel",
            "audit_status":"pending",
            "active":true
          },
          {
            "id":314,
            "name":"another sample pixel",
            "audit_status":"pending",
            "active":true
          }
        ],
        "control_pct": 0,
        "timezone": "EST5EDT",
        "last_modified": "2010-08-03 23:07:02",
        "stats": null,
        "billing_internal_user": null,
        "billing_address1": "123 Happy Street",
        "billing_address2": "",
        "billing_city": "New York",
        "billing_state": "NY",
        "billing_country": "US",
        "billing_zip": "10011",
        "default_category": null,
        "default_currency": "USD",
        "labels": null,
        "use_insertion_orders": false,
        "time_format": "12-hour",
        "default_brand": null,
        "is_malicious": false
      },
      {
        "id": 493,
        "code": null,
        "name": "Cheese Club",
        "legal_entity_name":"Toyota Germany",
        "state": "active",
        "default_brand_id": 0,
        "remarketing_segment_id": 11111,
        "lifetime_budget": null,
        "lifetime_budget_imps": null,
        "daily_budget": null,
        "daily_budget_imps": null,
        "enable_pacing": true,
        "profile_id": null,
        "thirdparty_pixels":null,
        "control_pct": 0,
        "timezone": "EST5EDT",
        "last_modified": "2010-09-15 21:02:37",
        "stats": null,
        "billing_internal_user": null,
        "billing_address1": null,
        "billing_address2": null,
        "billing_city": null,
        "billing_state": null,
        "billing_country": null,
        "billing_zip": null,
        "default_category": null,
        "default_currency": "USD",
        "labels": null,
        "use_insertion_orders": false,
        "time_format": "12-hour",
        "default_brand": null,
        "is_malicious": false
      }
    ],
    "count": 5,
    "start_element": null,
    "num_elements": null,
    "dbg_info": {
      ...
    }
  }
}

特定の広告主を表示する

$ curl -b cookies -c cookies 'https://api.appnexus.com/advertiser?id=51'

{
    "response":{
        "status":"OK",
        "count":1,
        "start_element":0,
        "num_elements":100,
        "advertiser":{
            "id":51,
            "code":null,
            "name":"Advertiser A",
            "legal_entity_name":"Toyota UK",
            "state":"active",
            "default_brand_id":0,
            "remarketing_segment_id":null,
            "profile_id":null,
            "control_pct":0,
            "timezone":"EST5EDT",
            "last_modified":"2010-05-06 20:21:56",
            "member_id":79,
            "billing_name":null,
            "billing_phone":null,
            "billing_address1":null,
            "billing_address2":null,
            "billing_city":null,
            "billing_state":null,
            "billing_country":null,
            "billing_zip":null,
            "default_currency":"USD",
            "use_insertion_orders":false,
            "time_format":"12-hour",
            "is_malicious":false,
            "billing_internal_user":null,
            "default_category":null,
            "default_brand":null,
            "labels":null,
            "competitive_brands":null,
            "competitive_categories":null,
            "lifetime_budget":null,
            "lifetime_budget_imps":null,
            "daily_budget":null,
            "daily_budget_imps":null,
            "enable_pacing":null,
            "lifetime_pacing":null,
            "lifetime_pacing_span":null,
            "allow_safety_pacing":null,
            "stats":null
      }
   }
}