# 서드파티 통합

서드파티 통합에서는 광고 플랫폼의 통합 기능을 제공하며, 이러한 플랫폼의 광고 배포 및 광고 수익 데이터를 TE 시스템과 동기화할 수 있습니다. 본문에서는 서드파티 통합의 각 페이지의 주요 기능과 기본 개념에 중점을 두며, 각 플랫폼의 구체적인 연결 방법에 대해서는 이 페이지의 서브페이지를 참조하시기 바랍니다

# 서드파티 통합 페이지

서드파티 통합 페이지에는 현재 연결된 통합 플랫폼과 그 기본 정보가 표시됩니다. 이에는 통합 플랫폼의 이름, 통합 플랫폼과 인터페이스 정보, 현재 통합 상태, 플랫폼 생성자 및 마지막 변경 일시 등이 포함됩니다.

그러나, 새 버전에서는 서드파티의 통합 설정 상한수가 추가되었습니다. 클러스터별로 동시에 존재할 수 있는 서드파티의 통합 설정 수는 이 상한을 초과할 수 없습니다. 상한에 도달한 경우, 불필요한 구성을 삭제하여 설정 수를 해제할 수 있습니다.

::: 경고

통합 설정 수의 상한은 클러스터 계획에 따라 결정됩니다. 상한을 조정할 필요가 있는 경우는 TE 매니저에게 연락해주세요.

:::

오른쪽 상단의 '계획 생성'을 클릭하면, 계획 선택 페이지로 이동할 수 있습니다. 현재 지원되는 데이터 인터페이스에서 연결할 수 있습니다. 또한, 카드 내의 편집 버튼을 클릭하여, 통합 계획의 설정 편집 페이지로 이동할 수도 있습니다.

# 서트파티 플랫폼 선택

서트파티 플랫폼 선택 페이지에는 현재 지원되는 모든 통합 방법의 기본 정보가 표시됩니다. 필요한 서드파티를를 선택하고, 편집 페이지로 이동할 수 있습니다.

또한, 서트파티 플랫폼 선택 페이지에서는 검색 기능도 제공되며, 데이터 연결이 필요한 플랫폼을 이름으로 검색할 수 있습니다.

# 서트파티 통합 구성

서트파티 플랫폼 선택 페이지에서 편집 버튼을 클릭하거나, 선택 페이지에서 서트파티 플랫폼을 클릭하면, 서드파티 통합 구성 페이지로 이동합니다. 위 그림은 Adjust의 설정 페이지입니다. 각 플랫폼의 데이터 로직이 다르기 때문에, 각 플랫폼의 설정 페이지도 다릅니다.

구성 페이지에서는, 선택한 서트파티의 기본 정보가 표시됩니다. 이 페이지에서, 해당 서드파티가 지원하는 데이터 유형에 대해 확인할 수 있습니다. 또한, '통합 가이드' 링크를 클릭하여, 그 계획의 통합 플랫폼 문서에 접근할 수도 있습니다.

데이터 통합의 규칙을 설정 페이지에서 조정할 수도 있습니다. 위 그림에 표시된 것처럼, 서드파티 데이터가 저장될 때 선택된 유저 식별 필드, 이벤트의 저장 가능 여부, 및 유저 속성의 저장 가능 여부를 변경할 수 있습니다. 더 많은 커스터마이징을 원하는 경우, [통합 구성]란에서 JSON을 조정하여, 데이터 수집의 구체적인 설정을 제어할 수 있습니다. 각 플랫폼별 설정 방법에 대해서는 해당 플랫폼 인터페이스의 통합 가이드를 참조하시기 바랍니다.

# 데이터 처리 로직

TE 시스템은 약 40개의 서드파티 플랫폼의 데이터 통합을 지원하며, 이들 플랫폼이 제공하는 데이터 구조와 의미는 다릅니다. 이 장에서는, 서드파티 플랫폼의 데이터 인터페이스 분류, 데이터 유형, 및 TE 시스템이 어떤 표준화 서비스를 제공하는지에 대해 설명합니다. 이를 통해, 플랫폼 간의 차이를 해소할 수 있습니다.

# 4.1 인터페이스 분류

서드파티 플랫폼에서 제공되는 데이터의 기능은 데이터 인터페이스라고 하며, 데이터 세밀도와 통합 유형의 두 가지로 분류할 수 있습니다.

데이터 세밀도

유저 레벨: 각 데이터는 유저의 노출, 클릭 또는 설치 행동을 나타냅니다. TE 시스템은 이러한 데이터를 직접 TE 이벤트 또는 유저 데이터로 변환합니다.
집계 지표: 각 데이터에는 분석 차원과 각종 지표가 포함되어 있지만, 유저 정보는 포함되어 있지 않습니다. TE 시스템에서는 이러한 데이터를 이벤트 형식으로 가상 유저로서 기록합니다.

광고 노출을 통해 두 가지 데이터 입자의 차이를 이해할 수 있습니다.

유저 레벨의 광고 노출 데이터는 유저 정보와 광고 정보가 기록되어 있으며, 각 데이터는 1회의 노출을 나타냅니다. 노출 데이터의 총량(또는 이벤트 수)이 노출량입니다.
집계 지표에는 1개 레코드 또는 몇 개 레코드의 데이터밖에 없습니다. "광고 노출량"은 각 데이터의 하나의 지표 필드에 불과합니다. 그 데이터에는 "광고 클릭 수", "전환 수", "비용" 등의 다른 지표들이 포함되는 것이 일반적입니다. 또한, "광고 계획", "광고 그룹" 등의 광고 필드도 포함됩니다. 각 데이터는 가장 상세한 분석 대상을 나타내며, 예를 들어 어떤 광고 계획 내에서 특정 광고에 대한 클릭 수, 노출률, 총 비용 등을 보여줍니다.

일반적으로, 유저 레벨의 데이터는 다른 이벤트와 마찬가지로, 각 분석 모델에서 사용될 수 있습니다. 반면, 집계 지표 데이터는 실제 유저 행동이 아니기 때문에, 이벤트 분석 모델이나 잔존 분석 모델(주로 ROI를 계산하기 위해) 및 SQL IDE 에서만 사용될 수 있습니다.

통합 유형

콜백: 콜백은 서드파티 플랫폼이 원본 데이터를 실시간으로 TE시스템에 반환하고, 데이터가 지속적으로 업로드되는 것을 의미합니다. 현재 TE시스템에서 지원되는 모든 콜백 유형 통합은 유저 레벨의 데이터 세밀도입니다. 경우에 따라 Push API라고도 불립니다.
API: API는 서드파티 플랫폼이 제공하는 데이터 수집 인터페이스를 가르킵니다. TE시스템은 구성에 따라 서드파티 플랫폼에 데이터 수집 요청을 보내고, 요청이 승인된 후에만 데이터가 전달됩니다. 현재, TE시스템에서 지원되는 API 유형의 대부분은 집계 지표이며, 일부는 유저 레벨입니다. 경우에 따라서는 Pull API라고도 불립니다.

통합 유형은 데이터의 실시간성에 영향을 줍니다. 예를 들어, 콜백되는 데이터는 기본적으로 실시간이지만, API 데이터에는 어느 정도의 지연이 발생할 수 있습니다. 또한, 통합 유형의 설정 방법도 다릅니다. 콜백되는 데이터의 주요 설정은 서드 파티 플랫폼에서 이루어지며, TE 시스템 측에서는 콜백 대상의 주소를 복사하는 것만으로 완료됩니다. 반면 API 데이터의 경우, 토큰이나 시간 범위, 취득 빈도 및 지표·차원 정보 등을 TE 시스템에서 설정해야 합니다.

# 데이터 유형

다른 플랫폼의 데이터에는 차이가 있을 수 있지만, 광고 배포 및 수익화에 가장 중요한 데이터는 다음의 6가지 유형으로 분류할 수 있습니다. 서드파티 통합 페이지에서는 각 플랫폼이 지원하는 데이터 유형을 확인할 수 있습니다.

데이터 유형	의미
어트리뷰션	유저에게 귀속된 광고 소스 정보는 유저 레벨 뿐입니다. 설치 이벤트와 유저 속성으로 소스 상황을 확인할 수 있습니다.
비용	트래픽 구매에 드는 비용은, 집계 지표일 수도 있고, 각 유저의 유저 레벨 비용일 수도 있습니다.
수익	수익은 광고로 얻어지며, 집계 지표일 수도 있고, 각 실현 광고가 유저 레벨의 수익을 얻은 경우일 수도 있습니다.
노출	트래픽 획득 광고나 수익화 광고의 노출 상황은, 집계 지표일 가능성이 있지만, 각 광고의 노출 데이터일 수도 있습니다.
클릭	트래픽 획득 광고나 수익화 광고의 클릭 상황은, 집계 지표일 가능성이 있지만, 각 광고의 클릭 데이터일 수도 있습니다.
전환	자연 트래픽이 아닌 유저가 게임/앱 내에서 전환 행동을 하는 경우, 대부분의 플랫폼에서는, 전환 행동은 유저의 설치를 가리킵니다. 이는 집계 지표거나, 각 유저의 전환 행동 이벤트일 수도 있습니다.

# 4.3 표준화 필드

마케팅 담당자가 다른 플랫폼의 광고 데이터를 통합 분석하기 위해, TE 시스템은 필드 표준화 기능을 제공합니다. TE 시스템은, 사전에 설정된 로직에 따라, 수신된 데이터의 코어 필드를 te_ads_object 객체 필드에 기록하고, 크로스플랫폼에서 코어 필드를 통일하는 기능을 실현합니다. TE 시스템은 연결된 대부분의 플랫폼에서 자동으로 필드 표준화 능력을 제공할 수 있습니다.

표준화 필드	의미
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	비용
te_ads_object.revenue	수익