# Appsflyer와의 연동

> MMP로 Appsflyer를 연동하여 사용자 참여와 캠페인 데이터를 탭조이 오퍼월과 공유합니다.

이 가이드에서는 Appsflyer 대시보드에서 새로운 오퍼월 캠페인을 설정하는 방법을 설명합니다.

추가 가이드는 Appsflyer 기술 자료의 [탭조이 설정 가이드](https://support.appsflyer.com/hc/en-us/articles/207033956-Tapjoy-campaign-configuration)를 참고하십시오.

## 탭조이 캠페인 설정##tapjoy-campaign-configuration

### 파트너 활성화##partner-activation

1. 사이드 메뉴에서 **Collaborate** > **Partner Marketplace**를 선택합니다.
2. 검색하여 **Tapjoy**를 선택합니다.
3. Tapjoy 프로필 페이지에서 **Integration 설정**을 선택합니다.
4. 연동 설정 페이지로 이동했습니다. Integration 탭에서 **Activate Partner**를 활성화합니다.

![AppsFlyer 대시보드에서 파트너로 Tapjoy 활성화](/api/media?file=/grow/media/images/AF_activate_partner.png)

> **Note:**
>
> **Activate partner**를 사용하여 캠페인 어트리뷰션을 일시 중지하거나 비활성화하지 마십시오. 파트너 연동을 비활성화하면 사용 중인 캠페인에 되돌릴 수 없는 손해가 있을 수 있습니다.

### 연동 탭(설치)##integration-tab-(install)

1. **First Time Installers**

   1. **Activate Partner**를 토글합니다.
   2. **app\_id** 필드 아래에 탭조이에서 생성된 문자열을 입력합니다.
   3. **Install view-through attribution** 옵션을 OFF로 토글합니다.
   4. Default Postback 섹션의 Install 옆에 있는 `All media sources, including organic`을 선택합니다.

   ![모든 미디어 소스를 보여주는 AppsFlyer 대시보드](/api/media?file=/grow/media/images/AF_all_media_sources.png)

2. **Existing Users**

   1. **In-app events postback**을 토글합니다.
   2. \*\*Add 이벤트 선택합니다.
   3. **Appsflyer event**에서 `af_app_opened`를 검색하거나 추가합니다.
   4. \#2.2단계의 **app\_id** 필드에 입력한 것과 동일한 탭조이 생성 문자열을 사용합니다.
   5. **for users from** 드롭다운에서 `All media sources, including organic`을 선택합니다.
   6. **Save Integration**을 선택하거나 3단계 연동 탭으로 이동합니다. 이벤트로 진행하여 추가 설치 후 이벤트를 추가합니다.

   ![AppsFlyer 대시보드에서 Tapjoy 생성 트래킹 링크](/api/media?file=/grow/media/images/AF_tapjoy_generated.png)

#### 설치를 위한 다이나믹 서프레션 요구 사항##dynamic-suppression-requirements-for-install

다이나믹 서프레션 정책을 준수하고 최적의 성능을 보장하기 위해, 2022년 4월 1일부터 다음과 같은 구성이 필요합니다.

* **첫 설치자**: 해당 디바이스에 앱을 설치하거나 실행한 적이 전혀 없는 사용자입니다. 재설치는 신규 설치로 간주되지 않습니다.
* **기존 사용자**: 사용자가 디바이스에 앱을 설치하고 실행한 적이 있는 경우(앱을 삭제한 후 다시 설치한 경우 포함).

### 연동 탭(이벤트)##integration-tab-(events)

1. **Single Multi-Reward CPE**

   1. **In-app events postback** 섹션으로 아래로 스크롤합니다.
   2. \*\*Add 이벤트 선택합니다.
   3. **Appsflyer event** 드롭다운에서 이벤트를 선택합니다.
   4. **mapped to partner event** 필드 아래에 탭조이가 생성한 engagement\_id를 입력합니다.
   5. 모든 이벤트가 설정될 때까지 2\~4단계를 반복하고 고유한 engagement\_id를 가리킵니다.
   6. **Save Integration**을 선택하거나 Daily Rewards 섹션으로 이동하여 추가 포스트 설치 이벤트를 설정합니다.

   ![AppsFlyer 대시보드에서 인앱 이벤트를 Tapjoy에 매핑합니다.](/api/media?file=/grow/media/images/AF_mapped_event.png)

2. **Daily Rewards CPE**

   1. **In-app events postback** 섹션으로 아래로 스크롤합니다.
   2. \*\*Add 이벤트 선택합니다.
   3. 인게임 레벨 업과 연관된 SDK 이벤트를 추가합니다. 지원되는 이벤트 이름에는 커스텀 이벤트와 `af_level` 또는 `af_level_achieved`와 같은 Appsflyer의 사전 정의 이벤트가 모두 포함됩니다.

   > **Note:**
   >
   > Appsflyer는 인게임 레벨 업에 대해 인앱 결제를 위한 [af\_level](https://support.appsflyer.com/hc/en-us/articles/4410481112081-In-app-events-Event-structure#af_level), 사용자 생성 광고 수익 이벤트를 위한 [af\_level\_achieved](https://support.appsflyer.com/hc/en-us/articles/4410481112081-In-app-events-Event-structure#level-achieved-af_level_achieved)와 같은 [사전 정의된 이벤트](https://support.appsflyer.com/hc/en-us/articles/115005544169-In-app-events-Overview#predefind-and-custom-events)를 통합할 것을 권장합니다. 커스텀 이벤트도 지원됩니다. [이벤트를 정의](https://support.appsflyer.com/hc/en-us/articles/115005544169-In-app-events-Overview#defining-an-inapp-event)하고 [이벤트 생성기](https://evgen.appsflyer.com/)를 사용하는 방법을 알아봅니다. 자세한 내용은 [팁](https://support.appsflyer.com/hc/en-us/articles/115005544169-In-app-events-Overview#tips) 및 [제한 사항](https://support.appsflyer.com/hc/en-us/articles/115005544169-In-app-events-Overview#limitations)을 참고하십시오.

   4. **mapped to partner event** 아래에 탭조이가 생성한 engagement\_id를 입력합니다.
   5. **Including** 아래 드롭다운에서 레벨 데이터가 전환 포스트백 정보에 포함되도록 `Values + No Revenue`를 선택합니다.
   6. **Save Integration**을 선택합니다.

   ![AppsFlyer 대시보드에서 일일 보상 보고](/api/media?file=/grow/media/images/AF_daily_rewards.png)

## ROAS용 IAP 및 광고 수익 설정##iap-and-ad-revenue-configuration-for-roas

### Appsflyer IAP 설정##appsflyer-iap-setup

1. **인앱 이벤트 포스트백** 섹션에서 **이벤트 추가**를 선택합니다.
2. 인앱 결제 이벤트를 추가합니다. IAP 이벤트에 `af_purchase`의 이벤트 이름을 사용하는 것이 좋습니다(Appsflyer의 [af\_purchase](https://support.appsflyer.com/hc/en-us/articles/4410481112081-In-app-events-Event-structure#purchase-af_purchase) 이벤트 참고).
3. **mapped to partner event** 아래에 탭조이가 생성한 engagement\\\_id를 입력합니다.
4. **for users from** 열에서 원하는 전송 옵션을 선택합니다. '*All media sources, including organic*'을 사용하는 것이 좋습니다.
5. **Including**에서 금액이 전환 포스트백 정보에 포함되도록 `Values + Revenue`를 선택합니다.
6. **Save Integration**을 선택합니다.

Appsflyer의 사전 정의된 이벤트 [리스트](https://support.appsflyer.com/hc/en-us/articles/115005544169-In-app-events-Overview#predefind-and-custom-events)를 참고하십시오.

![AppsFlyer 매출 값 설정 화면.](/api/media?file=/grow/media/images/AF_values_revenue.png)

### Appsflyer 광고 수익 설정##appsflyer-ad-revenue-setup

탭조이는 다음 두 가지 방법으로 광고 수익을 전송합니다. 포스트백과 Data Locker. 권장되는 베스트 프랙티스는 데이터 품질 향상을 위한 **포스트백 메서드**입니다.

1. **Postbacks (Recommended)**

   1. **In-app events postback** 섹션 \*\*Add 이벤트 선택합니다.
   2. 이벤트 이름을 `af_ad_revenue`로 사용하여 광고 수익 이벤트를 추가합니다. [af\_ad\_revenue](https://support.appsflyer.com/hc/en-us/articles/4410481112081-In-app-events-Event-structure#af_revenue) 이벤트 이름 **필수**입니다.
   3. **mapped to partner event** 아래에 탭조이가 생성한 engagement\_id를 입력합니다.
   4. **for users from** 열에서 원하는 전송 옵션을 선택합니다. 'Al\_l media sources, including organic\_'을 사용하는 것이 좋습니다.
   5. **Including**에서 금액이 전환 포스트백 정보에 포함되도록 `Values + Revenue`를 선택합니다.
   6. **Save Integration**을 선택합니다.

   > **Note:**
   >
   > 앱에서 포스트백을 통한 광고 수익을 처음 활성화하는 경우, 해당 데이터가 활성화되어 탭조이 대시보드에 표시되도록 세일즈 담당자에게 알려주십시오. 그렇지 않으면, 탭조이 대시보드의 광고 수익은 반영되지 않거나, 해당 앱에 대해 Data Locker가 설정된 경우 Data Locker 데이터에서 계속 발생할 것입니다. 이 작업은 각 앱별로 수행해야 합니다.

   ![AppsFlyer 광고 매출 값 설정 화면](/api/media?file=/grow/media/images/AF_values_ad_revenue.png)

2. **Data Locker**

   > **Note:**
   >
   > 광고주는 광고 수익 공유를 위한 Data Locker를 사용하려면 ROI360 고급 구독이 필요합니다.

   1. 사이드 메뉴에서 **Collaborate** > **Active integrations**를 선택합니다.
   2. 검색창을 사용하여 **Tapjoy**를 찾아 선택합니다.
   3. **Permissions** 탭으로 이동합니다.
   4. **Ad Network Permissions**를 활성화합니다.
   5. **Access ad revenue raw data (UA signals)** 권한을 활성화합니다.
   6. **Save**를 선택합니다.

   자세한 내용은 Appsflyer 기술 자료의 [UA 애드 네트워크의 광고 수익 신호](https://support.appsflyer.com/hc/en-us/articles/4402898251409-Ad-revenue-signals-for-UA-ad-networks#set-the-ad-revenue-report-in-data-locker)를 참고하십시오.

   ![AppsFlyer 대시보드의 광고 매출 보고](/api/media?file=/grow/media/images/AF_ad_revenue.png)