> For the complete documentation index, see [llms.txt](https://www.analytics-docs.laplacetec.com/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.analytics-docs.laplacetec.com/guide/startguide/connect/events/appsflyer.md).

# AppsFlyer 연결

라플라스에 AppsFlyer(앱스플라이어)를 연결하는 방법입니다. AppsFlyer 관리자 계정에서 API 토큰을 복사해 라플라스에 입력하고, 수집할 앱을 고르는 순서와 연결 오류 해결 방법을 안내합니다.

이 가이드는 AppsFlyer(앱스플라이어)의 앱 설치·이벤트 성과 데이터를 라플라스에 연결하는 방법을 안내합니다. AppsFlyer의 API 토큰 하나를 라플라스에 입력하고, 그 계정의 앱 가운데 수집할 앱을 고르면 연결돼요.

{% hint style="info" %}
**AppsFlyer 연결은 베타입니다.** 연결 화면의 커넥터 이름 옆에 **베타** 표시가 보여요. 연결하다 막히는 부분이 있으면 아래 채팅 상담으로 알려 주세요.
{% endhint %}

## 연결 절차 개요 <a href="#overview" id="overview"></a>

1. AppsFlyer 관리자 계정으로 API 토큰을 복사해요.
2. 라플라스 **AppsFlyer 연결** 화면에서 **데이터 연결**을 눌러 API 토큰을 입력하고 **연결하기**를 눌러요. 토큰이 확인되면 **AppsFlyer 연결이 완료되었습니다.** 안내가 보여요.
3. **데이터 소스 선택** 창에서 수집할 앱을 고르고 **데이터 연결**을 눌러요. 수집이 시작되고 **연결된 데이터** 표에 그 연결이 보여요.

## 사전 준비 <a href="#ready" id="ready"></a>

* AppsFlyer **관리자(admin)** 계정. 일반 사용자 계정에는 토큰 화면이 보이지 않아요.
* AppsFlyer의 API 토큰(API V2 토큰)
* 라플라스 계정

{% hint style="info" %}
**API 토큰 하나는 AppsFlyer 계정 하나에 연결돼요.** 그 계정의 앱이 데이터 소스로 들어오고, 연결한 뒤 **데이터 소스 선택** 창에서 수집할 앱을 골라요. AppsFlyer 계정이 여러 개라면 계정마다 API 토큰을 복사해 하나씩 연결해 주세요.
{% endhint %}

***

## Step 1. AppsFlyer에서 API 토큰 복사하기 <a href="#api-token" id="api-token"></a>

1. AppsFlyer에 관리자 계정으로 로그인합니다.
2. 상단 바의 계정 메뉴(이메일 주소 드롭다운) > **Security center**로 이동합니다.
3. **AppsFlyer API tokens** 영역에서 **Manage your AppsFlyer API tokens**를 누릅니다. 지금 쓸 수 있는 토큰이 보여요.
4. 토큰 종류가 **API token**(API V2 토큰)인 토큰을 복사해 안전한 곳에 보관합니다.

{% hint style="info" %}
AppsFlyer 계정에는 기본으로 API 토큰이 하나 만들어져 있어요. 토큰 종류마다 최대 두 개까지만 만들 수 있으니, 이미 두 개가 있다면 새로 만들지 않고 쓰고 있는 API 토큰을 그대로 입력해도 됩니다. 자세한 내용은 AppsFlyer 도움말 센터의 **Managing AppsFlyer tokens** 문서를 참고해 주세요.
{% endhint %}

{% hint style="warning" %}
**API 토큰은 비밀번호와 같은 역할이에요.** 다른 사람에게 공유하거나 공개된 곳에 올리지 마세요. 라플라스에 입력한 토큰은 암호화되어 저장됩니다.
{% endhint %}

***

## Step 2. 라플라스에서 AppsFlyer 연결 <a href="#step2" id="step2"></a>

1. 왼쪽 레일의 **데이터 연결**을 누른 뒤, 탐색 패널의 **커넥터 검색**에 AppsFlyer를 입력하거나 **이벤트 연결** 카테고리에서 **AppsFlyer 연결**을 눌러 주세요(1). **AppsFlyer 연결** 화면 머리글 오른쪽의 **데이터 연결**을 눌러 연결 창을 열어 주세요(2).

   ![AppsFlyer 연결 화면과 머리글의 데이터 연결 버튼](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-72500126ec2a2347a1f2121949e039ccdd293c0e%2Fstartguide__connect__events__appsflyer__01.png?alt=media)
2. **AppsFlyer 데이터 연결** 창의 **API 토큰 정보**에 Step 1에서 보관한 **API 토큰**을 입력하고(1) **연결하기**를 눌러 주세요(2). 토큰을 확인하는 동안 **새로운 AppsFlyer 커넥션을 추가하는 중입니다.** 창이 잠시 보여요.

   ![AppsFlyer 데이터 연결 창 API 토큰 입력](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-8b2d679f4f68289aca4fc6408c8364de53dca4e8%2Fstartguide__connect__events__appsflyer__02.png?alt=media)
3. 토큰이 확인되면 **AppsFlyer 연결이 완료되었습니다.** 안내와 함께 **데이터 소스 선택** 창이 열려요. 수집할 앱을 선택하고(1) **데이터 연결**을 눌러 수집을 시작해 주세요(2).

   ![데이터 소스 선택에서 앱 선택 후 데이터 연결](https://2146870105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiVMM5rubRDzSVhvd8yr0%2Fuploads%2Fgit-blob-4a36a987115ef0371cc41bd1cb8de98561f8ea04%2Fstartguide__connect__events__appsflyer__03.png?alt=media)

* **데이터 연결**을 누르기 전에 창을 닫았다면 **연결된 데이터** 표에서 그 연결 행의 ⋯ 버튼 > **데이터 소스 추가**를 눌러 같은 창을 다시 열고 **데이터 연결**을 눌러 주세요.
* 연결한 AppsFlyer 계정은 **AppsFlyer 연결** 화면의 **연결된 데이터** 표에 보여요.

{% hint style="info" %}
**데이터 연동이 왜 오래 걸리나요?**

👉 라플라스에서는 AppsFlyer의 데이터를 가져오기만 하는 것이 아니라 가져온 데이터를 정제하고 차트를 그려주는 작업을 해주기 때문이에요. 처음 연결하면 지난 기간의 성과를 함께 가져오고, AppsFlyer API는 앱과 계정마다 하루 호출 횟수를 제한하기 때문에 시간이 더 걸릴 수 있어요.

💬 진행 상황은 상단 바 오른쪽 **작업 · 데이터 상태**에서 확인할 수 있고, 연동이 완료되면 이메일로도 알려 드려요. 라플라스를 종료해도 수집은 계속되니 안심하시고 종료하셔도 됩니다.
{% endhint %}

***

## 연결이 되지 않을 때 <a href="#error" id="error"></a>

**연결하기**를 누른 뒤 **데이터 연결 오류** 창이 열리면 창에 보이는 문구에 따라 아래처럼 해 주세요.

* **API 토큰이 올바르지 않습니다. 다시 확인해 주세요.**
  * 원인: API 토큰이 잘못 입력됐거나, AppsFlyer에서 삭제·폐기된 토큰이에요.
  * 조치: AppsFlyer의 API 토큰(API V2 토큰)을 앞뒤 공백 없이 그대로 붙여 넣었는지 확인해 주세요. 토큰이 삭제되었거나 폐기되었다면 관리자 계정으로 **Security center** > **Manage your AppsFlyer API tokens**에서 새 API 토큰을 만들어 입력해 주세요.
* **이 API 토큰으로 볼 수 있는 앱이 없습니다. 앱이 있는 AppsFlyer 계정에서 가장 최근에 만든 API 토큰을 입력해 주세요.**
  * 원인: 토큰은 맞지만 그 AppsFlyer 계정에 앱이 없거나, 예전에 만든 토큰이라 AppsFlyer가 앱 목록을 주지 않아요.
  * 조치: 수집할 앱이 등록된 AppsFlyer 계정의 관리자로 로그인해, **Manage your AppsFlyer API tokens**에서 가장 최근에 만든 API 토큰을 입력해 주세요.
* **AppsFlyer API 요청이 많습니다. 잠시 후에 다시 시도해 주세요.**
  * 원인: 짧은 시간에 같은 계정으로 AppsFlyer API 요청이 많이 들어갔어요.
  * 조치: 잠시 기다린 뒤 다시 **연결하기**를 눌러 주세요.
* **AppsFlyer 서버가 일시적으로 응답하지 않습니다. 잠시 후 다시 시도해 주세요.**
  * 원인: AppsFlyer 쪽에 일시적인 문제가 있어요.
  * 조치: 잠시 후 다시 시도해 주세요. 계속되면 담당 매니저에게 문의해 주세요.

***

## 토큰을 바꿨을 때 <a href="#new-token" id="new-token"></a>

AppsFlyer 연결에는 **인증 갱신**이 없어요. 라플라스는 입력한 API 토큰으로 연결을 구분하기 때문에, 새 토큰을 입력하면 기존 연결이 바뀌지 않고 **새 연결로 추가**돼요.

{% hint style="warning" %}
AppsFlyer에서 연결에 쓴 API 토큰을 삭제하면 라플라스가 그 연결의 데이터를 가져올 수 없어요. 토큰을 바꿔야 한다면 아래 순서로 해 주세요.

1. AppsFlyer에서 새 API 토큰을 만들거나 다른 API 토큰을 복사해 주세요.
2. 라플라스 **AppsFlyer 연결** 화면에서 **데이터 연결**을 눌러 새 토큰으로 연결하고, **데이터 소스 선택** 창에서 같은 앱을 골라 주세요.
3. 새 연결의 수집이 시작된 것을 확인한 뒤, **연결된 데이터** 표에서 예전 연결 행의 ⋯ 버튼 > **삭제**를 눌러 지워 주세요.
4. 마지막으로 AppsFlyer에서 예전 토큰을 삭제해 주세요.
   {% endhint %}

***

## 연결 해제 <a href="#disconnect" id="disconnect"></a>

연결 해제는 라플라스의 **AppsFlyer 연결** 화면에서 해 주세요. **연결된 데이터** 표에서 해제할 연결 행의 ⋯ 버튼 > **삭제**를 누르면 돼요. AppsFlyer의 API 토큰은 라플라스에서 지워지지 않으니, 더 쓰지 않는다면 AppsFlyer **Security center** > **Manage your AppsFlyer API tokens**에서 직접 정리해 주세요.

***

## 전담 매니저에게 요청하기

AppsFlyer 연결에 어려움이 있으신가요?

하단의 문의하기 혹은 홈페이지의 채팅 상담을 통해 문의하세요. 담당 매니저가 도움을 드리도록 하겠습니다.

> 💬 [채팅으로 문의하기](https://laplacetec.channel.io/lounge)
>
> 💬 [홈페이지에서 문의하기](https://www.analytics.laplacetec.com/contact)

**이메일 문의:** [**product@laplacetec.com**](mailto:product@laplacetec.com)
