Bidder プロファイル - FAQ

[アーティクル]
01/16/2025

構成

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

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

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

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

販売メンバーによるフィルター処理
- 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_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_targetsに要素がない場合は、country_actionを含めないようにしてください。

親プロファイルと子プロファイル

一度に入札者に割り当てることができる親プロファイルと子プロファイルは 1 つだけです。

子プロファイルは必要ですか?

いいえ。子プロファイルがない場合は、親プロファイルに一致するすべてのインプレッションが入札者に送信されます。

親プロファイルは必要ですか?

いいえ。親プロファイルがない場合は、いずれかの子プロファイルに一致するすべてのインプレッションが入札者に送信されます。親プロファイルがなく、子プロファイルがない場合は、すべてのインプレッションが入札者に送信されます。

注:

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

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

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

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

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

これにより、Xandr のプロファイル ID が返されます。このプロファイルの ID は 100 であると想定します。次に、子プロファイルを作成する必要があります。次の 2 つのコードサンプルは、bidder プロファイルサービスの 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 の場合は、 Bidder サービスを使用して入札者を更新する必要があります。 PUTで次を使用して、プロフィール 100 とプロファイル 101 と 102 の子プロファイルを持つ親プロファイルを持つよう入札者を更新できます。

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

子プロファイル操作方法設定しますか?

レガシ Bidder プロファイルサービスを使用して、お子様のプロファイルにするプロファイルを作成します。各プロファイルには ID が設定されます。 Bidder Service のchild_profilesを更新して、すべての子プロファイル ([{"id":123},{"id":456},{"id":789}] など) を指定するオブジェクトの完全な配列を作成します。 bidder サービスの child_profiles に対する更新ごとに、子プロファイルにする ID の完全な一覧を指定する必要があります。

親プロファイル操作方法設定しますか?

レガシ Bidder プロファイルサービスを使用して、親プロファイルにするプロファイルを作成します。これにより、その特定のプロファイルの ID が返されます。 Bidder Service のparent_profile_idを更新して、作成したプロファイルの ID を使用します。

親子プロファイルを設定する方法

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

セットアップ 1 - 親レベルのセグメントと国または地域をフィルター処理し、子レベルで販売者固有の制限を含めます。
- 親プロファイル: セグメント 1 とセグメント 2 を含めます。には、国または地域 A、B、C、D が含まれます。
- 子プロファイル 1: 販売者 E を含めます。ドメインリスト 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 のいずれかに存在する必要があります。また、exlcusion セグメント 3 (たとえば、以前に変換したユーザー) もあります。ユーザーはそのセグメントに含まれている必要はありません。
- 親プロファイル: セグメントブール演算子 (OR)。セグメント 1 を含め、セグメント 2 を含めます。
- 子プロファイル: セグメント 3 を除外します。

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

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

子プロファイルはありません。
または、少なくとも 1 つの子プロファイルでインプレッションを送信できます。

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

入札者プロファイルの更新

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

入札者プロファイルサービスに PUT 呼び出しを行うことで、入札者プロファイルを更新できます。 PUT呼び出しには、次のものが含まれている必要があります。

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

次の方法で共有