에어브릿지와 메타 애즈의 전환 API 연동을 통해 에어브릿지에서 수집한 이벤트를 메타 애즈에 포스트백으로 전송합니다. 전송받은 이벤트로 메타 애즈 캠페인을 최적화할 수 있습니다.
전환 API를 연동하기 위해 먼저 에어브릿지 대시보드 [연동]>[광고 채널 연동]에서 ‘메타 애즈’를 선택합니다.
주의하세요
메타 애즈에서 제공하는 SDK 또는 픽셀(Pixel)로 이벤트를 별도 수집하고 있다면 이벤트가 중복 집계될 수 있습니다.
연동 정보를 등록하고 에어브릿지 이벤트와 메타 애즈 이벤트를 매핑합니다. 그리고 전환 API 연동을 활성화합니다.
메타 애즈 대시보드 [광고 관리자]에서 2가지 연동 정보를 확인해야 합니다. 각 연동 정보에 대한 자세한 내용은 메타 애즈 가이드를 참고해 주세요.
픽셀 ID
액세스 토큰
1. 메타 애즈 대시보드 [광고 관리자]>[이벤트 관리자]로 이동합니다.
2. [이벤트 관리자 개요]>[데이터 소스]로 이동합니다.
3. [데이터 소스]에서 전환 API 연동을 하려는 픽셀을 선택합니다. 그리고 [설정]을 선택합니다.
4. [설정]의 아래 위치에서 각 연동 정보를 확인합니다. 픽셀 ID는 [데이터 세트 ID]에서 확인합니다.
액세스 토큰은 [전환 API]>[직접 통합을 설정하세요]에서 확인합니다. 액세스 토큰이 아직 없다면 ‘액세스 토큰 만들기’를 클릭해 바로 만들 수 있습니다.
연동 정보를 확인한 후에 에어브릿지 대시보드에서 메타 애즈의 [전환 API 연동] 탭으로 이동합니다. [메타 애즈 전환 API 연동]>[연동 설정]의 1단계인 [연동 정보 등록]에서 픽셀 ID와 액세스 토큰을 등록합니다.
알립니다
이벤트 매핑이 없으면 연동을 활성화해도 메타 애즈로 어떤 이벤트도 자동 전송되지 않습니다. 메타 애즈로 전송하려는 에어브릿지 이벤트를 반드시 매핑하세요.
이때 Deeplink Open (App), Deeplink Pageview (App), Uninstall (App), Ad Impression (App), Order Canceled (App) 이벤트는 메타 애즈에 전환 API 연동으로 전송할 수 없습니다.
[연동 설정]의 2단계인 [메타 애즈 이벤트 매핑]에서 전환 API 연동으로 전송된 에어브릿지 이벤트가 메타 애즈에 표시될 이름을 매핑합니다. 이벤트 매핑이 1개 이상 있어야 저장할 수 있으며 앱 이벤트와 웹 이벤트끼리도 매핑할 수 있습니다. ‘추가’를 클릭해 이벤트 매핑을 추가하세요.
’직접 이벤트 매핑하기’를 클릭하면 먼저 에어브릿지 이벤트를 선택한 다음에 매핑할 메타 애즈 이벤트를 선택할 수 있습니다. Preset 태그가 붙은 에어브릿지 이벤트를 선택하면 특정 메타 애즈 이벤트와 자동으로 매핑됩니다. Preset 태그가 붙어있더라도 이벤트 매핑은 변경할 수 있습니다. 이 경우 태그가 Preset Off로 표시되며 오른쪽 ‘프리셋’ 버튼을 클릭하면 다시 프리셋으로 돌아갑니다.
‘채널 연동 이벤트 매핑 가져오기’를 클릭하면 채널 연동의 [인앱 이벤트 포스트백]에 적용된 이벤트 매핑 그대로 전환 API 연동의 이벤트를 매핑할 수 있습니다.
일부 에어브릿지 이벤트와 메타 애즈 이벤트가 데이터 수집 목적에 따라 미리 매핑된 프리셋(Preset)을 활용할 수 있습니다.
앱 이벤트
에어브릿지 | 메타 애즈 |
---|---|
Ad Click | AdClick |
Add Payment Info | 결제 정보 추가 |
Add To Cart | 장바구니에 담기 |
Add To Wishlist | 위시리스트에 추가 |
Complete Tutorial | 튜토리얼 완료 |
Home Screen | abr_home_screen_APP |
Initiate Checkout | 결제 시작 |
Open | 앱 활성화 |
Order Cancel | abr_order_cancel_APP |
Order Complete | 구매 |
Product Catalog | abr_product_catalog_APP |
Share | abr_share_APP |
Product View | 콘텐츠 조회 |
Rate | 평가 |
Schedule | 예약 |
Search Results | 검색 |
Sign-in | abr_sign_in_APP |
Sign-out | abr_sign_out_APP |
Sign-up | 등록 완료 |
Spend Credits | 크레딧 사용 |
Start Trial | 체험판 시작 |
Achieve Level | 레벨 달성 |
Subscribe | 구독 |
Unlock Achievement | 신기록 달성 |
Unsubscribe | abr_subscribe_canceled_APP |
웹 이벤트
에어브릿지 | 메타 애즈 |
---|---|
Add Payment Info | 결제 정보 추가 (Web) |
Add To Cart | 장바구니에 담기 (Web) |
Add To Wishlist | 위시리스트에 추가 (Web) |
Sign-up | 등록 완료 (Web) |
Initiate Checkout | 결제 시작 (Web) |
Order Complete | 구매 (Web) |
Schedule | 예약 (Web) |
Search Results | 검색 (Web) |
Spend Credits | 크레딧 사용 (Web) |
Start Trial | 체험판 시작 (Web) |
Product View | 콘텐츠 조회 (Web) |
주로 프리셋이 아닌 에어브릿지 이벤트를 메타 애즈로 전송할 때 메타 애즈 커스텀 이벤트를 활용할 수 있습니다. 프리셋 여부와 상관 없이 모든 에어브릿지 이벤트는 매핑할 수 있는 메타 애즈 커스텀 이벤트가 있습니다. 메타 애즈 커스텀 이벤트는 앱 이벤트와 웹 이벤트 모두 제공하며 이벤트 목록 가장 아래에서 확인할 수 있습니다.
메타 애즈 커스텀 이벤트의 이름은 해당하는 에어브릿지 이벤트 이름 앞에 abr_
이 붙어 구성됩니다. 또한 에어브릿지 이벤트 이름에 .
이 사용됐다면 _
로 자동 변경됩니다.
예시1) 에어브릿지 스탠다드 이벤트와 매핑 가능한 메타 애즈 커스텀 이벤트
에어브릿지의 스탠다드 이벤트: complete_tutorial
매핑 가능한 메타 애즈의 커스텀 이벤트: abr_complete_tutorial_APP 또는 abr_complete_tutorial_WEB
예시2) 에어브릿지 커스텀 이벤트와 매핑 가능한 메타 애즈 커스텀 이벤트
에어브릿지의 커스텀 이벤트: hello.Airbridge
매핑 가능한 메타 애즈의 커스텀 이벤트: abr_hello_Airbridge_APP 또는 abr_hello_Airbridge_WEB
알립니다
어떤 에어브릿지 커스텀 이벤트의 이름이 40자를 넘거나 특수기호를 포함하면 이 이벤트는 메타 애즈 커스텀 이벤트로 전송됐을 때 정상 처리되지 않습니다. 예를 들어 ‘Hello?’라는 에어브릿지 커스텀 이벤트를 메타 애즈 커스텀 이벤트로 전송하면 ‘abr_Hello?’로 전송됩니다.
이때 이름에 ?가 포함됐기 때문에 메타 애즈에서 이 이벤트는 확인할 수 없습니다. 이러한 이름을 가진 에어브릿지 커스텀 이벤트를 메타 애즈에서 확인하려면 메타 애즈 커스텀 이벤트가 아닌 메타 애즈 스탠다드 이벤트와 매핑하세요.
이벤트 매핑을 저장한 후에도 ’수정’을 클릭하면 이벤트 매핑을 추가하거나 변경할 수 있습니다. 기존에 매핑된 에어브릿지 이벤트와 메타 애즈 이벤트를 각각 클릭해서 다른 이벤트로 변경할 수 있습니다. 또한 빼기 버튼을 클릭해 이벤트 매핑을 삭제할 수 있습니다.
이때 채널 연동에서 이벤트 매핑을 가져오는 경우 전환 API 연동에 이미 매핑된 이벤트를 가져오면 채널 연동의 이벤트 매핑으로 변경됩니다. 예를 들어 에어브릿지의 Order Complete (App) 이벤트가 전환 API 연동과 채널 연동에서 각각 아래처럼 매핑된 상태라면 전환 API 연동에서 매핑된 메타 애즈 이벤트가 ‘결제 정보 추가’에서 ‘결제 시작’으로 변경됩니다.
전환 API 연동: Order Complete (App) - 결제 정보 추가
채널 연동: Order Complete (App) - 결제 시작
연동 설정을 완료했다면 [연동 활성화] 토글을 활성화합니다. 전환 API 연동을 활성화하면 매핑된 모든 이벤트를 메타 애즈에 포스트백으로 전송하기 시작합니다. 전환 API 연동으로 전송하는 에어브릿지 이벤트를 메타 애즈의 캠페인 최적화 등에 활용 중이라면, 연동을 중지하기 전에 캠페인에 영향을 끼칠 수 있는 부분을 반드시 확인하세요. 이 경우 연동을 중지하면 캠페인 성과에 직접적으로 영향을 줄 수 있습니다. 전송된 이벤트가 메타 애즈 대시보드에 반영되기까지 최대 24시간 소요될 수 있습니다.
[연동 활성화] 토글을 활성화하면 [확장된 프라이버시 제어] 토글이 나타납니다. 아래 에어브릿지 가이드를 참고해 확장된 프라이버시 제어의 활성화 여부를 결정해 주세요.
도움이 되었나요?