알립니다
이 기능은 베타 서비스입니다. 개선 의견과 문의사항은 에어브릿지 CSM을 통해 전달해 주세요. 담당 CSM이 없는 경우 문의하기를 통해 전달해 주세요. 정식 서비스에서 발전한 기능으로 보답하겠습니다.
에어브릿지와 유니티 레벨플레이(아이언소스)를 연동해 광고로 발생한 수익을 에어브릿지 대시보드에서 확인할 수 있습니다. 에어브릿지는 유니티 레벨플레이와의 서버 투 서버(S2S) 연동과 SDK 연동을 지원합니다.
연동하기 전에 연동 방식에 따른 특징을 먼저 확인해 주세요. 1가지 연동만 하거나 2가지 연동 모두 할 수 있습니다.
연동 방식 | 실시간 이벤트 수집 | 데이터 정합성 | 활용 범위 |
---|---|---|---|
서버 투 서버 (S2S) | 불가능 | 비교적 높음 | - 캠페인 결과 분석과 같이 높은 데이터 정합성이 요구되는 데이터 - 데이터 스토리지에 업로드되는 데이터 - SKAN 전환값 활용 불가능 |
SDK | 가능 | 비교적 낮음 | - 에어브릿지 대시보드에서 액츄얼스 리포트, 리얼 타임 로그 등에 사용되는 실시간 데이터 - 채널로 전송되는 포스트백 데이터 - 데이터 스토리지에 업로드되는 데이터 - Ad Impression에 한해서 SKAN 전환값 활용 가능 |
권장하는 연동 방식
더 정확한 광고 성과 측정과 활용을 위해 서버 투 서버 연동과 SDK 연동을 모두 설정하는 것을 권장합니다.
에어브릿지는 SDK 연동으로 실시간으로 받은 데이터를 서버 투 서버 연동으로 받은 보정된 데이터로 자동 업데이트합니다. 또한 SDK 연동으로 받은 데이터는 SKAdNetwork(SKAN)에 활용할 수 있습니다.
에어브릿지 SDK가 아래 버전 이상인지 확인해 주세요. 확인 시점에 에어브릿지 SDK가 아래 버전 미만이라면 서버 투 서버 연동 또는 SDK 연동 중에 1가지만 진행하는 것을 권장합니다.
주의하세요
서버 투 서버 연동과 SDK 연동을 모두 진행한다면 에어브릿지 SDK가 아래 버전 이상인지 반드시 확인해 주세요.
충분히 많은 유저가 아래 버전 이상의 SDK가 설치된 앱으로 업데이트한 후에 모든 연동을 진행하는 것을 권장합니다. 아래 버전 미만의 에어브릿지 SDK가 설치된 앱을 사용하는 유저가 대부분일 때 서버 투 서버 연동과 SDK 연동을 모두 진행하면 유저 수가 정확히 집계되지 않습니다.
Android SDK 2.25.0
React Native SDK 2.8.6
Flutter SDK 3.5.6
Cordova SDK 2.6.6
Expo SDK 2.6.6
Unity SDK 1.14.5
Unreal SDK 1.3.5
주의하세요
서버 투 서버 연동은 포스트백을 전송하지 않습니다.
유니티 레벨플레이(아이언소스)의 서버 투 서버(S2S) 연동에 유니티 레벨플레이의 Secret Key와 Refresh Token이 필요합니다. 유니티 레벨플레이에서 확인한 Secret Key와 Refresh Token을 에어브릿지에 입력합니다.
에어브릿지와 유니티 레벨플레이를 연동하기 위해 에어브릿지 대시보드에 입력하는 연동 정보를 유니티 레벨플레이 대시보드에서 확인해야 합니다. 확인해야 하는 연동 정보는 총 2가지입니다.
Secret Key
Refresh Token
아래 순서에 따라 유니티 레벨플레이에서 연동 정보를 확인할 수 있습니다.
1. 에어브릿지와 연동하는 유니티 레벨플레이(아이언소스) 계정에 로그인합니다.
2. 유니티 레벨플레이 대시보드 왼쪽 아래의 계정 아이콘을 클릭합니다. ‘Account’를 클릭합니다.
3. [API]에서 Secret Key와 Refresh Token을 확인할 수 있습니다.
아래 과정을 통해 에어브릿지에서 유니티 레벨플레이의 연동 정보를 입력할 수 있습니다.
1. 에어브릿지 대시보드 [연동]>[서드파티 연동]에서 ‘Unity LevelPlay (ironSource)’를 클릭합니다.
2. 유니티 레벨플레이 대시보드에서 확인한 Secret Key와 Refresh Token을 에어브릿지 대시보드에 입력하고 ‘등록’을 클릭합니다.
3. 연동 정보가 정상적으로 등록되면 에어브릿지와 연동할 수 있는 앱을 확인할 수 있습니다. 에어브릿지가 앱을 확인하는 과정에서 에어브릿지 대시보드를 이탈하면 연동 정보를 처음부터 다시 입력해야 합니다. 잠시만 기다려 주세요.
4. 에어브릿지에서 정상적으로 연동할 수 있는 앱을 확인하면 데이터 수신 설정이 활성화됩니다. 데이터 수신 설정은 안드로이드 또는 iOS 중에 연동할 수 있는 앱이 1가지 이상 확인되면 활성화됩니다.
계속해서 연동할 수 있는 앱이 확인되지 않으면 아래를 참고해 주세요.
에어브릿지 대시보드에서 연동하는 앱이 확인되지 않는 원인과 해결 방법은 아래를 참고해 주세요.
원인 | 해결 방법 |
---|---|
에어브릿지에 등록된 에어브릿지 앱이 없습니다. | 서드파티 플랫폼과 연동하는 에어브릿지 앱이 에어브릿지 대시보드 [에어브릿지 앱 설정]의 서비스에 등록되어 있는지 확인해 주세요. |
서드파티 플랫폼에서 에어브릿지 앱과 일치하는 앱이 확인되지 않습니다. | 등록한 에어브릿지 앱과 동일한 앱이 서드파티 플랫폼에 등록되어 있는지 확인해 주세요. |
에어브릿지는 아래와 같은 기본적인 기능을 제공합니다.
서드파티의 연동 상태는 아래의 상태 메시지를 통해 확인할 수 있습니다. 연동 정보에는 인증 토큰, Report Key, 제공업체 ID 등이 포함됩니다.
상태 메시지 | 설명 |
---|---|
(메시지 없음) | 연동 정보가 등록되지 않았습니다. |
Configured | 연동 정보가 정상적으로 등록됐습니다. |
Error | 서드파티 서버, 연동 정보 관련 인증 문제가 발생해 데이터가 수집되고 있지 않습니다. |
상태 메시지는 에어브릿지 대시보드의 [연동]>[서드파티 연동]에서 서드파티의 표시 이름 아래에 나타납니다.
또한 서드파티 메뉴 오른쪽에서도 상태 메시지를 확인할 수 있습니다.
연동하는 서드파티의 연동 정보를 바꿔야 한다면 이미 등록한 연동 정보를 수정해야 합니다. 입력된 연동 정보 오른쪽의 연필 아이콘을 클릭해 변경할 값으로 연동 정보를 수정합니다. 수정이 끝나면 ‘수정 완료’를 클릭합니다.
‘등록 삭제’를 클릭하면 연동 정보를 삭제할 수 있습니다. 연동 정보를 삭제하면 에어브릿지와 서드파티의 연동이 중단됩니다. 연동 정보를 삭제하더라도 연동 정보를 삭제하기 전에 수집된 데이터는 서드파티 또는 에어브릿지에서 사라지지 않습니다. 삭제 이후에 다시 연동하고 싶다면 연동 정보를 다시 등록해 주세요.
안드로이드 또는 iOS 중에 1가지 서비스에만 앱을 연동한 상태에서 다른 플랫폼에 추가로 연동하고 싶다면 연동을 처음부터 진행해야 합니다. ‘등록 삭제’를 클릭하고 연동 정보를 처음부터 입력해 주세요.
알립니다
연동으로 업데이트되는 데이터가 많으면 집계하는 시간이 길어집니다. 이에 따라 에어브릿지 리포트에서 조회할 수 있는 시점이 지연될 수 있습니다.
에어브릿지는 매일 UTC(협정세계시간) 오전 11시에 유니티 레벨플레이에서 2일 전(D-2) 오전 12시(0시)부터 어제(D-1) 오전 12시(0시)전까지 수집한 데이터를 가져옵니다. 이에 따라 유니티 레벨플레이 데이터가 수집된 첫 날을 기준으로 최대 3일 후에 에어브릿지에서 유니티 레벨플레이 데이터를 확인할 수 있습니다.
예를 들어 유니티 레벨플레이가 UTC 1월 1일 오전 12시(0시)부터 1월 2일 오전 12시(0시)까지 수집한 데이터는 UTC 1월 3일 오전 11시에 에어브릿지에서 가져오기 시작합니다. 해당 유니티 레벨플레이 데이터는 에어브릿지 리포트에서 UTC 1월 3일 오후 9시 이후에 확인할 수 있습니다. 이는 KST(한국표준시간) 기준으로 1월 4일 오전 6시 이후입니다.
주의하세요
서드파티 플랫폼은 SDK 연동으로 제공한 데이터를 계속해서 업데이트합니다. 따라서 SDK 연동으로 받은 데이터는 서드파티 플랫폼 대시보드와 수치 차이가 발생할 수 있습니다.
에어브릿지와 유니티 레벨플레이(아이언소스)의 SDK 연동 방법은 에어브릿지 개발자 가이드에서 확인할 수 있습니다.
광고 성과 데이터와 함께 유니티 레벨플레이(아이언소스)가 제공하는 광고로 발생한 수익 데이터를 에어브릿지에서 조회할 수 있습니다. 에어브릿지에서 확인할 수 있는 유니티 레벨플레이 데이터는 아래와 같습니다.
유니티 레벨플레이 데이터 | 에어브릿지 데이터 | 설명 |
---|---|---|
Network | Channel | 광고가 노출된 채널 |
Country | Country | 광고가 노출된 국가의 2자리 영문 코드 |
Advertising ID | Airbridge Device ID Type | IDFA(iOS), GAID(Android) 등 기기 식별자 |
Revenue | Event Value | 광고 수익 |
아래 사항을 주의해 주세요.
서버 투 서버 연동과 SDK 연동을 모두 사용하면 에어브릿지 리포트 수치가 최대 3일 동안 변경될 수 있습니다.
에어브릿지는 SDK 연동으로 수집한 실시간 데이터를 서버 투 서버 연동으로 수집한 보정된 데이터로 업데이트합니다. 에어브릿지 리포트에서 보여주는 오늘 실시간으로 수집한 데이터는 보정된 데이터로 최대 3일 후에 업데이트됩니다.
예를 들어 에어브릿지 리포트에서 1월 1일에 실시간으로 확인한 유니티 레벨플레이의 광고 수익 수치는 1월 4일에 데이터가 업데이트되어 변경될 수 있습니다.
서버 투 서버 연동은 포스트백을 전송하지 않습니다. 포스트백 전송을 원한다면 SDK 연동을 진행해 주세요.
서드파티 플랫폼과 에어브릿지의 서버 투 서버 연동과 SDK 연동을 모두 진행하면 아래 상황에서 이벤트 중복 집계가 발생할 수 있습니다.
데이터 스토리지로 연동 데이터를 전송하면 중복된 이벤트가 데이터 스토리지에 저장될 수 있습니다.
에어브릿지 대시보드 [원본 데이터]>[원본 앱 데이터 추출]에서 원본 데이터를 여러 번 추출하면 요청 시간에 따라 이벤트가 중복될 수 있습니다.
서드파티 플랫폼의 타임존(시간대)은 항상 UTC(협정세계시간)입니다. 서드파티 플랫폼 타임존은 변경할 수 없습니다. 에어브릿지에 등록한 앱의 타임존이 UTC가 아니면 조회 시점에 따라 서드파티 플랫폼과 에어브릿지에서 수치 차이(Discrepancy)가 발생할 수 있습니다.
서드파티 플랫폼과 에어브릿지의 연동을 완료한 후에 서드파티 플랫폼 대시보드에서 연동 정보를 변경하면 연동이 해제됩니다.
서드파티 플랫폼에서 연동 정보를 변경하면 반드시 에어브릿지 대시보드에서 연동을 다시 진행해야 합니다.
도움이 되었나요?