# AppsFlyer 통합 확인

> 사용자 확보 대시보드에서 AppsFlyer 통합 규칙과 통합 설정 경고를 결정하는 방법을 검토합니다.

사용자 확보 캠페인을 AppsFlyer와 [통합하는 경우](/user-acquisition/partner-integration/appsflyer/integrate-appsflyer-with-unity.md) Unity Dashboard는 통합 설정을 확인하여 올바르게 구성되었는지 확인합니다. 이러한 연동 오류를 결정 않으면 새 캠페인이나 일시 중지된 캠페인을 실행 수 없으며, 라이브 캠페인에 심각한 성과와 어트리뷰션 문제가 발생할 수 있습니다.

## 필수 통합 규칙##required-integration-rules

캠페인을 게재하려면 다음 규칙을 준수해야 합니다.

* MMP 통합의 [게임 ID는 Unity Dashboard](#the-game-id-must-match)의 게임 ID와 일치해야 합니다.
* [포스트백 창은 전체 수명](#postback-windows-must-be-set-to-lifetime)으로 설정해야 합니다.
* [클릭 스루 룩백 창은 최소 2일이어야 합니다.](#click-through-lookback-windows-must-be-at-least-2-days)
* [뷰스루 룩백 창은 최소 7일이어야 합니다.](#view-through-lookback-windows-must-be-at-least-7-days)
* [뷰스루 어트리뷰션은 활성화된, 사용 가능한](#view-through-attribution-must-be-enabled)이어야 합니다.
* 레벨 완료 캠페인의 [레벨 완료 이벤트 포스트백에는 값이 포함되어야 합니다.](#level-complete-event-postbacks-must-contain-values)
* 구매 캠페인의 [구매 이벤트 포스트백에는 값이 포함되어야 합니다.](#purchase-event-postbacks-must-contain-values)
* 광고 매출 캠페인의 [매출 이벤트 포스트백에는 값이 포함되어야 합니다](#revenue-event-postbacks-must-contain-values).
* 리텐션 캠페인의 [세션 이벤트 포스트백에는 값이 포함되어야 합니다](#session-event-postbacks-must-contain-values).
* 결제 캠페인에는 [구매 이벤트가 올바르게 매핑되어야 합니다.](#purchase-event-postbacks-must-be-mapped-correctly)
* [AppsFlyer 이벤트는 올바른 Unity 이벤트 이름](#appsflyer-events-must-be-mapped-to-the-correct-unity-event-name)에 매핑되어야 합니다.
* [앱 시작 후 2일 이내에 지난 90일 동안 앱에 설치 포스트백이 하나 이상 있어야 합니다](#app-must-receive-at-least-one-install-postback).
* [캠페인 실행 후 7일 이내에 하나 이상의 광고 수익 이벤트 포스트백이 있어야 합니다](#campaigns-must-receive-one-or-more-ad-revenue-postbacks).
* [캠페인 실행 후 7일 이내에 하나 이상의 인앱 구매 이벤트 포스트백이 있어야 합니다](#campaigns-must-receive-one-or-more-in-app-purchase-postbacks).

이러한 문제를 결정하는 방법에 대한 지침은 [필수 결정](#required-resolutions) 섹션을 참조하십시오.

## 권장 통합 규칙##recommended-integration-rules

캠페인을 게재하려면 다음 연동이 필요하지 않습니다. 하지만 다음 권장 규칙을 준수하지 않으면 캠페인 성과와 어트리뷰션에 부정적인 영향을 미칠 수 있습니다.

* Organic을 포함한 모든 소스의 사용자에게 [설치 이벤트 포스트백 보내기](#send-install-event-postbacks-for-users-from-all-sources)
* Organic을 포함한 모든 소스의 사용자에게 이벤트 포스트백 포스트백을 [보냅니다.](#send-post-install-event-postbacks-for-users-from-all-sources) 여기에는 다음 포스트백 타입이 포함됩니다.
  * Organic을 포함한 모든 소스의 사용자에게 인앱 구매 이벤트 포스트백을 보냅니다.
  * Organic을 포함한 모든 소스의 사용자에게 광고 매출 이벤트 포스트백을 보냅니다.
  * Organic을 포함한 모든 소스의 사용자에게 세션 이벤트 포스트백을 보냅니다.
  * Organic을 포함한 모든 소스의 사용자에게 레벨 완료 이벤트 포스트백을 보냅니다.

이러한 문제를 결정하는 방법에 대한 지침은 [권장안](#recommended-resolutions) 섹션을 참조하십시오.

## 필수 해상도##required-resolutions

필수 통합 규칙을 충족하려면 다음 섹션을 참고하십시오.

### 게임 ID와 일치해야 합니다.##the-game-id-must-match

이 확인 규칙을 충족하려면 AppsFlyer 대시보드에 입력한 게임 ID가 Unity 사용자 확보 대시보드의 게임 ID와 정확히 일치하는지 확인합니다. Unity Dashboard의 **앱** 페이지에서 게임 ID를 가져오려면 다음 단계를 따르십시오.

1. 대시보드 왼쪽 내비게이션 메뉴에서 **앱**으로 이동합니다. 제공된 표에는 조직의 각 앱이 나열되어 있습니다. 각 앱 이름 다음에 대시보드에는 앱 플랫폼과 게임 ID가 표시됩니다.
2. ID 옆의 **Copy** 기호를 선택하여 클립보드에 복사합니다.

또한 대시보드의 **캠페인**, **캠페인 세부 정보** 및 **머티리얼 팩** 페이지에서 게임 ID를 가져올 수도 있습니다. 자세한 내용은 [게임 ID](/user-acquisition/getting-started/locate-advertiser-credentials.md#game-id) 기술 자료를 참고하십시오.

### 포스트백 창은 전체 수명으로 설정해야 합니다.##postback-windows-must-be-set-to-lifetime

AppsFlyer에서 이 확인 규칙을 충족하려면 인앱 이벤트 포스트백 창을 `lifetime`로 설정합니다. 이 창을 설정하려면 다음 단계를 따르십시오.

1. **통합** 탭의 **인앱 이벤트 포스트백** 섹션으로 이동합니다.
2. **In-app event postbacks** 토글을 활성화합니다.
3. **In-app event postback window**를 **Lifetime**으로 설정합니다.


   **Lifetime postback window:**
   ![AppsFlyer 연동 설정의 인앱 이벤트 포스트백 창 설정](/api/media?file=/user-acquisition/media/images/appsflyer-lifetime-postback-window.png)

### 클릭 검색 룩백 기간은 최소 2일이어야 합니다.##click-through-lookback-windows-must-be-at-least-2-days

이 확인 규칙을 충족하려면 클릭 검색창을 `2` 일로 설정합니다. 이 창을 설정하려면 다음 단계를 따르십시오.

1. **통합** 탭의 **설치 어트리뷰션** 섹션으로 이동합니다.
2. **Install engaged click-through lookback window** 섹션에서 **Days**를 선택합니다.
3. 슬라이더를 사용하여 창을 **2** **일로** 설정합니다.


   **2-day click-through lookback window:**
   ![AppsFlyer 연동 설정의 설치 참여 클릭 룩백 창 설정](/api/media?file=/user-acquisition/media/images/appsflyer-click-through-lookback.png)

### 뷰스루 룩백 기간은 최소 7일이어야 합니다.##view-through-lookback-windows-must-be-at-least-7-days

이 확인 규칙을 충족하려면 뷰스루 룩백 창을 `7` 일로 설정합니다. 이 창을 설정하려면 다음 단계를 따르십시오.

1. **통합** 탭의 **설치 어트리뷰션** 섹션으로 이동합니다.
2. **Install engaged view-through lookback window** 섹션에서 **Days**를 선택합니다.
3. 슬라이더를 사용하여 창을 **7** **일**으로 설정합니다.
4. **Install view-through attribution** 토글을 활성화합니다.


   **7-day view-through lookback window:**
   ![AppsFlyer 연동 설정의 설치 참여 뷰스루 룩백 창 설정](/api/media?file=/user-acquisition/media/images/appsflyer-view-through-lookback.png)

### 뷰스루 어트리뷰션은 활성화된, 사용 가능한##view-through-attribution-must-be-enabled

이 확인 규칙을 충족하려면 AppsFlyer 연동 설정에서 뷰스루 어트리뷰션을 활성화하다, 사용 가능하다 합니다. 뷰스루 어트리뷰션을 활성화하다, 사용 가능하다 다음 단계를 따르십시오.

1. **통합** 탭의 **설치 어트리뷰션** 섹션으로 이동합니다.
2. **Install engaged view-through lookback window** 섹션을 따라 **Install view-through attribution** 토글을 활성화합니다.


   **View-through attribution enabled:**
   ![AppsFlyer 통합 설정의 설치 뷰스루 어트리뷰션 토글](/api/media?file=/user-acquisition/media/images/appsflyer-view-through-lookback.png)

### 레벨 완료 이벤트 포스트백에는 값이 포함되어야 합니다.##level-complete-event-postbacks-must-contain-values

이 확인 규칙을 충족하려면 AppsFlyer 연동 설정에서 레벨 완료 이벤트를 매핑할 때 **값 및 매출**을 선택해야 합니다. 이 데이터 공유 설정을 설정하려면 다음 단계를 따릅니다.

1. **통합** 탭의 **인앱 이벤트 포스트백** 섹션으로 이동합니다.
2. **In-app event postbacks** 토글을 활성화합니다.
3. 매핑 표의 **포함** 열에서 **값 및 매출**을 선택합니다.

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

| AppsFlyer event     | mapped to partner event | for users from                       | 포함     |
| ------------------- | ----------------------- | ------------------------------------ | ------ |
| `af_level_achieved` | `level_complete`        | All media sources, including organic | 값 및 매출 |


**Share Level Complete event values and revenue:**
![AppsFlyer 이벤트 매핑 표의 값 및 매출 선택](/api/media?file=/user-acquisition/media/images/appsflyer-values-and-revenue.png)

### 구매 이벤트 포스트백에는 값이 포함되어야 합니다.##purchase-event-postbacks-must-contain-values

이 확인 규칙을 충족하려면 AppsFlyer 연동 설정에서 구매 이벤트를 매핑할 때 **값 및 매출**을 선택해야 합니다. 이 데이터 공유 설정을 설정하려면 다음 단계를 따릅니다.

1. **통합** 탭의 **인앱 이벤트 포스트백** 섹션으로 이동합니다.
2. **In-app event postbacks** 토글을 활성화합니다.
3. 매핑 표의 **포함** 열에서 **값 및 매출**을 선택합니다.

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

| AppsFlyer event | mapped to partner event | for users from                       | 포함     |
| --------------- | ----------------------- | ------------------------------------ | ------ |
| `af_purchase`   | `purchase`              | All media sources, including organic | 값 및 매출 |


**Share Purchase event values and revenue:**
![AppsFlyer 이벤트 매핑 표의 값 및 매출 선택](/api/media?file=/user-acquisition/media/images/appsflyer-values-and-revenue.png)

### 매출 이벤트 포스트백에는 값이 포함되어야 합니다.##revenue-event-postbacks-must-contain-values

> **Important:**
>
> AppsFlyer를 사용하여 광고 매출 이벤트를 매핑하려면 먼저 [광고 매출 공유를 활성화하고, 사용 가능하다](#campaigns-must-receive-one-or-more-ad-revenue-postbacks)해야 합니다. 자세한 내용은 [AppsFlyer 광고 매출 어트리뷰션](https://support.appsflyer.com/hc/en-us/articles/217490046-ROI360-guide-ad-revenue-attribution#connect-to-ad-revenue-integrated-partners) 기술 자료를 참고하십시오.

이 확인 규칙을 충족하려면 AppsFlyer 연동 설정에서 광고 매출 이벤트를 매핑할 때 **값 및 매출**을 선택해야 합니다. 이 데이터 공유 설정을 설정하려면 AppsFlyer 통합 설정의 **통합** 탭에서 다음 단계를 따르십시오.

1. **통합** 탭의 **인앱 이벤트 포스트백** 섹션으로 이동합니다.
2. **In-app event postbacks** 토글을 활성화합니다.
3. 매핑 표의 **포함** 열에서 **값 및 매출**을 선택합니다.

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

| AppsFlyer event | mapped to partner event | for users from                       | 포함     |
| --------------- | ----------------------- | ------------------------------------ | ------ |
| `af_ad_revenue` | `ad_revenue`            | All media sources, including organic | 값 및 매출 |


**Share Ad Revenue event values and revenue:**
![AppsFlyer 이벤트 매핑 표의 값 및 매출 선택](/api/media?file=/user-acquisition/media/images/appsflyer-values-and-revenue.png)

### 세션 이벤트 포스트백에는 값이 포함되어야 합니다.##session-event-postbacks-must-contain-values

이 확인 규칙을 충족하려면 AppsFlyer 연동 설정에서 세션 이벤트를 매핑할 때 **값 및 매출 없음**을 선택해야 합니다. 이 데이터 공유 설정을 설정하려면 다음 단계를 따릅니다.

1. **통합** 탭의 **인앱 이벤트 포스트백** 섹션으로 이동합니다.
2. **In-app event postbacks** 토글을 활성화합니다.
3. 매핑 표의 **포함** 열에서 **값 & 매출 없음**을 선택합니다.

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

| AppsFlyer event | mapped to partner event | for users from                       | 포함             |
| --------------- | ----------------------- | ------------------------------------ | -------------- |
| `af_app_opened` | `session`               | All media sources, including organic | Values & no 매출 |


**Share Session event values only:**
![AppsFlyer 이벤트 매핑 표의 값 및 매출 없음 선택](/api/media?file=/user-acquisition/media/images/appsflyer-values-no-revenue.png)

### 구매 이벤트 포스트백은 올바르게 매핑되어야 합니다.##purchase-event-postbacks-must-be-mapped-correctly

이 확인 규칙을 충족하려면 AppsFlyer 연동 설정에서 Purchase 이벤트를 올바르게 맵 합니다. Purchase 이벤트 포스트백을 맵 다음 단계를 따르십시오.

1. **통합** 탭의 **인앱 이벤트 포스트백** 섹션으로 이동합니다.
2. **In-app event postbacks** 토글을 활성화합니다.
3. 다음과 같이 구매 이벤트 행을 맵.

| AppsFlyer event | mapped to partner event | for users from                       | 포함     |
| --------------- | ----------------------- | ------------------------------------ | ------ |
| `af_purchase`   | `purchase`              | All media sources, including organic | 값 및 매출 |


**Purchase event mapping for In-app Purchase campaigns:**
![AppsFlyer 연동 설정의 이벤트 매핑 표](/api/media?file=/user-acquisition/media/images/appsflyer-purchase-event-mapping.png)

### AppsFlyer 이벤트는 올바른 Unity 이벤트 이름에 매핑되어야 합니다.##appsflyer-events-must-be-mapped-to-the-correct-unity-event-name

이 확인 규칙을 충족하려면 모든 AppsFlyer 이벤트 포스트백을 올바르게 맵 합니다. 이벤트를 매핑하려면 다음 단계를 따릅니다.

1. **통합** 탭의 **인앱 이벤트 포스트백** 섹션으로 이동합니다.
2. **In-app event postbacks** 토글을 활성화합니다.
3. 이벤트 포스트백을 다음과 같이 **파트너 이벤트 매핑** 열에서 Unity 이벤트에 매핑합니다.
   * 세션 이벤트 to `session`
   * 레벨 `level_complete`로 이벤트 완료
   * 광고 매출 이벤트 to `ad_revenue`
   * 인앱 구매 이벤트를`purchase`

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

| AppsFlyer event           | mapped to partner event | for users from                       | 포함                  |
| ------------------------- | ----------------------- | ------------------------------------ | ------------------- |
| `af_purchase`             | `purchase`              | All media sources, including organic | 값 및 매출              |
| `{custom_sdk_event_name}` | `level_complete`        | All media sources, including organic | Values & revenue    |
| `af_app_opened`           | `session`               | All media sources, including organic | Values & no revenue |
| `af_ad_revenue`           | `ad_revenue`            | All media sources, including organic | Values & revenue    |

> **Important:**
>
> AppsFlyer를 사용하여 광고 매출 이벤트를 매핑하려면 먼저 [광고 매출 공유를 활성화하고, 사용 가능하다](#campaigns-must-receive-one-or-more-ad-revenue-postbacks)해야 합니다. 자세한 내용은 [AppsFlyer 광고 매출 어트리뷰션](https://support.appsflyer.com/hc/en-us/articles/217490046-ROI360-guide-ad-revenue-attribution#connect-to-ad-revenue-integrated-partners) 기술 자료를 참고하십시오.

### 앱은 최소 하나의 인스톨 포스트백을 수신해야 합니다.##app-must-receive-at-least-one-install-postback

이 확인 규칙을 충족하려면 캠페인이 인스톨 포스트백을 수신할 수 있도록 **기본 포스트백** 설정을 올바르게 설정해야 합니다. 다음과 같이 AppsFlyer 연동 설정을 설정.

1. **통합** 탭의 **기본 포스트백** 섹션으로 이동합니다.
2. `Install` 행에서 **for users from** 드롭다운에서 **All media sources, including organic**을 선택합니다.


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

### 캠페인은 하나 이상의 광고 매출 포스트백을 수신해야 합니다.##campaigns-must-receive-one-or-more-ad-revenue-postbacks

이 확인 규칙을 충족하려면 AppsFlyer 연동 설정에서 광고 매출 데이터를 활성화하다, 사용 가능하다 합니다. 광고 수익 이벤트 데이터를 캠페인과 공유하려면 다음 단계를 따릅니다.

1. AppsFlyer 연동 설정의 **Ad 매출** 탭으로 이동합니다.

2. **광고 매출 데이터 가져오기** 토글을 활성화합니다.


   **Get ad revenue toggle:**
   ![AppsFlyer 연동 설정에서 Ad 매출 탭과 Get ad 매출 토글](/api/media?file=/user-acquisition/media/images/appsflyer-get-ad-revenue.png)

3. AppsFlyer 대시보드 사이드 메뉴에서 **설정** > **매출 설정**으로 이동합니다.

   > **Important:**
   >
   > 매출 Settings\*\* 메뉴에 액세스, 접근 AppsFlyer ROI360 구독 필요합니다. 자세한 내용은 [AppsFlyer 광고 매출 어트리뷰션](https://support.appsflyer.com/hc/en-us/articles/217490046-ROI360-guide-ad-revenue-attribution#connect-to-ad-revenue-integrated-partners) 기술 자료를 참고하십시오.

4. **매출 설정** 페이지의 **광고 매출** 탭에서 **새로운 광고 매출 통합**을 선택합니다.

5. 매출 파트너 목록에서 **Unity Ads**를 선택합니다.

6. 파트너 설정에서 리포트 유형으로 \*\*Impression-level (via SDK) with Device-level (via S2S API)\*\*을 선택합니다.


   **AppsFlyer Revenue settings configuration:**
   ![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 Dashboard에서 **Secret key**를 검색하려면 다음 단계를 참고하십시오.

**Retrieve your Secret key:**

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

1. 왼쪽 내비게이션 메뉴에서 **API Management**로 이동합니다.

2. **Advertising Management API** > **Service account**를 선택합니다.


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

3. 서비스 계정이 없는 경우 **+ New**를 선택합니다. 서비스 계정이 있으면 표에서 해당 계정을 선택합니다.

4. 서비스 계정 페이지에서 **키** 섹션으로 이동합니다.

5. 새 키를 생성하려면 **+ Add key**를 선택합니다.

6. **Secret key** 뒤에 있는 복사 버튼을 선택하여 ID를 복사합니다.

### 캠페인은 하나 이상의 인앱 구매 포스트백을 수신해야 합니다.##campaigns-must-receive-one-or-more-in-app-purchase-postbacks

이 확인 규칙을 충족하려면 AppsFlyer 연동 설정에서 Purchase 이벤트를 올바르게 맵 합니다. Purchase 이벤트 포스트백을 맵 다음 단계를 따르십시오.

1. **통합** 탭의 **인앱 이벤트 포스트백** 섹션으로 이동합니다.
2. **In-app event postbacks** 토글을 활성화합니다.
3. 다음과 같이 구매 이벤트 행을 맵.

| AppsFlyer event | mapped to partner event | for users from                       | 포함     |
| --------------- | ----------------------- | ------------------------------------ | ------ |
| `af_purchase`   | `purchase`              | All media sources, including organic | 값 및 매출 |


**Purchase event mapping for In-app Purchase campaigns:**
![AppsFlyer 연동 설정의 이벤트 매핑 표](/api/media?file=/user-acquisition/media/images/appsflyer-purchase-event-mapping.png)

## 권장 해상도##recommended-resolutions

권장 통합 규칙을 충족하려면 다음 섹션을 참고하십시오.

### 모든 소스에서 사용자에게 이벤트 포스트백 보내기##send-install-event-postbacks-for-users-from-all-sources

이 권장 통합 규칙을 충족하려면 **Organic을 포함한 모든 미디어 소스의 사용자에게** 인스톨 이벤트 포스트백을 전송해야 합니다. 이렇게 하려면 다음 단계를 따릅니다.

1. AppsFlyer 통합의 **통합** 탭의 **기본 포스트백** 섹션으로 이동합니다.
2. **for users from** 드롭다운 섹션에서 **All media sources, including organic**을 **Install** 이벤트로 선택합니다.


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

### 모든 소스에서 사용자에게 이벤트 포스트백 포스트백 전송##send-post-install-event-postbacks-for-users-from-all-sources

이벤트 포스트백에 권장되는 모든 통합 규칙을 충족하려면 이벤트 매핑 시 이벤트 포스트백을 포함한 **모든 미디어 소스의 사용자용 이벤트 포스트백을 공유해야 합니다.** 이렇게 하려면 다음 단계를 따릅니다.

1. **통합** 탭의 **인앱 이벤트 포스트백** 섹션으로 이동합니다.
2. **In-app event postbacks** 토글을 활성화합니다.
3. 다음 이벤트 유형 각각에 대해 **for users from** 열에서 Organic을 포함한 **모든 미디어 소스**를 선택합니다.

   * `purchase`
   * `ad_revenue`
   * `level_complete`
   * `session`


   **Share post-install event postbacks for users from all media sources, including organic:**
   ![AppsFlyer 이벤트 매핑 표의 유기 선택 항목을 포함한 모든 미디어 소스](/api/media?file=/user-acquisition/media/images/appsflyer-for-users-from-dropdown.png)