서드파티 통합
서드파티 통합 모듈은 여러 서드파티 광고 플랫폼과의 통합 기능을 제공하며, 이러한 플랫폼의 광고 집행 및 광고 수익화 데이터를 AE 시스템으로 동기화할 수 있습니다. 이 문서에서는 서드파티 통합 모듈의 각 페이지의 핵심 기능과 서드파티 통합 모듈의 기본 개념을 중점적으로 소개합니다. 각 플랫폼의 구체적인 연동 방법은 이 페이지의 하위 페이지를 참고하십시오.
1. 서드파티 통합 홈
서드파티 통합 홈에는 현재 연동된 통합 계획과 그 기본 정보가 표시됩니다. 통합 계획의 이름, 통합된 플랫폼과 인터페이스 정보, 현재 통합 상태, 계획 생성자, 마지막 수정 시간 등이 포함됩니다.
새 버전에서는 서드파티 통합 설정 수에 상한이 추가되었으며, 각 프로젝트에 동시에 존재할 수 있는 서드파티 통합 설정 수는 이 상한을 초과할 수 없습니다. 상한에 도달한 경우 필요 없는 계획을 삭제하여 설정 수를 확보할 수 있습니다.
오른쪽 상단의 통합 생성을 클릭하면 계획 선택 페이지로 이동하며, 현재 지원되는 데이터 인터페이스를 선택하여 연동할 수 있습니다. 또한 카드 안의 편집 버튼을 클릭하여 계획 편집 페이지로 이동한 후 통합 계획의 설정을 수정할 수도 있습니다:
2. 계획 선택 페이지
계획 선택 페이지에는 현재 지원되는 모든 통합 방식의 기본 정보가 표시됩니다. 필요한 연동 방식을 선택하고 카드를 클릭하면 해당 통합 방식의 편집 페이지로 이동합니다.
계획 선택 페이지에서는 검색 기능도 제공하므로, 플랫폼명으로 데이터를 연동할 플랫폼을 검색할 수 있습니다.
3. 설정 페이지
서드파티 통합 홈에서 편집 버튼을 클릭하거나 계획 선택 페이지에서 통합 방식 카드를 클릭하면 모두 서드파티 통합의 설정 페이지로 이동합니다. 위 그림은 Adjust 실시간 콜백 계획의 설정 페이지입니다. 플랫폼마다 데이터 로직이 다르기 때문에 플랫폼별 설정 페이지도 서로 다릅니다.
설정 페이지에는 선택한 계획의 기본 정보가 표시되며, 이를 통해 해당 계획이 지원하는 데이터 타입을 확인할 수 있습니다. 또한 연동 문서 링크를 클릭하여 해당 계획의 통합 계획 문서로 이동할 수도 있습니다.
그 밖에 설정 페이지에서 데이터 연동 규칙을 조정할 수 있습니다. 위 그림과 같이 서드파티 데이터를 저장할 때 사용할 유저 식별 필드, 이벤트 저장 여부, 유저 속성 저장 여부를 수정할 수 있습니다. 더 세부적으로 조정하려면 통합 설정 영역에서 JSON을 조정하여 데이터 수집의 구체적인 설정을 제어할 수 있습니다. 각 플랫폼의 구성 방식은 해당 플랫폼 인터페이스의 통합 계획 문서를 참고하십시오.
4. 데이터 처리 로직
AE 시스템은 현재 40종 이상의 서드파티 플랫폼 데이터 통합 계획을 지원하며, 계획마다 제공하는 데이터의 구조와 의미가 각각 다릅니다. 이 장에서는 서드파티 플랫폼의 데이터 인터페이스 분류와 데이터 타입, 그리고 플랫폼 간 차이를 해소하기 위해 AE 시스템이 제공하는 표준화 서비스를 중점적으로 소개합니다.
4.1 인터페이스 분류
서드파티 플랫폼에서 데이터를 제공하는 기능을 데이터 인터페이스라고 하며, 데이터 인터페이스는 데이터 세분화와 통합 타입이라는 두 가지 차원으로 분류할 수 있습니다.
데이터 세분화
- 유저 수준: 각 데이터는 한 유저의 1회 노출, 클릭 또는 설치 행동이며, AE 시스템은 이 데이터를 AE의 이벤트 또는 유저 데이터로 직접 변환합니다
- 집계 지표: 각 데이터에는 분석 차원과 각종 지표가 포함되며 유저 정보는 포함되지 않습니다. AE 시스템은 이 데이터를 하나의 가상 유저에 이벤트 형태로 기록합니다
광고 노출을 예로 두 가지 데이터 세분화의 차이를 살펴보면 다음과 같습니다:
- 유저 수준의 광고 노출 데이터에는 유저 정보와 광고 정보가 기록되며, 각 데이터는 1회 노출을 나타냅니다. 노출 데이터의 전체 데이터양(즉 이벤트 수)이 곧 노출 수입니다
- 집계 지표는 데이터가 한 건 또는 몇 건뿐이며, 광고 노출 수는 각 데이터의 지표 필드 중 하나일 뿐입니다. 해당 데이터에는 광고 노출 수 외에도 일반적으로 광고 클릭 수, 전환 수, 비용 등 다른 지표가 포함되고, 캠페인, 광고 그룹 등의 광고 차원 필드도 포함됩니다. 각 데이터는 가장 세분화된 분석 차원의 지표 현황을 나타내며, 예를 들어 특정 캠페인의 한 광고에 대한 클릭 수, 노출률, 총비용 등입니다
일반적으로 유저 수준 데이터는 다른 이벤트와 마찬가지로 각 분석 모델에서 사용할 수 있습니다. 반면 집계 지표 데이터는 실제 유저가 발생시킨 행동이 아니므로 이벤트 분석 모델, 리텐션 분석 모델(주로 ROI 계산에 사용) 및 SQL IDE에서만 사용할 수 있습니다.
통합 타입
- 콜백: 콜백은 서드파티 플랫폼이 자체 원본 데이터를 비교적 실시간으로 AE 시스템에 전달하는 방식으로, 데이터가 지속적으로 유입됩니다. 현재 AE 시스템이 지원하는 모든 콜백 타입 통합 계획의 데이터 세분화는 유저 수준입니다. 경우에 따라 Push API라고도 합니다
- API: API는 서드파티 플랫폼이 제공하는 데이터 수집 인터페이스로, AE 시스템이 설정에 따라 서드파티 플랫폼에 데이터 수집 요청을 보내며, 수집 요청이 승인된 후에만 데이터가 전송됩니다. 현재 AE 시스템이 지원하는 API 타입 통합 계획은 데이터 세분화가 대부분 집계 지표이며, 일부는 유저 수준입니다. 경우에 따라 Pull API라고도 합니다
통합 타입은 데이터의 실시간성에 영향을 줍니다. 예를 들어 콜백 데이터는 거의 실시간이지만 API 데이터에는 어느 정도 지연이 있습니다. 또한 통합 타입에 따라 구성 방식도 다릅니다. 콜백 데이터는 주요 설정을 서드파티 플랫폼에서 하며, AE 시스템에서는 콜백 주소만 복사하면 됩니다. API 데이터는 AE 시스템에서 수집용 Token, 기간, 수집 빈도, 지표, 차원 등의 정보를 설정해야 합니다.
4.2 데이터 타입
플랫폼마다 데이터에 차이가 있지만, 광고 집행과 수익화에서 가장 핵심이 되는 데이터는 다음 여섯 가지로 분류할 수 있습니다. 서드파티 통합 홈에서 각 플랫폼이 지원하는 데이터 타입을 확인할 수 있습니다:
| 데이터 타입 | 의미 |
|---|---|
| 어트리뷰션 | 어트리뷰션 후 유저의 광고 소스 정보. 어트리뷰션 데이터는 유저 수준만 가능하며, 유저의 설치 이벤트와 유저 속성에서 어트리뷰션 현황을 확인할 수 있음 |
| 비용 | 유저 획득(UA)에 든 비용. 집계 지표일 수도 있고, 유저별 유저 수준 비용일 수도 있음 |
| 수익 | 수익화 광고로 얻은 수익 현황. 집계 지표일 수도 있고, 수익화 광고별로 얻은 유저 수준 수익일 수도 있음 |
| 노출 | UA 광고 또는 수익화 광고의 노출 현황. 집계 지표일 수도 있고, 광고별 노출 데이터일 수도 있음 |
| 클릭 | UA 광고 또는 수익화 광고의 클릭 현황. 집계 지표일 수도 있고, 광고별 클릭 데이터일 수도 있음 |
| 전환 | 비오가닉 유저가 게임/앱 내에서 전환 행동을 한 현황. 대부분의 플랫폼에서 전환 행동은 유저 설치를 뜻하며, 집계 지표일 수도 있고 유저별 전환 행동 이벤트일 수도 있음 |
4.3 표준화 필드
마케팅 담당자가 여러 플랫폼의 광고 데이터를 통합 분석할 수 있도록 AE 시스템은 필드 표준화 기능을 제공합니다. AE 시스템은 사전 설정된 로직에 따라 수신한 데이터의 핵심 필드를 객체 필드 te_ads_object에 기록하여 플랫폼 간 핵심 필드를 통일합니다. AE 시스템이 연동을 지원하는 대부분의 플랫폼에서 필드 표준화 기능을 자동으로 제공합니다.
| 표준화 필드 | 의미 |
|---|---|
| te_ads_object.ad_account_id | 광고 계정 ID |
| te_ads_object.campaign_name | 캠페인 이름 |
| te_ads_object.campaign_id | 캠페인 ID |
| te_ads_object.ad_group_name | 광고 그룹 이름, 수익화 광고의 Unit 이름 |
| te_ads_object.ad_group_id | 광고 그룹 ID, 수익화 광고의 Unit ID |
| te_ads_object.ad_name | 광고 이름 |
| te_ads_object.ad_id | 광고 ID |
| te_ads_object.placement | 광고 위치 |
| te_ads_object.media_source | 미디어 채널 또는 수익화 채널 |
| te_ads_object.app_id | 앱 ID |
| te_ads_object.app_name | 앱 이름 |
| te_ads_object.platform | 플랫폼(Android, iOS 등) |
| te_ads_object.country | 국가/지역 코드 |
| te_ads_object.currency | 비용 또는 수익의 통화 |
| te_ads_object.impressions | 노출 수 |
| te_ads_object.clicks | 클릭 수 |
| te_ads_object.installs | 설치 수 |
| te_ads_object.cost | UA 비용 |
| te_ads_object.revenue | 수익화 수익 |
| te_ads_object.agency | 대행사/대행 채널 |
| te_ads_object.conversions | 전환 수 |
5. 기존 계획 마이그레이션 문제
4.2 버전 이전에는 AE 시스템이 지원하는 대부분의 서드파티 통합 계획을 ThinkingAI 담당자가 설정했으며, 이러한 설정을 기존 계획이라고 합니다. 4.2 버전 배포 후에는 기존 계획의 새 설정 사본이 자동으로 생성되며, 서드파티 통합 모듈에서 확인할 수 있습니다. 콜백 타입 계획은 모든 마이그레이션 작업을 바로 완료하지만, API 타입 계획은 일부 설정 파라미터만 마이그레이션하므로 해당 계획 자체는 여전히 사용할 수 없으며 상태가 정책 마이그레이션으로 표시됩니다.
데이터가 정상적으로 저장되도록 다음과 같이 처리합니다:
- 4.2로 업그레이드한 후 API 타입 계획은 계속 기존 계획으로 데이터를 수집하며, 서드파티 통합 모듈에서 정책 마이그레이션 상태인 계획은 실제로 실행되지 않습니다. 콜백 타입 계획은 서드파티 통합 모듈의 새 계획을 바로 사용하며, 상태가 연동됨, 즉 정상 연동 상태입니다
- 특별한 필요가 없다면 기존에 저장된 계획은 계속 기존 계획을 사용하는 것을 권장합니다
- 정책 마이그레이션 상태의 새 계획을 활성화하려면 ThinkingAI 담당자에게 문의하여 작업을 진행하십시오