Reyun TrackingIO 통합 계획
이 문서에서는 AE 백엔드에서 Reyun TrackingIO 데이터를 연동하는 방법을 소개합니다. AE 백엔드는 Reyun TrackingIO 실시간 콜백 데이터의 연동을 지원합니다
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| 실시간 콜백 | 콜백 | 유저 수준 | ✅ |
Reyun TrackingIO 데이터 연동을 시작하기 전에 AE 시스템의 유저 식별 규칙을 읽고 AE가 #distinct_id와 #account_id로 유저를 식별하는 방식을 이해했는지 확인하십시오
현재 Reyun TrackingIO는 활성화, 가입, 로그인, 결제, 커스텀 이벤트의 콜백 기능을 제공합니다. 자세한 내용은 Reyun TrackingIO 콜백 링크 문서에서 확인할 수 있습니다.
고객의 어트리뷰션 정보를 얻으려면 활성화 또는 가입 콜백 데이터를 연동할 것을 권장합니다. 콜백 링크는 Reyun 기술 담당자가 설정해야 하므로, 이 절의 내용에 따라 필요한 정보를 모두 준비한 후 Reyun 기술 담당자에게 연락하여 콜백 설정을 요청하십시오.
통합 절차
- Reyun TrackingIO SDK와 AE SDK를 연동하고, Reyun SDK의 가입 메서드를 호출할 때 AE SDK의 게스트 ID를 전달합니다
- AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 Reyun TrackingIO 통합을 추가하고 관련 설정을 완료한 다음 콜백 주소를 복사합니다
- 앱의 APP_ID와 Secret, 콜백 주소, 콜백 데이터 타입을 Reyun 기술 담당자에게 제공하면 Reyun 기술 담당자가 데이터 콜백 설정을 지원합니다
- AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다
1. 클라이언트 SDK 설정
1.1 Reyun SDK 및 AE SDK 도입
먼저 앱에 Reyun TrackingIO SDK와 AE SDK를 도입하고 초기화 설정을 완료해야 합니다. Reyun TrackingIO SDK와 AE SDK의 연동 문서는 다음과 같습니다:
1.2 SDK 설정
SDK를 도입한 후에는 AE SDK의 게스트 ID와 계정 ID를 Reyun SDK에 설정해야 합니다. 콜백할 이벤트를 미리 정하고 이 장의 해당 부분에 따라 SDK 설정을 완료하십시오
1.2.1 활성화 이벤트
활성화 이벤트에서는 AE SDK의 게스트 ID를 커스텀 속성으로 설정할 수 있습니다. 다음은 Android용 코드 예시입니다:
// AE SDK 초기화 완료
//...
// Reyun 활성화 이벤트 전송
// 초기화 파라미터 객체 생성
InitParameters parameters = new InitParameters();
// 초기화 파라미터 appkey, 필수
parameters.appKey = "appkey";
// 초기화 파라미터 channelId, 필수
parameters.channelId = "320110";
// 초기화 파라미터 oaid. oaid를 전달하면 Reyun SDK는 더 이상 msa 관련 인터페이스를 호출해 oaid를 가져오지 않음
parameters.oaid = "hahahahahahaha";
// 초기화 파라미터 assetFileName. oaid 버전 1.0.26+ 이상을 사용할 때 필요
parameters.assetFileName = "com.reyun.chicken.cert.pem";
// 초기화 파라미터 oaidLibraryString. oaid 버전 1.0.26+ 이상을 사용할 때 필요
// msa 문서에 따르면 1.0.26의 값은 nllvm1623827671, 1.0.27의 값은 nllvm1630571663641560568, 1.0.30 이상의 값은 msaoaidsec
parameters.oaidLibraryString = "msaoaidsec";
// AE SDK의 게스트 ID 가져오기
String distinctId = TDAnalytics.getDistinctId();
// 커스텀 파라미터에 AE SDK의 게스트 ID 설정
HashMap<String, Object> params = new HashMap<>();
params.put("param6", distinctId);
parameters.installParams = params;
Tracking.initWithKeyAndChannelId(getApplication(), parameters);
1.2.2 가입 이벤트
마찬가지로 가입 이벤트를 전송할 때 커스텀 속성으로 AE SDK의 계정 ID와 게스트 ID를 전달할 수 있습니다:
// AE SDK와 Reyun SDK 초기화
// ...
// AE SDK의 계정 ID와 게스트 ID 가져오기
String teAccountId = "account_id";
String teDistinctId = TDAnalytics.getDistinctId();
// 가입 이벤트를 전송하면서 AE SDK의 계정 ID와 게스트 ID 전달
HashMap<String, Object> params = new HashMap<>();
params.put("param6", teDistinctId);
params.put("param7", teAccountId);
Tracking.setRegisterWithAccountID("account_id", params);
1.2.3 커스텀 이벤트
커스텀 이벤트 전송은 가입 이벤트와 비슷합니다. AE SDK의 계정 ID와 게스트 ID를 가져온 후 Reyun SDK의 커스텀 이벤트 전송 인터페이스에 전달하면 됩니다:
// AE SDK와 Reyun SDK 초기화
// ...
// AE SDK의 계정 ID와 게스트 ID 가져오기
String teAccountId = "account_id";
String teDistinctId = TDAnalytics.getDistinctId();
// 커스텀 이벤트를 전송하면서 AE SDK의 계정 ID와 게스트 ID 전달
HashMap<String, Object> params = new HashMap<>();
params.put("param6", teDistinctId);
params.put("param7", teAccountId);
Tracking.setEvent("event_1", params);
2. 계획 설정
SDK 설정을 완료한 후 AE 시스템 백엔드에 로그인하여 서드파티 통합 모듈에서 Reyun TrackingIO 설정을 완료해야 합니다. 아래 그림은 Reyun TrackingIO의 설정 화면입니다. 이 장의 내용에 따라 계획을 생성하십시오:
2.1 유저 식별 필드
Reyun이 콜백하는 데이터는 유저 수준 데이터이므로 유저 식별 규칙, 즉 콜백 데이터에서 #distinct_id와 #account_id에 대응하는 필드를 설정해야 합니다. AE 시스템은 이 설정에 따라 콜백 데이터를 변환할 때 해당 필드를 데이터의 유저 식별 필드로 설정합니다.
이 문서의 이전 단계에 따라 클라이언트 SDK를 설정했다면 기본값을 그대로 사용할 수 있습니다:
- 계정 ID 연관 필드: param7
- 게스트 ID 연관 필드: param6
2.2 이벤트 테이블 저장 설정
이벤트 테이블 저장 설정 스위치를 켜면 Reyun이 콜백하는 데이터가 모두 이벤트 테이블에 기록됩니다. 이벤트 데이터 저장을 활성화할 것을 권장합니다.
2.3 유저 속성 저장 규칙
기본적으로 AE 시스템은 Reyun 콜백 데이터의 어트리뷰션 필드를 표준화 처리된 유저 속성에 자동으로 기록합니다. 다음은 유저 속성에 기록되는 필드와 그 의미입니다:
| Reyun 필드 | AE 저장 후 유저 속성 이름 | 설명 |
|---|---|---|
| ry_adgroup_name | te_ads_object.ad_group_name | 텍스트 |
| channel | te_ads_object.media_source | 텍스트 |
| ry_adplan_name | te_ads_object.campaign_name | 텍스트 |
| ry_adcreative_name | te_ads_object.ad_name | 텍스트 |
이전 버전의 유저 속성 저장 기본 규칙은 현재와 다르므로 구분에 주의하십시오. 새 속성과 기존 속성을 병합해야 한다면 가상 속성 기능을 사용할 수 있습니다
수정이 필요하면 규칙 설정을 클릭하여 저장 규칙 설정 페이지로 이동합니다. 아래 그림과 같습니다
여기에서 유저 속성을 어떤 이벤트에서 가져올지와 저장 방식을 수정할 수 있습니다. 저장 방식의 기본값은 user_setOnce이며, 최초로 전송된 정보만 유지됩니다.
속성 매핑 버튼을 클릭하여 유저 속성에 기록할 필드를 추가할 수 있습니다. 또한 왼쪽의 규칙 버튼을 클릭하여 새 규칙 세트를 추가할 수도 있습니다.
유저 속성 저장을 끄려면 모든 규칙을 중지하면 됩니다:
2.4 엔드포인트 주소
시스템 및 프로젝트 수준의 데이터 수집 주소를 설정한 경우 다음과 같은 링크가 표시되며, 이 주소를 바로 복사할 수 있습니다:
여기에 주소가 표시되지 않으면 오른쪽 상단 메뉴의 프로젝트 관리 → 프로젝트 구성 → 연동 설정에서 공용 네트워크 주소를 설정하십시오. 이 주소는 AE SDK에 설정한 데이터 수집 주소입니다. 설정한 후 Reyun 설정 페이지의 엔드포인트 주소로 돌아와 엔드포인트 주소를 복사하십시오.
2.5 통합 설정
마지막으로 통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 예를 들어 저장 후 이벤트 이름 등을 설정할 수 있습니다.
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_mapping | 저장 후 이벤트 이름, 커스텀 가능. 지원하는 Key:
|
2.6 이벤트 저장 규칙
-
데이터의 activetime 필드를 이벤트의 #event_time으로 사용합니다
-
콜백 데이터의 기본 이벤트 이름은 다음과 같으며, sink_event.event_mapping을 수정하여 기본 이벤트 이름을 변경할 수 있습니다:
- 활성화 이벤트: reyun_init
- 가입 이벤트: reyun_sign_up
- 로그인 이벤트: reyun_login
- 결제 이벤트: reyun_payment
- 커스텀 이벤트: 이벤트 이름 앞에 reyun_ 접두사를 붙입니다(예: reyun_event_1)
-
그 밖의 필드는 모두 저장되며, Reyun 콜백 데이터에는 다음 필드가 포함됩니다:
| Reyun 콜백 필드 | 타입 | 설명 | 비고 |
|---|---|---|---|
| spreadurl | 텍스트 | 프로모션 캠페인 단축 링크 | 클릭 파라미터. ASA 어트리뷰션 또는 자연 유입 유저는 이 필드를 반환하지 않습니다 |
| spreadname | 텍스트 | 프로모션 캠페인 이름 | |
| channel | 텍스트 | 채널 이름 | |
| clicktime | 텍스트 | 클릭 수신 시간 | |
| uip | 텍스트 | 클릭 IP | |
| csite | 텍스트 | 광고 유닛 ID | |
| ry_adgroup_id | 텍스트 | 광고 그룹 ID | |
| ry_adgroup_name | 텍스트 | 광고 그룹 이름 | |
| ry_adplan_id | 텍스트 | 캠페인 ID | |
| ry_adplan_name | 텍스트 | 캠페인 이름 | |
| ry_adcreative_id | 텍스트 | 광고 소재 ID | |
| ry_adcreative_name | 텍스트 | 광고 크리에이티브 이름 | |
| advert_id | 텍스트 | 광고 ID | Ocean Engine 2.0 전용 파라미터 |
| advert_name | 텍스트 | 광고 이름 | Ocean Engine 2.0 전용 파라미터 |
| project_id | 텍스트 | 프로젝트 ID | Ocean Engine 2.0 전용 파라미터 |
| project_name | 텍스트 | 프로젝트 이름 | Ocean Engine 2.0 전용 파라미터 |
| mid1 | 텍스트 | 이미지 소재 ID | Ocean Engine 2.0 전용 파라미터 |
| mid2 | 텍스트 | 제목 소재 ID | Ocean Engine 2.0 전용 파라미터 |
| mid3 | 텍스트 | 동영상 소재 ID | Ocean Engine 2.0 전용 파라미터 |
| mid4 | 텍스트 | 연계 플레이어블 소재 ID | Ocean Engine 2.0 전용 파라미터 |
| mid5 | 텍스트 | 랜딩 페이지 소재 ID | Ocean Engine 2.0 전용 파라미터 |
| mid6 | 텍스트 | Android 다운로드 상세 페이지 소재 ID | Ocean Engine 2.0 전용 파라미터 |
| accountid | 텍스트 | 광고 집행 계정 ID | 매체 측 광고 집행 계정 |
| requestid | 텍스트 | 요청 발급 ID | Ocean Engine 공통 파라미터 |
| convertid | 텍스트 | 전환 ID | Ocean Engine 공통 파라미터 |
| appkey | 텍스트 | Reyun 앱 고유 식별자 | |
| activetime | 텍스트 | 이벤트 수신 시간 | |
| what | 텍스트 | 이벤트 타입 | 활성화: install |
| osversion | 텍스트 | 시스템 버전 | |
| ryos | 텍스트 | 운영 체제 | |
| devicetype | 텍스트 | 디바이스 타입 | |
| deviceid | 텍스트 | 디바이스 ID | |
| Idfa | 텍스트 | iOS의 IDFA | |
| idfv | 텍스트 | iOS의 IDFV | |
| imei | 텍스트 | Android의 IMEI. Android 10 이상에서는 가져올 수 없음 | |
| oaid | 텍스트 | OAID | |
| androidid | 텍스트 | Android ID | |
| aip | 텍스트 | 전환 이벤트 IP | |
| skey | 텍스트 | 요청 파라미터 securitykey이며 의미 없음 | |
| attribution | 텍스트 | ASA 어트리뷰션 | ASA 파라미터. ASA 광고 어트리뷰션인 경우에만 반환됩니다 |
| orgid | 텍스트 | 캠페인 그룹 ID | |
| campaignid | 텍스트 | 캠페인 ID | |
| clickdate | 텍스트 | ASA 광고 클릭 시간 | |
| adgroupid | 텍스트 | 광고 그룹 ID | |
| keywordid | 텍스트 | 키워드 ID | |
| creativesetid | 텍스트 | 소재 ID(크리에이티브 ID) | |
| conversiontype | 텍스트 | 전환 유형, 신규 또는 재설치 | |
| account | 텍스트 | 가입 시 설정한 계정 ID | 가입 이벤트에만 포함됨 |
| param1~param10 | 텍스트 | 커스텀 파라미터 | 기본적으로 param6은 AE SDK의 게스트 ID에, param7은 계정 ID에 대응시키는 것을 권장합니다 |
2.7 표준화 필드
다음은 Reyun 콜백 데이터에서 표준화되는 필드입니다:
| 콜백 필드 | 표준화 필드 | 설명 |
|---|---|---|
| channel | te_ads_object.media_source | 채널 이름 |
| csite | te_ads_object.placement | 광고 유닛 ID |
| ry_adgroup_id | te_ads_object.ad_group_id | 광고 그룹 ID |
| ry_adgroup_name | te_ads_object.ad_group_name | 광고 그룹 이름 |
| ry_adplan_id | te_ads_object.campaign_id | 캠페인 ID |
| ry_adplan_name | te_ads_object.campaign_name | 캠페인 이름 |
| ry_adcreative_id | te_ads_object.ad_id | 광고 소재 ID |
| ry_adcreative_name | te_ads_object.ad_name | 광고 크리에이티브 이름 |
| advert_id | te_ads_object.ad_id | 광고 ID |
| advert_name | te_ads_object.ad_name | 광고 이름 |
3. Reyun 기술 담당자에게 콜백 설정 요청
다음으로 Reyun 담당자에게 연락하여 콜백을 활성화해야 합니다. 일반적으로 Reyun에 다음 네 가지 정보를 제공해야 합니다:
| 메시지 | 설명 | 예시 |
|---|---|---|
| 콜백 데이터 타입 | 연동할 콜백 데이터 | |
| 콜백 링크 | AE 시스템이 콜백 데이터를 수신하는 주소. 통합 설정 페이지에서 가져옴 | https://{receiver-host}/attribution/callback/reyun/{app-id} |
| appkey | Reyun 백엔드에서 광고주 제품의 고유 식별자. Reyun 백엔드에서 가져옴 | f819f9cac******812b2067d0cf8 |
| securitykey | 보안 검증 필드. 현재 AE는 지원하지 않으며 광고주가 자유롭게 지정할 수 있음 | abc123 |
4. 후속 사용
4.1 데이터 저장 확인
마지막으로 AE 시스템이 Reyun의 콜백 데이터를 수신했는지 확인하십시오. 다음 방법으로 확인할 수 있습니다:
- 상세 데이터에서 확인
플랫폼 연동 상태가 연동됨이면 해당 플랫폼에서 데이터를 수신했고 데이터가 이미 저장되었음을 의미합니다. 이때 서드파티 통합 목록에서 해당 계획의 카드에 마우스를 올리고 상세 아이콘을 클릭하여 계획 상세 페이지로 이동하면 최근 수신한 1000건의 데이터를 확인할 수 있습니다. 특정 행을 클릭하면 변환 전후의 데이터를 포함한 해당 데이터의 상세 정보를 확인할 수 있으며, 해당 데이터를 복사하거나 내보낼 수 있습니다. 또는 상세 페이지 오른쪽 상단의 전체 데이터 다운로드를 클릭하여 전체 데이터를 다운로드할 수 있습니다:
- 다른 제품 모듈에서 확인
통합 페이지 외에 데이터 관리 페이지에서도 콜백 이벤트와 유저 속성이 생성되었는지 확인할 수 있습니다.
이벤트 분석 모델, 유저 속성 분석 모델 등의 분석 모델에서 분석을 통해 데이터가 저장되었는지 확인할 수도 있습니다.
4.2 리포트 권장사항
리포트 구축에 대한 몇 가지 권장사항은 다음과 같습니다:
- 각 모델에서 Reyun이 콜백한 유저 어트리뷰션 필드로 유저 그룹을 비교하여 유입 경로별 유저의 게임 내 행동 차이를 분석합니다
- 리텐션 분석 모델에서 Reyun이 콜백한 어트리뷰션 정보를 사용하여 유입 경로별 유저의 LTV를 비교 분석합니다