> For the complete documentation index, see [llms.txt](https://toss-ads.gitbook.io/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://toss-ads.gitbook.io/guide/resources/mat/airbridge.md).

# 에어브릿지

### 전환 추적 코드 생성하기

{% stepper %}
{% step %}
**전환 및 추적 연동**

<figure><img src="/files/4FTV4mG3jyK5dfDm5Rj8" alt=""><figcaption></figcaption></figure>

전환 및 추적 연동 설정은 아래 경로에서 가능해요.

광고 계정 접속 → 광고 도구 \[전환 및 추적 연동] 선택
{% endstep %}

{% step %}
**전환 추적 코드 생성**

<figure><img src="/files/X3jLEIiNtgp89du1R76C" alt=""><figcaption></figcaption></figure>

코드 명과 연동 방식, 연동 업체를 선택하여 코드를 생성해주세요.
{% endstep %}

{% step %}
**생성 여부 확인**

<figure><img src="/files/iZOBA2kZBPD5gbLSmBJ5" alt=""><figcaption></figcaption></figure>

설정한 정보에 맞게 생성된 전환 추적 코드의 ID를 복사하여 연동할 수 있어요.
{% endstep %}
{% endstepper %}

***

### 에어브릿지 연동하기

{% stepper %}
{% step %}
**에어브릿지 연동 경로**

<figure><img src="/files/6dCDaAaMyU0qRB7RUxTv" alt=""><figcaption></figcaption></figure>

에어브릿지 연동 링크 생성은 아래 경로에서 가능해요.

Integrations → Intergrated Ad Channels 선택 → \[Toss]앱 검색
{% endstep %}

{% step %}
**연동 활성화**

<figure><img src="/files/kWp6Eb4XblsJsNx1zyTI" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/JH44sf5F5yFAdRLWvBKz" alt=""><figcaption></figcaption></figure>

* 포스트백 전송 토글을 ON으로 변경하고 인증 정보 관리 버튼을 클릭하여 토스 플랫폼에서 발급받은 전환 추적 코드의 ID 값을 복사하여 cvr\_id 항목에 입력하여 파트너 연동을 활성화 해주세요.
  * 전환 추적 코드 ID 수정이 필요하다면 포스트백 전송을 중지한 이후 수정 해주세요.
* 이벤트 전송 규칙은 `채널 기여와 상관 없이 모든 이벤트 전송`으로 설정해주세요.
* 상세한 가이드는 [Airbridge 연동 가이드](https://help.airbridge.io/ko/guides/toss-ads)를 참고해주세요.
  {% endstep %}
  {% endstepper %}

***

### 미디어 파트너 권한 부여하기

{% stepper %}
{% step %}
**미디어 파트너 권한 부여**

<figure><img src="/files/fuoLzysMnH4XpoRvlHZ6" alt=""><figcaption></figcaption></figure>

에어브릿지를 연동한 후 데이터 관리 및 최적화를 위해 <toss-ads@toss.im> 계정에 미디어 파트너 권한을 부여해주세요.

권한 부여 경로는 아래와 같아요.

에어브릿지 접속 → \[Settings] → \[User Management] 접속
{% endstep %}

{% step %}
**앱 접근 권한 부여**

<figure><img src="/files/vU8zBIGEb8ecck9IlOYm" alt=""><figcaption></figcaption></figure>

\[앱 접근 권한 부여] 버튼을 클릭해주세요.

팝업창에서 <toss-ads@toss.im> 계정을 입력하고 앱 역할을 "미디어 파트너"로 설정해주세요.

자세한 가이드는 [에어브릿지 > 앱에서 앱 접근 권한 관리하기 가이드](https://help.airbridge.io/ko/guides/app-access-management)를 참고해주세요.
{% endstep %}
{% endstepper %}

***

### 전환 이벤트 연동하기

토스애즈에서 수집하는 전환 이벤트 항목은 아래와 같아요.

<table><thead><tr><th width="185.28466796875">이벤트 이름</th><th>Toss Ads 이벤트 라벨</th><th>Airbridge 이벤트 라벨</th></tr></thead><tbody><tr><td>설치</td><td>INSTALL</td><td>app_install</td></tr><tr><td>앱 오픈</td><td>APP_OPEN</td><td>app_open</td></tr><tr><td>딥링크 앱 오픈</td><td>APP_DEEPLINK_OPEN</td><td>app_deeplink_open</td></tr><tr><td>회원가입</td><td>SIGNUP</td><td>airbridge.user.signup</td></tr><tr><td>로그인</td><td>SIGNIN</td><td>airbridge.user.signin</td></tr><tr><td>결제</td><td>PURCHASE</td><td>airbridge.ecommerce.order.completed</td></tr><tr><td>상품 조회</td><td>PRODUCT_VIEW</td><td>airbridge.ecommerce.product.viewed</td></tr><tr><td>장바구니 추가</td><td>ADD_TO_CART</td><td>airbridge.ecommerce.product.addedToCart</td></tr><tr><td>검색</td><td>SEARCH</td><td>airbridge.ecommerce.searchResults.viewed</td></tr><tr><td>결제 시작</td><td>INITIATE_CHECKOUT</td><td>airbridge.initiateCheckout</td></tr><tr><td>위시리스트 추가</td><td>ADD_TO_WISHLIST</td><td>airbridge.addToWishlist</td></tr><tr><td>구독</td><td>SUBSCRIBE</td><td>airbridge.subscribe</td></tr><tr><td>홈 조회</td><td>VIEW_HOME</td><td>airbridge.ecommerce.home.viewed</td></tr><tr><td>광고 노출</td><td>AD_IMPRESSION</td><td>airbridge.adImpression</td></tr></tbody></table>

{% hint style="success" %}

* 연동 후 전환 추적을 위해서는 소재를 새롭게 세팅해야 해요.
  * 랜딩 URL은 전환 추적 템플릿으로 생성한 랜딩 URL로 입력해 주세요.
* Airbridge 이벤트 라벨은 Airbridge에서 사용 중인 기본 명칭으로 기재되었어요. 자사 서비스에서 발생하는 이벤트를 기준으로 [토스애즈의 표준이벤트](https://toss-ads.gitbook.io/guide/resources/tag/tracked-events)와 가장 적절한 이벤트에 매핑해 주세요.
  {% endhint %}

***

### 전환 추적 링크 필수/권장 항목

토스애즈에서 **에어브릿지**를 통해 광고 성과를 추적할 때 전환 추적에 필요한 **필수 항목**과 **권장 항목**을 올바르게 설정해야 정확한 데이터를 확인할 수 있어요.

#### 필수 항목

아래 항목들은 서로 짝을 지어 꼭 랜딩 URL에 포함해 주세요.&#x20;

필수 항목이 누락되면 **어떤 광고에서 전환이 발생했는지 확인하기 어렵고 에어브릿지 대시보드에서도 데이터가 정확하게 집계되지 않을 수 있어요.**

| 항목           | 값                     | 설명          |
| ------------ | --------------------- | ----------- |
| path         | /toss                 | 경로 식별자      |
| click\_id    | {TOSS\_TK\_CLICK\_ID} | 클릭 ID       |
| ad\_id       | {USER\_ADID}          | ADID / IDFA |
| campaign\_id | {TOSS\_CID}           | 캠페인 ID      |

#### 권장 항목

아래 항목들은 랜딩 URL에 함께 넣는 것을 권장해요.&#x20;

권장 항목이 빠지거나 잘못 설정되면 **캠페인/광고그룹/소재 단위 성과를 세부적으로 확인하기 어렵고 에어브릿지 표준 키와 맞지 않아 트래킹이 누락되거나 잘못 동작할 수 있어요.**

| 항목               | 값                    | 설명     |
| ---------------- | -------------------- | ------ |
| sub\_id          | {SITE\_ID}           | 지면 구분  |
| ad\_creative\_id | {TOSS\_CREATIVE\_ID} | 소재 ID  |
| campaign         | {CAMPAIGN\_NAME}     | 캠페인명   |
| ad\_group        | {ADGROUP\_NAME}      | 광고 그룹명 |
| ad\_creative     | {CREATIVE\_NAME}     | 광고 소재명 |

### 링크 구성 예시

모든 <mark style="color:red;">**필수**</mark>**/**<mark style="color:blue;">**권장**</mark> 항목이 포함된 예시 링크

> <https://abr.ge/@tossads/toss>?<mark style="color:red;">**click\_id={TOSS\_TK\_CLICK\_ID}\&ad\_id={USER\_ADID}\&campaign\_id={TOSS\_CID}**</mark>&<mark style="color:blue;">**sub\_id={SITE\_ID}\&ad\_creative\_id={TOSS\_CREATIVE\_ID}\&campaign={CAMPAIGN\_NAME}\&ad\_group={ADGROUP\_NAME}\&ad\_creative={CREATIVE\_NAME}**</mark>

{% hint style="success" %}
**링크 설정 Tip**

* 에어브릿지 콘솔에서 제공하는 click attribution link를 그대로 활용하면 필수/권장 항목을 놓치지 않을 수 있어요.
  * 자세한 설정 방법은 에어브릿지 대시보드 내 연동 > 광고 채널 연동 > 토스 >트래킹 링크 탭에서 확인하실 수 있어요.
* 이벤트 매핑이 잘못되면 실제 전환 데이터가 빠질 수 있으니 필수 항목의 구조를 꼭 확인해 주세요.
* Tracking URL에서 수정이 필요한 항목은 캠페인 설정 시 **소재 URL** 섹션에서 다시 확인할 수 있습니다.
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://toss-ads.gitbook.io/guide/resources/mat/airbridge.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.