Tenjin 실시간 콜백 인터페이스
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| 실시간 콜백 인터페이스 | 콜백 | 유저 수준 | ✅ | ✅ |
Tenjin은 실시간 콜백 링크를 설정하는 방법을 제공하며, 활성화 이벤트를 콜백하여 유저 단위의 어트리뷰션 데이터를 가져올 수 있습니다.
Tenjin 실시간 콜백 데이터 연동을 시작하기 전에 AE 시스템의 유저 식별 규칙을 읽고, AE가 #distinct_id와 #account_id로 유저를 식별하는 방식을 이해했는지 확인하십시오
통합 절차
- AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 Tenjin 실시간 콜백 인터페이스 계획을 추가하고 관련 설정을 완료합니다
- Tenjin 백엔드에서 Webhooks를 설정하고 AE의 콜백 링크를 입력합니다
- AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다
1. 통합 방안 설정
Tenjin 콜백 데이터 연동의 첫 단계로, AE 시스템 백엔드에 로그인하여 서드파티 통합 모듈에서 Tenjin 실시간 콜백 인터페이스 계획의 설정을 완료해야 합니다. 아래 그림은 Tenjin 실시간 콜백 인터페이스 계획의 설정 화면입니다:
1.1 이벤트 테이블 저장 설정
이벤트 테이블 저장 설정 스위치를 켜면 Tenjin이 콜백한 데이터가 모두 이벤트 테이블에 기록됩니다. 이벤트 데이터 저장을 활성화하는 것을 권장합니다.
1.2 유저 속성 저장 규칙
기본적으로 AE 시스템은 Tenjin 콜백 데이터를 유저 속성에 기록하지 않습니다. Tenjin에는 AE 시스템의 유저 식별 필드가 없어 콜백 데이터를 AE 유저와 연결할 수 없으므로 유저 속성 저장을 활성화하지 않는 것을 권장합니다
1.3 통합 설정
통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 예를 들어 저장 후 이벤트 이름 등이 있습니다
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_name | 저장 후의 이벤트 이름, 커스텀 가능 |
1.4 엔드포인트 주소
1.4.1 기본 설정
시스템 및 프로젝트 수준의 데이터 수집 주소를 설정한 경우 다음과 같은 링크가 표시되며, 이 주소를 그대로 복사할 수 있습니다:
여기에 주소가 표시되지 않으면 오른쪽 상단 메뉴의 프로젝트 관리 → 프로젝트 구성 → 연동 설정에서 공용 네트워크 주소를 설정하십시오. 이 주소는 AE SDK에 설정한 데이터 수집 주소입니다. 설정한 후 Tenjin 실시간 콜백 인터페이스 설정 페이지의 엔드포인트 주소로 돌아가 엔드포인트 주소를 복사합니다.
1.4.2 커스텀 매크로
Tenjin 실시간 콜백 인터페이스의 콜백 주소에는 매크로라는 구조가 포함되며, {{macro_name}} 형식으로 표기합니다. 매크로는 일종의 플레이스홀더로, Tenjin이 콜백할 데이터에 매크로에 대응하는 필드가 포함되어 있으면 해당 필드의 값을 매크로가 있는 위치에 채웁니다. {{campaign_name}}을 예로 들면, Tenjin은 데이터를 콜백할 때 Campaign의 값을 콜백 주소에서 매크로가 있는 위치에 채웁니다.
방금 가져온 엔드포인트 주소로 다음 주소의 앞부분을 교체한 후, 교체한 콜백 주소를 복사해 두십시오. 이후 Tenjin 백엔드에서 이 주소를 입력해야 합니다:
https://{엔드포인트 주소}?bundle_id={{bundle_id}}&platform={{platform}}&store_id={{store_id}}&time_in_ms={{time_in_ms}}&engaged_at_s={{engaged_at_s}}&acquired_at_ms={{acquired_at_ms}}&advertising_id={{advertising_id}}&developer_device_id={{developer_device_id}}&allow_ad_tracking={{allow_ad_tracking}}&ip_address={{ip_address}}&country={{country}}&campaign_name={{campaign_name}}&tenjin_campaign_id={{tenjin_campaign_id}}&click_id={{click_id}}&referrer={{referrer}}&site_id={{site_id}}&ad_network={{ad_network}}&device={{device}}&os_version={{os_version}}&app_version={{app_version}}&sdk_version={{sdk_version}}&language={{language}}&user_agent={{user_agent}}&creative_name={{creative_name}}&device_brand={{device_brand}}&device_model={{device_model}}&carrier={{carrier}}&locale={{locale}}&timezone={{timezone}}&tracking_status={{tracking_status}}
2. Tenjin 백엔드 설정
2.1 설정 방법
먼저 Tenjin 백엔드에 로그인하여 CONFIGURE - Apps에서 설정할 앱을 선택하고 + New Callback을 클릭하여 콜백을 추가합니다
오른쪽 상단의 Create Custom Callback을 클릭합니다
- 트리거 이벤트로 App Open 이벤트를 선택합니다
- 트리거 조건으로 Ping on Every Install을 선택할 수 있습니다
- 콜백 주소에는 1.4.2절에서 권장한 매크로를 입력할 수 있습니다
설정을 완료하면 아래 그림과 같은 설정 정보를 확인할 수 있습니다. Active가 true로 표시되면 콜백 설정이 완료된 것입니다
2.2 권장 매크로
콜백 링크 매크로는 콜백 링크에 설정하는 플레이스홀더 필드로, 데이터를 콜백할 때 Tenjin이 이 매크로를 필드 값으로 대체합니다. 따라서 매크로에 따라 콜백되는 필드가 결정됩니다.
아래 표는 권장 매크로로, 1.4.2절에서 제공한 매크로 포함 콜백 주소에서 사용하는 매크로이기도 합니다. Tenjin 공식 웹사이트에서 더 자세한 매크로 목록을 확인할 수 있으며, 설정할 매크로를 조정하려면 Tenjin 콜백의 Callback URL을 직접 수정하십시오.
| 매크로 | 설명 |
|---|---|
| {{bundle_id}} | Bundle ID (예: com.tenjin.wordfinder) |
| {{platform}} | 플랫폼 |
| {{store_id}} | App Store ID (숫자 부분) |
| {{time_in_ms}} | 요청 시간(밀리초 단위) |
| {{engaged_at_s}} | 클릭 또는 노출 타임스탬프(초 단위) |
| {{acquired_at_ms}} | 설치 타임스탬프(밀리초 단위) |
| {{advertising_id}} | 디바이스의 광고 식별자 ID |
| {{developer_device_id}} | IDFV 또는 개발자의 Device ID |
| {{allow_ad_tracking}} | 광고 추적 허용 여부 (true, false는 각각 허용과 허용하지 않음을 의미) |
| {{ip_address}} | IP 주소 |
| {{country}} | 유저 디바이스의 Country code |
| {{campaign_name}} | 어트리뷰션 Campaign 이름 |
| {{tenjin_campaign_id}} | 어트리뷰션 Campaign ID |
| {{click_id}} | Channel의 click ID |
| {{referrer}} | Android의 referrer |
| {{site_id}} | Channel의 site ID |
| {{ad_network}} | 유입 채널명 |
| {{device}} | 디바이스 모델 |
| {{os_version}} | 디바이스 시스템 버전 |
| {{app_version}} | App 버전 |
| {{sdk_version}} | Tenjin SDK 버전 |
| {{language}} | 디바이스 언어 |
| {{user_agent}} | 디바이스의 User Agent |
| {{creative_name}} | 크리에이티브 이름 |
| {{device_brand}} | 디바이스 브랜드 |
| {{device_model}} | 디바이스 모델 |
| {{carrier}} | 디바이스 통신사 |
| {{locale}} | 로캘 정보 |
| {{timezone}} | 디바이스 시간대 |
| {{tracking_status}} | iOS 디바이스의 ATT 권한 부여 상태.
|
3. 데이터 저장
3.1 저장 규칙
- Tenjin에는 AE 시스템의 유저 식별 필드가 없으므로 고정값을 유저 식별자로 사용합니다. 모든 데이터가 하나의 가상 유저에 연결된다고 보면 됩니다
- 데이터의 time_in_ms 필드를 이벤트의 #event_time으로 사용합니다
- 기본 이벤트 이름은 -- tenjin_callback입니다
- 콜백 링크에 설정한 기타 필드는 모두 저장됩니다
유저 단위 콜백 데이터를 AE 유저와 연결하려면 유저 속성에 GAID와 IDFA를 기록(하나의 유저 속성에 기록하는 것을 권장)한 후, 데이터 백필 방식으로 Tenjin 콜백 데이터를 AE 유저와 연결해야 합니다
3.2 표준화 필드
Tenjin 실시간 콜백 데이터의 일부 필드는 AE 시스템에서 표준화 처리됩니다
| 원본 필드 | 표준화 필드 | 의미 |
|---|---|---|
| campaign_name | te_ads_object.campaign_name | 캠페인 이름 |
| tenjin_campaign_id | te_ads_object.campaign_id | 캠페인 ID |
| creative_name | te_ads_object.ad_name | 광고 이름 |
| ad_network | te_ads_object.media_source | 미디어 채널 |
| bundle_id | te_ads_object.app_id | 앱 ID |
| platform | te_ads_object.platform | 플랫폼(Android, iOS 등) |
| country | te_ads_object.country | 국가/지역 코드 |