従来の Bidder プロファイル サービス

Bidder プロファイルは、リアルタイムの 入札リクエスト を受け取るフィルター条件を作成および管理するために使用されます。 プロファイルを使用すると、不要な入札要求を処理するために必要なリソースを制限できます。 Bidder プロファイル - FAQ を参照してください。

重要事項

• 入札要求が入札者プロファイルに合格するには、入札要求が指定されたフィルター条件をすべて満たす必要があります。
• 入札者には複数のプロファイルを作成できますが、特定の時点で入札者に対してアクティブにできる親プロファイルは 1 つだけです。 Bidder サービスを使用して、入札者に関連付けてプロファイルをアクティブ化します。
• 入札者は常に、入札者に関連付けられているメンバーが所有する在庫に対する入札要求を受け取ります。 この場合、Bidder プロファイルは適用されません。
• データ プロバイダーの入札者は、親プロファイルを 1 つだけ持ち、子プロファイルを持つ必要はありません。

サポートされているフィルター条件

現在、次のフィルター条件がサポートされています。

• 販売メンバー
  • メンバーにインベントリを要求するか除外するかを指定するには、 プラットフォーム メンバー サービスに関するページを参照してください。

• 地理
  • 国
    • 指定した国のセットに対する要求を含める/除外する(OR)
    • 指定した国のセットを除くすべての国の入札要求を受け取ります。
  • Region
    • 指定した一連のリージョンに対する要求を含める/除外する (OR)
    • 指定したリージョンのセットを除くすべてのリージョンの入札リクエストを受け取ります。
  • Dma
    • 指定した DMA のセットに対する要求を含める/除外する(OR)
    • 指定した DMA のセットを除くすべてのリージョンの入札要求を受け取ります。
• インベントリ
  • ドメイン リスト
    • 許可リストまたはブロックリストの要件を満たすインプレッションの要求を含める/除外します。
  • インベントリ属性
    • 特定のインベントリ属性を含むインプレッションに対するリクエストを含める/除外する。
  • 監査の状態
    • Xandr によって監査されていないドメインからの要求を除外します。
• Audience

• セグメントのターゲット設定

  • セグメントのターゲット条件を満たすユーザーの要求を含める/除外します。

• クリエイティブ サイズ

  • 指定したクリエイティブ サイズのセットに対する入札要求を含める/除外します。

• 供給の種類 (web/mobile_app/mobile_web)

  • 通常の Web アプリとモバイル アプリのインプレッションを含める/除外する。

REST API

JSON フィールド

国のターゲット

配列内の country_targets 各オブジェクトには、次のフィールドが含まれています。

国のターゲット: 例

{
    "profile": {
        "country_action": "include",
        "country_targets": [
            {
                "id": 233,
                "name": "United States",
                "code": "US"
            }
        ]
    }
}

リージョンターゲット

配列内の region_targets 各オブジェクトには、次のフィールドが含まれています。

リージョン ターゲット: 例

{
    "profile": {
        "region_action": "include",
        "region_targets": [
            {
                "id": 1
                                "name": "New York",
                                "code": "NY",
                "country_name": "United States",
                                "country_code": "US"
            }
        ]
    }
}

都市のターゲット

配列内の city_targets 各オブジェクトには、次のフィールドが含まれています。

市区町村のターゲット: 例

{
    "profile": {
        "city_action": "include",
        "city_targets": [
            {
                "id": 123,
                "name": "Queens",
                "region_name": "New York",
                "region_code": "NY",
                "country_code": "US",
                "country_name": "United States",
            }
        ]
    }
}

認証トークン

API Services を使用する場合、認証は常に最初の手順です。 認証トークンは、後で使用するために Cookie ファイルに書き込むことができます。 詳細な手順については、「 認証サービス」を参照してください。

例

bidder 6 に新しいプロファイルを追加する

新しいプロファイルの ID は 123 です。

$ cat bidder_profile:
    {
    "profile":
        {
        "description": "Only Alberta (NO US can be included)",
        "country_action": "include",
        "country_targets": [{"id": 1},{"ide":2}],
        "region_action": "exclude",
        "region_targets": [{id: 1}],
        "member_targets": [
           {
             "id": "100",
             "action": "exclude"
           },
           {
             "id": "102",
             "action": "exclude",
             "name": "Inventory name 2"
           }
        ],
        "dma_targets": [{"dma":123}, {"dma":124}],
        "dma_action": "exclude",
        "segment_boolean_operator": "and",
        "segment_targets": [
         {
          "id": "16808",
          "name": "Users meeting certain criteria",
          "action": "include",
          "start_minutes": null,
          "expire_minutes": null,
          "other_less": null,
          "other_greater": null,
          "other_equals": null
         },
         {
          "id": "16809",
          "name": "Users that have seen an ad for this campaign and should not be targeted for 2 days",
          "action": "exclude",
          "start_minutes": null,
          "expire_minutes": "2880",
          "other_less": null,
          "other_greater": null,
          "other_equals": null,
         }
        ],
        "size_targets": [{"width":300,"height":250},{"width":600,"height":160}]
        }
    }
    $ curl -b cookies -c cookies -X POST --data-binary @bidder_profile "https://api.adnxs.com/profile/6"
    {
    "response":
       {
         "status":"OK",
         "id":"123"
       }
    }

bidder 6 に現在関連付けられているすべてのプロファイルを表示する

curl -b cookies -c cookies "https://api.adnxs.com/profile/6"

bidder 6 に関連付けられているプロファイル 123 を表示する

curl -b cookies -c cookies "https://api.adnxs.com/profile/6/123"

入札者のプロファイルをアクティブ化するには、 Bidder Service を使用して、入札者のフィールドを目的の入札者プロファイルの ID に設定 profile_id します。

bidder 6 でプロファイル ID 123 を更新する

$ cat bidder_profile:
    {
    "profile":
        {
        "id": "123",
        "country_action": "include",
        "country_targets": [{"id": 233}]
        }
    }
    $ curl -b cookies -c cookies -X PUT --data-binary @bidder_profile "https://api.adnxs.com/profile/6/123"

入札者プロファイルにドメイン リストを "ブロックリスト" として追加する

$ cat domain-list-profile
{
   "profile" : {
      "domain_list_targets" : [
         {
            "id" : 9351
         }
      ],
      "domain_list_action" : "exclude",
      "id" : 431739
   }
}
$ curl -b cookies -c cookies -X PUT --data-binary @domain-list-profile 'https://api.adnxs.com/profile/497/431739'
{
   "response" : {
      "count" : 1,
      "num_elements" : null,
      "id" : "431739",
      "profile" : {
         "supply_type_targets" : null,
         "browser_targets" : null,
         "id" : 431739,
         "dma_targets" : null,
         "screen_size_targets" : null,
         "inventory_attribute_targets" : null,
         "device_type_targets" : null,
         "dma_action" : "exclude",
         "operating_system_targets" : null,
         "domain_list_targets" : [
            {
               "id" : 9351,
               "deleted" : false,
               "type" : "black",
               "description" : "Rich's awesome domain list (blocklist)",
               "name" : "Rich's awesome domain list (blocklist)"
            }
         ],
         "session_freq_type" : "platform",
         "operating_system_family_targets" : null,
         "domain_targets" : null,
         "venue_targets" : null,
         "description" : "Ethical Ad Blocker Test Segment",
         "city_targets" : null,
         "age_targets" : null,
         "domain_action" : "exclude",
         "inventory_action" : "exclude",
         "site_targets" : null,
         "size_targets" : [
            {
               "width" : 300,
               "height" : 50
            },
            {
               "width" : 300,
               "height" : 250
            }
         ],
         "location_target_radius" : null,
         "language_action" : "exclude",
         "ip_targets" : null,
         "segment_targets" : [
            {
               "deleted" : false,
               "other_greater" : null,
               "name" : "ethical ad blocker segment 00",
               "code" : "ethical-adblock-00",
               "other_less" : null,
               "expire_minutes" : null,
               "action" : "include",
               "other_in_list" : null,
               "id" : 110944,
               "other_equals" : null,
               "start_minutes" : null
            }
         ],
         "is_expired" : false,
         "region_action" : "exclude",
         "location_target_latitude" : null,
         "code" : "ethical-adblock-00",
         "inventory_group_targets" : null,
         "country_action" : "exclude",
         "querystring_targets" : null,
         "carrier_targets" : null,
         "member_id" : null,
         "passthrough_percent" : 100,
         "segment_boolean_operator" : "or",
         "intended_audience_targets" : null,
         "operating_system_extended_targets" : null,
         "device_model_action" : "exclude",
         "language_targets" : null,
         "gender_targets" : null,
         "non_audited_url_action" : "include",
         "inventory_network_resold_targets" : null,
         "supply_type_action" : "exclude",
         "daypart_targets" : null,
         "daypart_timezone" : null,
         "postal_code_targets" : null,
         "querystring_boolean_operator" : "and",
         "last_activity" : "2015-03-30 21:25:41",
         "member_targets" : [
            {
               "action" : "include",
               "billing_name" : "unexposed",
               "id" : 4782,
               "third_party_auditor_id" : null
            }
         ],
         "browser_family_targets" : null,
         "screen_size_action" : "exclude",
         "min_session_imps" : null,
         "device_model_targets" : null,
         "querystring_action" : "exclude",
         "segment_group_targets" : null,
         "country_targets" : null,
         "city_action" : "exclude",
         "domain_list_action" : "exclude",
         "location_target_longitude" : null,
         "carrier_action" : "exclude",
         "position_targets" : null,
         "use_inventory_attribute_targets" : false,
         "device_type_action" : "exclude",
         "region_targets" : null,
         "browser_action" : "exclude"
      },
      "start_element" : null,
      "status" : "OK"
   }
}

関連トピック

Bidder プロファイル - FAQ