# iOS SKAdNetwork 지원

> SKAdNetwork 통합 및 사용자 동의 처리에 대한 지침을 비롯하여 Apple의 iOS 14 개인정보 보호 요구 사항을 지원합니다.

이 가이드는 Unity 프로그래머틱 파트너에 대한 Unity Ads 경매 로직에 대한 현재 제안된 변경 사항을 보여 줍니다. 이 기술 자료를 주기적으로 다시 검토하여 최신 지침을 보유할 것을 권장합니다.

> **Note:**
>
> 모든 필드와 이름은 대소문자를 구분합니다.

## 입찰 요청 변경##bid-request-change

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

퍼블리셔 앱의 `Info.plist`에 DSP에 하나 이상의 `SKAdNetworkItem`가 있는 경우 Unity는 단가 요청에 이 오브젝트를 포함합니다. 서명을 생성하는 데 필요한 정보를 제공합니다.

| **필드**       | **유형** | **설명**                                                                | **예제**                               |
| ------------ | ------ | --------------------------------------------------------------------- | ------------------------------------ |
| `sourceapp`  | 문자열    | 퍼블리셔 앱 ID. 단가 요청의 app.bundle 값과 일치해야 합니다.                             | `"sourceapp":"123456789"`            |
| `skadnetids` | 문자열 배열 | 퍼블리셔 앱의 Info.plist\_ 파일에 표시되는 DSP 전용 `SKAdNetworkItem` 항목 소문자 리스트입니다. | `"skadnetids": ["dsp1.skadnetwork"]` |
| `versions`   | 문자열 배열 | 배열입니다. 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` | 정수     | 앱 트래킹 권한 부여, 인증 상태 값입니다. 가능한 값은 다음과 같습니다.- `0` = 결정되지 않음
- `1` = 제한됨
- `2` = 거부됨
- `3` = 승인됨 | `"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`        | 문자열     | `SKAdNetwork` 서명입니다.                                                                                                                                                                 | `"signature": "WOBQQIRTnAcfYzF..."`                                                                                                                    |
| `network`          | 문자열     | 광고 네트워크 식별자입니다. 요청의 `skadnetids` 배열의 항목 중 하나와 일치해야 합니다.                                                                                                                              | `"network":"5HUO92BLLQ.skadnetwork"`                                                                                                                   |
| `version`          | 문자열     | 특정 SKAdNetwork 버전입니다.                                                                                                                                                                | `"version":"2.0"`                                                                                                                                      |
| `campaign`         | 문자열     | 캠페인 ID입니다. 버전 2.0부터 이 값은 문자열로 표현된 `1`와 `100` 사이의 정수여야 합니다.                                                                                                                           | `"campaign":"83"`                                                                                                                                      |
| `itunesitem`       | 문자열     | Apple의 앱 스토어에서 광고주 앱 ID입니다. 단가 응답의 단가.번들와 일치해야 합니다.                                                                                                                                  | `"itunesitem":"987654321"`                                                                                                                             |
| `nonce`            | 문자열     | 각 광고 응답에 고유한 ID입니다.                                                                                                                                                                  | `"nonce":"385c9n44-a9ik-28fd-8247-gjk2efoa56a9"`                                                                                                       |
| `sourceapp`        | 문자열     | ID입니다. 단가 요청의 `imp.ext.skadn.sourceapp`와 일치해야 합니다.                                                                                                                                   | `"sourceapp":"123456789"`                                                                                                                              |
| `timestamp`        | 문자열     | 서명 생성 시점의 Unix 시간(밀리초 단위)입니다.                                                                                                                                                        | `"timestamp": "1225091839"`                                                                                                                            |
| `fidelities`       | 오브젝트 배열 | SKAdNetwork v2.2에 도입된 여러 정확도 유형을 지원합니다.                                                                                                                                              | ```text
"fidelities": 
[ { 
  "fidelity": 0, 
  "signature": 
  "MEQCIEQlmZRNfYzK…", 
  "nonce": "473b1a16…", 
  "timestamp": "1603246928149" 
} ]
``` |
| `sourceidentifier` | 문자열     | 광고 네트워크가 광고 캠페인을 나타내기 위해 정의하는 4자리 정수. SKAdNetwork 4.0 이상에서 사용되며, `BidResponse.imp.ext.skad.` 필드를 대체합니다.DSP는 소스 식별자 사용하여 버전 4.0 이상에서 서명을 생성해야 합니다. 버전 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`  | 정수     | 추적할 어트리뷰션의 정확도 타입입니다.                                                                                                                    | `"fidelity": 0`                                 |
| `nonce`     | 문자열    | ID입니다. 적절한 [UUID 형식](https://developer.apple.com/documentation/storekit/skstoreproductparameteradnetworknonce) 요구 사항은 Apple의 문서를 참조하십시오. | `"nonce":"385c9n44-a9ik-28fd-8247-gjk2efoa56a9` |
| `timestamp` | 문자열    | 서명 생성 시점의 Unix 시간(밀리초 단위)입니다.                                                                                                            | `"timestamp": "1225091839"`                     |
| `signature` | 문자열    | Apple에서 지정한 SKAdNetwork 서명입니다.                                                                                                           | `"signature": "MEQCIEQlmZRNfYzK…"`              |

## 기기 기기##device-i-ds

> **Note:**
>
> Unity IDFA를 전달. IDFA가 없는 경우 IDFV가 전달됩니다.

| **필드**           | **유형** | **설명**                                                                                | **예제**                                 |
| ---------------- | ------ | ------------------------------------------------------------------------------------- | -------------------------------------- |
| `Device.ifa`     | 문자열    | 선호 기기 광고 식별자(IDFA). 추적 권한이 부여되지 않은 경우에는 `00000000-0000-0000-0000-000000000000`가 있습니다. | `ABC123AB-1234-5678-A1B2-123ABCBCD789` |
| `Device.ext.ifv` | 문자열    | IDFV. 동일한 공급업체의 앱 간 고유 식별자입니다.                                                        | `ABCDEFGH-ABCD-1234-1234-ABCDEFGHABCD` |
