가져오기 매퍼
카테고리:
이 문서의 주제:
Tridens Monetization의 Import Mappers를 사용하면 외부 데이터(CSV, 플랫 파일 등)를 시스템 호환 형식으로 변환하고 정렬할 수 있습니다. 결제 데이터, 이벤트, 은행 거래를 가져오는 경우에도 Import Mapper는 시스템이 외부 플랫폼의 구조화된 데이터를 올바르게 해석하고 수집하도록 보장합니다.
매퍼 위치
다음으로 이동합니다:Business Configuration > Import
그림 1: Import Mappers 기본 페이지
Import Mapper 유형
Import Mappers 화면 상단에는 서로 다른 데이터 도메인을 나타내는 네 개의 탭이 있습니다. 모든 탭은 동일한 구성 구조를 공유합니다.
- Payment Mappers
- Direct Debit Mappers
- Event Mappers
- Bank Mappers
각 탭에서는 스크린샷에 표시된 것과 같은 양식을 사용하여 새 매퍼를 Add할 수 있습니다.
새 Import Mapper 추가
네 개의 탭 중 어느 탭에서든 Add 버튼을 클릭하여 Create Mapper 양식을 엽니다. 입력해야 하는 필드는 모든 매퍼 유형에서 동일합니다.
필수 필드
표 1: 필수 필드
| Field | Description |
|---|---|
| Name | 매퍼의 고유하고 설명적인 이름(예: Bankart Payment Mapper) |
| Code | 내부적으로 사용되는 시스템 식별자(예: BANKART_01) |
| Description | 선택 사항. 이 매퍼의 목적 또는 소스에 대한 참고 추가 |
| Prefix | 선택 사항. 매핑 중 고유 값을 추가하는 데 사용 |
| Import Mode | 입력 파일의 구조를 정의합니다. 옵션: Single 또는 Multi |
| Delimiter | 파일 구분자이며 일반적으로 쉼표 ,, 탭 \t, 세미콜론 ; |
| File | 매핑 템플릿 파일 업로드(일반적으로 CSV 또는 TXT 형식) |
그림 2: Create Import Mapper 페이지
사용 사례 예시
거래 ID, 고객 ID, 금액, 상태에 대한 열이 포함된 결제 제공업체(예: Stripe)의 CSV 파일을 가져온다고 가정합니다.
해당 열을 Tridens에서 기대하는 필드와 정렬하기 위해 Payment Mapper를 만듭니다.
사용 가능한 탭 개요
Import Mappers 아래의 각 탭은 동일한 필드를 허용합니다.
1. Payment Mappers
외부 결제 시스템의 원시 거래 데이터를 가져오는 데 사용됩니다.
2. Direct Debit Mappers
은행 또는 PSP의 자동이체 주문 또는 위임 데이터를 매핑합니다.
3. Event Mappers
평가 또는 과금 로직에 영향을 주는 이벤트(예: 사용 이벤트, 트리거)를 가져옵니다.
4. Bank Mappers
가져온 은행 명세서 또는 조정 파일을 통합하는 데 사용됩니다.
모범 사례
Info “Tip” - 코드와 접두사에 일관된 명명 규칙을 사용합니다. - 프로덕션 사용 전에 항상 샌드박스 환경에서 매핑 파일을 테스트합니다. - 데이터 소스(CSV, TSV 등)에 따라 올바른 구분자를 선택합니다. - 매핑 템플릿과 테스트 파일의 백업 사본을 보관합니다.
