Skip to main content
에어브릿지와 메타 애즈의 전환 API 연동을 통해 에어브릿지에서 수집한 이벤트를 메타 애즈에 포스트백으로 전송합니다. 전송받은 이벤트로 메타 애즈 캠페인을 최적화할 수 있습니다. 전환 API를 연동하기 위해 먼저 에어브릿지 대시보드 [연동]>[광고 채널 연동]에서 ‘메타 애즈’를 선택합니다.
주의하세요
  • 메타 애즈 SDK 또는 픽셀(Pixel)로 이벤트를 별도 수집 중이면 이벤트가 중복 집계됩니다.
  • 제한된 에어브릿지 SDK(Restricted SDK)를 사용 중이면 메타 애즈에 포스트백으로 이벤트가 전송되지 않습니다.

​
연동 설정하기

연동 정보를 등록하고 에어브릿지 이벤트와 메타 애즈 이벤트를 매핑합니다. 그리고 전환 API 연동을 활성화합니다.

​
연동 정보 등록하기

메타 애즈 대시보드 [광고 관리자]에서 2가지 연동 정보를 확인해야 합니다. 각 연동 정보에 대한 자세한 내용은 메타 애즈 가이드를 참고해 주세요.
  • 픽셀 ID
  • 액세스 토큰
  1. 메타 애즈 대시보드 [광고 관리자]>[이벤트 관리자]로 이동합니다.
01-kr-1821-meta-capi-integration
  1. [이벤트 관리자 개요]>[데이터 소스]로 이동합니다.
02-kr-1821-meta-capi-integration
  1. [데이터 소스]에서 전환 API 연동을 하려는 픽셀을 선택합니다. 그리고 [설정]을 선택합니다.
03-kr-1821-meta-capi-integration
  1. [설정]의 아래 위치에서 각 연동 정보를 확인합니다. 픽셀 ID는 [데이터 세트 ID]에서 확인합니다.
04-kr-1821-meta-capi-integration
액세스 토큰은 [전환 API]>[직접 통합을 설정하세요]에서 확인합니다. 액세스 토큰이 아직 없다면 ‘액세스 토큰 만들기’를 클릭해 바로 만들 수 있습니다.
05-kr-1821-meta-capi-integration
연동 정보를 확인한 후에 에어브릿지 대시보드에서 메타 애즈의 [전환 API 연동] 탭으로 이동합니다. [메타 애즈 전환 API 연동]>[연동 설정]의 1단계인 [연동 정보 등록]에서 픽셀 ID와 액세스 토큰을 등록합니다.

​
메타 애즈 이벤트와 매핑하기

아래 유의사항을 먼저 확인하세요.
  • Deeplink Open (App), Deeplink Pageview (App), Uninstall (App), Ad Impression (App), Order Canceled (App) 이벤트는 메타 애즈에 전환 API 연동으로 전송할 수 없습니다.
  • fbclid가 데이터에 포함된 이벤트만 메타 애즈로 전송됩니다. 따라서 이전에 다른 서드파티를 이용 중이었다면 에어브릿지를 이용한 후에 이벤트 전송량이 줄 수 있으나 이는 정상 현상입니다. 전송 조건이 다르기 때문입니다.
  • 기여된 이벤트만 메타 애즈로 전송됩니다. 메타 애즈가 아닌 다른 광고 채널에 기여된 이벤트도 전송됩니다.
알립니다이벤트 매핑이 없으면 연동을 활성화해도 광고 채널로 어떤 이벤트도 자동 전송되지 않습니다. 채널로 전송하려는 에어브릿지 이벤트를 꼭 매핑하세요.
[연동 설정]의 2단계인 [메타 애즈 이벤트 매핑]에서 전환 API 연동으로 전송된 에어브릿지 이벤트가 메타 애즈에 표시될 이름을 매핑합니다. 이벤트 매핑이 1개 이상 있어야 저장할 수 있으며 앱 이벤트와 웹 이벤트끼리도 매핑할 수 있습니다. ‘추가’를 클릭해 이벤트 매핑을 추가하세요.
’직접 이벤트 매핑하기’를 클릭하면 먼저 에어브릿지 이벤트를 선택한 다음에 매핑할 메타 애즈 이벤트를 선택할 수 있습니다. Preset 태그가 붙은 에어브릿지 이벤트를 선택하면 특정 메타 애즈 이벤트와 자동으로 매핑됩니다. Preset 태그가 붙어있더라도 이벤트 매핑은 변경할 수 있습니다. 이 경우 태그가 Preset Off로 표시되며 오른쪽 ‘프리셋’ 버튼을 클릭하면 다시 프리셋으로 돌아갑니다.
‘채널 연동 이벤트 매핑 가져오기’를 클릭하면 채널 연동의 [인앱 이벤트 포스트백]에 적용된 이벤트 매핑 그대로 전환 API 연동의 이벤트를 매핑할 수 있습니다.
06-kr-1821-meta-capi-integration
일부 에어브릿지 이벤트와 메타 애즈 이벤트가 데이터 수집 목적에 따라 미리 매핑된 프리셋(Preset)을 활용할 수 있습니다.
앱 이벤트웹 이벤트
주로 프리셋이 아닌 에어브릿지 이벤트를 메타 애즈로 전송할 때 메타 애즈 커스텀 이벤트를 활용할 수 있습니다. 프리셋 여부와 상관 없이 모든 에어브릿지 이벤트는 매핑할 수 있는 메타 애즈 커스텀 이벤트가 있습니다. 메타 애즈 커스텀 이벤트는 앱 이벤트와 웹 이벤트 모두 제공하며 이벤트 목록 가장 아래에서 확인할 수 있습니다.
07-kr-1821-meta-capi-integration
메타 애즈 커스텀 이벤트의 이름은 해당하는 에어브릿지 이벤트 이름 앞에 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 연동 활성화하기

알립니다제한된 SDK(Restricted SDK) 사용, 서비스 중인 앱의 특성 등으로 확장된 프라이버시 제어(EPC)를 꼭 활성화하는 경우에는 전환 API 연동 사용에 제한이 있을 수 있습니다. 먼저 확인해 주세요.
연동 설정을 완료했다면 [연동 활성화] 토글을 활성화합니다. 전환 API 연동을 활성화하면 매핑된 모든 이벤트를 메타 애즈에 포스트백으로 전송하기 시작합니다. 전환 API 연동으로 전송하는 에어브릿지 이벤트를 메타 애즈의 캠페인 최적화 등에 활용 중이라면, 연동을 중지하기 전에 캠페인에 영향을 끼칠 수 있는 부분을 반드시 확인하세요. 이 경우 연동을 중지하면 캠페인 성과에 직접적으로 영향을 줄 수 있습니다. 전송된 이벤트가 메타 애즈 대시보드에 반영되기까지 최대 24시간 소요될 수 있습니다. [연동 활성화] 토글을 활성화하면 [확장된 프라이버시 제어] 토글이 나타납니다. 아래 에어브릿지 가이드를 참고해 확장된 프라이버시 제어의 활성화 여부를 결정해 주세요.