# 入札リクエスト

> デマンドパートナーがオークション信号を効果的に解釈して対応できるようにします。

Unity が広告リクエストを受信すると、SDK は、ユーザーが使用を制限していない場合にパーソナライズ広告に使用されるデータを含む、すべての入札者候補に入札リクエストを送信します ([データプライバシー](/grow/programmatic/unity-exchange/data-privacy.md)に関するドキュメントを参照)。

Unity は、入札リクエストデータの JSON 形式をサポートしています。標準 JSON 表現の MIME 型は `application/json` で、HTTP ヘッダーフィールドで以下のように指定します。

```text
contentType: application/json

Accept-エンコード： gzip
```

Unity はリクエストで承諾エンコード [GZIP](https://www.gzip.org/) 圧縮を送信し、反応を圧縮することを強く推奨します。詳細については、[OpenRTB 仕様](https://iabtechlab.com/wp-content/uploads/2022/04/OpenRTB-2-6_FINAL.pdf)の**セクション 2.4** を参照してください。

> **Important:**
>
> エンドポイントが入札リクエストを受信するには、`HTTPS`プロトコルをサポートする必要があります。

> **Note:**
>
> 以下の各入札リクエスト属性は、使用可能な場合に Unity によって渡されます。ただし、説明の列に特に記載がない場合は例外です。

## request objects##request

最上位の入札リクエスト オブジェクトには、広告リクエストのグローバルな一意の ID が含まれます。

| **Attribute** | **型**        | **例**                                                                                                             | **説明**                                                                                                            |
| ------------- | ------------ | ----------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `id`          | string       | `"id": "bcaIDT1Nbv0zU8mn9tXQ6j"`                                                                                  | Unity によって生成された ID。このIDは[入札反応オブジェクト](/grow/programmatic/unity-exchange/bid-responses.md)で返す必要があります。               |
| `imp`         | object       | 詳細については、[`impression objects`](#imp)のセクションを参照してください。                                                              | Unityは、入札リクエストごとに1つの`imp`オブジェクトをサポートします。                                                                          |
| `pmp`         | object       | 詳細については、[`pmp objects`](#pmp)のセクションを参照してください。                                                                     | インプレッションに関連する可能性のある、買い手と売り手の間の直接取引のためのプライベートマーケットプレイスコンテナ。実際の取引は、[`deal objects`](#deal)のコレクションとして表されます。          |
| `app`         | object       | 詳細については、[`app objects`](#app)のセクションを参照してください。                                                                     | プロジェクトまたはアプリケーションを記述するオブジェクト。                                                                                     |
| `device`      | object       | 詳細については、[`device objects`](#device)のセクションを参照してください。                                                               | ユーザーのデバイスを示すオブジェクト。                                                                                               |
| `user`        | object       | 詳細については、[データプライバシー](/grow/programmatic/unity-exchange/data-privacy.md#user-object-extension)に関するドキュメントを参照してください。  | デバイスのユーザー、または広告のオーディエンスを表すオブジェクト。                                                                                 |
| `at`          | int          | `"at": 1`                                                                                                         | 使用されるオークションタイプ。Unity Exchange オークションはすべてファースト プライス オークションであるため、値は常に `1` です。                                       |
| `tmax`        | int          | `"tmax": 200`                                                                                                     | タイムアウト値 (ミリ秒)。Unity では、ネットワーク接続の切断を避けるために、パートナーが 200 ミリ秒以内に応答することを推奨しています。                                        |
| `bcat`        | string array | `"bcat": ["IAB9-9", "IAB8"]`                                                                                      | [IAB 分類 ID](/grow/programmatic/unity-exchange/iab-category-mapping.md) を使用して、ブロックされた広告主カテゴリ。この属性はサポートされていますが任意です。 |
| `bapp`        | string array | `"bapp": ["com.foo.mygame"]`                                                                                      | ブロックされたアプリケーションのリスト。特定のプラットフォームで表されます。Android では、これらはバンドル名またはパッケージ名です。iOS では、これらは数値 ID です。                        |
| `source`      | object       | 詳細については、[`source objects`](#source) を参照してください。                                                                    | インベントリソースに関するデータを提供し、どのエンティティが最終決定を行うかを示すオブジェクト。                                                                  |
| `regs`        | object       | 詳細については、[データプライバシー](/grow/programmatic/unity-exchange/data-privacy.md#user-object-extension) に関するドキュメントを参照してください。 | このリクエストに適用される業界、法律、または政府の規制を指定するオブジェクト。                                                                           |

## ソースオブジェクト##source

エクスチェンジからアップストリームの入札リクエストのソースであるエンティティの性質と動作を記述するオブジェクトクラス。このオブジェクトの主な目的は、オークション後または上流の意思決定を定義し、エクスチェンジ自体が最終決定をコントロールしない場合に使用します。詳細については、[OpenRTB ガイドライン](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)の「 **オブジェクト： ソース** 」セクションを参照してください。

| **Attribute**               | **型**  | **例**                                      | **説明**                                                                                                                                                    |
| --------------------------- | ------ | ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `pchain`                    | string | `"pchain": "12abcd3456789:12345"`          | [タグ支払い ID プロトコル v1.0](https://www.tagtoday.net/hubfs/CAF/TAG%20Certified%20Against%20Fraud%20Guidelines%20v1%202016.pdf) で説明されている埋め込み構文を含む支払いチェーン ID 文字列。 |
| `schain`                    | object | 詳細は、[チェーンオブジェクト](#schain) のセクションを参照してください。 | このオブジェクトは、サプライチェーンのリンクと、サプライチェーンが完了したかどうかを示すインジケータの両方を表します。                                                                                               |
| `source.ext.omidpn`         | string | `"omidpn": "Unity3d"`                      | [Open Measurement](/grow/programmatic/unity-exchange/open-measurement.md) SDK インテグレーションの識別子。これはOMID Partnerオブジェクトの`name`パラメーターと同じです。                      |
| `source.ext.omidpv`         | string | `"omidpv": "1.3.0"`                        | [Open Measurement](/grow/programmatic/unity-exchange/open-measurement.md) SDK インテグレーションのバージョン。これはOMID Partnerオブジェクトの`versionString`パラメーターと同じです。           |
| `source.ext.header_bidding` | int    | `"header_bidding": 0`                      | オークションの種類を示します。1 は入札、0 はウォーターフォールです。                                                                                                                      |
| `source.ext.fd`             | int    | `"fd": 0`                                  | インプレッション販売の最終決定を担当するエンティティ。0 ＝ エクスチェンジ、1 ＝ アップストリームソース。                                                                                                   |

## schain オブジェクト##schain

このオブジェクトは、サプライチェーン内のリンクと、サプライチェーンが完了したかどうかを示すインジケータの両方を表します。

| **Attribute** | **型**    | **例**           | **説明**                                                                                                                                                                                              |
| ------------- | -------- | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `complete`    | int      | `"complete": 1` | サイト、アプリケーション、またはインベントリの他の媒体の所有者につながるトランザクションに関連するすべてのノードがチェーンに含まれているかどうかを示すフラグ。- `0` は no を示します。
- `1` は yes を示します。                                                                                 |
| `nodes`       | オブジェクト配列 | 例が必要            | チェーンの順に並べた[`SupplyChainNode`](#nodes)オブジェクトの配列。サプライチェーン全体では、最初のノードはトランザクションに関連する最初の広告システムと販売者 ID (サイト、アプリケーション、その他の媒体の所有者など) を表します。不完全なサプライチェーンでは、既知の最初のノードを表します。最後のノードは、この入札リクエストを送信するエンティティを表します。 |
| `ver`         | string   | `"ver": "1.0"`  | 使用されているサプライチェーン仕様のバージョン。`"major.minor"`の形式。                                                                                                                                                         |

## ノード オブジェクト##nodes

トランザクションサプライチェーンに関与するエンティティを表すオブジェクト。

| **Attribute** | **型**  | **例**                                                      | **説明**                                                                                                                                           |
| ------------- | ------ | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `asi`         | string | `"asi":"unity.com"`                                        | 入札者が接続するシステムのドメイン名。これは、システムの運用ドメインである可能性があります (親企業ドメインと異なる場合)。これは、`app-ads.txt`ファイルで販売者を識別するために使用される値と同じである必要があります (存在する場合)。                     |
| `sid`         | string | `"sid":"​​1596090"`                                        | 広告システム内の売り手またはリセラーアカウントに紐づけられた ID。これは OpenRTB トランザクションで使用される値と同じ値を含む必要があります。これは通常、`publisher.id` です。このフィールドの長さを 64 文字に制限。                        |
| `rid`         | string | `"rid": "582f5fb3-0cc6-4944-ab12-1233175675e8-9999-36946"` | この売り手によって発行されたリクエストの OpenRTB `RequestId`。                                                                                                        |
| `hp`          | int    | `"hp":1`                                                   | このノードがインベントリの支払いフローに関与しているかどうかを示します。- `0`は、このノードが支払いフローに関与していないことを示します。
- `1` は、asi フィールドの広告システムが、チェーン内の前のノードの支払いを担当する sid フィールドの販売者に支払うことを示します。 |

## imp objects##imp

オークションに出品されるアドインプレッションを記述するオブジェクトクラス。

| **Attribute**           | **型**  | **例**                                                                                                          | **説明**                                                                                                                   |
| ----------------------- | ------ | -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `banner`                | object | 詳細については、[`banner`オブジェクト](#banner)のセクションを参照してください。                                                              | バナーディスプレイインプレッションを記述するオブジェクト。Unity はバナーおよびディスプレイ広告に対してのみこの属性を渡します。                                                       |
| `bidfloor`              | float  | `"bidfloor": 3.95`                                                                                             | このインプレッションを獲得するために必要な最小 CPM 入札額。米ドルで表されます。                                                                               |
| `displaymanager`        | string | `"displaymanager": "unity sdk"`                                                                                | 広告のレンダリングを担当する広告メディエーションパートナー、SDK テクノロジー、またはプレイヤーの名前。                                                                    |
| `displaymanagerver`     | string | `4001`                                                                                                         | 広告のレンダリングを担当する広告メディエーションパートナー、SDK テクノロジー、またはプレイヤーのバージョン。                                                                 |
| `id`                    | string | `"id": "1"`                                                                                                    | Unity は入札リクエストごとに 1 つの`imp`オブジェクトをサポートするため、`id`値は常に `1` です。                                                              |
| `instl`                 | int    | `"instl": 1`                                                                                                   | バナー広告リクエストの値は `0` です。その他すべてのプレースメントはインタースティシャルで、値は `1` です。                                                               |
| `secure`                | int    | `"secure": 1`                                                                                                  | Unity では、インプレッションに安全な`HTTPS URL`クリエイティブアセットとマークアップが必要です。値は常に `1` です。                                                     |
| `tagid`                 | string | `"tagid": "com.this.game-video"`                                                                               | Unity は識別子として`&#x3C;appID>-&#x3C;adType>`を渡します。                                                                          |
| `video`                 | object | 詳細は、[ビデオオブジェクト](#video) のセクションを参照してください。                                                                       | 動画インプレッションを記述するオブジェクト。Unity は、動画広告に対して常にこの属性を渡します。                                                                       |
| `ext.skadn`             | object | 詳細については、[iOS 14 のサポート](/grow/programmatic/unity-exchange/ios14-support.md#impression-ext) に関するドキュメントを参照してください。 | DSP がパブリッシャーアプリ `Info.plist` のファイルに少なくとも 1 `SKAdNetworkItem` つ存在する場合、Unity はこのオブジェクトを入札リクエストに加えます。これは、署名の作成に必要な情報を提供します。 |
| `ext.skadn.skoverlay`   | 整数     | `1`                                                                                                            | SKOverlay 特徴の適格性を示します。- `1` は、imp が SKOverlay の表示に適していることを示します。
- `0` は、imp が SKOverlay の表示に適さないことを示します。                 |
| `ext.skadn.productpage` | 整数     | `1`                                                                                                            | カスタムプロダクトページ特徴の適格性を示します。- `1` imp がカスタムプロダクトページの表示に適していることを示します。
- `0` は、imp がカスタムプロダクトページを表示できないことを示します。                |
| `ext.skadn.ext.ask`     | 整数     | `1`                                                                                                            | 自動ストアキット特徴の適格性を示します。- `1` IMP が Auto Storekit の表示に適していることを示します。
- `0` IMP が Auto Storekit の表示に適さないことを示します。               |

### video objects##video

動画アドインプレッションを記述する `impression` オブジェクト クラスのサブセット。詳細については、[OpenRTB 仕様](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)の**セクション 3.2.7** を参照してください。

| **Attribute**   | **型**        | **例**                              | **説明**                                                                                                                                                                                                                                                                                                                                                                                 |
| --------------- | ------------ | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `api`           | int 配列       | `"api": [7]`                       | このインプレッションでサポートされる API フレームワーク。値 `7` は Open Measurement サポートを示します。詳細については、[OM 拡張機能](/grow/programmatic/unity-exchange/om-extensions.md) に関するドキュメントを参照してください。                                                                                                                                                                                                                           |
| `battr`         | int 配列       | `"battr": [ 1, 3, 5, 6, 8, 9, 13]` | ブロックされたクリエイティブ属性の配列。サポートされている値の完全なリストについては、[OpenRTB 仕様](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf) の **表 5.3** を参照してください。Unity のポリシーでは、デフォルトで以下のブロックします。\[1]オーディオ広告(自動再生)拡張可能な\[3] (自動)拡張可能な\[5] (ユーザー主導 - ロールオーバー)バナー内動画広告の\[6]\(自動再生)Pop の\[8] (例えば、Over、Under、Upon Exit)挑発的または暗示的な画像の\[9]\[13] ユーザーインタラクティブ (例えば、埋め込まれたプロジェクト) |
| `h`             | int          | `"h": 600`                         | ビデオプレイヤーの高さ。単位はデバイス非依存ピクセル (DIPS)。                                                                                                                                                                                                                                                                                                                                                     |
| `maxduration`   | int          | `"maxduration": 30`                | 動画広告の最大継続時間（秒単位）。この値は常に `30` です。                                                                                                                                                                                                                                                                                                                                                       |
| `mimes`         | string array | `"mimes": ["video/mp4"]`           | サポートされているコンテンツ MIME タイプ (`"video/mp4"` など)。                                                                                                                                                                                                                                                                                                                                            |
| `minduration`   | int          | `"minduration": 5`                 | 動画広告の最小継続時間（秒単位）。この値は常に `5` です。                                                                                                                                                                                                                                                                                                                                                        |
| `placement`     | int          | `"placement": 5`                   | Unity でサポートされているビデオ配置タイプは次のとおりです。- `1` はインストリームを示します。
- `5` はインタースティシャルを示します。                                                                                                                                                                                                                                                                                                          |
| `pos`           | int          | `"pos": 7`                         | ビデオ広告の位置。Unity Ads インベントリは常に全画面（`7`）に設定されています。サポートされている値の完全なリストについては、[OpenRTB 仕様](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf) の **表 5.4** を参照してください。                                                                                                                                                                               |
| `protocols`     | int 配列       | `"protocols": [2, 3, 5, 6]`        | サポートされているビデオ プロトコルの配列。サポートされている値の完全なリストは、[OpenRTB 仕様](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf) の **表 5.8** を参照してください。Unity は VAST 2.0 (2) と VAST 2.0 Wrapper (5) を完全にサポートしており、VAST 3.0 (3) と VAST 3.0 Wrapper (6) の一部の機能をサポートしている場合があります。詳細については、アカウントマネージャに確認してください。                                                           |
| `w`             | int          | `"w": 1024`                        | ビデオプレイヤーの幅 (デバイス非依存ピクセル、DIPS)。                                                                                                                                                                                                                                                                                                                                                         |
| `companiontype` | int 配列       | `"companiontype": [1,2,3]`         | (`1`)、`HTMLResource`(`2`)、`IFrameResource`(`3`) など `StaticResource` 、サポートされているエンドカードタイプの配列。                                                                                                                                                                                                                                                                                            |
| `linearity`     | int          | `"linearity": 1`                   | インプレッションがリニアかどうかを示します。Unity Exchange の場合、この値は常に です `1`。                                                                                                                                                                                                                                                                                                                                |
| `skip`          | int          | `"skip": 1`                        | 動画をスキップできるかどうかを示します。- `0` ビデオをスキップできないことを示します。
- `1` は、ビデオをスキップできることを示します。Unity Exchange の場合、この値は常に です `1`。                                                                                                                                                                                                                                                                            |
| `sequence`      | int          | `"sequence": 1`                    | 同じ入札リクエストで複数の広告インプレッションが提供される場合は、シーケンス番号を使用して複数のクリエイティブを連携して配信できます。Unity Exchange の場合、この値は常に です `1`。                                                                                                                                                                                                                                                                                   |

### バナー objectsバナー##banner

バナーアドインプレッションを記述する `impression` オブジェクト クラスのサブセット。詳細については、[OpenRTB 仕様](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)の**セクション 3.2.6** を参照してください。

| **Attribute** | **型**        | **例**                             | **説明**                                                                                                                                                                                                                                                                                                                                                              |
| ------------- | ------------ | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `api`         | int 配列       | `"api": [6]`                      | パブリッシャーがサポートするバナー API フレームワーク。UnityはMRAID 3.0(`6`)をサポートします。サポートされている値の完全なリストについては、[OpenRTB 仕様](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf) の表 **5.6 API Frameworks** を参照してください。                                                                                                                                 |
| `battr`       | int 配列       | `"battr": [ 1, 3, 5, 6, 8, 9]`    | ブロックされたバナー属性の配列。サポートされている値の完全なリストについては、[OpenRTB 仕様](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf) の **表 5.3** を参照してください。Unity のポリシーでは、デフォルトで以下のブロックします。- `[1]`オーディオ広告(自動再生)
- 拡張可能な`[3]` (自動)
- 拡張可能な`[5]` (ユーザー主導 - ロールオーバー)
- バナー内動画広告の`[6]`(自動再生)
- Pop の`[8]` (例えば、Over、Under、Upon Exit)
- 挑発的または暗示的な画像の`[9]` |
| `format`      | object array | `"format": [{"w": 728, "h": 90}]` | サポートされているバナーディスプレイサイズを表すオブジェクトの配列バナークリエイティブ形式対応サイズ:- 320x50
- 728x90ディスプレイリエイティブ形式がサポートするサイズ:- 250x300
- 300x250
- 320x480
- 1024x768imp.banner オブジェクトはモバイル バナーおよびインタースティシャル ディスプレイ要求に対してだけ渡されます。形式を指定しない場合、ディメンションのデフォルトはimp.banner.hとimp.banner.wの値になります。バナー形式を指定しない場合、ディメンションのデフォルトはhとwの値になります。さまざまな寸法のサポートについて質問がある場合は、Unity サポートに接触してください。                     |
| `h`           | int          | `"h": 320`                        | バナー ディスプレイの高さ（デバイス非依存ピクセル（DIPS）単位）。                                                                                                                                                                                                                                                                                                                                 |
| `pos`         | int          | `"pos": 7`                        | バナー広告の位置。サポートされている値の完全なリストについては、[OpenRTB 仕様](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf) の **表 5.4** を参照してください。                                                                                                                                                                                                 |
| `w`           | int          | `"w": 480`                        | バナーディスプレイの幅（デバイス非依存ピクセル（DIPS）単位）。                                                                                                                                                                                                                                                                                                                                   |

## pmp objects##pmp

インプレッションに関連する可能性のある買い手と売り手間の直接取引のプライベートマーケットプレイス属性を記述するオブジェクトクラス。詳細については、[OpenRTB 仕様](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)の**セクション 3.2.11** を参照してください。

| **Attribute**     | **型**        | **例**                                           | **説明**                                                                                                                    |
| ----------------- | ------------ | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| `deals`           | object array | 詳細については、[`deal objects`](#deal)のセクションを参照してください。 | このインプレッションに適用される特定の取引を示す`deal`オブジェクトの配列。                                                                                  |
| `private_auction` | int          | `"private_auction": 0`                          | [`deal`](#deal) オブジェクトで指定されたシートのオークション参加資格を示します。- `0`(デフォルト)は、すべての入札が承認されたことを示します。
- `1`は、入札が指定された取引とその条件に限定されていることを示します。 |

## deal オブジェクト##deal

買い手と売り手の間に確立された特定の取引を示すオブジェクトクラス。そのインプレッションの存在は、その取引の条件の下でインプレッションが利用可能であることを示します。詳細については、[OpenRTB 仕様](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)の**セクション 3.2.12** を参照してください。

| **Attribute** | **型**  | **例**                 | **説明**                                                                                                                                       |
| ------------- | ------ | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `at`          | int    | `"at": 1`             | 入札リクエストのオークション タイプの任意のオーバーライド:- `1` はファーストプライスオークションであることを示します。
- `2`はセカンドプライスオークションであることを示します。
- `3`は、`bidfloor`で渡された値が合意された取引価格であることを示します。 |
| `id`          | string | `"id": "abcdef12345"` | 直接取引の一意の識別子。                                                                                                                                 |

## アプリケーションオブジェクト##app

広告リクエストを行うアプリケーションを記述するオブジェクトクラス。詳細については、[OpenRTB 仕様](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)の**セクション 3.2.14** を参照してください。

| **Attribute** | **型**  | **例**                                                                          | **説明**                                                                                                                                                   |
| ------------- | ------ | ------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `bundle`      | string | Google の例:`"bundle": "com.unityexample.game"`Apple の例：`"bundle": "1198634425"` | アプリケーション バンドルまたはパッケージ名。Exchange 全体で一意の名前です。- Android アプリケーションはバンドル ID を渡します。
- iOS アプリがバンドル ID またはストア ID を渡す。この属性は、パブリッシャーとの契約上の合意によって禁止されている状況では渡されません。 |
| `id`          | string | `"id": "a1b2c3d4e5f6g7h8i9j0123456789abc"`                                     | 取引所固有のアプリケーション ID。                                                                                                                                       |
| `name`        | string | `"name": "Trash Dash"`                                                         | アプリケーション名。この属性は、パブリッシャーとの契約上の合意によって禁止されている状況では渡されません。                                                                                                    |
| `publisher`   | object | `"publisher": "ExamplePublisher"`                                              | エクスチェンジ固有のパブリッシャー ID。                                                                                                                                    |
| `storeurl`    | string | `"storeurl": "https://itunes.apple.com/us/app/trash-dash/id1198634425?mt=8"`   | インストールされたアプリケーションのストア URL（QAG 1.5 準拠の場合）。この属性は、パブリッシャーとの契約上の合意によって禁止されている状況では渡されません。                                                                     |

## パブリッシャーオブジェクト##publisher

広告リクエストを行うパブリッシャーを記述するオブジェクトクラス。詳細については、[OpenRTB 仕様](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)の**セクション 3.2.15** を参照してください。

| **Attribute** | **型**  | **例**                                      | **説明**                |
| ------------- | ------ | ------------------------------------------ | --------------------- |
| `id`          | string | `"id": "a1b2c3d4e5f6g7h8i9j0123456789abc"` | エクスチェンジ固有のパブリッシャー ID。 |

## デバイス objects#デバイス##device

終了ユーザーのデバイスを示すオブジェクトクラス。詳細については、[OpenRTB 仕様](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)の**セクション 3.2.18** を参照してください。

| **Attribute**    | **型**  | **例**                                                                                                                                                                                 | **説明**                                                                                                                                                                                                                                                                                                                                                    |
| ---------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `connectiontype` | int    | `"connectiontype": 1`                                                                                                                                                                 | ネットワーク接続タイプ。サポートされている値の完全なリストについては、[OpenRTB 仕様](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)の**表 5.22**を参照してください。                                                                                                                                                                                      |
| `devicetype`     | int    | `"devicetype": 4`                                                                                                                                                                     | デバイスの一般的なタイプ。サポートされている値の完全なリストについては、[](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf)[OpenRTB 仕様](https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf) の **表 5.21** を参照してください。携帯電話とタブレットの分離は OpenRTB バージョン 2.2 で導入されました。- `4` は電話機を指定します。
- `5` はタブレットを指定します。 |
| `geo`            | object | ```text
  "geo": {
      "lat":34.0544,
      "lon":-118.2441,
      "type":2,
      "country":"USA",
      "region":"CA",
      "city":"Los Angeles",
      "utcoffset":-480
  }
``` | デバイスの位置データ (ユーザーの現在位置を想定):- `lat`
- `lon`
- `type`
- `country`
- `region`
- `city`
- `UTCoffset`                                                                                                                                                                                                                                                          |
| `hwv`            | string | `"hwv": "samsung SM-J200H"`                                                                                                                                                           | デバイスのハードウェアバージョン。                                                                                                                                                                                                                                                                                                                                         |
| `ifa`            | string | `"ifa": "ab12c456-78de-90f1-ghi2-j3kl4567890m"`                                                                                                                                       | 消去の状態で広告主による使用が認められている Android Advertising ID（AID）または iOS Identifier for Advertisers（IFA/IDFA）。Unity は、COPPA または GDPR への準拠の要求に応じてこのフィールドをクリアします。                                                                                                                                                                                                          |
| `ip`             | string | `"ip": "12.34.5.6"`                                                                                                                                                                   | デバイスの IP アドレス。Unity は、COPPA または GDPR への準拠の要求に応じてこのフィールドをクリアします。                                                                                                                                                                                                                                                                                           |
| `language`       | string | `"language": "en"`                                                                                                                                                                    | ブラウザー言語。[ISO-639-1-アルファ-2](https://www.iso.org/iso-639-language-codes.html) コードを使用します。                                                                                                                                                                                                                                                                    |
| `lmt`            | int    | `"lmt": 1`                                                                                                                                                                            | 商業的に認められている「追跡型広告制限」信号。- `0` はトラッキングが制限されていないことを示します。
- `1`は、商用ガイドラインごとに追跡を制限する必要があることを示しています。Unity は `1`、値が の場合は常にこの属性を渡し、 の場合は省略します `0`。                                                                                                                                                                                                                |
| `make`           | string | `"make": "Apple"`                                                                                                                                                                     | デバイスのメーカー                                                                                                                                                                                                                                                                                                                                                 |
| `model`          | string | `"model": "iPhone7,2"`                                                                                                                                                                | デバイスのモデル                                                                                                                                                                                                                                                                                                                                                  |
| `os`             | string | `"os": "ios"`                                                                                                                                                                         | デバイスのオペレーティングシステム                                                                                                                                                                                                                                                                                                                                         |
| `osv`            | string | `"osv": "3.1.2"`                                                                                                                                                                      | デバイスのオペレーティングシステムのバージョン。                                                                                                                                                                                                                                                                                                                                  |
| `ua`             | string | `"ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 10_0 like Mac OS X)``AppleWebKit/602.1.50 (KHTML, like Gecko) Mobile/14A345"`                                                              | ウェブブラウザーのユーザーエージェント文字列                                                                                                                                                                                                                                                                                                                                    |
| `carrier`        | string | `"carrier": "Verizon"`                                                                                                                                                                | デバイスのサービスプロバイダー。                                                                                                                                                                                                                                                                                                                                          |

## 入札リクエストの例##例

### VAST 入札リクエスト##v-a-s-t

```json
{ 
	"id": "bcaIDT1Nbv0zU8mn9tXQ6j",
	"at":1,
	"tmax":200,
	"source": {
		"pchain":"12abcd3456789:12345"
		"omidpn":"Unity3d",
		"omidpv":"1.3.0"
	},
	"imp": [{ 
		"id": "1",
		"secure":1,
		"instl":1,
		"tagid": "com.unity3d.ads.example-vast",
		"bidfloor":3.95,
		"video": { 
			"mimes": [
				"video/mp4","application/javascript" 
			],
			「minduration」：5,
			"maxduration":30,
			"placement":5
			"protocols": [2, 3, 5, 6], 
			"pos":7,
			"battr": [1, 3, 5, 8, 9, 13],
			"w":1024,
			"h":600,
			"api": [7],
			"companiontype": [1,2,3] 
		}
		"displaymanager": "unity sdk",
		"displaymanagerver":"4001",
                "ext": {
    	          "skadn": {
                    "ext": {
          	        "ask":1
                    },
                    "skoverlay":1,
                      "productpage":1
    	          }
              }
	  }],
	"app": { 
		"id": "d01234idnfld234ier6c70930a",
		"name": "ビルド A タウン:すべてのゲーム",
		"publisher": {
		  "id": "11972001l"
		},
		"bundle":"12312312399",
		"storeurl": "https://apps.apple.com/us/app/build-a-town/id12312312399" 
	},
	"device": { 
		"ifa": "ab12c456-78de-90f1-ghi2-j3kl4567890m",
		"make":"Apple",
		"model": "iPhone",
		"ua":"Mozilla/5.0 (iPhone、Mac OS X のような CPU iPhone OS 10_0) AppleWebKit/602.1.50 (Gecko のような KHTML) モバイル/14A345"
		"os": "ios",
		"ip": "12.34.5.6",
		"devicetype":4,
		"carrier":"Apple",
		"osv":"10.1",
		"hwv": "iphone6",
		"geo": { 
			"lat":55.5492,
			"lon":59.0456,
			"country": "USA",
			"city":"サンフランシスコ",
			"type":2,
			"utcoffset":180 
		},
		"connectiontype":3,
		"language": "en",
		"h":1184,
		"w":768 
	},
	"regs": { 
		"coppa":0 
	}
}
```

### バナー入札リクエスト##バナー例

```json
{
  "id": "bcda7938-14eb-4a46-8dcb-bcd7587a964f",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w":320,
        "h":50,
        "battr": [
          1,
          3,
          5,
          6,
          8,
          9,
          13
        ]
      },
      "pmp": {},
      "displaymanager": "unity sdk",
      "displaymanagerver":"3200",
      "tagid": "com.unity3d.ads.opstool-banner",
      "bidfloor":3.95,
      "secure":1
    }
  ],
  "app": {
    "id": "2aa377f91oo12398465d6af383",
    "name": "ゲームの例:第二章」
    "publisher": {
      "id": "189857700"
    },
    "bundle": "com.devexample.thegamebundlename",
    "storeurl": "https://play.google.com/store/apps/details?id=com.devexample.thegamebundlename\u0026hl=en"
  },
  "device": {
    "ua":"Mozilla/5.0 (Linux; Android 9; ピクセル ビルド/PQ3A.190705.001; wv) AppleWebKit/537.36 (Gecko のような KHTML) Version/4.0 Chrome/75.0.3770.101 モバイル Safari/537.36",
    "geo": {
      "lat":37.7958,
      "lon": -122.4203,
      "type":2,
      "country": "USA",
      "region":"CA",
      "city":"サンフランシスコ",
      "utcoffset": -480
    },
    "ip": "4.14.109.3",
    "devicetype":4,
    "make":"Google",
    "model":"Pixel",
    "os": "android",
    "osv":"9.0",
    "hwv":"Google Pixel",
    "w":320,
    "h":50,
    "language": "en",
    "connectiontype":2,
    "ifa": "d0a77d1b-e974-41f3-84c5-8fe75718ef2d"
  },
  "at":1,
  "tmax":500,
  "regs": {
    "ext": {}
  },
  "ext": {
    "sessionDepth":1
  }
}
```

### Playable bidリクエスト##m-r-a-i-d

```json
{ 
	"id": "abcIDT1Def0zU8mn9gHI6j",
	"source": {
		"pchain":"12abcd3456789:12345"
	},
	"imp": [{ 
		"id": "1",
		"banner": { 
			"w":1024,
			"h":768,
			"battr": [1, 3, 5, 6, 8, 9],
			"pos":7,
			"api": [5] 
		},
		"displaymanager": "unity sdk",
        "displaymanagerver":"4000",
		"instl":1,
		"tagid": "com.unity-game.trashdash-m3-ios-display",
		"bidfloor":3.95,
			"secure":1 
	}],
	"app": { 
		"id": "d01234idnfld234ier6c70930a",
		"name": "ビルド A タウン:すべてのゲーム",
		"publisher": {
		  "id": "11972001l"
		},
		"bundle":"12312312399",
		"storeurl": "https://apps.apple.com/us/app/build-a-town/id12312312399" 
	},
	"device": { 
		"ifa": "ab12c456-78de-90f1-ghi2-j3kl4567890m",
		"ua":"Mozilla/5.0 (iPad、Mac OS X のような CPU OS 11_2_2) AppleWebKit/604.4.7 (Gecko のような KHTML) モバイル/15C202"
		"geo": { 
			"lat":55.5492,
			"lon":59.0456,
			"country": "USA",
			"city":"サンフランシスコ",
			"type":2,
			"utcoffset":180 
		},
		"ip": "12.34.5.6",
		"devicetype":5,
		"model": "iPad5,3",
		"os": "ios",
		"osv":"11.2.2",
		"hwv": "iPad Air 2 (Wi-Fi)",
		"h":768,
		"w":1024,
		"language": "en",
		"connectiontype":2 
	},
	"at":1,
	"tmax":200,
	"regs": {},
	"ext": {} 
} 
```

### インタースティシャルディスプレイ入札リクエスト##インタースティシャル

```json
{ 
	"id": "ApJv9QAmN3FJjEcTtFDtW3",
	"imp": [{ 
		"id": "1",
		"banner": { 
			"w":480,
			"h":320,
			"format": [
				{"w":250,"h":300},
				{"w":300,"h":250},
				{"w":480,"h":320},
				{"w":320,"h":480}
			],
			"battr": [1, 3, 5, 6, 8, 9, 13],
			"pos":7,
			"api": [5] 
		},
		"displaymanager": "unity sdk",
        "displaymanagerver":"3750",
		"instl":1,
		"tagid": "com.unity3d.ads.example-display",
		"bidfloor":3.95,
		"secure":1 
	}],
	"app": { 
		"id": "2aa377f91oo12398465d6af383",
		"name": "ゲームの例:第二章」
		"publisher": {
		  "id": "189857700"
		},
		"bundle": "com.devexample.thegamebundlename",
		"storeurl": "https://play.google.com/store/apps/details?id=com.devexample.thegamebundlename\u0026hl=en" 
	},
	"device": { 
		"ua":"Mozilla/5.0 (Linux、Android 5.1.1、SM-J200H ビルド/LMY48B、wv) AppleWebKit/537.36 (Gecko などの KHTML) バージョン/4.0 Chrome/64.0.3282.137 モバイル Safari/537.36"
		"geo": { 
			"lat":55.5492,
			"lon":59.0456,
			"country": "USA",
			"city":"サンフランシスコ",
			"type":2,
			"utcoffset":180 
		},
		"source": {
			"pchain":"12abcd3456789:12345"
		},
		"ip": "12.34.5.6",
		"devicetype":4,
		"make": "samsung",
		"model":"SM-J200H",
		"os": "android",
		"osv":"5.1",
		"hwv": "samsung SM-J200H",
		"h":540,
		"w":960,
		"language": "ru",
		"carrier":"Tele2",
		"connectiontype":2,
		"ifa": "dd92e219-68ae-43b9-bcb7-e6fb7557806e" 
	},
	"at":1,
	"tmax":200,
	"regs": {},
	"ext": {
		"placementType":"nonrewarded",
		"Mute":false,
		"gameCategory":"Applications",
		"subGameCategory":"Tools",
		"sessionDepth":0
	}
}
```
