# Singular와 Unity 연동

> Singular 대시보드에서 Unity Ads 연동을 활성화하고, 전체 데이터 공유를 사용 가능하게 설정하며, 이벤트를 매핑합니다.

> **Important:**
>
> 다음 기술 자료는 Unity가 개발하거나, 소유하거나, 운영하지 않는 제품 또는 서비스(‘타사 제품’)에 관한 내용입니다.
> 이 정보는 오래되었거나 불완전할 수 있으며 편의를 위해 제공됩니다.
> 타사 제품을 사용하는 경우 해당 제품의 약관이 적용됩니다.
> Unity는 이러한 제품에 대해 어떠한 보증도 하지 않으며, 타사 제공자의 콘텐츠, 광고 또는 머티리얼과 관련된 문제를 포함하여 제품 사용으로 인한 손해나 손실에 대해서도 책임지지 않습니다.

Unity 사용자 확보 캠페인의 MMP(모바일 측정 파트너)로 Singular를 설정합니다. 연동에는 다음 설정 작업이 포함됩니다.

* Singular 대시보드에서 Unity Ads를 활성화합니다.
* 데이터 공유 설정을 구성합니다.
* 설치 후 이벤트를 매핑합니다.

Singular 연동 최신 정보는 [Singular 도움말 센터](https://support.singular.net/hc/en-us/articles/360028964651-Unity-Ads-Attribution-Integration)를 참고하십시오.

## 선행 조건##prerequisites

설정 전에 다음 요구 사항을 충족하는지 검토합니다.

* [Unity 사용자 확보 대시보드](https://cloud.unity.com/acquire)에 최소 하나 이상의 앱을 [추가합니다](../../getting-started/add-an-app#add-an-app-to-the-dashboard).
* UA 대시보드에서 [게임 ID](../../getting-started/locate-advertiser-credentials#game-id)를 검색합니다.
* 최신 버전의 [Singular SDK](https://github.com/singular-labs/Singular-Unity-SDK)를 다운로드합니다.

## Unity와 Singular 연동##integrate-unity-with-singular

[Singular 대시보드](https://app.singular.live/dashboard)에서 Unity Ads를 연동하려면 다음 단계를 완료합니다.

### Singular 대시보드에서 Unity Ads 활성화##activate-unity-ads-in-the-singular-dashboard

1. **Attribution Setup** > **Partner Configuration**으로 이동합니다.
2. **Add a Partner**를 선택합니다. **Unity Ads**를 검색하여 선택합니다.
3. [게임 ID](../../getting-started/locate-advertiser-credentials#game-id)를 **Unity Ads Game ID** 필드에 입력합니다.

> **Note:**
>
> UA 대시보드에 표시된 게임 ID를 정확하게 입력합니다. 게임 ID가 일치하지 않으면 Unity에서 이벤트를 올바르게 수신할 수 없습니다.

### 데이터 공유 설정 구성##configure-data-sharing-settings

데이터 공유 설정을 구성하려면 다음 단계를 따릅니다.

1. **Attribution Postbacks & Settings** 탭에서 **Attribution Postbacks** 표로 이동합니다.
2. **Install** 체크박스를 **Attribution Event** 열에서 선택합니다.
3. 동일한 행에서 다음 체크박스를 선택합니다.

* **Send View Through**
* **Send All**
* **Send Fraud Postbacks**

![Singular 대시보드의 Attribution Postbacks & Settings 탭.](/api/media?file=/user-acquisition/media/images/singular-integration-attribution-settings.png)

### 설치 후 이벤트 매핑##map-post-install-events

이벤트를 매핑하려면 다음 단계를 따릅니다.

1. **In app Events Postback** 탭에서 **Send all ad monetization events**를 **Revenue Events Postbacks** 드롭다운에서 선택합니다.

> **Important:**
>
> Singular는 모든 수익화 이벤트를 한 번에 전송할 수 있는 유일한 MMP입니다. Singular에서 광고 수익 이벤트를 전송하려면 **Revenue Events Postbacks** 드롭다운에서 **Send all ad monetization events**를 선택하고, **SDK Event Name** 드롭다운에서 \*\*`__REVENUE__*`\*\*를 선택합니다.

![싱글 연동 설정의 매출 이벤트 포스트백 옵션.](/api/media?file=/user-acquisition/media/images/singular-send-all-monetization-events.png)

2. 이벤트를 매핑하려면 **SDK 이벤트 이름** 열에서 Singular 이벤트를 선택하고, **이벤트 이름** 열에서 Unity 이벤트와 매핑합니다.

| * `__iap__`
* `custom_purchase_event_name` | `purchase`   |                                                                                                                       |
| ------------------------------------------ | ------------ | --------------------------------------------------------------------------------------------------------------------- |
| `__REVENUE__*`                             | `ad_revenue` | Singular와 함께 광고 수익 이벤트를 전송하려면, 이벤트 표 위에 있는 Revenue Events Postbacks 드롭다운에서 Send all ad monetization events를 선택해야 합니다. |
| `__SESSION__`                              | `session`    |                                                                                                                       |

3. 전체 사용자 기반의 데이터를 공유하려면 각 이벤트에서 **Send all** 체크박스를 선택합니다.
4. **Postback Window Starting Point** 열의 각 이벤트에서 **Unlimited**를 선택합니다.
5. Singular [Enterprise](https://support.singular.net/hc/en-us/articles/115000483946-Partner-Configuration-and-Postbacks-FAQ-and-Troubleshooting#in_app_event_postbacks) 계정을 보유한 경우 \*\*Postback Window (days)\*\*를 **Unlimited**로 설정합니다. 그렇지 않으면 기간을 `30`일로 설정합니다.
6. 각 행에서 **Include Revenue** 체크박스를 선택합니다.

![Singular 연동 워크플로의 In-app Events Postback 탭.](/api/media?file=/user-acquisition/media/images/singular-in-app-postback-tab.png)