# AppsFlyer와 Unity 연동

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

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

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

* [AppsFlyer 대시보드에서 Unity Ads를 활성화합니다](#activate-unity-ads-in-the-appsflyer-dashboard).
* [일반 연동 설정을 구성합니다](#configure-general-integration-settings).
* [데이터 공유 설정을 구성](#configure-data-sharing-settings)하고 설치 후 이벤트를 매핑합니다.
* [파트너 권한을 설정합니다](#set-partner-permissions).

AppsFlyer 연동 최신 정보는 [AppsFlyer 도움말 센터](https://support.appsflyer.com/hc/en-us/articles/208005086-Unity-Ads-campaign-configuration)를 참고하십시오.

## 선행 조건##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)를 검색합니다.
* 최신 버전의 [AppsFlyer SDK](https://github.com/AppsFlyerSDK/appsflyer-unity-plugin)를 다운로드합니다.

## Unity와 AppsFlyer 연동##integrate-unity-with-appsflyer

UA 캠페인에 AppsFlyer를 연동하려면 다음 단계를 완료합니다.

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

[AppsFlyer 대시보드](https://hq1.appsflyer.com/auth/login)에서 Unity Ads를 활성화하려면 다음 단계를 따릅니다.

1. AppsFlyer 대시보드에서 **Collaborate** > **Partner Marketplace**로 이동합니다.
2. **Unity Ads**를 검색한 후 **Set up integration**을 선택하면 **Integration** 탭이 열립니다.
3. **Activate Partner** 토글을 활성화합니다.
4. 일부 광고주의 경우 **Advanced Privacy** 토글이 **Integration** 탭에 있을 수 있습니다. 대시보드에 이 토글이 있으면 비활성화해야 합니다.

> **Important:**
>
> 연동 설정에서 **Advanced Privacy** 토글이 활성화되어 있으면 AppsFlyer는 캠페인에 이벤트 데이터를 공유할 수 없습니다.


**Deactivate the Advanced Privacy toggle:**
![AppsFlyer 통합 설정의 고급 개인정보 보호 토글](/api/media?file=/user-acquisition/media/images/appsflyer-advanced-privacy.png)

### 일반 연동 설정 구성##configure-general-integration-settings

**Integration** 탭에서 **General settings**와 **Install attribution** 섹션 모두 다음과 같이 설정합니다.

1. **General settings**

   #### 일반 설정

   **General settings** 섹션을 다음과 같이 설정합니다.

   1. **Share organic/non-organic indication** 토글을 활성화합니다.


   **Share organic and non-organic:**
   ![AppsFlyer 통합 설정에서 공유 유기/비유기 토글](/api/media?file=/user-acquisition/media/images/appsflyer-share-organic-non-organic.png)

   2. Unity [게임 ID](../../getting-started/locate-advertiser-credentials#game-id)를 입력합니다.

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

2. **Install attribution**

   #### 설치 어트리뷰션

   **Install attribution** 섹션을 다음과 같이 설정합니다.

   1. **Install engaged click-through lookback window**를 **Days**로 설정합니다.
   2. 슬라이더를 사용하여 룩백 기간을 **2**일로 설정합니다.
   3. **Install view-through attribution** 토글을 활성화합니다.
   4. **Install engaged view-through lookback window** 간격을 **Days**로 설정합니다.
   5. 슬라이더를 사용하여 룩백 기간을 **7**일로 설정합니다.


   **Set attribution lookback windows:**
   ![AppsFlyer 통합 탭의 클릭 검색 창 슬라이더](/api/media?file=/user-acquisition/media/images/appsflyer-install-attribution.png)

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

**Integration** 탭에서 다음 데이터 공유 설정을 구성합니다.

1. **Default postbacks**

   #### 기본 포스트백

   **Default postbacks** 섹션에서 **for users from** 드롭다운을 사용하여 **All media sources, including organic**을 **Install** 이벤트로 선택합니다.


   **Share all sources, including organic:**
   ![AppsFlyer 통합 탭의 기본 포스트백 섹션](/api/media?file=/user-acquisition/media/images/appsflyer-default-install-postbacks.png)

2. **In-app event settings**

   #### 인앱 이벤트 설정

   **In-app event settings** 섹션을 다음과 같이 설정합니다.

   1. **game\_id** 필드 [게임 ID](../../getting-started/locate-advertiser-credentials#game-id)를 입력합니다.
   2. **In-app event postbacks** 토글을 활성화합니다.
   3. **In-app event postback window**를 **Lifetime**으로 설정합니다.


   **Set a lifetime postback window:**
   ![AppsFlyer 통합 탭의 수명 주기 인앱 이벤트 포스트백 룩백 창](/api/media?file=/user-acquisition/media/images/appsflyer-lifetime-postback-window.png)

3. **Map events**

   #### 이벤트 매핑

   **Integration** 탭 > **In-app event postbacks** 섹션에서 AppsFlyer 이벤트를 Unity 이벤트에 매핑합니다.

   AppsFlyer 대시보드에서 설정한 모든 인앱 이벤트를 매핑할 수 있습니다. AppsFlyer의 [인앱 이벤트](https://support.appsflyer.com/hc/en-us/articles/4410481112081-In-app-events-Event-structure#predefined-event-names) 기술 자료를 참고하여 AppsFlyer 이벤트 이름 목록을 확인합니다.

   > **Important:**
   >
   > **AppsFlyer event** 이름이 앱 코드의 이벤트 식별자와 정확히 일치해야 합니다. 이벤트를 잘못 매핑하면 캠페인에서 해당 데이터를 무시합니다.

   올바른 이벤트 매핑 예시는 다음과 같습니다.

   | `af_purchase`          | `purchase`       | All media sources, including organic | Values & revenue    |
   | ---------------------- | ---------------- | ------------------------------------ | ------------------- |
   | `milestone_event_name` | `level_complete` | All media sources, including organic | Values & revenue    |
   | `af_app_opened`        | `session`        | All media sources, including organic | Values & no revenue |


   **Map events to Unity event names:**
   ![AppsFlyer 이벤트 매핑 표](/api/media?file=/user-acquisition/media/images/appsflyer-event-mapping.png)

   다음 선택 사항을 적용해야 합니다.

   * 모든 이벤트의 **for users from** 드롭다운에서 **All media sources, including organic**을 선택합니다.
   * **Level Complete** 및 **Purchase** 이벤트의 **including** 드롭다운에서 **Values & revenue**를 선택합니다.
   * **Session events**의 **including** 드롭다운에서 **Values & no revenue**를 선택합니다.

4. **Enable ad revenue data**

   #### 광고 수익 데이터 활성화

   > **Important:**
   >
   > AppsFlyer **Revenue Settings** 메뉴에 액세스하고 Unity와 광고 수익 데이터를 공유하려면 AppsFlyer ROI360을 구독해야 합니다. 자세한 내용은 AppsFlyer 도움말 센터의 [광고 수익 어트리뷰션](https://support.appsflyer.com/hc/en-us/articles/217490046-ROI360-guide-ad-revenue-attribution#connect-to-ad-revenue-integrated-partners) 기술 자료를 참고하십시오.

   광고 수익 이벤트 데이터를 캠페인과 공유하려면 다음 단계를 따릅니다.

   1. AppsFlyer 연동 설정의 **Ad revenue** 탭으로 이동합니다.
   2. **Get ad revenue data** 토글을 활성화합니다.


   **Enable Ad revenue:**
   ![AppsFlyer 통합 설정의 Get ad 매출 토글](/api/media?file=/user-acquisition/media/images/appsflyer-get-ad-revenue.png)

   3. AppsFlyer 대시보드 사이드 메뉴에서 **Settings** > **Revenue Settings**로 이동합니다.
   4. **Revenue settings** 페이지의 **Ad revenue** 탭에서 **New ad revenue integration**을 선택합니다.
   5. 수익 파트너 목록에서 **Unity Ads**를 선택합니다.
   6. 파트너 설정에서 리포트 유형으로 \*\*Impression-level (via SDK) with Device-level (via S2S API)\*\*을 선택합니다.


   **Send impression-level and device-level reports:**
   ![AppsFlyer 대시보드의 광고 매출 설정](/api/media?file=/user-acquisition/media/images/appsflyer-ad-revenue-setup.png)

   7. API 자격 증명을 입력합니다. **App Key** 필드에 [게임 ID](/user-acquisition/getting-started/locate-advertiser-credentials.md#game-id)를 입력합니다. Unity 대시보드에서 **Secret key**를 검색하려면 다음 단계를 참고하십시오.

      **Retrieve your Secret key:**

      Unity 대시보드에서 Secret key를 검색하려면 다음 단계를 따릅니다.

      1. 왼쪽 내비게이션 메뉴에서 **API Management**로 이동합니다.
      2. **Advertising Management API** > **Service account**를 선택합니다.


      **Retrieve secret keys from your Advertising Management Service account:**
      ![Unity 사용자 확보 대시보드의 API 관리 페이지](/api/media?file=/user-acquisition/media/images/api-service-account.png)

      3. 서비스 계정이 없는 경우 **+ New**를 선택합니다. 서비스 계정이 있으면 표에서 해당 계정을 선택합니다.
      4. 서비스 계정 페이지에서 **Keys** 섹션으로 이동합니다.
      5. **+ Add key**를 선택해 새 키를 생성합니다.
      6. **Secret key** 뒤에 있는 복사 버튼을 선택하여 ID를 복사합니다.

   8. AppsFlyer 대시보드의 **Integration** 탭으로 다시 이동합니다.

   9. **In-app event postbacks** 섹션에서 광고 수익 이벤트를 `ad_revenue`에 매핑합니다. 올바른 광고 수익 매핑 예시는 다음과 같습니다.

   | `af_ad_revenue` | `ad_revenue` | All media sources, including organic | Values & revenue |
   | --------------- | ------------ | ------------------------------------ | ---------------- |

### 파트너 권한 설정##set-partner-permissions

**Permissions** 탭에서 다음 권한 설정을 구성합니다.

1. **Toggle Ad Network Permissions**를 활성화하여 다른 모든 토글을 사용 가능하게 합니다.
2. 다음 토글을 활성화합니다.

* **Configure integration**
* **Configure in-app event postbacks**
* **Access retention report**
* **Access aggregate conversions and in-app event data**
* **Access aggregate revenue data**
* **View validation rules**
* **Access Protect360 dashboard and raw data**
* **Access ad revenue raw data (UA signals)**

각 권한에 대한 설명은 AppsFlyer 도움말 센터의 [권한 탭](https://support.appsflyer.com/hc/en-us/articles/4410395957521-Set-up-an-integrated-partner#permissions-tab) 기술 자료를 참고하십시오.