# iOS SKAdNetwork サポート

> SKAdNetworkインテグレーションやユーザー同意の処理に関するガイダンスなど、AppleのiOS14のプライバシー要件をサポート。

このガイドは、Unityがプログラマティック パートナー向けに現在提案しているUnity Adsオークション ロジックの変更を示しています。このドキュメントを定期的に参照して、最新のガイダンスを確認することをお勧めします。

> **Note:**
>
> すべてのフィールドと名前は大文字と小文字が区別されます。

## 入札リクエスト変更##bid-request-change

### BidRequest.imp.ext.skadn##impression-ext

DSPがパブリッシャー アプリケーションの`Info.plist`に少なくとも1つの`SKAdNetworkItem`がある場合、Unityはこのオブジェクトを入札リクエストに加えます。これは、署名の作成に必要な情報を提供します。

| **フィールド**    | **型**        | **説明**                                                                      | **例**                                |
| ------------ | ------------ | --------------------------------------------------------------------------- | ------------------------------------ |
| `sourceapp`  | string       | Apple のアプリストアのパブリッシャー App ID。入札リクエストの application.bundle 値と一致する必要があります。     | `"sourceapp":"123456789"`            |
| `skadnetids` | string array | パブリッシャーアプリケーションのInfo.plist\_ファイルに表示されるDSP固有の`SKAdNetworkItem`エントリーの小文字のリスト。 | `"skadnetids": ["dsp1.skadnetwork"]` |
| `versions`   | string array | サポートされている skadnetwork バージョンを含む文字列の配列。OS バージョンと SDK バージョンの両方に依存。             | `"versions":["2.0","2.1","3.0"]`     |

### BidRequest.device.ext.atts##device-ext

Unity の `BidRequest.device.ext.atts` フィールドにはアプリケーション トラッキングの承認状態が表示されます。このフィールドの詳細については、[Apple の API ドキュメント](https://developer.apple.com/documentation/apptrackingtransparency/attrackingmanager/authorizationstatus)

| **フィールド** | **型** | **説明**                                                                                           | **例**      |
| --------- | ----- | ------------------------------------------------------------------------------------------------ | ---------- |
| `atts`    | int   | アプリケーション トラッキング承認の状態値。使用可能な値は以下のとおりです。- `0` = 未決定
- `1` = 制限あり
- `2` ＝ denied
- `3` ＝ authorized | `"atts":2` |

## 入札反応変更##bid-response-change

### BidResponse.seatbid.bid.ext.skadn##seatbid-ext

入札リクエストに`BidRequest.imp.ext.skadn`が含まれている場合、DSPは反応として`BidResponse.seatbid.bid.ext.skadn`オブジェクトを送信できます。存在する場合、Unity はこのオブジェクトの署名をアトリビューションに使用します。詳細については、[Apple の API ドキュメント](https://developer.apple.com/documentation/storekit/skadnetwork)

| **フィールド**          | **型**        | **説明**                                                                                                                                                                                    | **例**                                                                                                                                          |
| ------------------ | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `signature`        | string       | Apple によって指定された`SKAdNetwork`署名。                                                                                                                                                           | `"signature": "WOBQQIRTnAcfYzF..."`                                                                                                            |
| `network`          | string       | シグニチャで使用される広告ネットワーク識別子。これは、リクエスト内の `skadnetids` 配列内のアイテムの 1 つと一致する必要があります。                                                                                                                | `"network":"5HUO92BLLQ.skadnetwork"`                                                                                                           |
| `version`          | string       | 指定した SKAdNetwork のバージョン。                                                                                                                                                                  | `"version":"2.0"`                                                                                                                              |
| `campaign`         | string       | Apple の仕様と互換性のあるキャンペーン ID。バージョン 2.0 では、これは `1` と `100` の間の整数でなければならず、文字列で表されます。                                                                                                           | `"campaign":"83"`                                                                                                                              |
| `itunesitem`       | string       | Apple のアプリストアの広告主 App ID。これは入札反応の bid.bundle と一致する必要があります。                                                                                                                                | `"itunesitem":"987654321"`                                                                                                                     |
| `nonce`            | string       | 各広告反応に一意の ID。                                                                                                                                                                             | `"nonce":"385c9n44-a9ik-28fd-8247-gjk2efoa56a9"`                                                                                               |
| `sourceapp`        | string       | ID。これは入札リクエストの`imp.ext.skadn.sourceapp`と一致する必要があります。                                                                                                                                      | `"sourceapp":"123456789"`                                                                                                                      |
| `timestamp`        | string       | シグニチャが生成されたときのミリ秒単位の Unix 時間。                                                                                                                                                             | `"timestamp": "1225091839"`                                                                                                                    |
| `fidelities`       | object array | SKAdNetwork v2.2で導入された複数の忠実度タイプをサポートします。                                                                                                                                                  | ```text
"fidelities":
[ { 
  "fidelity":0,
  "signature":
  "MEQCIEQlmZRNfYzK…",
  "nonce":「473b1a16…」
  "timestamp": "1603246928149" 
} ]
``` |
| `sourceidentifier` | string       | 広告ネットワークが広告キャンペーンを表すために定義する 4 桁の整数。SKAdNetwork 4.0 以降で使用され、`BidResponse.imp.ext.skad.` フィールドを置き換えます。DSP は、バージョン 4.0 以降でソース ID を使用して署名を生成する必要があります。バージョン 3.0 以前については、引き続き を使用します campaign。 | `"sourceidentifier": "1234"`                                                                                                                   |

### bid.ext.skadn.fidelities##bid-ext

入札リクエストに`BidRequest.imp.ext.skadn`が含まれている場合、DSPは反応として`BidResponse.seatbid.bid.ext.skadn`オブジェクトを送信できます。存在する場合、Unity はこのオブジェクトの署名をアトリビューションに使用します。詳細については、[Apple の API ドキュメント](https://developer.apple.com/documentation/storekit/skadnetwork)を参照してください。

| **フィールド**   | **型**  | **説明**                                                                                                                                                | **例**                                           |
| ----------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
| `fidelity`  | int    | 追跡するアトリビューションの忠実度タイプ。                                                                                                                                 | `"fidelity": 0`                                 |
| `nonce`     | string | 各広告反応に一意の ID。適切な [UUID 形式](https://developer.apple.com/documentation/storekit/skstoreproductparameteradnetworknonce) の要件については、Apple のドキュメントを参照してください。 | `"nonce":"385c9n44-a9ik-28fd-8247-gjk2efoa56a9` |
| `timestamp` | string | シグニチャが生成されたときのミリ秒単位の Unix 時間。                                                                                                                         | `"timestamp": "1225091839"`                     |
| `signature` | string | Apple によって指定された SKAdNetwork シグニチャ。                                                                                                                    | `"signature": "MEQCIEQlmZRNfYzK…"`              |

## デバイス ID##デバイス ID

> **Note:**
>
> Unity は IDFA が存在する場合はパスします。IDFA が存在しない場合は、IDFV が渡されます。

| **フィールド**        | **型**  | **説明**                                                                                                   | **例**                                  |
| ---------------- | ------ | -------------------------------------------------------------------------------------------------------- | -------------------------------------- |
| `Device.ifa`     | string | 優先デバイス Advertisement Identifier（IDFA）。追跡する権限が与えられていない場合、値は `00000000-0000-0000-0000-000000000000` になります。 | `ABC123AB-1234-5678-A1B2-123ABCBCD789` |
| `Device.ext.ifv` | string | パブリッシャー内のデバイスのIDFV。これは、同じベンダーのアプリケーション間の一意の識別子です。                                                        | `ABCDEFGH-ABCD-1234-1234-ABCDEFGHABCD` |
