TalkingData 통합 계획
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| 커스텀 데이터 콜백 | 콜백 | 유저 수준 | ✅ | ✅ |
TalkingData는 커스텀 데이터 콜백 기능을 제공하며, 이 기능을 통해 유저 수준의 활성화 또는 가입 데이터를 가져올 수 있습니다
TalkingData 모바일 광고 데이터 연동을 시작하기 전에 AE 시스템의 유저 식별 규칙을 읽고 AE가 #distinct_id와 #account_id로 유저를 식별하는 방식을 이해했는지 확인하십시오
통합 절차
- TalkingData 클라이언트 SDK와 AE 클라이언트 SDK를 연동하고, TalkingData SDK에 AE 유저 식별 ID를 설정합니다
- AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 TalkingData 통합 계획을 추가하고 관련 설정을 완료한 다음 콜백 주소를 복사합니다
- TalkingData 백엔드에 로그인하여 관리 센터 - 데이터 관리 페이지에서 데이터 콜백 추가를 클릭하고, 콜백 데이터의 프로젝트와 콜백 이벤트(가입 또는 활성화)를 선택합니다
- AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다
1. 클라이언트 SDK 전송
클라이언트 SDK로 데이터를 전송하는 경우 먼저 App에 TalkingData SDK와 AE SDK를 통합하십시오. TalkingData의 활성화 이벤트를 콜백하려면 TalkingData SDK를 초기화할 때 AE SDK의 게스트 ID를 커스텀 ID로 설정합니다:
// 먼저 AE SDK 초기화
TDAnalytics.init(this, APPID, SERVER_URL);
// AE의 게스트 ID 가져오기. AE의 #distinct_id에 대응
String distinctId = TDAnalytics.getDistinctId();
// TalkingData SDK 설정
JLibrary.InitEntry(this); //1.0.13 이동 보안 연합 통합 SDK 초기화
TalkingDataSDK.init(this, "귀하의 App ID", "채널 ID", distinctId);
가입 이벤트를 콜백하려면 AE SDK와 TalkingData SDK에 동일한 계정 ID를 설정하면 됩니다:
// 계정 ID 가져오기
String accountId = "Account ID";
// AE SDK 설정
TDAnalytics.login(accountId);
// TalkingData SDK 설정
TalkingDataSDK.onRegister(accountId);
2. 계획 설정
SDK 설정을 완료한 후 AE 시스템 백엔드에 로그인하여 서드파티 통합 모듈에서 TalkingData 계획 설정을 완료해야 합니다. 아래 그림은 TalkingData 커스텀 데이터 콜백 계획의 설정 화면입니다:
2.1 유저 식별 필드
TalkingData 커스텀 콜백 데이터는 유저 수준 데이터이므로 유저 식별 규칙, 즉 TalkingData SDK에 설정한 AE 시스템의 유저 식별 ID를 설정해야 합니다. AE 시스템은 이 설정에 따라 콜백 데이터를 변환할 때 해당 필드를 데이터의 유저 식별 필드로 설정합니다.
이 문서의 이전 단계에 따라 클라이언트 SDK를 설정한 경우 다음 설정을 사용하십시오:
- 계정 ID 연관 필드: ACCOUNTID
- 게스트 ID 연관 필드: CUSTOM
2.2 이벤트 테이블 저장 설정
이벤트 테이블 저장 설정 스위치를 켜면 TalkingData가 콜백하는 데이터가 모두 이벤트 테이블에 기록됩니다. 이벤트 데이터 저장을 활성화할 것을 권장합니다.
2.3 유저 속성 저장 규칙
기본적으로 AE 시스템은 TalkingData 콜백 데이터를 유저 속성에 기록하지 않습니다. 유저 어트리뷰션 정보 필드 등 일부 필드를 유저 테이블에 기록하려면 먼저 규칙을 켜서 실행되도록 한 다음, 속성 매핑 기능으로 유저 테이블에 기록할 필드를 추가하십시오. 소스 속성명에는 필드의 저장명을 입력해야 합니다:
다음과 같이 저장할 유저 속성을 추가할 것을 권장합니다:
| 소스 데이터명 | 대상 속성명 | 설명 |
|---|---|---|
| ADNETNAME | te_ads_object.media_source | 미디어 채널 |
| ADCAMPAIGN | te_ads_object.campaign_name | 캠페인 이름 |
| ADGROUP | te_ads_object.ad_group_name | 광고 그룹 이름 |
| ADCREATIVE | te_ads_object.ad_name | 광고 이름 |
2.4 통합 설정
통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 예를 들어 저장 후 이벤트 이름 등이 있습니다
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_mapping | 저장 후 이벤트 이름, 커스텀 가능. Key는 TalkingData의 콜백 데이터 타입이고, Value는 해당 이벤트의 저장 후 이벤트 이름입니다. 선택 가능한 Key:
|
2.5 엔드포인트 주소
시스템 및 프로젝트 수준의 데이터 수집 주소를 설정한 경우 다음과 같은 링크가 표시됩니다. 이 주소를 그대로 복사하여 TalkingData 백엔드의 실시간 콜백 설정에 붙여 넣으십시오:
여기에 주소가 표시되지 않으면 오른쪽 상단 메뉴의 프로젝트 관리 → 프로젝트 구성 → 연동 설정에서 공용 네트워크 주소를 설정하십시오. 이 주소는 AE SDK에 설정한 데이터 수집 주소입니다. 설정한 후 TalkingData 콜백 설정 페이지의 엔드포인트 주소로 돌아와 엔드포인트 주소를 복사하십시오.
3. 콜백 설정
3.1 데이터 콜백 추가
TalkingData 모바일 광고 데이터를 연동하려면 TalkingData 모바일 광고 모니터링 백엔드에 로그인해야 합니다. 관리 센터 - 데이터 관리 탭에서 모든 데이터 콜백을 확인하고 설정할 수 있습니다.
- 다음으로 데이터 콜백 추가를 클릭하면 새 데이터 콜백 페이지로 이동합니다
- 이어서 데이터 콜백의 이름을 지정하고 데이터를 콜백할 앱을 선택한 후, 콜백 이벤트에서 활성화/가입 이벤트 중 하나를 선택합니다. 그런 다음 AE 시스템의 TalkingData 계획에 있는 엔드포인트 주소를 데이터 수신 URL에 입력합니다
- 다음으로 이벤트 파라미터를 설정해야 합니다. 선택한 콜백 이벤트에 따라 3.2절의 내용을 참고하여 설정하십시오. 설정을 마친 후 저장을 클릭하면 콜백 설정이 완료됩니다.
3.2 콜백 파라미터 설정
3.2.1 활성화 이벤트
활성화 이벤트를 콜백하는 경우 아래 표의 파라미터 이름에 따라 각 매크로의 저장명을 설정할 것을 권장합니다:
| 파라미터 이름 | 매크로 | 지원 플랫폼 | 파라미터 설명 | 예시 |
|---|---|---|---|---|
| APPKEY | #APPKEY | 전체 플랫폼 | Ad Tracking 시스템에서 APP의 고유 식별자 | 10691808c7dc494eba8afd44cdef1df7 |
| EVENTTIME | #EVENTTIME | 전체 플랫폼 | 이벤트 발생 시간, 13자리 unix 타임스탬프 | 1451379329000 |
| OSVERSION | #OSVERSION | 전체 플랫폼 | 디바이스의 시스템 버전 | 9.2 |
| DEVICETYPE | #DEVICETYPE | 전체 플랫폼 | 디바이스 유형 | iPad4,4 |
| OAID | #OAID | Android | Android 디바이스 ID | |
| OAID_MD5 | #OAID_MD5 | Android | Android 디바이스 암호화 ID | |
| OAID_MD5_1 | #OAID_MD5_1 | Android | Android 디바이스 암호화 ID | |
| ADVERTISINGID | #ADVERTISINGID | Android | 광고 ID. Google Play Service에서 제공 | 4c30a866-30d6-4418-a6dc-0f702737bf58 |
| ADVERTISINGID_MD5 | #ADVERTISINGID_MD5 | Android | 광고 암호화 ID | |
| ANDROIDID | #ANDROIDID | Android | Android 디바이스의 고유 디바이스 식별 번호 | |
| ANDROIDID_MD5 | #ANDROIDID_MD5 | Android | Android 디바이스의 암호화된 고유 디바이스 식별 번호 | |
| ANDROIDID_MD5_1 | #ANDROIDID_MD5_1 | Android | Android 디바이스의 암호화된 고유 디바이스 식별 번호 | |
| IMEI | #IMEI | Android | 국제 모바일 기기 식별 번호 | 493002407599521 |
| IMEI2 | #IMEI2 | Android | 국제 모바일 기기 식별 번호 2 | |
| TDID | #TDID | 전체 플랫폼 | TalkingData의 고유 디바이스 식별 번호 | hc5e59e1926ee0fe142b22610cdda14df |
| IP | #IP | 전체 플랫폼 | 이벤트 발생 시의 ip | 123.123.123.123 |
| SPREADURL | #SPREADURL | 전체 플랫폼 | 6자리 단축 링크. 프로모션 캠페인의 고유 식별자 | Vx7b6c |
| SPREADNAME | #SPREADNAME | 전체 플랫폼 | 프로모션 캠페인 이름 | "Domob 프로모션-소재1" |
| SPREADGROUP | #SPREADGROUP | 전체 플랫폼 | 프로모션 캠페인 그룹 이름 | |
| UA | #UA | 전체 플랫폼 | 광고를 클릭한 디바이스의 UA 정보 | |
| CLICKIP | #CLICKIP | 전체 플랫폼 | 광고를 클릭한 디바이스의 IP 정보 | 123.123.123.123 |
| CLICKTIME | #CLICKTIME | 전체 플랫폼 | 광고 클릭 시간, 13자리 unix 타임스탬프 | 1451379329000 |
| ADNETNAME | #ADNETNAME | 전체 플랫폼 | 광고 네트워크 채널사 이름(영문 고유 식별자) | “Domob” |
| ADNETDESC | #ADNETDESC | 전체 플랫폼 | 광고 네트워크 채널사 설명(중국어 식별자, 연동 업그레이드에 따라 변경될 수 있음) | "Domob" |
| CHANNELPACKAGEID | #CHANNELPACKAGEID | 전체 플랫폼 | 앱에 통합된 서브 패키지 ID. "channeled"라고도 함 | “jifeng_1” |
| CLICK | @_ | 전체 플랫폼 | 연관 클릭의 파라미터를 json 형식으로 나타낸 값 | {"a":"1","b":"2"} |
| ASSISTANT_CLICK_1 | #ASSISTANT_CLICK_1 | 전체 플랫폼 | 어시스트 클릭 1의 프로모션 캠페인 이름 | |
| ASSISTANT_CLICK_2 | #ASSISTANT_CLICK_2 | 전체 플랫폼 | 어시스트 클릭 2의 프로모션 캠페인 이름 | |
| ASSISTANT_CLICK_3 | #ASSISTANT_CLICK_3 | 전체 플랫폼 | 어시스트 클릭 3의 프로모션 캠페인 이름 | |
| TD_SUBID | #TD_SUBID | 전체 플랫폼 | 하위 채널 ID | |
| ACTIVE_TYPE | #ACTIVE_TYPE | 전체 플랫폼 | 활성화 유형 | |
| FRAUD_PREVENTION | #FRAUD_PREVENTION | IOS Android | 부정 행위 방지 식별자 | "0"은 이상 없음; "1"은 IP 이상 활성화; "2"는 시간차 전환 이상 활성화; "3"은 연관 이상 활성화; "4"는 IP 이전 활성화(고급 버전 부정 행위 방지 전용); "5"는 LAT 이상 활성화(고급 버전 부정 행위 방지 전용); "6"은 완전 신규 디바이스 활성화(고급 버전 부정 행위 방지 전용); |
| ATTRIBUTION_TYPE | #ATTRIBUTION_TYPE | IOS Android | 어트리뷰션 소스 | "click"은 클릭에서 발생; "impression"은 노출에서 발생; "deeplink"는 앱 호출에서 발생; |
| ADCREATIVE | #ADCREATIVE | 전체 플랫폼 | 광고 크리에이티브 | |
| ADCAMPAIGN | #ADCAMPAIGN | 전체 플랫폼 | 캠페인 | |
| ADGROUP | #ADGROUP | 전체 플랫폼 | 광고 그룹 | |
| APPSTOREID | #APPSTOREID | IOS | App Store ID | 1046850159 |
| IDFA | #IDFA | IOS | iOS 시스템의 광고 추적 식별자 | 6C59CB5A-3091-4246-AA6E-9C025FE0E33B |
| MAC | #MAC | Android | IEEE 802 표준에 따른 MAC 주소 문자열 | AB:12:CD:34:EF:56 |
| CUSTOM | #CUSTOM | 전체 플랫폼 | 커스텀 파라미터 | |
| CLICKTRACKID | #CLICKTRACKID | 전체 플랫폼 | 활성화에 대응하는 클릭의 추적 ID |
3.2.2 가입 이벤트
가입 이벤트를 콜백하는 경우 아래 표의 파라미터 이름에 따라 각 매크로의 저장명을 설정할 것을 권장합니다:
| 파라미터 유형명 | 치환 매크로 | 지원 플랫폼 | 파라미터 설명 | 예시 |
|---|---|---|---|---|
| SPREADURL | #SPREADURL | 전체 플랫폼 | 6자리 단축 링크. 프로모션 캠페인의 고유 식별자 | Vx7b6c |
| SPREADNAME | #SPREADNAME | 전체 플랫폼 | 프로모션 캠페인 이름 | "Domob 프로모션-소재1" |
| UA | #UA | 전체 플랫폼 | 광고를 클릭한 디바이스의 UA 정보 | |
| CLICKIP | #CLICKIP | 전체 플랫폼 | 광고를 클릭한 디바이스의 IP 정보 | 123.123.123.123 |
| CLICKTIME | #CLICKTIME | 전체 플랫폼 | 광고 클릭 시간, 13자리 unix 타임스탬프 | 1451379329000 |
| CLICK | @_ | 전체 플랫폼 | 연관 클릭의 파라미터를 json 형식으로 나타낸 값 | {"a":"1","b":"2"} |
| ACCOUNTID | #ACCOUNTID | 전체 플랫폼 | 이벤트 발생 시 앱 내 계정 | |
| APPKEY | #APPKEY | 전체 플랫폼 | Ad Tracking 시스템에서 APP의 고유 식별자 | 10691808c7dc494eba8afd44cdef1df7 |
| EVENTTIME | #EVENTTIME | 전체 플랫폼 | 이벤트 발생 시간, 13자리 unix 타임스탬프 | 1451379329000 |
| OSVERSION | #OSVERSION | 전체 플랫폼 | 디바이스의 시스템 버전 | 9.2 |
| DEVICETYPE | #DEVICETYPE | 전체 플랫폼 | 디바이스 유형 | iPad4,4 |
| IDFA | #IDFA | IOS | iOS 시스템의 광고 추적 식별자 | 6C59CB5A-3091-4246-AA6E-9C025FE0E33B |
| MAC | #MAC | Android | IEEE 802 표준에 따른 MAC 주소 문자열 | AB:12:CD:34:EF:56 |
| ADVERTISINGID | #ADVERTISINGID | Android | 광고 ID. Google Play Service에서 제공 | 4c30a866-30d6-4418-a6dc-0f702737bf58 |
| ANDROIDID | #ANDROIDID | Android | Android 디바이스의 고유 디바이스 식별 번호 | |
| IMEI | #IMEI | Android | 국제 모바일 기기 식별 번호 | 493002407599521 |
| TDID | #TDID | 전체 플랫폼 | TalkingData의 고유 디바이스 식별 번호 | hc5e59e1926ee0fe142b22610cdda14df |
| IP | #IP | 전체 플랫폼 | 이벤트 발생 시의 ip | 123.123.123.123 |
| ADNETNAME | #ADNETNAME | 전체 플랫폼 | 광고 네트워크 채널사 이름(영문 고유 식별자) | “Domob” |
| ADNETDESC | #ADNETDESC | 전체 플랫폼 | 광고 네트워크 채널사 설명(중국어 식별자, 연동 업그레이드에 따라 변경될 수 있음) | "Domob" |
| CHANNELPACKAGEID | #CHANNELPACKAGEID | 전체 플랫폼 | 앱에 통합된 서브 패키지 ID. "channeled"라고도 함 | “jifeng_1” |
| DEEPLINK | #DEEPLINK | 전체 플랫폼 | 딥 링크 |
4. 데이터 저장 규칙
4.1 활성화 이벤트 저장 규칙
- 기본적으로 데이터의 CUSTOM을 데이터의 게스트 ID로 사용합니다. 이 필드는 AE 프로젝트의 게스트 ID와 대응해야 합니다
- 데이터의 EVENTTIME 필드, 즉 데이터 시간을 이벤트의 #event_time으로 사용합니다
- 데이터 이벤트 이름은 talkingdata_init_data입니다
- 콜백 링크에 설정한 기타 필드는 모두 저장됩니다
4.2 가입 이벤트 저장 규칙
- 기본적으로 데이터의 ACCOUNTID를 데이터의 계정 ID로 사용합니다. 이 필드는 AE 프로젝트의 계정 ID와 대응해야 합니다
- 데이터의 EVENTTIME 필드, 즉 데이터 시간을 이벤트의 #event_time으로 사용합니다
- 데이터 이벤트 이름은 talkingdata_register_data입니다
- 콜백 링크에 설정한 기타 필드는 모두 저장됩니다
4.3 표준화 필드
TalkingData 콜백 데이터의 일부 필드는 AE 시스템에서 표준화 처리합니다:
| 필드 | 표준화 필드 | 의미 |
|---|---|---|
| ADCAMPAIGN | te_ads_object.campaign_name | 캠페인 이름 |
| ADGROUP | te_ads_object.ad_group_name | 광고 그룹 이름 |
| ADCREATIVE | te_ads_object.ad_name | 광고 이름 |
| ADNETNAME | te_ads_object.media_source | 미디어 채널 |
| APPSTOREID | te_ads_object.app_id | 앱 ID |
5. 비고
활성화 이벤트의 CUSTOM 또는 가입 이벤트의 ACCOUNTID가 AE 프로젝트의 게스트 ID, 계정 ID와 대응하지 않으면 해당 이벤트는 하나의 가상 유저(게스트 ID는 without_id)에 연결됩니다. 가상 유저에 연결된 이벤트 데이터를 나중에 AE 프로젝트의 실제 유저와 연관시키려면 TalkingData의 td_id를 해당 유저의 유저 속성에 설정한 후 데이터 백필을 통해 유저 데이터를 연결해야 합니다.
String td_id = TalkingDataAppCpa.getDeviceId(this);
try {
// td_id를 유저 속성으로 설정
JSONObject properties = new JSONObject();
properties.put("td_id",td_id);
TDAnalytics.userSet(properties);
} catch (JSONException e) {
e.printStackTrace();
}