> ## Documentation Index
> Fetch the complete documentation index at: https://help.airbridge.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 앱러빈

앱러빈에서 운영한 웹 캠페인의 어트리뷰션 데이터를 에어브릿지 대시보드에서 확인할 수 있습니다.

## 앱러빈 웹 캠페인 연동하기

에어브릿지 대시보드에서 앱러빈 웹 캠페인 연동을 할 수 있습니다.

### 사전 준비사항(필수)

앱러빈 웹 캠페인 연동 전에 아래 사전 준비사항을 모두 완료하세요.

| 항목 | 설명 | 작업 위치 | 담당자 | 참고 |
| - | - | - | - | - |
| 앱러빈 전환 API 연동 | 앱러빈 웹 캠페인에서 발생한 이벤트를 최적화하려면 전환 API를 연동해야 합니다. | 에어브릿지 대시보드 | 마케터 | [앱러빈 전환 API 연동하기](#앱러빈-전환-api-연동하기) |
| 에어브릿지 웹 SDK에 `utmParsing: true` 설정 | 에어브릿지 웹 SDK에 `utmParsing` 옵션을 `true`로 설정해야 합니다. 이 옵션이 `true`여야 에어브릿지가 UTM 파라미터를 활용할 수 있습니다. | 에어브릿지 웹 SDK | 개발자 | [utm 파라미터 자동으로 설정하기](https://help.airbridge.io/ko/developers/web-sdk#utm-파라미터-자동으로-설정하기) |

> [!CAUTION]
>
> **주의하세요**
>
> 에어브릿지 웹 SDK의 유저 ID(`user.externalUserID`)는 6자 이상으로 설정해야 합니다.

### 사전 준비사항(권장)

필요한 경우 아래 사전 준비사항을 완료하세요.

| 항목 | 설명 | 작업 위치 | 담당자 | 참고 |
| - | - | - | - | - |
| 앱러빈 픽셀 설치 | 앱러빈은 앱러빈 픽셀과 전환 API를 함께 사용하는 것을 권장합니다. 앱러빈 픽셀을 사용하는 경우 웹 이벤트에 커스텀 어트리뷰트를 추가해야 합니다. | 웹사이트 에어브릿지 웹 SDK | 개발자 | · [앱러빈 헬프센터 가이드](https://support.applovin.com/en/growth/promoting-your-websites/api/conversion-api) · [웹 이벤트에 커스텀 어트리뷰트 추가하기](#웹-이벤트에-커스텀-어트리뷰트-추가하기-개발자) |

#### 웹 이벤트에 커스텀 어트리뷰트 추가하기 (개발자)

앱러빈 픽셀을 함께 사용하려면 개발자에게 아래 가이드와 함께 웹 이벤트에 커스텀 어트리뷰트를 추가해 달라고 요청하세요. 커스텀 어트리뷰트는 앱러빈에서 정확한 측정과 중복 집계 방지를 위해 쓰입니다.

* [웹 이벤트 추가 설정하기](https://help.airbridge.io/ko/developers/web-sdk#웹-이벤트-추가-설정하기)

| 필드 | 설명 |
| - | - |
| applovin\_awxrt | 앱러빈 픽셀이 브라우저에 저장한 \_axwrt 쿠키 값. 앱러빈이 전환을 광고와 매칭하기 위해 사용됩니다. |
| applovin\_dedupe\_id | 전환마다 고유한 값. 앱러빈 픽셀과 에어브릿지 전환 API가 같은 전환을 보낼 때 중복 집계를 방지하기 위해 사용됩니다. |

> [!CAUTION]
>
> **주의하세요**
>
> 커스텀 어트리뷰트(customAttributes)는 최대 2,048자까지 저장됩니다. 모든 커스텀 어트리뷰트를 합친 전체 길이가 2,048자를 넘으면 applovin\_awxrt와 applovin\_dedupe\_id가 정상적으로 전달되지 않을 수 있습니다.

아래는 구매 완료 이벤트에 커스텀 어트리뷰트를 추가한 예시입니다. applovin\_awxrt에는 이벤트를 보낼 때 \_axwrt 쿠키에서 읽은 값을, applovin\_dedupe\_id에는 주문 ID처럼 전환별로 고유한 값을 넣습니다.

```javascript theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
// 브라우저에서 _axwrt 쿠키 값을 읽는 함수
function getCookie(name) {
    const match = document.cookie.match(new RegExp('(?:^|; )' + name + '=([^;]*)'))
    return match ? decodeURIComponent(match[1]) : undefined
}

airbridge.events.send('airbridge.ecommerce.order.completed', {
    value: 11,
    semanticAttributes: {
        transactionID: 'order_123',
        currency: 'USD',
    },
    customAttributes: {
        applovin_awxrt: getCookie('_axwrt'),
        applovin_dedupe_id: 'order_123',
    },
})
```

### 앱러빈 설정에 웹 페이지 URL 입력하기

1. [앱러빈 대시보드](https://ads.applovin.com/)에서 새 캠페인을 만드세요.
2. \[Campaign URL]>\[Destination URL]에 유저를 보낼 웹 URL을 입력하세요. 사전 준비사항 단계에서 웹 SDK를 설정한 웹 URL을 사용해야 합니다.
3. \[Tracking parameters]에서 'Edit'을 클릭해 \[UTM parameters]를 확인하고 그대로 사용하세요. 입력된 UTM 파라미터는 앱러빈에서 제공하는 항목입니다. \[Measurement partner parameters]는 사용하지 않습니다.
4. \[Add custom parameters]에서 아래 Key와 Value를 각각 복사해 붙여 넣고 'Add'를 클릭하세요. 에어브릿지 \[웹 캠페인 연동] 탭에서 값마다 있는 복사 아이콘을 클릭하면 복사할 수 있습니다.

   | Key | Value | 에어브릿지로 전달되는 정보 |
   | - | - | - |
   | channel | applovin | 광고 채널 |
   | campaign\_id | \{CAMPAIGN\_ID} | 캠페인 ID |
   | ad\_group\_id | \{CREATIVE\_SET\_ID} | 크리에이티브 세트 ID |
   | click\_id | \{EVENT\_ID} | 클릭 ID |
5. \[Final URL]을 확인하고 ‘Confirm’을 클릭해 저장하세요.

## 앱러빈 전환 API 연동하기

에어브릿지와 앱러빈의 전환 API 연동을 통해 에어브릿지에서 수집한 이벤트를 앱러빈에 포스트백으로 전송합니다. 전송받은 이벤트로 앱러빈 캠페인을 최적화할 수 있습니다.

> [!CAUTION]
>
> **주의하세요**
>
> 앱러빈 픽셀로 이벤트를 별도 수집 중이면 이벤트가 중복 집계됩니다. 중복 집계를 막으려면 [웹 이벤트에 커스텀 어트리뷰트 추가하기](#웹-이벤트에-커스텀-어트리뷰트-추가하기-개발자)를 참고해 applovin\_dedupe\_id를 설정하세요.

### 연동 정보 등록하기

앱러빈 대시보드에서 연동 정보인 Event Key를 확인해야 합니다.

> [accordion] 앱러빈에서 Event Key 확인하기
>
> 앱러빈 대시보드 \[Account settings]>\[Keys]에서 Event Key를 확인하세요. Event Key는 앱러빈 문서에서 픽셀 ID(pixel\_id)로 표기하는 값과 같습니다.

연동 정보를 확인한 후에 에어브릿지 대시보드 \[연동]>\[광고 채널 연동]에서 앱러빈의 \[전환 API 연동] 탭으로 이동합니다. \[앱러빈 전환 API 연동]>\[연동 설정]의 1단계인 \[연동 정보 등록]에서 Event Key를 등록합니다.

### 앱러빈 이벤트와 매핑하기

> [!NOTE]
>
> **알립니다**
>
> 이벤트 매핑이 없으면 연동을 활성화해도 앱러빈으로 어떤 이벤트도 자동 전송되지 않습니다. 앱러빈으로 전송하려는 에어브릿지 이벤트를 꼭 매핑하세요.

\[연동 설정]의 2단계인 \[앱러빈 이벤트 매핑]에서 전환 API 연동으로 전송된 에어브릿지 이벤트가 앱러빈에 표시될 이름을 매핑합니다. 웹 이벤트만 매핑할 수 있습니다. ‘추가’를 클릭해 이벤트 매핑을 추가하세요.

> [accordion] 직접 이벤트 매핑하기
>
> ‘직접 이벤트 매핑하기’를 클릭하면 먼저 에어브릿지 이벤트를 선택한 다음에 매핑할 앱러빈 이벤트를 선택할 수 있습니다.

> [accordion] 권장 이벤트 매핑하기
>
> ‘권장 이벤트 매핑하기’를 클릭하면 운영하는 캠페인의 권장 이벤트를 골라 매핑에 추가할 수 있습니다. \[ROAS 또는 CPP 캠페인] 또는 \[CPL 캠페인]에서 추가할 이벤트를 선택하고 ‘완료’를 클릭하세요. 추가한 이벤트 매핑은 나중에 수정할 수 있습니다.
>
> CPL 캠페인의 generate\_lead는 에어브릿지 이벤트가 미리 매핑돼 있지 않습니다. 직접 선택하세요.

운영하는 캠페인에 따라 미리 정해진 권장 이벤트를 활용할 수 있습니다.

> [accordion] 권장 이벤트 매핑 테이블) 에어브릿지 이벤트 - 앱러빈 이벤트
>
> | 에어브릿지 이벤트 | 앱러빈 이벤트 | 캠페인 |
> | - | - | - |
> | Open (Web) | page\_view | 모든 캠페인 |
> | Product View (Web) | view\_item | ROAS 또는 CPP 캠페인 |
> | Add To Cart (Web) | add\_to\_cart | ROAS 또는 CPP 캠페인 |
> | Initiate Checkout (Web) | begin\_checkout | ROAS 또는 CPP 캠페인 |
> | Order Complete (Web) | purchase | ROAS 또는 CPP 캠페인 |
> | 직접 선택한 이벤트 | generate\_lead | CPL 캠페인 |

매핑을 마쳤다면 ‘저장’을 클릭하세요. 저장해야 매핑한 이벤트가 전송 대상이 됩니다. 이벤트 매핑을 저장한 후에도 ‘수정’을 클릭하면 이벤트 매핑을 추가하거나 변경할 수 있습니다. 기존에 매핑된 에어브릿지 이벤트와 앱러빈 이벤트를 각각 클릭해서 다른 이벤트로 변경할 수 있습니다. 또한 빼기 버튼을 클릭해 이벤트 매핑을 삭제할 수 있습니다.

### 전환 API 연동 활성화하기

연동 설정을 완료했다면 \[연동 활성화] 토글을 활성화합니다. 전환 API 연동을 활성화하면 매핑된 모든 웹 이벤트를 앱러빈에 포스트백으로 전송하기 시작합니다. 전환 API 연동으로 전송하는 에어브릿지 이벤트를 앱러빈의 캠페인 최적화 등에 활용 중이라면, 연동을 중지하기 전에 캠페인에 영향을 끼칠 수 있는 부분을 반드시 확인하세요. 이 경우 연동을 중지하면 캠페인 성과에 직접적으로 영향을 줄 수 있습니다.

## 대행사 설정하기

대행사 사용자가 광고 채널과 연동하거나 광고 채널에서 발생한 성과와 비용을 확인하기 위해서는 오너 계정 또는 사내 마케터 계정이 \[대행사 설정] 탭에서 대행사 설정을 진행해야 합니다.

* [대행사 설정으로 접근 권한 관리하기](https://help.airbridge.io/ko/guides/agency-setting.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.