앱러빈 - Airbridge Help Center

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

앱러빈 웹 캠페인 연동하기

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

사전 준비사항(필수)

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

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

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

사전 준비사항(권장)

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

항목	설명	작업 위치	담당자	참고
앱러빈 픽셀 설치	앱러빈은 앱러빈 픽셀과 전환 API를 함께 사용하는 것을 권장합니다. 앱러빈 픽셀을 사용하는 경우 웹 이벤트에 커스텀 어트리뷰트를 추가해야 합니다.	웹사이트 에어브릿지 웹 SDK	개발자	· 앱러빈 헬프센터 가이드 · 웹 이벤트에 커스텀 어트리뷰트 추가하기

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

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

웹 이벤트 추가 설정하기

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

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

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

// 브라우저에서 _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 입력하기

앱러빈 대시보드에서 새 캠페인을 만드세요.
[Campaign URL]>[Destination URL]에 유저를 보낼 웹 URL을 입력하세요. 사전 준비사항 단계에서 웹 SDK를 설정한 웹 URL을 사용해야 합니다.
[Tracking parameters]에서 ‘Edit’을 클릭해 [UTM parameters]를 확인하고 그대로 사용하세요. 입력된 UTM 파라미터는 앱러빈에서 제공하는 항목입니다. [Measurement partner parameters]는 사용하지 않습니다.
[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
[Final URL]을 확인하고 ‘Confirm’을 클릭해 저장하세요.

Key	Value	에어브릿지로 전달되는 정보
channel	applovin	광고 채널
campaign_id	{CAMPAIGN_ID}	캠페인 ID
ad_group_id	{CREATIVE_SET_ID}	크리에이티브 세트 ID
click_id	{EVENT_ID}	클릭 ID

앱러빈 전환 API 연동하기

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

주의하세요앱러빈 픽셀로 이벤트를 별도 수집 중이면 이벤트가 중복 집계됩니다. 중복 집계를 막으려면 웹 이벤트에 커스텀 어트리뷰트 추가하기를 참고해 applovin_dedupe_id를 설정하세요.

연동 정보 등록하기

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

앱러빈에서 Event Key 확인하기

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

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

앱러빈 이벤트와 매핑하기

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

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

직접 이벤트 매핑하기

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

권장 이벤트 매핑하기

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

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

권장 이벤트 매핑 테이블) 에어브릿지 이벤트 - 앱러빈 이벤트

에어브릿지 이벤트	앱러빈 이벤트	캠페인
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 연동으로 전송하는 에어브릿지 이벤트를 앱러빈의 캠페인 최적화 등에 활용 중이라면, 연동을 중지하기 전에 캠페인에 영향을 끼칠 수 있는 부분을 반드시 확인하세요. 이 경우 연동을 중지하면 캠페인 성과에 직접적으로 영향을 줄 수 있습니다.

대행사 설정하기

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

대행사 설정으로 접근 권한 관리하기

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

​사전 준비사항(필수)

​사전 준비사항(권장)

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

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

​앱러빈 전환 API 연동하기

​연동 정보 등록하기

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

​전환 API 연동 활성화하기

​대행사 설정하기

앱러빈 웹 캠페인 연동하기

사전 준비사항(필수)

사전 준비사항(권장)

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

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

앱러빈 전환 API 연동하기

연동 정보 등록하기

앱러빈 이벤트와 매핑하기

전환 API 연동 활성화하기

대행사 설정하기