入札者プロフィール - FAQ

構成

特定の販売者の会員IDを見つけるにはどうすればよいですか?

公開されている販売者メンバー ID はすべて、プラットフォームメンバーサービスを通じて取得できます。

入札者プロフィールを設定する方法

入札者プロファイル (従来の入札者プロファイルサービス) を設定する唯一の正しい方法はありませんが、フィルター処理に使用するフィールドに関するベストプラクティスについては、以下を参照してください。これらは親レベルまたは子レベルのいずれかで使用できることに注意してください。

販売メンバーによるフィルター処理
- member_targets配列は、購入方法に応じて設定する必要があります。
  - 一部の販売者のセットのみを購入する場合:
    - "member_targets": [{"id": "100","action": "include"},{"id": "101","action": "include"},{"id": "102","action": "include"}]
  - 一部の販売者グループを除外する:
    - "member_targets": [{"id": "100","action": "exclude"},{"id": "101","action": "exclude"}]
国によるフィルター処理
- "country_action" パラメーターを使用してグローバルな "include" または "exclude" を設定します。
- "country_targets" 配列に含めるか除外する国または地域をオブジェクトとして追加します。
  - "country_targets": [{"country": "GB"},{"country": "US"},{"country": "DE"}]
セグメントによるフィルター処理
- "segment_boolean_operator" パラメーターを "and または "or" に設定します。
- フィルターとして使用するセグメントを segment_targets パラメーターに追加します。
  - "segment_targets": [{"id": "100","action": "include"},{"id": "101","action": "include"}]
サイズによるフィルター処理
- 入札者がクリエイティブを持っているクリエイティブサイズのリストを含めます。クリエイティブサイズでフィルター処理することを選択した場合は、このリストを網羅する必要があります。
  - "size_targets":[{"width": "100","height": "200"},{"width": "100","height": "200"}]
ドメインリストによるフィルター処理
- ドメインの一覧を含めるまたは除外する。これらは、 Domain List Service を使用して作成されます。
  - "domain_list_target":[{"id":1}, {"id":2}]
  - "domain_list_action":"include"

販売者分類の在庫属性によるフィルタリング

このオプションを使用すると、機密属性で分類されたインベントリをオプトインできます。 "use_inventory_attribute_targets" が true に設定されている場合、入札者は、inventory_attribute_targets 配列にリストされているインベントリ属性で分類されたインベントリと、すべての未分類インベントリからトラフィックを受け取ります。

たとえば、ツールバーとして分類されたインベントリを除くすべてのインベントリから入札リクエストを受け取りたい場合、入札者プロファイルを調整して次の情報を含める必要があります。

"use_inventory_attribute_targets": true,
"inventory_attribute_targets": [
            {
                "id": 2,
                "name": "Political"
            },
            {
                "id": 4,
                "name": "Social media"
            },
            {
                "id": 6,
                "name": "Photo & video sharing"
            },
            {
                "id": 8,
                "name": "Forums (moderated)"
            },
            {
                "id": 10,
                "name": "Forums (unmoderated)"
            },
            {
                "id": 12,
                "name": "Incentivized clicks"
            },
            {
                "id": 14,
                "name": "Non-english languages"
            },
            {
                "id": 16,
                "name": "Streaming media"
            }
        ]

一般的な注意事項
- 配列に任意の項目を含めたら、明示的に追加された項目のみが送信されるため、表示したくない項目を除外する必要はありません。
- 含めるターゲットが設定されていない場合は、アクションを "含める" に設定しないでください。たとえば、要素がない場合は country_actioncountry_targets 含めないでください。

親子プロファイル

同時に入札者に割り当てることができる親プロフィールは 1 つ、子プロフィールは 5 つだけです。

子供用プロフィールは必須ですか?

その必要はありません。子プロフィールが存在しない場合は、親プロフィールに一致するすべてのインプレッションが入札元に送信されます。

親プロフィールは必要か?

その必要はありません。親プロフィールが存在しない場合、いずれかの子プロフィールに一致するすべてのインプレッションが入札者に送信されます。親プロフィールが無く、子プロフィールもない場合、すべてのインプレッションが入札者に送られます。

注:

親プロファイルが存在しない場合、ビッダー構成要素 bid_percent は無視されます。

親子のプロフィールを設定するにはどうすればよいですか?

このプロセスにはいくつかの手順があります。 1 つ目は、どのロジックを使用するかを決めることです。ベストプラクティスに関する質問がある場合は、この FAQ の残りの部分を読み、アカウントの担当者にお問い合わせください。この例では、1 つの親プロファイルと 2 つの子プロファイルを使用します。親プロファイルはセグメントでフィルター処理され、各子プロファイルには販売者メンバーと地域の組み合わせが含まれます。

最初の手順は、プロファイル自体を作成することです。プロファイルは、従来の入札者プロファイルサービスを使用して作成できる Xandr プラットフォーム上のオブジェクトです。以下のサンプルは、 POST でプロファイルを作成するために使用できます。

{"profile":{
 "segment_targets": [{"id":"12345","action":"include"}]}}

これにより、Xandr のプロファイル ID が返されます。このプロファイルの ID は 100 であると想定します。次は、子プロファイルを作成する必要があります。次の 2 つのコードサンプルは、入札者プロファイルサービスへの POST で使用できます。

{"profile":{
 "country_action":"include",
 "country_targets": [{"country":"US"},{"country":"CA"}],
 "member_targets": [{"id":1000, "action":"include}]}}

and

{"profile":{
 "country_action":"include",
 "country_targets": [{"country":"US"}],
 "member_targets": [{"id":2000, "action":"include}]}}

これら 2 つのプロファイルが作成され、それぞれ 101 と 102 の ID が付与されていると仮定します。入札者 15 の場合は、入札者サービスを使用して入札者を更新する必要があります。 PUTで以下を使用して、プロフィール 100 の親プロフィールとプロフィール 101 と 102 の子プロフィールを持つように入札者を次のように更新できます。

{"bidder":{
 "id":15,
 "parent_profile_id":100,
 "child_profiles":[{"id":101},{"id":102}]
}}

お子様のプロフィールを設定する操作方法

従来の入札者プロファイルサービスを使用して、子プロファイルにするプロファイルを作成します。各プロファイルには ID があります。ビッダーサービスのchild_profilesを更新して、すべての子プロファイル (例: [{"id":123},{"id":456},{"id":789}]) を指定するオブジェクトの完全な配列を持つようにします。ビッダーサービス内の child_profiles を更新するたびに、子プロファイルにする ID の完全なリストを指定する必要があります。

親プロフィールを設定する操作方法

従来の入札者プロファイルサービスを使用して、親プロファイルにするプロファイルを作成します。これにより、その特定のプロファイルの ID が返されます。作成したプロファイルの ID を使用するように、入札者サービスのparent_profile_idを更新します。

親子のプロフィールはどのように設定すればよいですか?

これは、ビジネスロジックによって異なります。一般的な例を次に示します。

セットアップ 1 - 親レベルでセグメントと国または地域でフィルター処理し、子レベルで販売者固有の制限を含めます。
- 親プロファイル: セグメント 1 とセグメント 2 を含めます。国または地域 A、B、C、D を含みます。
- お子様のプロフィール 1: 販売者 E を含める;include domain list F;B と C の国または地域を含みます。
- 子プロファイル 2: 販売者 F、G を含め、ドメインリスト H を除外します。すべての国または地域を許可します。
- お子様のプロフィール 3: 出品者 I、J、K を含む。国または地域 A と D を含み、ドメインリスト L を含めます。
セットアップ 2 - 国または地域でフィルター処理し、親レベルで販売者を除外します。
- 親プロファイル: 国または地域 A、B、C を含む;販売者 D と E を除外します。
- お子様のプロフィールは許可されません。
セットアップ 3 - ドメインリストのみでフィルター処理します。
- 親プロファイル: ドメインリスト A を含めます。
セットアップ 4 - ユーザーはセグメント 1 またはセグメント 2 のいずれかに存在する必要があります。除外セグメント 3 (以前に変換したユーザーなど) もあります。ユーザーはそのセグメントに含まれてはいけません。
- 親プロファイル: セグメントブール演算子 OR。セグメント 1 を含め、セグメント 2 を含めます。
- お子様のプロフィール: セグメント 3 を除外します。

親プロファイルと子プロフィールの関係は何ですか?

インプレッションが親プロファイルを通過した場合、次の場合に入札者に送信されます。

お子様のプロフィールはありません。
または、少なくとも 1 つの子プロファイルでインプレッションの送信が許可されています。

インプレッションが親プロファイルによってブロックされている場合、子プロファイルによって明示的に許可されていても、入札者には送信されません。この関係は、次のブール論理で要約できます: Parent AND (Child-1 OR Child-2 OR ...OR Child-n)

入札者プロフィールの更新

入札者プロファイルを変更するにはどうすればよいですか?

入札者プロフィールを更新するには、入札者プロフィールサービスを PUT 呼び出します。 PUT呼び出しには、次のもののみを含める必要があります。

プロファイルの ID。
また、変更するフィールドも選択します。変更したフィールドに必要な値を含める必要があります。配列を変更する場合、これは、変更後の配列のすべての値を PUTで送信する必要があることを意味します。

Last updated on 2026-08-18