FAQ - パートナー統合プロセスの提供

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

OpenRTB

Wiki には、"2.4" と "Mobile 2.2" の仕様が記載されています。違いは何ですか? 私たち (SSP) はモバイル企業です。どの oRTB バージョンを使用する必要がありますか?

Xandr では、すべてのメディアタイプのインプレッションを受け取るための OpenRTB 2.4 仕様がサポートされています。一部の従来のモバイル統合では、Xandr は OpenRTB 2.2 仕様と下位互換性があります。新しい種類の統合については、 OpenRTB 2.4 仕様に従ってください。

サポートしている VPAID と MRAID の最新バージョンは何ですか?

Xandr ビデオでは現在、VPAID バージョン 1 と 2 と VAST 1、2、および 3 がサポートされています。現在、MRAID バージョン 2.0 がサポートされています。モバイル向け。 OpenRTB バージョン 2.2 および 2.3 と下位互換性があります。

データセンター

データセンターはどこにありますか?

Xandr は現在、ロサンゼルスの LAX1、ノースベルゲンの NYM2、NJ、アムステルダムの AMS3、オランダ、フランクフルト、ドイツの FRA1、シンガポールの SIN3 の 5 つのデータセンターを実行しています。

さまざまなデータセンターへの待機時間をテストするにはどうすればよいですか?

東海岸データセンター (ニューヨークメトロ) への待機時間をテストするには、 jump.nym1.adnxs.net ping を実行します。 jump.lax1.adnxs.net を使用して西海岸のデータセンターに ping を実行でき、ヨーロッパのデータセンターは jump.ams1.adnxs.net で利用できます。

前提条件のチェックリストでは、グローバルオークションのタイムアウト制限と待機時間の測定に関する説明が MICROSOFT (SP) IP に記載されています。このアクティビティに対して実行されるテストの種類を指定してください。

Xandr には、各 SSP の最大オークション時間を可変に設定する機能があります。そのため、すべてのリージョンで SSP DC と Xandr DC の間の上位の待機時間を測定します。結果は、入札応答が SSP に対してタイムアウトと見なされる前に Xandr で最大オークション時間を設定するために使用されます。プラットフォームでの最大オークション時間が 100 ミリ秒であるとします。 100ms - (DC 間の上位待機時間 (18 ミリ秒など) - 10ms バッファー = 72 ミリ秒を計算します。その結果、SSP に対する Xandr の最大オークション時間が定義され、プラットフォームに到達する前に入札応答が遅くなります。

我々(SSP)は待機時間が非常に高く、tmaxパラメーターはまったく尊重されていないようです。皆さんはtmaxを使用していますか? その場合は、有効にする必要がありますか、それとも最後にそのようなものにする必要がありますか?

Xandr tmax プラットフォームの入札要求で値を動的に設定することはできません。これは、メンバーシートと各データセンターに対する Xandr のサポートによって個別に設定する必要があります。このtmaxフィールドは、ここで Xandr プラットフォームで異なる方法で処理されるため、OpenRTB スペックでも強調表示されています。

メンバー ID

と `MEMBER_ALIASMEMBER_ID`を持つことは可能ですか?

はい。標準プロセスの前提条件であるため、Xandr の連絡先にお問MEMBER_ALIASMEMBER_IDい合わせください。

プラットフォームで入札する顧客に提供するシート ID はどこで確認できますか? がすべてのユーザーに公開されているか、広告主にケースバイケースで提供できるものですか?

シート ID はメンバー ID とも呼ばれ、商用契約が完了すると Xandr のプラットフォーム上の各パートナーに割り当てられます。シート/メンバー ID は、パートナーオブジェクトの有効期間を通じて同じままであり、他のパートナーが参照して、たとえば広告品質の設定を調整したり、キャンペーンを特定のメンバー ID に絞り込んだり、特定の販売者/買い手メンバーを許可したりすることができます。

`wseat` はサポートされていますが、どのように使用できますか? 可能な値とマッピングの場所は何ですか?

wseat OpenRTB 入札要求のフィールドには、このインプレッションに対する入札が許可されている許可リスト (広告主、代理店など) に配置された購入者シート ID の配列が含まれています。 Xandr の名前付け規則では、シート ID とメンバー ID は同じです。そのため、配列には、wseatプラットフォームメンバーサービスを介して取得できる有効なメンバー ID を設定する必要があります。

"wseat": [
    "958",
    "1417"
]

パブリッシャー ID

パブリッシャーオブジェクトのインベントリリレーションシップを (SSP) で定義する方法

SSP メンバーシートの下に新しいパブリッシャーオブジェクトを作成したり、既存のパブリッシャー設定を変更したりするには、API または UI でインベントリ関係情報を送信する必要があります。多くの場合、リレーションシップは "パブリッシャーから直接ソース化された単一パブリッシャー" です。その場合、たとえば、パブリッシャーサービスを介して設定する必要があるフィールドは次のとおりです。

{
    "publisher": {
        "name": "Standard Publisher",
        "state": "active",
        "code": "4321",
        "reselling_exposure": "public",
        "expose_domains": true,
        "final_auction_type": "First Price",
        "inventory_relationship": "indirect_single_publisher",
        "inventory_source": "other",
        "inventory_source_name": "Publisher name for indirect_single_publisher",
        "contact": {
            "name": "The name of the point of contact for this publisher.",
            "phone": "contact phone number",
            "email": "CSPFeedback@appnexus.com"
        },
        "billing_dba": "Publisher name as in inventory_source_name",
        "billing_address1": "The street information of the billing address.",
        "billing_address2": "The street information of the billing address cont.",
        "billing_city": "The city of the billing address.",
        "billing_state": "The state of the billing address.",
        "billing_zip": "10010",
        "billing_country": "The country of the billing address."
    }
}

したがって、私たち(SSP)が非公開に公開を再販した場合、他のメンバーが供給を再販することは許可されません。しかし、オープンオークションに参加し、取引 ID を介して在庫を販売することはできますか?

いいえ。インベントリは、ネットワークレベルとパブリッシャーレベルでターゲットにすることができます。これは、配置グループレベルでのみ購入可能にすることができます。したがって、購入者が在庫をターゲットにして購入できるようにするには、次のアクションを実行する必要があります。

購入者によるターゲット設定のインベントリを公開する: これは"再販公開" とも呼ばれ、ネットワーク全体またはパブリッシャーごとに実行できます。これにより、ターゲット設定が可能になります。この設定を切り替える方法については、「 Publisher Service」を参照してください。
再販のためにプレースメントグループ (およびそのすべての配置) を有効にする: 他のメンバーに転売するには、RTB Marketplace に参加するように設定することで、プレースメントグループを再販可能にする必要があります。これにより、購入可能になります。この設定を切り替える方法については、「 Site Service」を参照してください。

Xandr は、パブリッシャーと明確に識別できるパブリッシャー名の使用を強くお客様に提案します (name 「 API を使用してインベントリ構造を同期する」で説明されているフィールド)。パブリッシャーの名前付けのために内部プラットフォームでのみ認識されている (SSP の) 内部 ID は使用しないでください。以下のインベントリマッピング構造の例を参照してください。

インベントリマッピング構造の例を示すスクリーンショット。

`publisher.is_oo` API 内は重要ですか?

パブリッシャーサービスで説明されているように、このパラメーターがにtrue設定されている場合、パブリッシャーはネットワークによって所有および運用されます。つまり、ネットワークは収益の 100% を取得します。ただし、との両方is_ooが指定されている場合は、inventory_relationshipリレーションシップに基づいて適切な値で上書きis_ooinventory_relationshipされます。

SSP 統合の一部として実装する方法`Ads.txt` / `App-Ads.txt`

Ads.txt と App-Ads.txtのサポートに関するドキュメントを確認し、「Publishers」セクションの手順を使用してパブリッシャーに連絡します (または、メンバー ID をそのページに送信するだけで、ファイルにads.txt/app-ads.txt追加できます)。

取引 ID

OpenRTB プロトコルで送信する前に、取引 ID (PMP) を Xandr プラットフォームに事前登録する必要がありますか。

Xandr プラットフォームで取引 ID を販売できるようにするには、 Deal Service を使用して事前に登録する必要があります。

{
    "deal": {
        "active": true,
        "code": "5612",
        "name": "Standard Deal",
        "start_date": "2017-04-10 00:00:00",
        "type": {
            "id": 1
        },
        "buyer": {
            "id": 882
        }
    }
}

Microsoft (SSP) `deal.id` は Xandr システムに配置されます `deal.code` 。入札要求で SSP `deal.id` の参照方法を明確にすることはできますか? または、Xandr 取引 ID のみが含まれますか?

取引 ID は、インベントリオブジェクトを Xandr にマップする方法と同様に、参照 deal.code されます。取引のdeal.id作成時に、取引サービスを介して Xandr のプラットフォームで SSP がにdeal code設定されます。 OpenRTB 入札要求の配列には pmp.deals 、外部 SSP deal.idを含める必要があります。 Xandr は、入札要求から外部 deal.id を読み取り、フィールドに指定されたマッピングを介して内部 Deal ID オブジェクトに deal.code マップします。以下の OpenRTB 入札要求の例を参照してください (前の質問の取引オブジェクトを参照)。

[...] "pmp":{"deals":[{"id":"5612" [...]

私たち(SSP)とXandrの間で作成された取引ごとにバイヤーメンバーIDを渡す必要があるのは本当ですか? ここでのプロセスは何ですか? 取引 ID を使用してパブリッシャーのインベントリを購入する各機関は、一意のメンバーシート ID を指定する必要がありますか?

取引は、売り手と買い手の間の1対1の関係に基づいて作成されます。取引販売者メンバーは、Xandr のプラットフォームで取引を作成できるようにするために、購入者メンバー ID を知っている必要があります。

エンドポイント

(SSP) は、運用環境の OpenRTB 入札要求にエンドポイントでを `&test=1` 引き続き使用する必要がありますか?

いいえ。運用環境の OpenRTB 入札要求&test=1には使用&test=1しないでください。レポートデータは生成されません。

Xandr は、Microsoft (SSP) がコントラクトに署名する前に OpenRTB 機能をテストするためのテストエンドポイントを提供していますか?

いいえ。 Xandr では、標準の OpenRTB 統合用に個別のテスト環境またはサンドボックス環境は提供されません。実稼働エンドポイントでを test=1 使用して、テストトラフィックを示します。

OpenRTB にアップグレードすると、Xandr エンドポイントドメインは変更されますか?

いいえ。変更する唯一の部分は、から /CUSTOM_ENDPOINT への /openrtb2実際のエンドポイントです。そのため、OpenRTB2 プロトコルの正しい新しいエンドポイントは次のとおりです。

https://MEMBER_ALIAS-useast.adnxs.com/openrtb2?member_id=MEMBER_ID
https://MEMBER_ALIAS-uswest.adnxs.com/openrtb2?member_id=MEMBER_ID
https://MEMBER_ALIAS-emea.adnxs.com/openrtb2?member_id=MEMBER_ID
https://MEMBER_ALIAS-apac.adnxs.com/openrtb2?member_id=MEMBER_ID

注:

MEMBER_ID は MEMBER_ALIAS 、Xandr 連絡先によって提供される個々のパートナーメンバー ID とエイリアスに置き換える必要があります。

広告マークアップから、広告の品質フラグをトリガーせずにテストまたは監査のために win 通知 URL を呼び出し、インプレッションをテストインプレッションとしてマークすることは可能ですか?

もちろんです。または /openrtb_win 呼び出しがテスト目的専用であることを示すには、呼び出しの/abヘッダーに次の情報を使用します。

curl -v --header 'X-is-test: 1' --header 'Host: ib.adnxs.com' 'https://nym1-ib.adnxs.com/ab?e=wqT_3QKoCfA8qAQAAAMA1gAFAQjQis3HBRCUvPSr_...&referrer=appnexus.com&pp=1'

注:

このテスト構成のドメイン参照で解決されない IP アドレスは使用しないでください。

ユーザー ID

Bid 要求に無効な `"buyeruid"`が含まれています。これを修正する必要がありますか? その場合は、ドキュメントを提供してください。

はい。この buyeruid フィールドには、 usersync ピクセルを介して以前に一致したユーザーを示すために送信する Xandr ユーザー ID が含まれています。入札要求オブジェクトは、一致するユーザーデータを持つ入札要求と見なされるためには、フィールドに有効なユーザー ID を buyeruid 含める必要があります。入札要求ユーザーオブジェクトの詳細については、「 SP からの入札要求の受信」を参照してください。

Xandr と同期する標準ユーザーには、ユーザー一致テーブルのホストが必要です。 Xandr はユーザー同期を開始しますか? その場合、ここで予想できるボリュームは何ですか?

Xandr 標準の OpenRTB SSP 統合では、SSP がユーザーマッピングを独自のシステムに格納する必要があります。通常、SSP ページの 1x1 イメージピクセルは Xandr getUID サービスを呼び出し、ストレージの Xandr UUID を返します。ピクセルの形式は、「ユーザー ID マッピング」で確認できます。 Xandr から usersync 呼び出しを受け取るサーバーは、1K-3K QPS を処理できる必要があります。

Xandr で双方向のユーザー同期がサポートされているかどうか (SSP) が疑問に思われますか?

Xandr では、SSP ユーザー同期マッピングテーブルを Xandr 側に格納する双方向ユーザー同期はサポートされていません。ただし、Xandr によって開始されるユーザー同期は完全にサポートされています。これにより、Xandr は Xandr ユーザー ID のユニバース全体で SSP ユーザー同期ピクセルを削除できます。 Xandr によって開始されるユーザー同期ピクセルのセットアップは、統合プロセスの一部です。

ユーザーの同期が期待どおりに機能していることをテストして確認する最良の方法は何ですか?

(Xandr ユーザー ID) が正しくマップされているかどうかを buyeruid 確認する最も簡単な方法は、デバッグオークションを使用することです。入札要求の呼び出しに追加 &debug=1 すると、次のような出力が表示 status: success されます。

[COOKIESHEET] cookie source: provided uid
[COOKIESHEET]   mobile optout action: none
[COOKIESHEET]   get request:
[COOKIESHEET]       uid source: provided uid
[COOKIESHEET]       uid: 5160786676315026726
[COOKIESHEET]       status: success
[COOKIESHEET]   map request: none
[COOKIESHEET]   mobile request: none

Xandr では、モバイルインベントリの Xandr ユーザー ID をフィールドに入力 In-App 必要 `buyeruid` がありますか?

buyeruidは、OpenRTB の入札要求 In-App 必須ではありません。ただし、ユーザーの一致率を最も高くするためには、をbuyeruid常に指定することをお勧めします。 Xandr は最初にモバイル ID の照合を試み、一致しない場合はを buyeruid照合しようとします。両方の値が指定されている場合は、正常に一致したモバイル ID がよりも buyeruid優先されます。

usersync ピクセルの起動の間隔パラメーターは何ですか?

既定では、Xandr は SSP usersync ピクセルに対して定義され、内部パラメーター max_interval=432000 (5 日) と min_interval=43200 (12 時間) が発生します。最大間隔: そのピクセルの同期の間に待機する最大秒数。たとえば、5 日間ピクセルを発生していない場合は、それをアルゴリズムに含めて、起動する usersync ピクセルを選択します。最小間隔: 同期が正常に実行されたことを確認できない場合に、同期ピクセルの再試行の間に待機する秒数 (ピクセルを削除したが、正常に起動しなかったか、ユーザーがすばやく移動した可能性があります)。たとえば、ピクセルを起動したばかりの場合は、少なくとも 12 時間はもう一度同期しないでください。

Xandr がユーザーデータを格納する期間

現在、ユーザーデータ (Xandr ユーザー ID) のおおよその Time To Live (TTL) は 60 日です。

と `/getuidnb` サービスの`/getuid`違いは何ですか?

ユーザーが Xandr Cookie 領域に格納されている Xandr ID を持っず、スティッキー Cookie を持っていない場合:

/getuid を使用して転送する UID=0
/getuidnb がに転送 UID=0 されない (SSP は非スティッキー Cookie 環境から値を受信 0 しません)

入札要求

OpenRTB 入札要求にはフィールドがあります `imp.tagid` 。 Xandr は、そのフィールドが配置サービスからアクセス可能な対応する `placement.id` フィールドを保持することを期待していますか? または、(API Placement Service を介して管理される) e 値であると `placement.cod`予想されますか?

imp.tagidは、配置サービスの値になりますplacement.code。これは、渡す値と同じ値、またはapp.id入札要求時site.idの値と同じである必要があります。

OpenRTB 入札要求オブジェクト ID のインベントリ検索シーケンスは何ですか?

Xandr は、次のルックアップシーケンスを使用して、OpenRTB 入札要求で提供される ID と一致します。

1. imp.tagid - used to lookup by placement code
2. bidrequest.app.id - used to lookup by placement code
3. bidrequest.site.id - used to lookup by placement code
4. use bidrequest.site.publisher.id or bidrequest.app.publisher.id to lookup publisher by code and try to get default publisher placement

入札要求には、複数の mediatype オブジェクトが含まれています。すべてではないにしても、購入側に送信され、最終的に取引されるのはどれですか?

OpenRTB では、複数形式の要求がサポートされています。ただし、複数のメディアタイプに対して入札応答が明確に定義されているわけではありません。その結果、メディアの種類間でハードコーディングされた優先順位付けを使用した複数形式の入札要求がサポートされます。たとえば、要求がネイティブおよびビデオとして送信された場合、購入側に送信されると、単なるビデオ要求に変換されます。順序は次のとおりです。

video
audio
banner
native

パブリッシャーがメンバーシートのインベントリ階層にマップされていない場合、入札リクエストインプレッションはどうなりますか?

その場合、パブリッシャーのインプレッションのソースが正しく表示されず、フィルター処理される可能性があります。 Xandr はインプレッションのプロパティをいかなる方法でも変更しません。しかし、Xandrオープンエクスチェンジで販売された供給は分析され、在庫が買い手にとって最も直接的で透明で効率的な購入パスを表していることを確認します。これらの要件を満たしていないインプレッションは、RTB 販売に不適格な場合があります。これらのインプレッションは、引き続き取引を通じて販売される可能性があります。オープンマーケットプレースでの配信に関する問題が発生している場合は、在庫を収益化するために特定の購入者との取引を設定することを検討できます。

Xandr は入札リクエストで複数のインプレッションに応答しますか? または、入札リクエストごとに 1 つのインプレッションオブジェクトにのみ応答しますか?

OpenRTB 仕様に従って、1 つの入札要求で複数のインプレッションオブジェクトをサポートします。各インプレッションオブジェクトは、独自のオークションを実行し、購入者から個々の入札を受け取ります。

ネイティブ入札要求での一般的なネイティブアセット定義に対する Xandr の推奨事項は何ですか?

導入を容易にし、ネイティブバイヤー間で売り手のリーチを最大化するために、以下の最小サイズと縦横比の両方に関する推奨事項が行われます。

フィールド	Xandr のガイドライン
`Title`	最大 25 文字
`Body`	最大 300 文字
`Icon/Logo*`	縦横比 1:1 注: OpenRTB 仕様では、アプリアイコン、ブランドロゴなどに使用するために、以前の重複する型 1 とタイプ 2 が単にタイプ 1 としてマージされています
`Image`	1.91:1 縦横比 (600 px min/ 150 KB max)
`Sponsored By`	最大 40 文字 (広告のブランド)

ネイティブ入札要求の画像アセットは、アプリアイコン、ブランドロゴなどにタイプ 1 を使用しています。 Xandr は特定のアイコンサイズ (50x50 など) をサポートしていますか?

いいえ。 Xandr クリエイティブ ID には、現在、購入者が送信したネイティブクリエイティブのアイコン/ロゴサイズに関する情報は含まれていません。 img タイプ 1 を含むすべてのネイティブ入札要求は、サイズ 0x0として宣言する必要があります。

要求`"native-request-native"` (フィールド) のネイティブ部分では、JSON でエンコードされた文字列が必要であることがわかります。通常のオブジェクトを受け入れることもできますか?

native.request ノード内のネイティブフィールドは文字列である必要があります。 Native 1.0 仕様は技術的には独自の仕様であり、理論的には OpenRTB2.3 仕様の外部で使用できるため、ネイティブフィールドの内容を JSON 構造の一部にすることはできません。そのため、文字列として表示するには "エスケープ" する必要があります。

要求インプレッションの `tagid` 内部について、私たち (SSP) はすべての配置を Xandr にマップする必要がありますか? または、このフィールドを空のままにするか、値 `site.id`をに置き換えることができますか?

はい、いいえ、いいえ! すべてのインベントリを Xandr 配置にマップする必要があります。入札要求のフィールドを tagid 空のままにせず、両方のフィールド tagidsite.id を Xandr 配置オブジェクトの同じ placement.code フィールドにマップしないでください。

Xandr の既定のマークアップ配信方法は `bid.adm` 、現在サポートされていない入札応答の属性です。属性を使用して代替の広告マークアップ配信を `bid.nurl` サポートしていますか?

はい。Win 通知で提供される広告マークアップをサポートしています。 OpenRTB 仕様によると、入札者 (Xandr) から取引所 (SSP) にマークアップを転送するための複数の標準的な方法があります。 Xandr の既定の広告マークアップ配信方法は、属性を bid.adm 使用します。 SSP が受信入札要求に属性を提供する場合、win notice bid.nurl 属性を使用したBidRequestExtension代替マークアップ配信方法が選択されます。

注:

代替マークアップ配信方法は、現在、ネイティブメディアの種類では機能しません。

"ext": { "appnexus": { "markup_delivery": 1 } }

Xandr が OpenRTB 入札要求から参照元ドメインまたは URL を読み取っているとき、Xandr はフィールドまたはフィールドを`domainpage`見ていますか?

両方のフィールドを調べて、参照元の URL またはドメインを決定します。このpageフィールドは、SP からのフィールド受信domain入札要求よりも優先されます。

Xandr 応答は、ブロックされたドメイン、カテゴリ、属性などの発行元のブロックリストにどのように準拠していますか? 言い換えると、OpenRTB 統合を通じて配信するクリエイティブがパブリッシャーのブロックリストに違反しないようにするにはどうすればよいですか。

そのために、IAB は OpenRTB プロトコルで入札要求フィールド wseat、、 bcat、 badv および bapp を導入しました。これに加えて、Xandr のプラットフォームでは、広告プロファイルサービスを使用して、あまり動的でない形式の Publisher ブロック設定を使用できます。

入札要求で複数の imp オブジェクトをサポートするには、最後に構成が必要ですか?

Xandr では、入札要求で既定で複数 imp のオブジェクトがサポートされます。各 imp オブジェクトは、Xandr プラットフォーム上で個別の印象として扱われます。同じ入札要求に含まれる Xandr に複数のインプレッションが送信されるという事実は、ネットワークリソースと接続オーバーヘッドを節約する以外に何の影響もありません。

Xandr

ネイティブ資産の値に関しては、Xandr はどのように処理し、`wmin/hmin`null エッジケースを処理`0`しますか。

たとえば、ネイティブの img アセットフィールドwmin/hminが入札要求でまたは null に0設定されている場合、Xandr はそれらのフィールドが入札要求で省略されたかのように論理的に扱います。その影響は、外部の入札者が、それらのフィールドなしで送信された同じ入札要求を表示すること、つまり、効率のためにそれらのフィールドを削除することです。

`private_auction`入札要求の pmp では、実際には何を意味し、それをに`1`設定することの影響は何ですか。つまり、指定された取引の入札のみが受け入れられますか?

OpenRTB 販売者からプライベートオークションのインプレッションを受け取った場合は、サードパーティのオークションで受け入れられる入札のみを送信します。の影響 pmp.private_auction=1 : Xandr は、そのインプレッションに関する取引によって指定されていない他の潜在的な買い入札者に入札要求を送信 しません 。

Xandr は SSP OpenRTB 入札要求のフィールドを外部入札者に送信 `imp.bidfloor` しますか?

はい。 Xandr は、インプレッションレベルのフロア価格を受け取って評価し、外部の入札者バイヤーに渡 imp.bidfloor します。

(SSP) では、入札要求の一部が HTTP 400 形式の応答を返しています。どうしてでしょうか?

これは、非アクティブな配置、配置グループ、または発行元、および無効なバナーサイズの現在の動作です。要求に有効なインプレッションが見つからない場合、HTTP 400 が返されます。

入札応答

入札要求に対して予想される HTTP 応答は何ですか?

入札要求に対する予想される HTTP 応答を次に示します。

200 OK: 有効な入札応答が返されました。
204 コンテンツなし: 入札は返されていません。
400 MALFORMED: 受信入札要求には、Xandr システムの非アクティブな発行元または配置オブジェクトにマップされる、app.id、app.publisher.id、または site.publisher.id が含まれていますsite.id。詳細については、「一般的な配信のトラブルシューティング手順 2 」を参照してください。

Microsoft (SSP) では、 `bid.adomain` すべての入札応答にパラメーターが必要です。 Xandr のすべての入札応答に、入力されたフィールドが `bid.adomain` 含まれますか? 広告主のドメインは、openrtb `bid.adomain` フィールドになくても、他のフィールドで取得することはできますか?

Xandr は OpenRTB 仕様に非常に密接に従っており、必要に応じてドメインフィールドを定義しません。ただし、すべてのクリエイティブには、未知のブランド (ID 1) を含むブランドが関連付けられています。これは、監査されていない新しいクリエイティブに自動的に割り当てられます。不明なブランドは、adomain appnexus.com にリンクします。したがって、内部ポリシーやその他の理由により、アドメインが関連付けられていないブランドに関連付けられているクリエイティブ (<すべてのクリエイティブの 0.08%) を含むクリエイティブを除き、すべての入札応答に adomain が含まれると予想されます。

OpenRTB 入札応答の NEX10-101 カテゴリとは

これらのカテゴリは無視します。これらは IAB カテゴリと重複しており、今後数か月以内に非推奨になる予定です。

入札応答の `adm` フィールドを通常のオブジェクトにすることはできますか?

いいえ。 adm には、ページまたはアプリに配信される広告マークアップが含まれます。 JSON 構造体にすることはできません。

(SSP) では、応答の幅と高さが 1x1 であることが確認されています。ビデオ広告サイズの正確な幅と高さを返しますか?

バナー以外のメディアタイプの場合: 入札応答の幅と高さは、パブリッシャーのページに配信されるクリエイティブ (または広告マークアップ) の実際のサイズを表すものではありません。たとえば、ビデオメディアタイプのクリエイティブは配信に複数のメディアファイルを使用し、ネイティブイメージアセットのサイズにも同様の柔軟性が提供されます。これらのクリエイティブの場合、正確な幅と高さはクリエイティブオブジェクトのより深いレベルで転送されます。これは、次の構文を使用してプレビューできます。

Video: https://{DATACENTER}-ib.adnxs.com/cr?id={APN_CREATIVE_ID}&format=vast 
Native: https://{DATACENTER}-ib.adnxs.com/cr?id={APN_CREATIVE_ID}&format=json

iurl はプラットフォーム上のクリエイティブプレビューを表し、静的 URL (上記の構文を参照) です。つまり、期限切れではありません。事前監査、クリエイティブキャッシュなどに使用できます。パラメーターは id Xandr クリエイティブ ID を表し、プラットフォームで一意です。ビデオクリエイティブプレビューの場合は、"vast" 形式パラメーターを iurl にアタッチして xml を表示します (例: )。 https://fra1-ib.adnxs.com/cr?id=48265354&format=vast

広告マークアップのオークション価格は米ドルですか? 私はそれがCPMであると仮定します。正しいですか?

Xandr は、ここで OpenRTB 仕様に従います。価格は、ほとんどの場合、USD と CPM と同じ通貨と単位を使用します。

入札要求が入札なしを返すか、構文的に正しくないかをテスト中に(SSP)はどのように確認できますか?

手動呼び出しで debug=1 次に示すように、パラメーターを自由に使用して、一般的なデバッグオークションを実行してください。

ヒント: デバッグ出力がまったく返されない場合は、入札要求の構造に問題がある、または配置が機能していない可能性があります。

https://MEMBER_ALIAS-useast.adnxs.com/openrtb2?member_id=MEMBER_ID&debug=1
https://MEMBER_ALIAS-uswest.adnxs.com/openrtb2?member_id=MEMBER_ID&debug=1
https://MEMBER_ALIAS-emea.adnxs.com/openrtb2?member_id=MEMBER_ID&debug=1
https://MEMBER_ALIAS-apac.adnxs.com/openrtb2?member_id=MEMBER_ID&debug=1

当選通知で最終的な価格を渡すにはどうすればよいですか? (SSP) にはマクロ `pp=$(AUCTION_PRICE)`が存在することがわかります。必要なエンコード/形式は何ですか?

入札要求のauction typeフィールドが (2 番目の価格のオークション) ${AUCTION_PRICE} としてat=2定義されている場合、2 番目の価格を受け取るには、SSP によってマクロを設定する必要があります。決済価格は、入札と同じ通貨、単位、フォーマット/エンコード (通常は USD 通貨と CPM) を使用する必要があります。

注:

マクロにAUCTION_PRICE入力された価格のような$通貨文字は使用しないでください。一般に、doubl 数値形式で指定されている文字以外の文字は使用しないでください。 CPM 決済価格がドルなどの 0.47 場合は、を AUCTION_PRICE 次のように置き換えます。

正しい `AUCTION_PRICE` マクロ置換

pp=0.47

当社(SSP)は、当選価格を渡すときに暗号化を使用する必要がありますか? サポートされている暗号化アルゴリズムを確認できますか?

標準統合でのマクロの AUCTION_PRICE エンコードはまだサポートされていません。

パブリッシャーのページで Xandr imptracker と clicktracker のレンダリングをどのように実装する必要がありますか? インプレッションウィンイベントに対して起動する (SSP) インプトラッカーを実装し、インプレッションの Xandr imptracker が表示されるイベントを実装できますか? クリックの不一致につながるでしょうか。

はい。SSP と Xandr の起動イベントの間でインプトラッカーの実装に違いがある場合は、不一致の動作が発生します。クリックは、インプレクサーのタイミングに依存するため、影響も受けます。

OpenRTB ネイティブで (SSP) が稼働するようになりました。 Xandr のどのクリエイティブフィールドに対応する OpenRTB フィールドを購入者と通信できるように、フィールドマッチングテーブルがありますか?

ネイティブバイヤー、プラットフォーム購入者、外部 DSP は、クリエイティブサービスに従ってネイティブクリエイティブを事前に登録する必要があります。 (詳細については、例を参照してください)。

入札応答 JSON の入札の順序は、たとえば、入札価格に基づく降順など、特定のパターンに従っていますか?

いいえ。入札応答 JSON 配列構造の順序は保証されません。完全な JSON 応答を解析した後は、入札を評価し、入札選択ロジックを厳密に適用することをお勧めします。

インプレッションウィン通知通話のタイムアウト制限は何ですか?

Win 通知呼び出しのタイムアウト制限はメディアの種類によって異なります。次のタイムアウトが適用され、呼び出し/openrtb_winが適用/ab, /itされます。

banner: 5 minutes
native: 60 minutes
video: 360 minutes

クリック追跡のタイムアウト制限は何ですか?

クリック追跡 URL の場合、Xandr のプラットフォームでインプレッションが処理された後の集計ルックバックウィンドウが呼び出されます。

banner: 120 minutes
native: 120 minutes
video: 120 minutes

注:

Xandr クリックレポートでは、プラットフォームでインプレッションが処理された後、指定された集計ルックバックウィンドウの外部で行われたクリック URL 呼び出しはカウントされません。これは、SSP が Xandr レポートよりも多くのクリック数をカウントするクリックの不一致に特に重要です。

Reporting

Xandr のプラットフォームで使用可能なレポートとメトリックと、それらのレポートを取得する方法

SP によって実行される最も一般的なレポートの種類は、Network Analytics レポートです。このレポートは、一般的に提供されているもの、何がうまくいっているか、両方の購入側と売り側の情報を提供します。すべてのレポートは Reporting API サービスを介して取得されます。使用可能なレポートの種類の完全な一覧を参照してください。

過去 7 日間の Network Analytics レポートを取得するために必要な API 呼び出しシーケンスの例を次に示します。

echo "AUTH to AppNexus API: "
curl -bc -cc -X POST -s -d '{"auth":{"username":"YOUR_USERNAME","password":"YOUR_PASSWORD"}}' "https://api.appnexus.com/auth"
{
    "response": {
        "status": "OK"
    }
}
 
echo "POST to report API service: "
curl -bc -cc -X POST -s -d '{ "report": { "report_type":"network_analytics", "columns":[ "hour", "seller_member_name", "buyer_member_name", "publisher_name", "publisher_id", "publisher_code", "imps", "clicks", "total_convs", "revenue", "ctr", "convs_rate" ], "report_interval":"last_7_days", "format":"csv" } }' "https://api.appnexus.com/report?member_id=MEMBER_ID"
{
    "response": {
        "report_id": "287efed55c091dc97e2c839580962cba",
        "status": "OK"
    }
}
 
echo "DOWNLOAD from report-download API service: "
curl -bc -cc -s "https://api.appnexus.com/report-download?id=287efed55c091dc97e2c839580962cba" 
hour,seller_member_name,buyer_member_name,publisher_name,publisher_id,publisher_code,imps,clicks,total_convs,revenue,ctr,convs_rate
2017-06-02 05:00,Member Inc.,Test Buyer,Example Publisher,777999,222333,0,0,0,0.000000,0.000000000000000000,0.000000000000000000
2017-05-31 13:00,Member Inc.,Test Buyer - Netherlands,Publisher Name AG,555777,100200,172,0,0,0.000000,0.000000000000000000,0.000000000000000000

次の方法で共有

FAQ - パートナー統合プロセスの提供

OpenRTB

Wiki には、"2.4" と "Mobile 2.2" の仕様が記載されています。 違いは何ですか? 私たち (SSP) はモバイル企業です。 どの oRTB バージョンを使用する必要がありますか?

サポートしている VPAID と MRAID の最新バージョンは何ですか?

データセンター

データセンターはどこにありますか?

さまざまなデータセンターへの待機時間をテストするにはどうすればよいですか?

メンバー ID

と MEMBER_ALIASMEMBER_IDを持つことは可能ですか?

プラットフォームで入札する顧客に提供するシート ID はどこで確認できますか? がすべてのユーザーに公開されているか、広告主にケース バイ ケースで提供できるものですか?

wseat はサポートされていますが、どのように使用できますか? 可能な値とマッピングの場所は何ですか?

パブリッシャー ID

パブリッシャー オブジェクトのインベントリ リレーションシップを (SSP) で定義する方法

したがって、私たち(SSP)が非公開に公開を再販した場合、他のメンバーが供給を再販することは許可されません。 しかし、オープンオークションに参加し、取引 ID を介して在庫を販売することはできますか?

パブリッシャー名に関する当社(SSP)にアドバイスをお願いします。 内部システムの発行元を表す名前または ID を使用することをお勧めしますか?

publisher.is_oo API 内は重要ですか?

SSP 統合の一部として実装する方法Ads.txt / App-Ads.txt

取引 ID

OpenRTB プロトコルで送信する前に、取引 ID (PMP) を Xandr プラットフォームに事前登録する必要がありますか。

Microsoft (SSP) deal.id は Xandr システムに配置されます deal.code 。 入札要求で SSP deal.id の参照方法を明確にすることはできますか? または、Xandr 取引 ID のみが含まれますか?

エンドポイント

(SSP) は、運用環境の OpenRTB 入札要求にエンドポイントで を &test=1 引き続き使用する必要がありますか?

Xandr は、Microsoft (SSP) がコントラクトに署名する前に OpenRTB 機能をテストするためのテスト エンドポイントを提供していますか?

OpenRTB にアップグレードすると、Xandr エンドポイント ドメインは変更されますか?

広告マークアップから、広告の品質フラグをトリガーせずにテストまたは監査のために win 通知 URL を呼び出し、インプレッションをテストインプレッションとしてマークすることは可能ですか?

ユーザー ID

Bid 要求に無効な "buyeruid"が含まれています。 これを修正する必要がありますか? その場合は、ドキュメントを提供してください。

Xandr と同期する標準ユーザーには、ユーザー一致テーブルのホストが必要です。 Xandr はユーザー同期を開始しますか? その場合、ここで予想できるボリュームは何ですか?

Xandr で双方向のユーザー同期がサポートされているかどうか (SSP) が疑問に思われますか?

ユーザーの同期が期待どおりに機能していることをテストして確認する最良の方法は何ですか?

Xandr では、モバイル インベントリの Xandr ユーザー ID をフィールドに入力 In-App 必要 buyeruid がありますか?

usersync ピクセルの起動の間隔パラメーターは何ですか?

Xandr がユーザー データを格納する期間

と /getuidnb サービスの/getuid違いは何ですか?