manuallatest제품 매뉴얼 / SolarEngine 통합 계획
SolarEngine 통합 계획
팁
서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다
개요
인터페이스 소개
| 인터페이스명 | 타입 | 세분화 | 어트리뷰션 | 비용 | 수익 | 노출 | 클릭 | 전환 |
|---|---|---|---|---|---|---|---|---|
| 실시간 API | 콜백 | 유저 수준 | ✅ | ✅ |
SolarEngine 데이터 연동을 시작하기 전에 AE 시스템의 유저 식별 규칙을 읽고 AE가 #distinct_id와 #account_id로 유저를 식별하는 방식을 이해했는지 확인하십시오
SolarEngine은 실시간 API 내보내기 기능을 제공하며, 활성화 등 이벤트 데이터의 실시간 콜백을 지원합니다. 자세한 내용은 SolarEngine 공식 문서를 참고하십시오
통합 절차
- SolarEngine SDK와 AE SDK를 연동하고, SolarEngine SDK의 공통 이벤트 속성 설정 인터페이스를 통해 AE SDK의 게스트 ID를 전달합니다
- AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 SolarEngine 통합을 추가하고 관련 설정을 완료한 다음 콜백 주소를 복사합니다
- SolarEngine 백엔드에 로그인하여 데이터 콜백 설정을 완료합니다
- AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다
1. 클라이언트 SDK 설정
1.1 SolarEngine SDK 및 AE SDK 도입
먼저 앱에 SolarEngine SDK와 AE SDK를 도입하고 초기화 설정을 완료해야 합니다. SolarEngine SDK와 AE SDK의 연동 문서는 다음과 같습니다:
1.2 SDK 설정
SDK를 도입한 후에는 AE SDK의 게스트 ID와 계정 ID를 SolarEngine SDK에 설정해야 합니다. SolarEngine의 공통 이벤트 속성 설정 인터페이스를 사용하는 방법을 권장합니다
순서에 유의하십시오:
- AE SDK 초기화를 완료합니다
- AE SDK의 게스트 ID를 가져옵니다
- SolarEngine의 공통 속성 설정 인터페이스를 호출하여 AE SDK의 게스트 ID를 SolarEngine SDK의 공통 속성으로 설정합니다
- SolarEngine SDK를 초기화합니다
- AE SDK의 계정 ID를 가져올 수 있게 되면(즉 계정에 로그인하거나 캐릭터가 접속할 때) AE SDK의 login 인터페이스를 호출하고, SolarEngine의 공통 속성 설정 인터페이스를 다시 호출하여 계정 ID를 SolarEngine SDK의 공통 속성으로 설정합니다
다음은 Android 코드 예시입니다:
// AE SDK 초기화 완료
TDAnalytics.init(context, APPID, SERVER_URL);
// AE SDK의 게스트 ID 가져오기
String te_distinct_id = TDAnalytics.getDistinctId();
// 공통 이벤트 속성 설정 인터페이스로 AE의 게스트 ID를 SolarEngine SDK의 공통 속성으로 설정
SolarEngineManager.getInstance().setSuperProperties(context, "te_distinct_id", te_distinct_id);
// SolarEngine SDK 초기화
SolarEngineConfig config = new SolarEngineConfig.Builder().build();
SolarEngineManager.getInstance().initialize(context, "개발자가 신청한 appkey","개발자가 신청한 userId",config);
// .....
// 유저 로그인 후
// 계정 ID 가져오기
String te_account_id = "login_id";
// TE SDK에서 login 호출
TDAnalytics.login(te_account_id);
// 공통 이벤트 속성 설정 인터페이스로 AE의 계정 ID를 SolarEngine SDK의 공통 속성으로 설정
SolarEngineManager.getInstance().setSuperProperties(context,"te_account_id", te_account_id);
2. 계획 설정
SDK 설정을 완료한 후 AE 시스템 백엔드에 로그인하여 서드파티 통합 모듈에서 SolarEngine 설정을 완료해야 합니다. 아래 그림은 SolarEngine의 설정 화면입니다:
2.1 유저 식별 필드
SolarEngine이 콜백하는 데이터는 유저 수준 데이터이므로 유저 식별 규칙을 설정해야 합니다. AE 시스템은 이 설정에 따라 콜백 데이터를 변환할 때 해당 필드를 데이터의 유저 식별 필드로 설정합니다.
이 문서의 이전 단계에 따라 클라이언트 SDK를 설정한 경우 다음 설정을 사용하십시오:
- 계정 ID 연관 필드: event_custom_params.te_account_id
- 게스트 ID 연관 필드: event_custom_params.te_distinct_id
2.2 이벤트 테이블 저장 설정
이벤트 테이블 저장 설정 스위치를 켜면 콜백 데이터(활성화 이벤트와 인앱 이벤트 포함)가 모두 이벤트 테이블에 기록됩니다
이벤트 데이터 저장을 활성화할 것을 권장합니다. 단, 기본적으로 SolarEngine이 콜백하는 모든 데이터를 수신합니다. 콜백하는 이벤트 유형이 너무 많으면 AE 프로젝트의 이벤트량이 과도하게 늘어날 수 있으므로, SolarEngine 플랫폼에서 콜백을 설정할 때 필요한 이벤트만 선택하여 콜백할 것을 권장합니다.
2.3 유저 속성 저장 규칙
기본적으로 AE 시스템은 SolarEngine 콜백 데이터의 어트리뷰션 필드를 표준화 처리된 유저 속성에 자동으로 기록합니다. 다음은 유저 속성에 기록되는 필드와 그 의미입니다:
| SolarEngine 필드 | 표준화 필드 | 설명 |
|---|---|---|
| channel_name | te_ads_object.media_source | 미디어 채널 |
| adplan_name | te_ads_object.campaign_name | 캠페인 이름 |
| adgroup_name | te_ads_object.ad_group_name | 광고 그룹 이름 |
| adcreative_name | te_ads_object.ad_name | 광고 이름 |
수정이 필요하면 규칙 설정을 클릭하여 저장 규칙 설정 페이지로 이동합니다. 아래 그림과 같습니다
여기에서 유저 속성을 어떤 이벤트에서 가져올지 수정할 수 있습니다. 유저 속성이 너무 자주 기록되지 않도록 하려면 모든 이벤트 포함을 끄고 소스 이벤트명을 install로 변경하십시오. 이렇게 설정하면 AE 시스템은 SolarEngine이 콜백한 install 이벤트에서만 유저 속성에 기록할 필드를 추출하여 기록합니다. 저장 방식의 기본값은 user_setOnce이며, 최초로 전송된 정보만 유지됩니다.
유저 속성 저장을 끄려면 모든 규칙을 중지하면 됩니다:
2.4 통합 설정
마지막으로 통합 설정 모듈에서 데이터 수집의 세부 설정을 제어할 수 있습니다. 예를 들어 저장 후 이벤트 이름 등을 설정할 수 있습니다.
통합 설정의 내용은 JSON이며, 다음 내용에 따라 커스텀 설정할 수 있습니다:
| 모듈 | 이름 | 의미 |
|---|---|---|
| sink_event | event_mapping | 저장 후 이벤트 이름, 커스텀 가능. Key는 SolarEngine의 이벤트 이름이고 Value는 저장 후 이벤트 이름입니다. 기본값은 활성화 이벤트: install |
2.5 엔드포인트 주소
엔드포인트 주소에는 AE 시스템이 SolarEngine 콜백 데이터를 수신하는 주소가 표시됩니다.
엔드포인트 주소에는 APP 콜백용 파라미터가 기본으로 포함되어 있으니 유의하십시오. 미니 프로그램/미니 게임 데이터를 콜백하려면 미니 프로그램/미니 게임 콜백 파라미터 절을 참고하십시오
이 주소를 그대로 복사하여 이후 콜백을 설정할 때 입력하십시오:
여기에 주소가 표시되지 않으면 오른쪽 상단 메뉴의 프로젝트 관리 → 프로젝트 구성 → 연동 설정에서 공용 네트워크 주소를 설정하십시오. 이 주소는 AE SDK에 설정한 데이터 수집 주소입니다. 설정한 후 SolarEngine 설정 페이지의 엔드포인트 주소로 돌아와 엔드포인트 주소를 복사하십시오.
3. SolarEngine에서 콜백 설정 완료
3.1 SolarEngine 백엔드의 실시간 API 데이터 내보내기 페이지에서 콜백 링크 설정
AE 백엔드에서 계획을 생성한 후 SolarEngine 백엔드에 로그인하여 데이터를 콜백할 프로젝트를 선택하고, 어트리뷰션 모듈에서 앱 설정 - 데이터 내보내기 - 실시간 api 내보내기를 선택하면 SolarEngine의 실시간 콜백을 설정할 수 있습니다
다음 규칙에 따라 입력하십시오:
- 콜백 유형은 활성화를 선택합니다
- 콜백 주소에는 AE 백엔드에서 가져온 콜백 주소를 입력합니다
- 콜백 주소 파싱은 3.2절의 내용에 따라 입력할 것을 권장합니다
- 콜백 방식은 POST를 선택하십시오
- 타임아웃 시간과 재시도 횟수는 필요에 따라 수정할 수 있으며, 특별한 요구 사항이 없으면 기본값을 사용해도 됩니다
설정을 마친 후 제출을 클릭하면 됩니다
3.2 SolarEngine의 콜백 파라미터
아래는 SolarEngine 콜백에서 설정할 수 있는 파라미터입니다. 설정 시 입력하는 파라미터 이름을 선택한 값과 일치시킬 것을 권장합니다. 아래 표에서 콜백을 권장하는 모든 필드를 확인할 수 있으며, event_name, event_time, event_custom_params 필드는 반드시 콜백해야 합니다. 그렇지 않으면 데이터 변환에 실패할 수 있습니다
3.2.1 App 콜백 파라미터
| 파라미터 이름 | 기본 사용 | 값(예시) | 설명 |
|---|---|---|---|
| event_type | 예 | 열거값: preset, custom | 프리셋 이벤트 여부 |
| event_name | 예 | 이벤트 이름: install, startup, etc... | 이벤트 이름 |
| attribution_time | 예 | 2023/7/1 22:47 | 어트리뷰션 시간 |
| attribution_touch_type | 예 | click | 어트리뷰션 터치포인트 유형 |
| attribution_method | 예 | 열거값: deviceid fingerprint | 어트리뷰션 방법 |
| attribution_lbw | 86400 | 어트리뷰션 시간 윈도우 | |
| attribution_ttit | 68 | 어트리뷰션 시간차 | |
| channel_name | 예 | Mintegral | 어트리뷰션된 채널 이름 |
| app_name | 예 | Cat EscapeInfinity | APP 이름 |
| appkey | 예 | appkey | |
| app_platform | 예 | ios | app의 플랫폼 |
| landing_page_url | https://apps.apple.com/us/app/cat-escape-infinity/id6445884698 | app 랜딩 페이지 주소 | |
| turl_id | Ev2Evya | 트래킹 링크 단축 링크 ID | |
| turl_string | 트래킹 링크 단축 링크 | ||
| turl_campaign_id | 예 | 7b35b6bd982780f729fcf4ff925b9c4e | 트래킹 링크 고유 ID |
| turl_campaign_name | 예 | 숨바꼭질 무한 모드-IOS | 트래킹 링크 이름 |
| channel_id | 예 | 8221 | 트래킹 링크에 대응하는 채널 ID |
| ry_touchpoint_ts | 예 | 1688222783854 | 터치포인트 시간 |
| attribution_type | 예 | ua | 어트리뷰션 유형(UA 신규 유입으로 고정) |
| account_id | 예 | 광고 집행 계정 ID | |
| adgroup_id | 예 | 광고 플랫폼 광고 그룹 ID | |
| adgroup_name | 예 | CatEscapeInfinity_CN_FO_0404_WX_iOS_MTG_1 | 광고 플랫폼 광고 그룹 이름 |
| adplan_id | 예 | ss_Duomm_CN_FO_0404_WX_iOS_MTG_1 | 광고 플랫폼 광고 계획 ID |
| adplan_name | 예 | 광고 플랫폼 광고 계획 이름 | |
| adcreative_id | 예 | 1804913040 | 광고 플랫폼 광고 소재 ID |
| adcreative_name | 예 | wadmm_21186_0_V_1203_mtg_nndb_cn_1024x768_cy.mp4 | 광고 플랫폼 광고 소재 이름 |
| adcreative_type | 예 | 광고 플랫폼 광고 소재 유형 | |
| site_id | 예 | mtg1183741824 | 광고 플랫폼 하위 채널 ID |
| site_name | 예 | 광고 플랫폼 하위 채널 이름 | |
| ad_type | 예 | 광고 플랫폼 광고 유형 | |
| placement_id | 예 | 광고 플랫폼 광고 슬롯 id | |
| conversion_id | 광고 플랫폼의 전환 수신 고유 ID | ||
| click_id | mtg64a03bfe52979a0001a8cb4y | 광고 플랫폼 클릭 고유 ID | |
| impression_id | 광고 플랫폼 노출 고유 ID | ||
| request_id | 7434D04B787321D534C7268DD8D4D52E | 광고 플랫폼 요청 고유 ID | |
| callback_id | 광고 플랫폼 콜백 고유 ID | ||
| callback_url | 광고 플랫폼 콜백 주소 | ||
| custom_params_1 | 광고 플랫폼 커스텀 파라미터 데이터 1-10 | ||
| custom_params_2 | 광고 플랫폼 커스텀 파라미터 데이터 1-10 | ||
| custom_params_3 | 광고 플랫폼 커스텀 파라미터 데이터 1-10 | ||
| custom_params_4 | 광고 플랫폼 커스텀 파라미터 데이터 1-10 | ||
| custom_params_5 | 광고 플랫폼 커스텀 파라미터 데이터 1-10 | ||
| custom_params_6 | 광고 플랫폼 커스텀 파라미터 데이터 1-10 | ||
| custom_params_7 | 광고 플랫폼 커스텀 파라미터 데이터 1-10 | ||
| custom_params_8 | 광고 플랫폼 커스텀 파라미터 데이터 1-10 | ||
| custom_params_9 | 광고 플랫폼 커스텀 파라미터 데이터 1-10 | ||
| custom_params_10 | 광고 플랫폼 커스텀 파라미터 데이터 1-10 | ||
| device_id | 예 | B9BBB98D-FFEE-448D-A9BE-52883FF230FD | 어트리뷰션 디바이스 고유 ID |
| device_id_type | 예 | distinct_id | distinct_id |
| device_id_md5_type | distinct_id_md5 | distinct_id_md5 | |
| device_id_md5 | 55a6187afabbe2ed4c6e9bc0fdca423d | 어트리뷰션 디바이스 고유 ID의 md5 | |
| gaid | gaid | ||
| gaid_md5 | gaid_md5 | ||
| imei1 | imei1 | ||
| imei1_md5 | imei1_md5 | ||
| imei2 | imei2 | ||
| imei2_md5 | imei2_md5 | ||
| oaid | oaid | ||
| oaid_md5 | oaid_md5 | ||
| mac | mac | ||
| mac_md5 | mac_md5 | ||
| android_id | android_id | ||
| android_id_md5 | android_id_md5 | ||
| idfa | 49BB9C2F-E0DB-46B8-9C68-21C4C7FB30CC | idfa | |
| idfa_md5 | 1225a829ea48f2fc62a2d3faee263829 | idfa_md5 | |
| idfv | B9BBB98D-FFEE-448D-A9BE-52883FF230FD | idfv | |
| idfv_md5 | 55a6187afabbe2ed4c6e9bc0fdca423d | idfv_md5 | |
| ipv4 | 110.154.208.22 | ipv4 | |
| ipv6 | ipv6 | ||
| ua | 예 | Mozilla/5.0 (iPad; CPU OS 14_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 | ua |
| manufacturer | 예 | apple | 브랜드 |
| model | 예 | iPad11,6 | 기종 |
| os | 예 | 열거값 1: Android 2: ios | 시스템 |
| os_version | 예 | 14.2 | 버전 |
| ua_device_type | iPad | ua에서 파싱한 디바이스 유형 | |
| ua_os | IOS | ua에서 파싱한 시스템 | |
| ua_osv | 14.2 | ua에서 파싱한 os version | |
| language | 예 | zh-Hans-CN | 언어 |
| country | 예 | CN | 국가 |
| city | 예 | 도시 | |
| att_status | 열거값: denied, restricted, authorized, unknown, 빈 값 | ||
| lat_status | 열거값: enable, disable, unknown, 빈 값 | ||
| network_type | 예 | 열거값: 0: 네트워크 없음 1: unknown 2: 2G 3: 3G 4: 4G 5: 5G 6: 6G 또는 차세대 네트워크 9: WIFI | 데이터 업로드 시의 네트워크 상태 |
| carrier | 예 | 통신사 | |
| install_time | 1688222848242 | 활성화 시간 | |
| event_time | 예 | 1689781058000 | 서버가 이벤트를 수신한 시간 |
| channel_package_name | default | 채널 패키지 이름 | |
| app_version | 예 | 1.0.2 | 앱 버전 |
| bundleid | 예 | jp.os.catescape | app bundle id |
| event_data | 예 | ||
| collector_version | 1.1.8.0 | sdk 버전 | |
| integration_type | 열거값: sdk api s2s | 연동 방식 | |
| event_custom_params | 예 | 고객의 커스텀 이벤트 속성 내용 | |
| caid | 이벤트의 caid 값 | ||
| caid_md5 | 이벤트 caid의 md5 값 | ||
| event_account_id | 이벤트의 account_id |
3.2.2 미니 프로그램/미니 게임 콜백 파라미터
미니 프로그램 또는 미니 게임을 연동하는 경우 다음 콜백 주소를 사용하십시오. {receiver-host}는 데이터 수집 주소로, {app-id}는 프로젝트의 APP ID로 바꾸십시오:
https://{receiver-host}/attribution/callback/solarengine/{app-id}?appkey=appkey&app_name=app_name&app_platform=app_platform&app_type=app_type&event_name=event_name&country=country¤t_event_time=current_event_time&channel_name=channel_name&os=os&os_version=os_version&brand=brand&model=model&ua=ua&user_id=user_id&account_id=account_id&adgroup_id=adgroup_id&adgroup_name=adgroup_name&adplan_id=adplan_id&adplan_name=adplan_name&adcreative_id=adcreative_id&adcreative_name=adcreative_name&adcreative_type=adcreative_type&scene_id=scene_id&custom_params=custom_params&ad_platform=ad_platform&ad_type=ad_type&ad_appid=ad_appid&ad_id=ad_id&mediation_platform=mediation_platform&ad_ecpm=ad_ecpm&order_id=order_id&order_amount=order_amount¤cy_type=currency_type&purchase_type=purchase_type&product_id=product_id&product_name=product_name&product_num=product_num®ister_type=register_type&login_type=login_type
미니 프로그램/미니 게임 공통 이벤트 필드 설명:
| 필드 이름 | 권장 사용 | 값(예시) | 설명 |
|---|---|---|---|
| appkey | 예 | 9b716df699b77694 | SE 백엔드에서 생성한 앱 고유 식별자 |
| app_name | 예 | 앱 이름 | 앱 이름 |
| app_platform | 예 | miniprogram | 운영체제: miniprogram 또는 minigame |
| app_type | 예 | 플랫폼 유형: wechat, douyin | |
| event_name | 예 | startup | 이벤트 이름. install(활성화), startup(실행), register(가입), login(로그인), order(주문), purchase(결제), adimpression(광고 노출)... 중 하나로 고정 |
| country | 예 | CHN | 국가 |
| install_time | 1637823377000 | 설치 시간 | |
| current_event_time | 예 | 1637823377000 | 현재 이벤트가 발생한 시간 |
| report_time | 1637823377000 | 서버가 수신한 시간 | |
| integration_type | sdk | 통합 방식. sdk로 고정 | |
| collector_version | 1.8.0 | 수집기 버전 | |
| attribution_method | path | 어트리뷰션 방식: 경로 어트리뷰션(path), 클릭 어트리뷰션(click) | |
| channel_id | 8221 | 채널 id | |
| channel_name | 예 | tiktok | 채널 이름 |
| turl_campaign_id | 871bbfa4560283c5a0ca00483c529c63 | 트래킹 링크 ID | |
| turl_campaign_name | 트래킹 링크 이름_Mintegral | 트래킹 링크 이름 | |
| openid | oUFfk5coGBwScTmIsr008qL93ANk | 현재 미니 프로그램 내 유저 고유 ID | |
| anonymous_openid | Douyin 전용. 현재 미니 프로그램 내 익명 유저 고유 ID | ||
| unionid | f7510d9ab*********** | 동일 개발자의 서로 다른 미니 프로그램 간 유저 고유 ID | |
| device_id | oUFfk5UyO--kSbPVEuC5zWtqYvbs | 디바이스 ID | |
| device_id_type | openid | 디바이스 ID 유형 | |
| container_name | toutiao | 호스트 APP 이름, Douyin 전용 | |
| os | 예 | android | 호스트 App 운영체제 플랫폼 |
| os_version | 예 | 10 | 호스트 App 운영체제 버전 |
| brand | 예 | HUAWEI | 호스트 App 디바이스 제조사 |
| model | 예 | Mate 40 | 호스트 App 디바이스 모델 |
| language | zh-han | 호스트 App 디바이스 언어 | |
| ipv4 | 1.1.1.1 | 유저 공인 IP v4 버전 | |
| ua | 예 | Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4638.54 Safari/537.36 | UA |
| user_id | 예 | 계정 ID(유저 id) | |
| account_id | 예 | 광고 계정 ID | |
| adgroup_id | 예 | 광고 그룹 ID | |
| adgroup_name | 예 | 광고 그룹 이름 | |
| adplan_id | 예 | 캠페인 ID | |
| adplan_name | 예 | 캠페인 이름 | |
| adcreative_id | 예 | 광고 크리에이티브 ID | |
| adcreative_name | 예 | 광고 크리에이티브 이름 | |
| adcreative_type | 예 | 크리에이티브 유형(예: 큰 이미지, 작은 이미지, 동영상 등) | |
| material_1 | 소재 ID_1 | ||
| material_2 | 소재 ID_2 | ||
| material_3 | 소재 ID_3 | ||
| material_4 | 소재 ID_4 | ||
| material_5 | 소재 ID_5 | ||
| material_6 | 소재 ID_6 | ||
| click_id | 광고 클릭 id | ||
| impression_id | 광고 노출 id | ||
| request_id | 광고 요청 id | ||
| callback_id | 채널 콜백 id | ||
| callback_url | 채널 콜백 주소 | ||
| site_id | 트래픽 매체 id(예: Ocean Engine의 Toutiao, Pangle, Douyin 등). | ||
| site_name | 트래픽 매체 이름(예: Ocean Engine의 Toutiao, Pangle, Douyin 등). | ||
| scene_id | 예 | 1 | 시나리오 값 |
| path | index/xxx | 미니 프로그램 시작 페이지 경로 | |
| query_info | { "channel_id": "234234", "turl_id": "234234", ...} | 미니 프로그램 플랫폼에서 가져온 query 정보. SE 전달 파라미터 + 채널 추가 파라미터 | |
| custom_params | 예 | { "add_cart": "234234", //커스텀 파라미터. "sku": "234234", "level_up": "234234" ... } | /이벤트 커스텀 파라미터 중첩. 포함되는 파라미터는 최대 10개. |
미니 프로그램/미니 게임 일부 이벤트 전용 필드 설명:
| 이벤트 | 필드 이름 | 권장 사용 | 설명 |
|---|---|---|---|
| adimpression | ad_platform | 예 | 수익화 플랫폼 |
| ad_type | 예 | 노출 광고 유형 | |
| ad_appid | 예 | 수익화 플랫폼의 앱 ID | |
| ad_id | 예 | 수익화 플랫폼의 수익화 광고 슬롯 ID | |
| mediation_platform | 예 | 미디에이션 플랫폼 식별자. 미디에이션 플랫폼 식별자가 없으면 "custom"으로 설정하십시오 | |
| ad_ecpm | 예 | 광고 ECPM(광고 1,000회 노출당 수익화 수익, 0 또는 음수는 전달되지 않았음을 의미), 단위: 위안 | |
| is_rendered | 광고 렌더링 성공 여부. 구체적인 열거값은 다음과 같습니다: YES: 성공 NO: 실패 이 지표를 집계할 필요가 없으면 YES를 전달하십시오 | ||
| adclick | ad_platform | 예 | 수익화 플랫폼 |
| ad_type | 예 | 노출 광고 유형 | |
| ad_id | 예 | 수익화 플랫폼의 수익화 광고 슬롯 ID | |
| mediation_platform | 예 | 미디에이션 플랫폼 식별자. 미디에이션 플랫폼 식별자가 없으면 "custom"으로 설정하십시오 | |
| purchase | order_id | 예 | 주문 ID |
| order_amount | 예 | 이번 구매에서 결제한 금액 | |
| currency_type | 예 | 결제 통화 종류. ISO 4217 국제 표준을 따름(예: CNY, USD) | |
| purchase_type | 예 | 결제 방식: alipay, weixin, applepay, paypal 등 | |
| product_id | 예 | 구매 상품의 ID | |
| product_name | 예 | 상품 이름 | |
| product_num | 예 | 구매 상품의 수량 | |
| order | order_id | 예 | 주문 ID |
| order_amount | 예 | 주문 금액, 단위: 위안 | |
| currency_type | 예 | 노출 수익의 통화 종류. ISO 4217 국제 표준을 따름(예: CNY, USD) | |
| purchase_type | 예 | 결제 방식: alipay, weixin, applepay, paypal 등 | |
| register | register_type | 예 | 가입 유형. "WeChat", "QQ" 등 커스텀 값 |
| login | login_type | 예 | 로그인 유형. "WeChat", "QQ" 등 커스텀 값 |
4. 데이터 저장
4.1 데이터 저장 규칙
기본적으로 다음 규칙에 따라 수집한 데이터를 이벤트 형태로 AE 프로젝트에 기록합니다:
- 데이터의 event_time 필드를 이벤트의 데이터 시간 #event_time으로 사용합니다
- 데이터의 event_name을 데이터의 이벤트 이름으로 사용합니다
- 나머지 필드는 모두 저장됩니다
4.2 표준화 필드
| 원본 필드 | 표준화 필드 | 의미 |
|---|---|---|
| account_id | te_ads_object.ad_account_id | 광고 계정 ID |
| adplan_name | te_ads_object.campaign_name | 캠페인 이름 |
| adplan_id | te_ads_object.campaign_id | 캠페인 ID |
| adgroup_name | te_ads_object.ad_group_name | 광고 그룹 이름, 수익화 광고의 Unit 이름 |
| adgroup_id | te_ads_object.ad_group_id | 광고 그룹 ID, 수익화 광고의 Unit ID |
| adcreative_name | te_ads_object.ad_name | 광고 이름 |
| adcreative_id | te_ads_object.ad_id | 광고 ID |
| placement_id | te_ads_object.placement | 광고 위치 |
| channel_name | te_ads_object.media_source | 미디어 채널 또는 수익화 채널 |
| bundleid | te_ads_object.app_id | 앱 ID |
| app_name | te_ads_object.app_name | 앱 이름 |
| app_platform | te_ads_object.platform | 플랫폼(Android, iOS 등) |
| country | te_ads_object.country | 국가/지역 코드 |
이 문서가 도움이 되었나요?