Airbridge 실시간 콜백 통합 계획
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| Callbacks | 콜백 | 유저 수준 | ✅ | ✅ | ✅ |
Callbacks 인터페이스는 Airbridge의 유저 수준 데이터를 실시간으로 제공하며, 여기에는 광고 노출, 클릭, 전환 등의 데이터가 포함됩니다.
Airbridge 데이터 연동을 시작하기 전에 AE 시스템의 유저 식별 규칙을 읽고, AE가 #distinct_id와 #account_id로 유저를 식별하는 방식을 이해했는지 확인하십시오.
통합 절차
- Airbridge 클라이언트 SDK와 AE SDK를 연동하고, Airbridge SDK에 AE의 유저 식별 ID를 설정합니다
- AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 Airbridge 실시간 콜백 계획을 추가하고 관련 설정을 완료합니다
- Airbridge 백엔드에 로그인하여 콜백 설정을 완료합니다
- AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다
1. 클라이언트 SDK 설정
Airbridge 데이터 통합의 첫 단계는 클라이언트에서 AE SDK와 Airbridge SDK를 연결하여 Airbridge SDK에 AE 시스템의 유저 식별 ID를 설정하는 것입니다.
이 단계는 전체 연동 경로의 핵심으로, Airbridge가 수집하는 데이터에 AE의 게스트 ID 또는 계정 ID가 포함되도록 합니다.
- ID 가져오기: Airbridge SDK를 초기화하기 전이나 초기화 과정에서 ThinkingData SDK 인터페이스를 호출하여 현재 유저의 게스트 ID 또는 계정 ID를 가져옵니다.
- 속성 설정: 가져온 ID를 Airbridge의 User Alias 또는 Custom User Property로 설정합니다.
다음은 각 플랫폼 SDK의 코드 예시입니다:
- Android
//Android // Default Auto Start Tracking Enabled = true
val option = AirbridgeOptionBuilder("YOUR_APP_NAME", "YOUR_APP_SDK_TOKEN")
.setAutoStartTrackingEnabled(false)
.build()
Airbridge.initializeSDK(this, option)
Airbridge.setDeviceAlias("ADD_YOUR_KEY", "AND_YOUR_VALUE");
Airbridge.startTracking()
- iOS
let option = AirbridgeOptionBuilder(name: "YOUR_APP_NAME", token: "YOUR_APP_SDK_TOKEN")
.setAutoStartTrackingEnabled(true)
.build()
Airbridge.initializeSDK(option: option)
Airbridge.setDeviceAlias(key: "string", value: "string")
Airbridge.startTracking()
- Unity
Refer ：https://help.airbridge.io/en/developers/unity-sdk-v4
- Unreal
위와 같이 설정하면 콜백 데이터의 custom_data에 ta_distinct_id 필드가 포함됩니다.
2. 계획 설정
SDK 설정을 완료한 후에는 AE 시스템 백엔드에 로그인하여 서드파티 통합 모듈에서 Airbridge 설정을 완료해야 합니다. 다음은 Airbridge 설정 화면입니다:
2.1 유저 식별 필드
Airbridge가 콜백하는 데이터는 유저 수준 데이터이므로 유저 식별 규칙, 즉 Airbridge 콜백 데이터에서 #distinct_id 및 #account_id에 대응하는 필드를 설정해야 합니다. AE 시스템은 이 설정에 따라 콜백 데이터를 변환할 때 해당 필드를 데이터의 유저 식별 필드로 설정합니다.
이 문서의 이전 단계에 따라 클라이언트 SDK를 설정한 경우 다음 설정을 사용하십시오:
- 게스트 ID 연관 필드: custom_data.ta_distinct_id
2.2 이벤트 테이블 저장 설정
이벤트 테이블 저장 설정 스위치를 켜면 콜백 데이터(활성화 이벤트와 인앱 이벤트 포함)가 모두 이벤트 테이블에 기록됩니다
이벤트 데이터 저장을 활성화할 것을 권장합니다. 다만 기본적으로 Airbridge가 콜백하는 모든 데이터를 수신한다는 점에 유의하십시오. 콜백하는 이벤트 타입이 너무 많으면 AE 프로젝트의 이벤트량이 과도하게 늘어날 수 있습니다. 따라서 Airbridge 플랫폼에서 콜백을 설정할 때 필요한 이벤트만 선택하여 콜백하는 것을 권장합니다.
현재 지원되는 Airbridge 이벤트 목록은 다음과 같습니다:
| 이벤트 이름 event_name | 설명 |
|---|---|
| airbridge_user_signin | 유저 로그인 |
| airbridge_user_signout | 유저 로그아웃 |
| airbridge_user_signup | 유저 회원가입 |
| airbridge_adclick | 광고 클릭 |
| app_open | 앱 열기 |
| app_deeplink_open | 앱 링크 열기 |
| airbridge_adimpression | 광고 노출 |
| app_install | 앱 설치 |
2.3 표준화 유저 속성 저장 규칙
기본적으로 AE 시스템은 Airbridge 콜백 데이터의 어트리뷰션 필드를 표준화 처리된 유저 속성에 자동으로 기록합니다. 유저 속성에 기록되는 필드와 그 의미는 다음과 같습니다:
| 원본 필드 | 표준화 필드 | 의미 |
|---|---|---|
| attributedCampaign | te_ads_object.campaign_name | 캠페인 이름 |
| attributedCampaignId | te_ads_object.campaign_id | 캠페인 ID |
| attributedAdGroup | te_ads_object.ad_group_name | 광고 그룹 이름 |
| attributedAdGroupId | te_ads_object.ad_group_id | 광고 그룹 ID |
| attributedChannel | te_ads_object.media_source | 미디어 채널 또는 수익화 채널 |
| originalCurrency | te_ads_object.currency | 비용 또는 수익의 통화 |
수정이 필요하면 규칙 설정을 클릭하여 저장 규칙 설정 페이지로 이동합니다. 아래 그림과 같습니다
여기에서 유저 속성을 어떤 이벤트에서 가져올지 수정할 수 있습니다. 유저 속성이 빈번하게 기록되지 않도록 하려면 모든 이벤트 포함을 끄고 소스 이벤트명을 install로 수정하십시오. 이렇게 설정하면 AE 시스템은 Airbridge가 콜백한 install 이벤트에서만 유저 속성에 기록할 필드를 추출하여 기록합니다. 저장 방식의 기본값은 user_setOnce이며, 최초로 전송된 정보만 유지됩니다.
유저 속성 저장을 끄려면 모든 규칙을 중지하면 됩니다:
2.4 엔드포인트 주소
엔드포인트 주소에는 AE 시스템이 Airbridge 콜백 데이터를 수신하는 주소가 표시됩니다. 이 주소를 그대로 복사하여 이후 Airbridge 콜백을 설정할 때 입력하십시오:
여기에 주소가 표시되지 않으면 오른쪽 상단 메뉴의 프로젝트 관리 → 프로젝트 구성 → 연동 설정에서 공용 네트워크 주소를 설정하십시오. 이 주소는 AE SDK에 설정한 데이터 수집 주소입니다. 설정한 후 Airbridge 설정 페이지의 엔드포인트 주소로 돌아와 엔드포인트 주소를 복사하십시오.
2.5 이벤트 저장 규칙
- 데이터의 event_time_selected_timezone 필드에서 시간과 시간대 정보를 가져와 시간은 #event_time으로, 시간대는 #zone_offset으로 기록합니다. event_time_selected_timezone이 비어 있으면 event_time을 #event_time으로 사용하며, 시간대 #zone_offset은 0으로 설정됩니다
- 데이터의 이벤트 이름은 해당 이벤트의 Airbridge 내 이벤트 이름입니다
- 나머지 필드는 모두 저장됩니다
3. Airbridge Push API 설정
AE 백엔드 설정을 완료한 후 관리자 계정으로 Airbridge 백엔드에 로그인하고, Integration - Advertiser Postback에서 그림과 같은 부분을 찾아 다음 방법으로 콜백 주소를 설정하십시오:
https://help.airbridge.io/en/guides/airbridge-event-types#list-of-standard-events
4. 후속 사용
4.1 데이터 저장 확인
데이터 관리 페이지에서 콜백 이벤트와 유저 속성이 생성되었는지 확인할 수 있습니다.
이벤트 분석 모델, 유저 속성 분석 모델 등의 분석 모델에서 분석을 통해 데이터가 저장되었는지 확인할 수도 있습니다.
4.2 리포트 권장사항
리포트 구축에 대한 몇 가지 권장사항은 다음과 같습니다:
- 이벤트 분석 모델에서 Airbridge 콜백 데이터로 광고 집행 및 광고 수익화 핵심 지표를 구성하고 광고 분석 리포트를 생성합니다
- 퍼널 분석 모델에서 설치 이벤트를 신규 유저 전환 퍼널에 추가하고, 미디어 채널, 캠페인 등의 세분화 수준으로 소스별 유저의 전환 현황을 분석합니다