Aghanim-ThinkingData 통합
해당 가이드는 ThinkingData와 Aghanim을 통합하여 플레이어 분석 및 추적을 간소화하는 방법을 설명합니다. Aghanim을 ThinkingData와 연결하면 Game Hub 및 기타 판매 채널에서 플레이어가 수행한 구매와 환불을 추적하여, Aghanim 커머스 이벤트를 게임의 분석 데이터와 연계할 수 있습니다.
Aghanim은 ThinkingData REST API를 통해 서버 측에서 ThinkingData로 이벤트를 전송하므로 클라이언트 측 설정이 필요하지 않습니다.
요구 사항
- TE 콘솔에 프로젝트가 생성된 ThinkingData 계정.
- 프로젝트의 APP ID에 대한 접근 권한.
1단계: ThinkingData에서 프로젝트 자격 증명 얻기
- ThinkingData(TE) 콘솔을 열고 Project Management 페이지로 이동합니다.
- 이벤트를 전송할 프로젝트의 APP ID를 복사합니다.
- 프라이빗 ThinkingData 배포를 사용하는 경우 System Settings → Data Receiving URL에서 데이터 수신 호스트를 복사한 후
/sync_json경로를 추가합니다(예:https://receiver.example.com/sync_json). SaaS 프로젝트의 경우 기본 글로벌 엔드포인트가 자동으로 사용됩니다.
2단계: Aghanim에서 통 합 구성
- Aghanim 대시보드로 이동 → Aghanim Connect → ThinkingData.
- 구성 필드를 입력합니다(아래 표 참조).
- 통합을 활성화하려면 설치 버튼을 클릭합니다.
| 필드 | 설명 | 필수 여부 |
|---|---|---|
| App ID | ThinkingData 콘솔에 있는 프로젝트의 APP ID입니다. | 예 |
| Receiver URL | /sync_json으로 끝나는 전체 ThinkingData raw 데이터 수신 엔드포인트입니다(프라이빗 배포용). 지정하지 않으면 글로벌 ThinkingData 엔드포인트(https://global-receiver-ta.thinkingdata.cn/sync_json)가 기본값으로 사용됩니다. | 아니요 |
| Purchase Event Name | 구매 이벤트의 사용자 지정 이벤트 이름입니다. 기본값은 purchase입니다. | 아니요 |
| Refund Event Name | 환불 이벤트의 사용자 지정 이벤트 이름입니다. 기본값은 refund입니다. | 아니요 |
| Property Prefix | 모든 이벤트 속성 이름에 추가되는 접두사입니다. 예를 들어 agn_을 지정하면 agn_order_id가 됩니다. | 아니요 |
| Excluded Sales Channels | 선택한 판매 채널(Game Hub, Checkout, SDK, Checkout links)의 구매 이벤트는 추적을 위해 전송되지 않습니다. 환불 이벤트는 이 설정과 관계없이 전송됩니다. | 아니요 |
사용자 지정 이벤트 이름과 속성 이름(접두사 포함)은 ThinkingData 명명 규칙을 따라야 합니다: 문자로 시작하고, 문자·숫자·밑줄만 포함하며, 최대 50자여야 합니다. 이 값은 구성을 저장할 때 검증되지 않으므로 접두사가 붙은 속성 이름(예: <prefix>total_amount_decimal_usd)이 제한을 초과하지 않는지 확인하세요.
3단계: 통합 확인
통합을 설치할 때 ThinkingData로 테스트 요청이 전송되지 않으므로, 잘못된 App ID나 Receiver URL은 첫 이벤트가 전송될 때 비로소 드러납니다. 설정을 확인하려면 Excluded Sales Channels에 포함되지 않은 판매 채널에서 테스트 구매를 완료한 후, 예상되는 #account_id와 속성(아래 참조)과 함께 구매 이벤트가 ThinkingData 프로젝트에 표시되는지 확인하세요. 환불 추적을 확인하려면 테스트 주문을 환불하고 해당 환불 이벤트가 표시되는지 확인하세요.
ThinkingData로 전송되는 이벤트
통합이 설정되면 Aghanim은 플레이어 주문에 대한 구매(purchase) 및 환불(refund) 이벤트를 자동으로 전송합니다. 이벤트는 플레이어의 Aghanim Player ID가 #account_id로 설정되어 추적되므로 게임의 이벤트와 매칭할 수 있습니다. 이벤트의 #time은 구매 이벤트의 경우 주문 생성 시각, 환불 이벤트의 경우 환불 시각입니다.
각 이벤트에는 다음 속성이 포함됩니다(구성된 접두사가 있는 경우 적용됨):
| 속성 | 유형 | 설명 |
|---|---|---|
order_id | string | Aghanim 주문 ID입니다. |
item_sku | string | 주문에 포함된 아이템의 SKU를 쉼표로 구분한 값입니다. |
amount_decimal | number | 결제 통화 기준 주문 금액입니다. Reward Points 또는 가상 화폐로 결제한 주문의 경우 0입니다. |
currency | string | 결제 통화 코드입니다. Reward Points 또는 가상 화폐로 결제한 주문의 경우 USD입니다. |
payment_number | string, null | 사람이 읽을 수 있는 결제 영수증 번호입니다. Reward Points 또는 가상 화폐로 결제한 주문처럼 결제 제공자의 영수증이 없는 주문의 경우 null입니다. |
total_amount_decimal_usd | number, null | USD 기준 총 주문 금액입니다. |
revenue_decimal_usd | number, null | 구매 이벤트의 경우 USD 기준 고객 매출입니다. 환불 이벤트의 경우 환불로 인한 매출 변동으로, 음수(또는 0)로 전송됩니다. |
도움이 필요하세요?
통합팀에 문의하십시오 [email protected]