翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ORTB フィールドリファレンス
<a name="yield-optimization-ortb-reference"></a>

このページは、OpenRTB 入札リクエストのすべてのフィールドの完全なリファレンスです。フィールドは、MediaTailor がフィールドを処理する方法と、最適な広告フィルのために APS がフィールドを要求または推奨するかどうかによって分類されます。

OpenRTB 2.6 の完全な仕様については、[「IAB OpenRTB 2.6 仕様](https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/main/2.6.md)」を参照してください。

## フィールドカテゴリ
<a name="yield-optimization-ortb-reference-categories"></a>


| Category | 意味 | アクション | 
| --- | --- | --- | 
| 必須 | テンプレートに存在する必要があります。MediaTailor が見つからない場合はエラーをスローします。 | これらを指定する必要があります。 | 
| EMT によるハードコード | MediaTailor は、コンソール設定または現在の可用性コンテキストの値を使用してこれらを常に設定します。テンプレートの値は上書きされます。 | テンプレートでこれらを設定しないでください。 | 
| APS 推奨 | MediaTailor では厳密に必須ではありませんが、APS では広告のフィルとターゲティングを改善するためにこれらを推奨しています。推奨フィールドがないと、フィルレートが低くなったり、入札なしのレスポンスになる可能性があります。 | 強くお勧めします。 | 
| オプション | 指定した場合にのみ、入札リクエストに含まれます。デフォルト値はありません。 | ユースケースに関連する場合は、 を指定します。 | 

## `app` オブジェクト
<a name="yield-optimization-ortb-reference-app"></a>


| フィールド | Category | 注意事項 | 
| --- | --- | --- | 
| app | 必須 | app オブジェクトはテンプレートに存在する必要があります。 | 
| app.bundle | 必須 | アプリのバンドル ID ( などG15147002586)。空にすることはできません。 | 
| app.storeurl | 必須 | App Store URL (例: https://apps.apple.com/us/app/yourapp/id123)。 | 
| app.publisher.id | EMT によるハードコード | コンソール設定PublisherIdから常に を に設定します。 | 
| app.content | 必須 (オブジェクト) | MediaTailor は、これを省略すると空のContentオブジェクトを送信します。ターゲティングを向上させるためにコンテンツメタデータを提供します。 | 
| app.name | APS 推奨 | 識別用のアプリケーション名。 | 
| app.id | APS 推奨 | APS のアプリ識別子。 | 
| app.domain | APS 推奨 | アプリドメイン。 | 
| app.content.genre | APS 推奨 | コンテンツジャンル (、 など"Sport""News")。 | 
| app.content.contentrating | APS 推奨 | コンテンツ評価 (例: 、"TV-G""TV-14")。 | 
| app.content.language | APS 推奨 | コンテンツ言語 (ISO-639-1)。 | 
| app.content.id | APS 推奨 | コンテンツ識別子。 | 
| app.content.title | APS 推奨 | コンテンツのタイトル。 | 
| app.content.episode | APS 推奨 | エピソード番号。 | 
| app.content.len | APS 推奨 | 秒単位のコンテンツの長さ。 | 
| app.cat | オプションです。 | コンテンツカテゴリ (IAB 分類）。 | 
| app.sectioncat | オプションです。 | セクションカテゴリ。 | 
| app.pagecat | オプションです。 | ページカテゴリ。 | 
| app.ver | オプションです。 | アプリのバージョン。 | 
| app.privacypolicy | オプションです。 | 1 = プライバシーポリシーがあります。 | 
| app.paid | オプションです。 | 1 = 有料アプリ。 | 
| app.keywords | オプションです。 | カンマ区切りキーワード。 | 
| app.kwarray | オプションです。 | 配列としてのキーワード。 | 
| app.inventorypartnerdomain | オプションです。 | インベントリパートナードメイン。 | 
| app.ext | オプションです。 | 拡張オブジェクト (パススルー）。 | 

## `device` オブジェクト
<a name="yield-optimization-ortb-reference-device"></a>


| フィールド | Category | 注意事項 | 
| --- | --- | --- | 
| device | 必須 | device オブジェクトはテンプレートに存在する必要があります。 | 
| device.ua | 必須 | ユーザーエージェントの文字列。空にすることはできません。{{session.user\_agent}} を使用します。 | 
| device.ip | 必須 | IPv4 アドレス。空にすることはできません。{{session.client\_ip}} を使用します。 | 
| device.lmt | オプション (デフォルト: 0) | 広告追跡制限フラグ。 0 = 追跡を許可、 1 = 追跡制限。テンプレートで指定されていない場合、 はデフォルトで になります0。 | 
| device.devicetype | EMT でハードコード (デフォルト: 3) | MediaTailor は、指定されていない場合は 3 (接続されたテレビ) を設定します。値が存在する場合は が使用されます。 | 
| device.make | APS 推奨 | デバイス製造元 (例: 、"Samsung""Apple")。 | 
| device.model | APS 推奨 | デバイスモデル (、 など"Tizen TV""iPhone")。 | 
| device.os | APS 推奨 | オペレーティングシステム (、 など"Tizen""iOS")。 | 
| device.osv | APS 推奨 | OS バージョン。 | 
| device.h | APS 推奨 | ピクセル単位の画面の高さ。 | 
| device.w | APS 推奨 | ピクセル単位の画面幅。 | 
| device.language | APS 推奨 | デバイス言語 (ISO-639-1)。 | 
| device.ifa | APS 推奨 | デバイスアドバタイズ ID。すべてのデバイスに 1 つのデバイス (ウェブブラウザなど) があるわけではありません。 | 
| device.dnt | APS 推奨 | 追跡しないフラグ。 | 
| device.geo | オプションです。 | country、、 latを持つ Geo オブジェクトlon。 | 
| device.sua | オプションです。 | 構造化ユーザーエージェント (UA-CH)。 | 
| device.ipv6 | オプションです。 | IPv6 アドレス。 | 
| device.hwv | オプションです。 | ハードウェアバージョン。 | 
| device.connectiontype | オプションです。 | 接続タイプ (WiFi、セルラーなど）。 | 
| device.carrier | オプションです。 | キャリア名。 | 
| device.mccmnc | オプションです。 | モバイルの国/ネットワークコード。 | 
| device.ext | オプションです。 | 拡張オブジェクト (パススルー）。 | 

## `imp` (インプレッション) オブジェクト
<a name="yield-optimization-ortb-reference-imp"></a>

テンプレートには、配列に **1** つの`imp`オブジェクトのみが含まれている必要があります。


| フィールド | Category | 注意事項 | 
| --- | --- | --- | 
| imp[0].video | 必須 | video オブジェクトが存在している必要があります。 | 
| imp[0].video.mimes | 必須 | サポートされている MIME タイプ (例: ["video/mp4"])。 | 
| imp[0].video.protocols | オプション | サポートされている VAST プロトコル。省略すると、MediaTailor はハードコードされたフォールバック を使用します[1, 2, 3, 4, 5, 6, 7, 8]。以下のプロトコル列挙リファレンスを参照してください。 | 
| imp[0].video.minduration | EMT によるハードコード | コンソールMinimumUnfilledDurationから を に設定します。 | 
| imp[0].video.maxduration | EMT によるハードコード | を実際の未入力時間 (秒) に設定します。 | 
| imp[0].video.maxseq | EMT によるハードコード | 計算: floor(unfilled\_duration / 6)。APS では、複数の広告を返すpoddurように maxseqまたは を推奨しています。 | 
| imp[0].video.poddur | EMT によるハードコード | を未入力の期間 (秒) に設定します。 | 
| imp[0].video.startdelay | オプションです。 | 開始遅延。 0 = プリロール、 -1 = 汎用ミッドロール、 -2 = ポストロール、 > 0 = 秒単位のミッドロールオフセット。ライブミッドロールブレーク-1に使用します。ハードコードされたフォールバック: 6。 | 
| imp[0].video.w | APS 推奨 | ピクセル単位の動画幅。 | 
| imp[0].video.h | APS 推奨 | ピクセル単位の動画の高さ。 | 
| imp[0].video.plcmt | APS 推奨 | 配置タイプ (1 = ストリーム内）。 | 
| imp[0].video.podid | APS 推奨 | ポッド識別子。 | 
| imp[0].video.slotinpod | APS 推奨 | ポッド内のスロット位置。 | 
| imp[0].video.ext.slotId | オプション (デフォルト: "default\_slot\_id") | APS コンソールの APS スロット ID。デフォルトは機能しますが、実際のスロット ID を指定すると、APS はスロット固有のターゲット設定と下限料金を適用できます。 | 
| imp[0].bidfloor | オプション (デフォルト: 1.0) | CPM での最低入札価格。 | 
| imp[0].secure | オプション (デフォルト: 1) | 1 = HTTPS クリエイティブ URLsが必要です。 | 
| imp[0].id | オプションです。 | インプレッション ID。指定しない場合、自動生成されます。 | 
| imp[0].tagid | オプションです。 | タグ/配置 ID。 | 
| imp[0].bidfloorcur | オプションです。 | 入札価格の通貨 (デフォルト USD)。 | 
| imp[0].ssai | オプションです。 | SSAI インジケータ。 | 
| imp[0].exp | オプションです。 | インプレッションの有効期限。 | 
| imp[0].rqddurs | オプションです。 | リクエストされた durations 配列。 | 
| imp[0].mincpmpersec | オプションです。 | 1 秒あたりの最小 CPM。 | 
| imp[0].pmp | オプションです。 | プライベートマーケットプレイスオブジェクト。 | 
| imp[0].ext | オプションです。 | 拡張オブジェクト (パススルー）。 | 

### プロトコル列挙リファレンス
<a name="yield-optimization-ortb-reference-protocol-enum"></a>


| 値 | プロトコル | 
| --- | --- | 
| 1 | VAST 1.0 | 
| 2 | VAST 2.0 | 
| 3 | VAST 3.0 | 
| 4 | VAST 1.0 ラッパー | 
| 5 | VAST 2.0 ラッパー | 
| 6 | VAST 3.0 ラッパー | 
| 7 | VAST 4.0 | 
| 8 | VAST 4.0 ラッパー | 
| 9 以上 | デート | 

## 最上位フィールド
<a name="yield-optimization-ortb-reference-top-level"></a>


| フィールド | Category | 注意事項 | 
| --- | --- | --- | 
| id | EMT によるハードコード | 自動生成: {sessionId}\_{availId}形式 (例: abc123-def456\_78901)。入札リクエストとセッションログの関連付けに役立ちます。 | 
| cur | オプション (デフォルト: ["USD"]) | 使用できる通貨。 | 
| ext.integrationType | EMT によるハードコード | 常に を に設定します"EMT"。 | 
| bcat | オプションです。 | ブロック広告カテゴリ (IAB 分類）。テンプレート値は APS にそのまま送信されます。 | 
| badv | オプションです。 | ブロックされたアドバタイザードメイン。 | 
| bapp | オプションです。 | ブロックされたアプリケーションバンドル IDs。 | 
| test | オプションです。 | テストモードフラグ。 | 
| at | オプションです。 | Auction タイプ。 | 
| tmax | オプションです。 | 入札応答を待機する最大時間 (ms)。 | 
| wseat | オプションです。 | 許可された購入者の座席。 | 
| bseat | オプションです。 | 購入者の座席がブロックされました。 | 
| wlang | オプションです。 | 許可されたクリエイティブ言語。 | 
| source | オプションです。 | サプライチェーンのソースオブジェクト。 | 
| ext | オプションです。 | カスタム拡張フィールドは EMT の とマージされますintegrationType。 | 

## `user` オブジェクト
<a name="yield-optimization-ortb-reference-user"></a>


| フィールド | Category | 注意事項 | 
| --- | --- | --- | 
| user | APS 推奨 (EU) | GDPR の同意がある EU トラフィックに必要です。 | 
| user.consent | APS 推奨 (EU) | GDPR 同意文字列 (TCF)。 | 
| user.id | オプションです。 | ユーザー ID | 
| user.buyeruid | オプションです。 | 購入者固有のユーザー ID。 | 
| user.eids | オプションです。 | 拡張識別子 (LiveRamp、UID2 など）。 | 
| user.data | オプションです。 | ユーザーデータセグメント。 | 
| user.ext | オプションです。 | 拡張オブジェクト。 | 

## `regs` オブジェクト
<a name="yield-optimization-ortb-reference-regs"></a>


| フィールド | Category | 注意事項 | 
| --- | --- | --- | 
| regs | APS 推奨 | 規制コンプライアンスのために を含めます。 | 
| regs.coppa | APS 推奨 (米国) | COPPA フラグ (1 = child-directed)。 | 
| regs.us\_privacy | APS 推奨 (米国) | 米国プライバシー/CCPA 文字列。 | 
| regs.gdpr | APS 推奨 (EU) | GDPR が適用されます (1 = はい）。 | 
| regs.gpp | APS 推奨 | グローバルプライバシープラットフォームの文字列。米国の視聴者に us\_privacyよりも優先されるため、フィルレートが向上します。「[ベストプラクティス](yield-optimization-best-practices.md)」を参照してください。 | 
| regs.gpp\_sid | APS 推奨 | GPP IDs (米国国民[7]向けなど）。gpp が存在する場合に必要です。 | 
| regs.ext | オプションです。 | 拡張オブジェクト。 | 

## 次の手順
<a name="yield-optimization-ortb-reference-next-steps"></a>
+ コピー/貼り付けテンプレートについては、「」を参照してください[テンプレートの例](yield-optimization-examples.md)。
+ フィルレートの最大化に関する推奨事項については、「」を参照してください[ベストプラクティス](yield-optimization-best-practices.md)。