> 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/airbridge.md).

# 에어브릿지 연결

라플라스에 에어브릿지(Airbridge)를 연결하는 방법입니다. 에어브릿지 대시보드에서 앱 이름(App Name)과 API 토큰을 복사해 라플라스에 입력하고 수집을 시작하는 순서와 연결 오류 해결 방법을 안내합니다.

이 가이드는 에어브릿지(Airbridge)의 앱 광고 성과와 앱 이벤트 데이터를 라플라스에 연결하는 방법을 안내합니다. 에어브릿지 앱 하나의 앱 이름(App Name)과 API 토큰을 라플라스에 입력하면 그 앱이 연결돼요.

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

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

1. 에어브릿지 대시보드에서 연결할 앱의 앱 이름(App Name)과 API 토큰을 복사해요.
2. 라플라스 **에어브릿지 연결** 화면에서 **데이터 연결**을 눌러 앱 이름과 API 토큰을 입력하고 **연결하기**를 눌러요. 확인되면 **에어브릿지 연결이 완료되었습니다. 데이터 수집을 시작합니다.** 안내가 보여요.
3. 이어서 열리는 **데이터 소스 선택** 창에서 앱을 선택하고 **데이터 연결**을 눌러요. **연결된 데이터** 표에 그 앱이 보여요.

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

* 연결할 앱에 접근할 수 있는 에어브릿지 계정
* 에어브릿지의 앱 이름(App Name)과 API 토큰
* 라플라스 계정

{% hint style="info" %}
**앱 하나가 연결 하나예요.** 에어브릿지 앱이 여러 개라면 앱마다 앱 이름을 바꿔 하나씩 연결해 주세요. API 토큰은 에어브릿지 계정마다 주어지는 값이라, 같은 계정에서 보이는 앱이면 같은 토큰을 다시 입력해도 됩니다.
{% endhint %}

***

## Step 1. 에어브릿지에서 앱 이름과 API 토큰 확인하기 <a href="#app-name-token" id="app-name-token"></a>

1. 에어브릿지 대시보드에 로그인하고 연결할 앱을 선택합니다.
2. **설정** > **토큰 관리** 메뉴로 이동합니다. 영문 화면에서는 **Settings** > **Tokens** 메뉴예요.
3. **앱 이름**(App Name)을 복사합니다. 앱 목록에 보이는 표시 이름이 아니라 앱을 등록할 때 정한 고유 ID예요. **설정** > **에어브릿지 앱 설정**에서도 같은 값을 볼 수 있어요.
4. 같은 화면의 **API 토큰**(API Token)을 복사해 안전한 곳에 보관합니다.

{% hint style="info" %}
토큰 화면에는 웹 SDK 토큰, 앱 SDK 토큰, 트래킹 링크 API 토큰도 함께 보여요. 라플라스에는 **API 토큰**을 입력해 주세요. 자세한 내용은 에어브릿지 도움말 센터의 **토큰 관리하기** 문서를 참고해 주세요.
{% endhint %}

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

***

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

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

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

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

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

{% hint style="info" %}
앱 이름 칸에는 영문, 숫자, 하이픈(-), 밑줄(\_)만 쓸 수 있어요. 다른 글자가 들어가면 **앱 이름은 영문, 숫자, -, \_ 로 된 100자 이하의 값입니다.** 안내가 보여요. 한글이나 띄어쓰기가 있는 이름은 표시 이름이니 Step 1의 앱 이름(App Name)을 다시 확인해 주세요.
{% endhint %}

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

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

👉 라플라스에서는 에어브릿지의 데이터를 가져오기만 하는 것이 아니라 가져온 데이터를 정제하고 차트를 그려주는 작업을 해주기 때문이에요. 처음 연결할 때는 시간이 더 걸릴 수 있어요.

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

***

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

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

* **앱 이름 또는 API 토큰이 올바르지 않습니다. 다시 확인해 주세요.**
  * 원인: 앱 이름이나 API 토큰이 잘못 입력됐거나, 재설정되어 더 쓸 수 없는 토큰이에요. 앱 목록의 표시 이름을 앱 이름 칸에 넣었거나, 그 앱에 접근할 수 없는 계정의 토큰을 넣었을 때도 이 문구가 보여요.
  * 조치: 에어브릿지 **설정** > **토큰 관리**의 앱 이름(App Name)과 API 토큰을 앞뒤 공백 없이 그대로 붙여 넣었는지 확인해 주세요. 토큰을 재설정했다면 새 토큰을 입력해 주세요.
* **이미 연결된 에어브릿지 앱입니다.**
  * 원인: 같은 앱 이름의 연결이 이미 있어요.
  * 조치: **연결된 데이터** 표에서 그 앱의 연결을 확인해 주세요. 토큰을 바꾸려는 경우는 아래 **토큰을 바꿨을 때**를 봐 주세요.
* **에어브릿지 API 에 연결하지 못했습니다. 잠시 후에 다시 시도해 주세요.**
  * 원인: 에어브릿지 쪽에 일시적인 문제가 있거나, 짧은 시간에 요청이 많이 들어갔어요.
  * 조치: 잠시 기다린 뒤 다시 **연결하기**를 눌러 주세요. 계속되면 담당 매니저에게 문의해 주세요.
* **알 수 없는 에러가 발생했습니다. 잠시 후에 다시 시도해 주세요. 같은 문제가 반복되시면 문의를 통해 연락주세요.**
  * 조치: 잠시 후 다시 시도하고, 반복되면 아래 채팅 상담으로 알려 주세요.

연결은 됐는데 **연결은 완료되었지만 첫 수집을 시작하지 못했습니다. 목록에서 수집을 다시 시작해 주세요.** 안내가 보이면, **연결된 데이터** 표에서 그 연결 행의 ⋯ 버튼 > **데이터 소스 추가**를 눌러 앱을 선택하고 **데이터 연결**을 눌러 주세요.

***

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

에어브릿지 연결에는 **인증 갱신**이 없고, 같은 앱을 다시 연결하면 **이미 연결된 에어브릿지 앱입니다.** 안내가 보여요. 에어브릿지에서 API 토큰을 재설정하면 예전 토큰은 더 쓸 수 없어 그 연결의 데이터를 가져올 수 없어요.

{% hint style="warning" %}
API 토큰은 에어브릿지 계정마다 주어지는 값이라, 재설정하면 그 토큰을 쓰는 다른 곳도 새 토큰으로 바꿔야 할 수 있어요. 꼭 필요할 때만 재설정해 주세요. 토큰을 바꿨다면 아래 순서로 다시 연결해 주세요.

1. 라플라스 **에어브릿지 연결** 화면의 **연결된 데이터** 표에서 그 앱의 연결 행의 ⋯ 버튼 > **삭제**를 눌러 지워 주세요. 삭제하면 그 연결로 가져온 데이터도 함께 지워져요.
2. **데이터 연결**을 눌러 같은 앱 이름과 새 API 토큰으로 다시 연결하고, **데이터 소스 선택** 창에서 앱을 선택해 **데이터 연결**을 눌러 주세요. 수집이 처음부터 다시 시작돼요.

삭제하기 전에 궁금한 점이 있으면 아래 채팅 상담으로 먼저 문의해 주세요.
{% endhint %}

***

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

연결 해제는 라플라스의 **에어브릿지 연결** 화면에서 해 주세요. **연결된 데이터** 표에서 해제할 연결 행의 ⋯ 버튼 > **삭제**를 누르면 돼요. 에어브릿지의 API 토큰은 라플라스에서 바뀌지 않으니, 더 쓰지 않는다면 에어브릿지 **설정** > **토큰 관리**에서 직접 관리해 주세요.

***

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

에어브릿지 연결에 어려움이 있으신가요?

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

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

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