入札者プロファイル移行ガイド

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

注:

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

重大な変更に関する通知: 移行を完了していない場合:

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

移行プロセスの概要

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

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

移行のプロセス

ステップ 1: 現在の状態を取得する (0.25 ~ 0.5 時間)

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

ヒント

従来の入札者プロファイルにおける親プロファイルと子プロフィールの関係を理解する &

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

例:

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

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

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

概要

Bidder Service API を使用してアクティブなプロフィールオブジェクトを取得します: GET bidder/[bidder id]。
すべてのアクティブなプロフィールオブジェクトに対して、従来の入札者プロフィールサービス API を使用して profile/[profile ID] を GET します。
結果を要約します。

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

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

参考: 認証サービスと入札者サービス。

例

-> 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: すべてのアクティブなプロフィールオブジェクトに対して、従来の入札者プロフィールサービス API を使用してプロフィール/[プロフィール ID] `GET` する

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

"..._action" は "含める" または "除外する" に設定できます。
"..._targets" には、販売者メンバー、国または地域などの ID のリストを含めることができます。

リファレンス: 従来の入札者プロファイルサービス

手順 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) の基準を満たしたときに送信されます。

従来のプロファイル API サービスには、非推奨のフィールドが複数あります。以下のターゲット可能なフィールドのみに注目することをお勧めします。このページの「従来の入札者プロファイルフィールドと拡張入札者プロファイルフィールドのマッピング」セクションには、どの正確に確認するべきかについてのガイドがあります。

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

販売者メンバー
国/地域
ドメインリスト
サイズ
サプライの種類
インベントリ属性
既知のユーザーのみ

注:

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

ヒント

AppNexus Directとは?

従来のプロフィールの設定によっては、含まれる販売者メンバーに加えて、Xandr の直接供給がプロフィールオブジェクトに含まれる場合があります。詳細については、「 Microsoft Monetize Supply for External Demand Partners」を参照してください。

新しい入札者プラットフォーム UI では、Xandr の「直接」交換グループに属している販売者メンバーを確認できます。

ドメインリストからドメインを取得する方法

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

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

概要 (方法 2)

各入札者プロファイルの現在のフィルターを表示します。
結果を要約します。

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

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

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

現在、斜体以外の子プロファイルがアクティブです。お子様のプロフィールをクリックすると、プロフィールの設定を確認できます。

手順 1.2: 結果を要約する

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

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

販売者メンバー
国/地域
ドメインリスト
サイズ
サプライの種類
インベントリ属性
既知のユーザーのみ

注:

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

ヒント

AppNexus Directとは?

従来の入札者 UI には表示されない場合がありますが、プロファイルでの販売者メンバーターゲティングに加えて、Xandr の直接供給の販売者メンバーがプロファイルに含まれます。詳細については、「 Microsoft Monetize Supply for External Demand Partners」を参照してください。

新しい入札者プラットフォーム UI では、Xandr の「直接」交換グループに属している販売者メンバーを確認できます。

ドメインリストからドメインを取得する方法

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

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

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

フラット階層: 親子プロファイルモデルが削除されました。
広告タイプ: バナー、ビデオ、ネイティブ、オーディオの 4 つの主要な広告タイプを簡単にターゲットにできるようになりました。
エクスチェンジ: ターゲティングを容易にするために、販売者メンバーをエクスチェンジにグループ化しました。
簡略化されたプロファイル: プロファイルをお客様のビジネスに関連するフィールドのみに絞り込みました。
新しい入札者プラットフォーム UI: プロファイルを管理および維持するための新しい UI を構築しました。 2019 年を通じて、この UI に追加機能が追加される予定です。

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

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

注:

新しい入札者プロフィールサービス API または新しい入札者プラットフォーム UI での拡張入札者プロフィールの設定は、手順 4: Xandr サポートに問い合わせると、2019 年 5 月 21 日までにバックエンドのスイッチを切り替えるまで、Xandr からのトラフィックフローには影響しません。

拡張入札者プロファイルを設定する方法は 2 つあります。 API 経由で新しい入札者プラットフォーム UI を使用することをおすすめします。

入札者プラットフォームのユーザーインターフェイス (推奨): https://bidder.appnexus.com/login
- 入札者プラットフォームのユーザーインターフェイス
- プロファイル画面
新しい入札者プロフィールサービス API

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

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

従来の入札者プロファイルフィールドと拡張入札者プロファイルフィールドのマッピング

ターゲティング	従来の入札者プロファイル API フィールド	拡張入札者プロフィール UI & API フィールド
販売者メンバー/グループ	`member_targets` API の `seller_member_group_targets` フィールド	[交換とメンバー] タブ。すべての販売者メンバーは 3 つの取引所のいずれかに所属しており、各取引所に属している販売者メンバーを確認できます。 `exchanges` API のフィールド (メンバーレベルの制御の場合、Exchange で `excluded_members` および `included_members` 配列を使用します)。
Countries	`country_action` フィールドには `include` または `exclude`があります。 `country_targets` 配列には、国または地域の一覧が含まれています。	[国] タブ。 `countries` API のフィールド。 (`countries` で `action` と `targets` を使用します。ターゲットには、Country Service から取得した ID を使用します。)
ドメインリスト	`domain_list_action` フィールドには `include` または `exclude`があります。 `domain_list_targets` 配列にはドメインリストのリストがあります。ドメインリストサービスを使用して、ドメインを作成、表示、または編集します。	の [ドメインリスト] タブ (ドメインを編集するには、 Domain List Service を使用します)。 `domain_lists` API のフィールド。 (`domain_lists` で `action` と `targets` を使用します。ターゲットには、ドメインリストサービスから取得した ID を使用します。)
サイズ (および広告タイプ)	`size_targets` 配列 (Include のみ)。	[広告タイプ] タブ。最初に、含める広告タイプを選択します。バナー広告タイプを含める場合は、含めるサイズを選択できます。 `ad_types` API のフィールド。広告の種類ごとに、[ `action` ] を [ `include` ] または [ `exclude`] に設定します。 `banner`広告タイプの場合、`sizes` 配列にサイズを含めることができます。
サプライの種類	`supply_type_action` フィールドには `include` または `exclude`があります。 `supply_type_targets` 配列には、Web、モバイル Web、またはモバイルアプリがあります。	の [サプライの種類] タブ。 `supply_types` API のフィールド。 (`supply_types` で `action` と `targets` を使用します。ターゲットの場合、可能な値は `web`、`mobile_web`、`mobile_app` です。)
インベントリ属性	`use_inventory_attribute_targets` 指定: true または false. `inventory_attribute_targets` 配列には、インベントリ属性のリストがあります (Include のみ)。	の [機密属性] タブ。 `inventory_attributes` API のフィールド。 (アクションは含めるのみです。ターゲットには、インベントリ属性サービスから取得した ID を使用します。)
既知のユーザーのみの受信	フィールド `passthrough_percent` 0 で、Bidder オブジェクト `always_send_owned_segments` true に設定されている場合は、既知のユーザーのみをリッスンしています。または、既知のユーザーのみをターゲットにするセグメント 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 のフィールド。

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

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

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

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

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

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

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

手順 4: Xandr サポートに連絡して移行を完了する (~1 営業日)

注:

このセクションは、プロファイルの移行に関する重大な変更のメールを受信した場合にのみ該当します。実行しない場合は、この手順を実行しないでください。代わりに、担当のアカウントマネージャーにお問い合わせください。

警告

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

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

カテゴリ: 製品サポートの選択
何についてお困りですか?: 外部入札者の統合を選択

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

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

入札者 ID と入札者名:
新しいビッダープラットフォームの UI または API を使用して構成しましたか?:
現在のプロファイル設定からの変更点について簡単な説明を提供します (変更がない場合は「該当なし」と記入します)。

次に何が起こりますか?

サポートスペシャリストが、最初に従来の入札者プロファイルと拡張入札者プロファイルの設定を確認します。見た目に問題がない場合は、サポートスペシャリストがバックエンドのスイッチを入れ替えて、確認のメモを送信します。この場合、新しい拡張入札者プロファイル構成がトラフィックフローで有効になり始め、従来の入札者プロファイルの設定は無視されます。

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

1 日トラフィックフローに問題がなければ、移行は完了し、サポートチケットは終了します。

ヒント

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

手順 4 を完了していない場合

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

Last updated on 2026-08-18