View a markdown version of this page

ORTB フィールドリファレンス - AWS Elemental MediaTailor
フィールドカテゴリapp オブジェクトdevice オブジェクトimp (インプレッション) オブジェクト最上位フィールドuser オブジェクトregs オブジェクト次の手順

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

ORTB フィールドリファレンス

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

OpenRTB 2.6 の完全な仕様については、「IAB OpenRTB 2.6 仕様」を参照してください。

フィールドカテゴリ

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

app オブジェクト

フィールド 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 オブジェクト

フィールド 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 (インプレッション) オブジェクト

テンプレートには、配列に 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 オプションです。 拡張オブジェクト (パススルー）。

プロトコル列挙リファレンス

値 プロトコル
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 以上 デート

最上位フィールド

フィールド 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 オブジェクト

フィールド 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 オブジェクト

フィールド 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よりも優先されるため、フィルレートが向上します。「ベストプラクティス」を参照してください。
regs.gpp_sid APS 推奨 GPP IDs (米国国民[7]向けなど）。gpp が存在する場合に必要です。
regs.ext オプションです。 拡張オブジェクト。

次の手順

  • コピー/貼り付けテンプレートについては、「」を参照してくださいテンプレートの例。

  • フィルレートの最大化に関する推奨事項については、「」を参照してくださいベストプラクティス。