schain ビルダー & バリデーター
OpenRTB 向けの IAB SupplyChain オブジェクト（schain）を構築・検証し、source.ext.schain の JSON とシリアライズ済み文字列の両方をエクスポートします — すべてブラウザ内で。
schain ビルダー & バリデーターは、すべてブラウザ内で動作します。構築または貼り付けた販売者 id、ドメイン、供給チェーンノードはデバイス上に留まり、ArrayKit にアップロードされることはありません。
OpenRTB Enum リファレンスを開く
schain ビルダー について
schain ビルダー & バリデーターは、OpenRTB ビッドリクエストの source.ext.schain に乗る IAB Tech Lab の SupplyChain オブジェクトを組み立てます。各中間業者を asi、sid、hp（支払い）フラグを持つ順序付きノードとして追加し、complete と ver の値を設定してから、JSON オブジェクトと、取引所が期待する URL エンコードされたシリアライズ済み文字列の両方をコピーします。Validate モードに切り替えると、既存の schain を JSON またはシリアライズ済み文字列として貼り付け、欠落した必須フィールド、不正な complete フラグ、想定外のバージョンを即座に確認でき、ホップチェーンがノードごとに描き出されます。広告オペレーション、SSP、ヘッダービッディングのエンジニアは、供給パスをここで監査・修復できます。貼り付けたノードと販売者 id はデバイス上で解析され、アップロードされることはありません。
機能
- 順序付きの供給チェーンノード（asi、sid、hp、rid、name、domain）を追加・並べ替え・削除
- complete フラグを切り替え、ver を現行の 1.0 仕様に固定
- ビッドリクエストにそのまま投入できる OpenRTB source.ext.schain の JSON オブジェクトをエクスポート
- 取引所が受け付ける URL エンコードされたシリアライズ済み文字列（ver,complete!node!node）を生成
- Validate モードは JSON schain とシリアライズ済み文字列のどちらも受け付け
- asi、sid、hp の欠落、不正な complete フラグ、想定外の ver を指摘
- ホップチェーンを可視化し、ノードの順序を一目で確認
- すべてブラウザ内で動作 — 販売者 id とドメインはデバイス上に留まります
schain ビルダー の使い方
- Build タブを選択したまま、各ノードの asi、sid、hp フラグを入力する
- ノードを追加し、矢印を使ってパブリッシャーから取引所への順序に並べる
- complete フラグを設定し（パス全体が宣言されている場合は 1）、JSON またはシリアライズ済み文字列をコピーする
- Validate に切り替え、既存の schain を貼り付けて必須フィールドとノード順序を確認する
例
入力
asi: exchange1.com
sid: 1234
hp: 1
complete: 1
出力
1.0,1!exchange1.com,1234,1
1 ノードは ver,complete!asi,sid,hp にシリアライズされ、JSON は source.ext.schain に入ります。
よくあるエラーとトラブルシューティング
- Validate がノードに asi、sid、hp が欠けていると報告する。 — すべてのノードには 3 つの必須フィールドが必要です: asi は広告システムの正規ドメイン、sid はそのシステムからの seller/reseller id、hp は 0 または 1 でなければなりません。
- 取引所がシリアライズ済み文字列を拒否する。 — フィールドは URL エンコードされ、asi,sid,hp,rid,name,domain の順で並べ、フィールド間はカンマ、ノード間は ! で区切ります。ヘッダーセグメントは ver,complete です。
- complete を 1 に設定したが、上流のリセラーを 1 つ落とした。 — complete=1 はすべての中間業者が宣言されていることを主張します。いずれかのホップが不明なら complete=0 に設定し、下流のビッダーにパスが部分的だと知らせてください。
- sid が sellers.json の seller id と一致しない。 — 各ノードの sid は、対応するシステムが sellers.json で公開する seller_id と等しくなければなりません。さもないとバイヤーはパスを未検証として扱います。
よくある質問
- schain（SupplyChain）オブジェクトとは何ですか？
- OpenRTB で source.ext.schain に運ばれる IAB Tech Lab のオブジェクトで、パブリッシャーと取引所の間でビッドリクエストに触れたすべての広告システムを順番に列挙するので、バイヤーが供給パスを検証できます。
- 各ノードの asi、sid、hp は何を意味しますか？
- asi は広告システムの正規ドメイン、sid はそのシステム内の seller または reseller のアカウント id（そのシステムの sellers.json に一致）、hp はそのノードが支払いフローに関与する場合に 1 です。この 3 つはノードごとに必須です。
- JSON オブジェクトとシリアライズ済み文字列の違いは何ですか？
- JSON オブジェクトは、ビッドリクエストのボディで使う完全な source.ext.schain 構造です。シリアライズ済み文字列は、コンパクトな URL エンコード形式 — ver,complete!node!node — で、各ノードは asi,sid,hp,rid,name,domain です。ヘッダーやクエリパラメータが必要な場所で使います。
- complete は 0 と 1 のどちらにすべきですか？
- パブリッシャー以降のすべての中間業者が nodes 配列に宣言されている場合にのみ complete=1 を設定してください。上流のホップが不明または省略されている場合は complete=0 に設定し、チェーンが不完全だとビッダーに知らせてください。
- このツールは私の広告タグやビッドリクエストをサーバーからフェッチしますか？
- いいえ。schain を貼り付けるか構築すると、すべて — シリアライズ、解析、検証 — がブラウザ内でローカルに行われます。入力した販売者 id、ドメイン、ノードデータが ArrayKit に送られることはありません。
- ライブのビッドリクエストからコピーした schain を検証できますか？
- はい。JSON オブジェクト（source.ext.schain のラップを含む）またはシリアライズ済み文字列として Validate モードに貼り付けると、ツールが必須のノードフィールド、complete フラグ、ver を確認し、ホップチェーンを描きます。
関連ツール
すべての ArrayKit ツール