Bidder プロファイル移行ガイド

[アーティクル]
02/23/2024

Bidder プロファイル (従来のプロファイルサービスと拡張入札者プロファイルの両方) を使用すると、Xandr から受信したトラフィックをフィルター処理できます。このプロファイル移行ガイドは、従来の Bidder プロファイルから拡張入札者プロファイルに設定を移行するのに役立ちます。

注:

このページの手順 4 は、プロファイルの移行に関する破壊的変更メール通信を受信した場合にのみ関連します。そうでない場合は、代わりにアカウントマネージャーに問い合わせてください。

破壊的変更に関する通知: 移行を完了しない場合:

2019 年 10 月 4 日に、拡張入札者プロファイルの入札者が有効になります。この時点で、新しいプロファイルでトラフィックの受信方法が制御され、レガシプロファイルは非推奨になります。この日付より前に拡張入札者プロファイルを更新しない場合、既定では、入札者に在庫制限は設定されません。

移行プロセスの概要

従来の Profile Service API (推奨) または従来の Bidder UI を使用して、現在の状態を取得します。 (0.25~0.5時間)
変更を理解し、ビジネスニーズに基づいてフィルターを再評価します。 (0.5~1時間)
新しい Bidder プラットフォーム UI (推奨) または新しい Bidder Profile Service を使用して、拡張入札者プロファイルを設定します。 (0.5~1時間)
従来のプロファイルの使用から拡張入札者プロファイルへの切り替えを切り替えるには、サポートにお問い合わせください。 (~1営業日)

または API の新しい拡張 Bidder プロファイル構成は、2019 年 5 月 21 日より前に手順 4 を完了するまでトラフィックフローに影響しません。

移行のプロセス

手順 1: 現在の状態を取得する (0.25 ~ 0.5 時間)

現在の状態をチェックするには、2 つの方法があります。従来の UI にはすべてのターゲットパラメーターが表示されない場合があるため、API メソッドをお勧めします。

ヒント

従来の入札者プロファイルにおける親 & 子プロファイル間の関係について

従来の Bidder プロファイルには、親プロファイルと (省略可能) 子プロファイルがあります。 Xandr からの受信トラフィックはすべて、最初に親プロファイルの条件を満たす必要があります。さらに、入札者がアクティブな子プロファイルを持っている場合、トラフィックはいずれかの子プロファイルを通過する必要があります。要約すると、トラフィックはの条件 (Parent Profile) AND (Child Profile 1 OR Child Profile 2 OR ... OR Child Profile N)を満たしたときに送信されます。

例:

親プロファイルに米国を含め、お子様プロファイル 1 にモバイルアプリの供給の種類を含め、お子様プロファイル 2 にモバイル Web サプライの種類を含める場合、入札者は米国モバイルアプリトラフィック (子プロファイル 1 経由) と米国モバイル Web トラフィック (子プロファイル 2 経由) の両方を受け取ります。入札者は、米国デスクトップトラフィックまたは米国以外のトラフィックを受信しません。

詳細については、従来の Bidder プロファイルに関する FAQ を参照してください。

方法 1: API を使用する (推奨)

概要

Bidder Service API: GET bidder/[bidder id]を使用してアクティブなプロファイルオブジェクトを取得します。
すべてのアクティブなプロファイルオブジェクトの場合は、 GET 従来の Bidder Profile Service API を使用して profile/[profile id] を使用します。
結果を要約します。

手順 1.1: Bidder Service API: `GET` bidder/[bidder id] を使用してアクティブなプロファイルオブジェクトを取得する

アクティブな親プロファイル ID がフィールドにあり parent_profile_id 、アクティブな子プロファイル ID が配列内 child_profiles にあります。

リファレンス: 認証サービスと Bidder サービス。

例

-> curl -b cookie -c cookie -s "https://api.adnxs.com/bidder/129" # 129 is a sample bidder ID.
{
    "response": {
        "bidder": {
            ...
            "parent_profile_id": 12345,
            "child_profiles": [
                {
                    "id": 34567
                },
                {
                    "id": 56789
                }
            ],
            ...
        }
    }
}

手順 1.2: すべてのアクティブなプロファイルオブジェクトについて、 `GET` 従来の Bidder Profile Service API を使用した profile/[profile id]

各プロファイルには、アイテムの許可リストまたはブロックリストがあります。通常、メンバー、国などごとに "アクション" と "ターゲット" があります。

"..._action" を "include" または "exclude" に設定できます。
"..._targets" は、販売者メンバー、国などの ID の一覧を持つことができます。

リファレンス: レガシ Bidder プロファイルサービス

手順 1.2: 例

-> curl -b cookie -c cookie -s "https://api.adnxs.com/profile/129/12345" # 129 is a sample bidder id and 12345 is a sample bider profile ID.
{
    "response": {
        "profile": {
            "country_action": "include",
            "country_targets": [
                {
                    "active": true,
                    "code": "US",
                    "id": 233,
                    "name": "United States"
                }
            ],
            ...
        }
    }
}

手順 1.3: 結果を要約する

親 & 子プロファイルロジックを評価することを忘れないでください。トラフィックは、の条件を満たしている場合に (Parent Profile) AND (Child Profile 1 OR Chile Profile 2 OR ... OR Child Profile N)送信されます。

従来の Profile API サービスには、非推奨のフィールドが複数あります。以下の対象フィールドにのみ注目することをお勧めします。このページの[従来の入札者プロファイルフィールドへのマッピング]セクションで、正確なフィールドを確認するためのガイドがあります。

新しい拡張入札者プロファイルを簡単に設定できるように、これらの各フィールドに含まれる属性または除外された属性を一覧表示します。

販売者メンバー
Countries
ドメイン Lists
サイズ
供給の種類
インベントリ属性
既知のユーザーのみ

注:

既知のユーザーのみを聞いている場合は、入札者プロファイルに 0% のパススルー率があります。
監査されていない URL アクション

ヒント

AppNexus Direct とは

従来のプロファイルの設定によっては、Xandr の直接供給が、含まれている販売者メンバーに加えて、プロファイルオブジェクトに含まれる場合があります。詳細については、「外部需要パートナー向けの Microsoft 収益化供給」を参照してください。

新しい Bidder Platform UI では、Xandr の "直接" 交換グループに属している販売者メンバーを確認できます。

ドメインリスト内のドメインをプルする方法

ドメインリスト内のドメインを確認する場合は、ドメインリスト API サービス ( ドメインリストサービス) を使用してリストを取得または編集できます。

方法 2: 従来の入札者 UI を使用する

概要 (方法 2)

各入札者プロファイルの現在のフィルターを参照してください。
結果を要約します。

手順 1.1: 各入札者プロファイルの現在のフィルターを確認する

https://bidder.adnxs.net/に移動し、bidder ユーザーの資格情報を使用してログインします。ログインできない場合は、まず会社の統合チームにチェックし、Xandr サポートにお問い合わせください。

左側の [プロファイル] タブに移動します。親プロファイルの設定を確認できます。

非斜体の子プロファイルは現在アクティブです。子プロファイルをクリックすると、プロファイルの設定が表示されます。

手順 1.2: 結果を要約する

親 & 子プロファイルロジックを評価することを忘れないでください。Xandr からの受信トラフィックはすべて、最初に親プロファイルの条件を満たす必要があります。さらに、子プロファイルが設定されている場合、トラフィックは子プロファイルの 1 つを渡す必要があります。

新しい拡張入札者プロファイルを簡単に設定できるように、これらの各フィールドに含まれる属性または除外された属性を一覧表示します。

販売者メンバー
Countries
ドメイン Lists
サイズ
供給の種類
インベントリ属性
既知のユーザーのみ

注:

既知のユーザーのみを聞いている場合は、入札者プロファイルに 0% のパススルー率があります。
監査されていない URL アクション

ヒント

AppNexus Direct とは

従来の Bidder UI には表示されない場合がありますが、プロファイルを対象とする販売者メンバーに加えて、Xandr の直接供給の販売者メンバーがプロファイルに含まれます。詳細については、「外部需要パートナー向けの Microsoft 収益化供給」を参照してください。

新しい Bidder Platform UI では、Xandr の "直接" 交換グループに属している販売者メンバーを確認できます。

ドメインリスト内のドメインをプルする方法

手順 2: 変更を理解し、フィルターを再評価する (0.5 ~ 1 時間)

拡張 Bidder プロファイルには、次の利点があります。

フラット階層: 親プロファイルモデルと子プロファイルモデルが削除されました。
広告の種類: バナー、ビデオ、ネイティブ、オーディオの 4 種類のメインを簡単にターゲットにできるようになりました。
取引所: 販売者メンバーを Exchange にグループ化し、ターゲット設定を容易にしました。
簡略化されたプロファイル: プロファイルを、ビジネスに関連するフィールドのみに絞り込んでいます。
新しい Bidder プラットフォーム UI: プロファイルを管理および管理するための新しい UI が構築されました。この UI には、2019 年を通じて追加の機能が追加されます。

最初に、拡張入札者プロファイルの変更ログと、拡張入札者プロファイルに関するよく寄せられる質問 (FAQ) を確認してください。

手順 3: 拡張入札者プロファイルを設定する (0.5 ~ 1 時間)

注:

新しい Bidder Profile Service API または新しい Bidder Platform UI での拡張 Bidder プロファイルの設定は、手順 4: Xandr サポートに問い合わせ、2019 年 5 月 21 日より前にバックエンドでスイッチを反転するまで、Xandr からのトラフィックフローには影響しません。

拡張入札者プロファイルを設定するには、2 つの方法があります。 API 経由で新しい Bidder Platform UI を使用することをお勧めします。

Bidder Platform ユーザーインターフェイス (推奨): https://bidder.appnexus.com/login
- Bidder Platform ユーザーインターフェイス
- プロファイル画面
新しい Bidder Profile Service API

拡張入札者プロファイルで複数のプロファイルを使用する

インプレッションは、入札者に送信される 1 つのプロファイルの要件を満たしている必要があります。複数のプロファイルを作成する場合、プロファイル間のロジックは OR です。つまり、次の条件を満たすと、インプレッションが送信されます。 (Profile 1 OR Profile 2 OR ... Profile N).

拡張入札者プロファイルフィールドへのレガシのマッピング

ターゲット	従来の Bidder プロファイル API フィールド	拡張 Bidder プロファイル UI & API フィールド
販売者メンバー/グループ	`member_targets` API のフィールドと `seller_member_group_targets` フィールド	の [Exchange and Members]\(交換とメンバー\) タブ。すべての販売者メンバーが 3 つの Exchange のいずれかに属しており、各 Exchange に属している販売者メンバーを確認できます。 `exchanges`API のフィールド (メンバーレベルの制御の場合は、と `included_members` を交換する配列を使用`excluded_members`します)。
Countries	`country_action` フィールドにはまたは `include` があります `exclude`。 `country_targets` 配列には国のリストがあります。	の [国] タブ。 `countries` API のフィールド。 (およびの下を`targetscountries`使用`action`します。ターゲットの場合は、Country Service から取得した ID を使用します)。
ドメイン Lists	`domain_list_action` フィールドにはまたは `include` があります `exclude`。 `domain_list_targets` array にはドメインリストのリストがあります。ドメインリストサービスを使用して、ドメインを作成、表示、または編集します。	の [ドメイン Lists] タブ (ドメインを編集するには、ドメインリストサービスを使用します)。 `domain_lists` API のフィールド。 (およびの下を`targetsdomain_lists`使用`action`します。ターゲットの場合は、ドメインリストサービスから取得した ID を使用します)。
サイズ (および広告の種類)	`size_targets` 配列 (含めるのみ)。	の [広告の種類] タブ。最初に、[広告の種類] を選択して含めることができます。バナー広告の種類を含める場合は、含めるサイズを選択できます。 `ad_types` API のフィールド。広告の種類ごとに、または `exclude`に`include`設定`action`します。広告の種類の場合 `banner` は、配列にサイズを `sizes` 含めることができます。
供給の種類	`supply_type_action` フィールドにはまたは `include` があります `exclude`。 `supply_type_targets` 配列には、Web、モバイル Web、またはモバイルアプリがあります。	の [供給の種類] タブ。 `supply_types` API のフィールド。 (およびの下を`targetssupply_types`使用`action`します。ターゲットの場合、使用可能な値は`web`、`mobile_web`および `mobile_app`です)。
インベントリ属性	`use_inventory_attribute_targets` は true または false です。 `inventory_attribute_targets` array にはインベントリ属性のリストがあります (含めるのみ)。	の [機密属性] タブ。 `inventory_attributes` API のフィールド。 (アクションは含まれます。ターゲットの場合は、インベントリ属性サービスから取得した ID を使用します)。
既知のユーザーのみを受信する	フィールドに 0 があり、Bidder オブジェクトが true に設定されている`always_send_owned_segments`場合`passthrough_percent`は、既知のユーザーのみをリッスンしています。または、入札者プロファイルに、既知のユーザーのみを対象とするセグメント ID を含めることができます。	メモ：この機能を使用するには、ユーザーの照合に Xandr で/setuid url を使用する必要があります。 [不明なユーザー] トグルイン。除外に設定 `Allow Unknown Users` します。 `user_not_in_segment_action` API のフィールド。をに `exclude` 設定して、既知のユーザーのみをリッスンします。
監査されていない URL アクション	`non_audited_url_action` API のフィールド。	`non_audited_url_action` API のフィールド。

トラフィック量の調整: パススルー率の代替手段

従来の Bidder プロファイルでは、トラフィック量または入札要求 QPS (1 秒あたりのクエリ) を制御するために使用される passthrough_percent 一部のクライアント。拡張 Bidder プロファイルにはボリュームコントロール機能がありません。代わりに、Bidder Instance のフィールドをqps_limit使用して、データセンターごとに QPS の安全上限を設定します。現在のトラフィック量を確認するには、従来の入札者 UI https://bidder.adnxs.net/metricsの [メトリック] タブを参照してください。

すべての入札者インスタンスで QPS の安全性上限がある場合は、最適化された入札Stream機能を有効にするオプションがあります。すべてのトラフィックは、QPS 上限が満たされるまで送信されます。QPS 上限よりも使用可能なトラフィックが多い場合は、QPS 上限を満たすためにトラフィック量をランダムに切断するのではなく、QPS 上限を超える購入動作に基づいて優先順位の低いトラフィックが削減されます。詳細については、「最適化された入札Stream FAQ」を参照してください。この機能に関心がある場合は、アカウントマネージャーまたは Xandr サポートにお問い合わせください。

新しい入札者プロファイルのアクティブ化

API で新しい Bidder プロファイルをアクティブにするには、 アクティブな フィールドをに true設定します。 Bidder Service API でプロファイル ID を設定してプロファイルをアクティブ化する必要がなくなりました。以下の手順 4 が完了すると、 parent_profile_idchild_profiles Bidder API オブジェクトは無視されます。

プロファイルをアクティブにするには、プロファイル画面の [アクティブ化] ボタンをクリックする必要があります。斜体以外のプロファイルはアクティブです。

手順 4 に進む前に、新しい Bidder プロファイルをアクティブ化します。拡張 Bidder プロファイルの設定は、2019 年 5 月 21 日より前の手順 4 でバックエンドスイッチが Xandr サポートによって反転されるまで、トラフィックフローに影響しません。

手順 4: Xandr サポートに問い合わせて移行を完了する (~1 営業日)

注:

このセクションは、プロファイルの移行に関する破壊的変更メール通信を受け取った場合にのみ関連します。実行しなかった場合は、この手順に従わないでください。代わりに、アカウントマネージャーに問い合わせてください。

警告

新しい拡張入札者プロファイルの設定は、2019 年 5 月 21 日より前にこの手順を完了するまで、トラフィックフローに影響しません。

サポートチケットを開きます。情報を入力する場合:

カテゴリ: [製品サポート] を選択します
ヘルプの内容:外部入札者統合を選択する

サポートチケットにこのテンプレートを使用する

拡張入札者プロファイルを確認して構成しました。プロファイルのセットアップを移行します。

Bidder ID と bidder 名:
新しい Bidder Platform UI または API を使用して構成しましたか?
現在のプロファイル設定からの変更の簡単な説明を入力します (変更がない場合は、"N/A"と書きます)。

次に何が起こりますか?

サポートスペシャリストは、最初にレガシと拡張 Bidder プロファイルの設定を確認します。見た目が良い場合は、サポートスペシャリストがバックエンドでスイッチを反転させ、確認のメモを送信します。この場合、新しい拡張入札者プロファイル構成がトラフィックフローに影響を与え始め、従来の入札者プロファイルの設定は無視されます。

従来の入札者 UI の [メトリック] タブを使用して、トラフィックフローを監視します。 https://bidder.adnxs.net/metrics 問題が発生した場合は、サポートスペシャリストがレガシプロファイルの設定にすぐに切り替えることができます (これは 5 ~ 10 分でトラフィックフローに反映されます)、拡張 Bidder プロファイルの設定のトラブルシューティングに取り組むことができます。

1 日のトラフィックフローに問題がない場合は、移行が完了し、サポートチケットが閉じられます。

ヒント

移行が完了した後も、従来の入札者プロファイルは API と従来の Bidder UI でアクティブとして表示されます。バックエンドで移行される限り、レガシプロファイルの設定は無視され、トラフィックフローには影響しません。

手順 4 を完了しない場合

2019 年 5 月 21 日に、拡張入札者プロファイルの入札者が有効になります。この時点で、新しいプロファイルでトラフィックの受信方法が制御され、レガシプロファイルは非推奨になります。この日付より前に拡張入札者プロファイルを更新しない場合、既定では、入札者に在庫制限は設定されません。

次の方法で共有

Bidder プロファイル移行ガイド

移行プロセスの概要

移行のプロセス

手順 1: 現在の状態を取得する (0.25 ~ 0.5 時間)

方法 1: API を使用する (推奨)

概要

手順 1.1: Bidder Service API: `GET` bidder/[bidder id] を使用してアクティブなプロファイルオブジェクトを取得する

例

手順 1.2: すべてのアクティブなプロファイルオブジェクトについて、 `GET` 従来の Bidder Profile Service API を使用した profile/[profile id]

手順 1.2: 例

手順 1.3: 結果を要約する

方法 2: 従来の入札者 UI を使用する

概要 (方法 2)

手順 1.1: 各入札者プロファイルの現在のフィルターを確認する

手順 1.2: 結果を要約する

手順 2: 変更を理解し、フィルターを再評価する (0.5 ~ 1 時間)

手順 3: 拡張入札者プロファイルを設定する (0.5 ~ 1 時間)

拡張入札者プロファイルで複数のプロファイルを使用する

拡張入札者プロファイルフィールドへのレガシのマッピング

トラフィック量の調整: パススルー率の代替手段

新しい入札者プロファイルのアクティブ化

手順 4: Xandr サポートに問い合わせて移行を完了する (~1 営業日)

サポートチケットにこのテンプレートを使用する

次に何が起こりますか?

手順 4 を完了しない場合

その他のリソース

次の方法で共有

Bidder プロファイル移行ガイド

移行プロセスの概要

移行のプロセス

手順 1: 現在の状態を取得する (0.25 ~ 0.5 時間)

方法 1: API を使用する (推奨)

概要

手順 1.1: Bidder Service API: GET bidder/[bidder id] を使用してアクティブなプロファイル オブジェクトを取得する

例

手順 1.2: すべてのアクティブなプロファイル オブジェクトについて、 GET 従来の Bidder Profile Service API を使用した profile/[profile id]

手順 1.2: 例

手順 1.3: 結果を要約する

方法 2: 従来の入札者 UI を使用する

概要 (方法 2)

手順 1.1: 各入札者プロファイルの現在のフィルターを確認する

手順 1.2: 結果を要約する

手順 2: 変更を理解し、フィルターを再評価する (0.5 ~ 1 時間)

手順 3: 拡張入札者プロファイルを設定する (0.5 ~ 1 時間)

拡張入札者プロファイルで複数のプロファイルを使用する

拡張入札者プロファイル フィールドへのレガシのマッピング

トラフィック量の調整: パススルー 率の代替手段

新しい入札者プロファイルのアクティブ化

手順 4: Xandr サポートに問い合わせて移行を完了する (~1 営業日)

サポート チケットにこのテンプレートを使用する

次に何が起こりますか?

手順 4 を完了しない場合

その他のリソース

手順 1.1: Bidder Service API: `GET` bidder/[bidder id] を使用してアクティブなプロファイルオブジェクトを取得する

手順 1.2: すべてのアクティブなプロファイルオブジェクトについて、 `GET` 従来の Bidder Profile Service API を使用した profile/[profile id]

拡張入札者プロファイルフィールドへのレガシのマッピング

トラフィック量の調整: パススルー率の代替手段

サポートチケットにこのテンプレートを使用する