구성 템플릿
구성 템플릿은 비즈니스 기능 파라미터를 담는 데 사용합니다. 구성 항목 아래에 구성 템플릿을 하나 이상 생성할 수 있으며, 사용 시나리오는 다음과 같습니다:
- 앱 내 사이트 내 메시지 구성 항목에 사이트 내 메시지 기능 파라미터를 담는 템플릿 생성
- 이벤트 센터 구성에서 여러 템플릿을 생성하여 서로 다른 이벤트 형식을 담기
- 같은 비즈니스 기능이라도 플랫폼마다 기능 파라미터 설계가 다른 경우, 여러 템플릿을 생성하여 여러 플랫폼의 구성 배포에 대응
- 사이트형 구성 항목에서 여러 리소스 슬롯을 연동하는 경우, 여러 템플릿으로 서로 다른 리소스 슬롯을 담기
구성 템플릿 생성
- 템플릿 이름: 템플릿의 표시 이름입니다. 예: 공지, 연속 로그인 보상, 누적 충전 보상 등
- 템플릿 ID: 템플릿의 고유 식별자로, 구성을 가져올 때 사용합니다. 템플릿 ID는 구성 전략과 함께 배포되며, 전략이 속한 구체적인 하위 기능을 식별하는 데 사용됩니다. 생성한 후에는 템플릿 ID를 수정할 수 없습니다. 기술 연동에 대한 자세한 내용은 구성 센터 기술 연동 문서를 참고하십시오.
- 비고(선택 사항): 템플릿을 사용하는 비즈니스 시나리오 등을 설명합니다.
템플릿 파라미터 추가
템플릿 파라미터는 다운스트림 비즈니스에서 해석할 수 있는 기능 파라미터입니다. 게임 내 공지의 템플릿 파라미터 예시는 다음과 같습니다:
| 파라미터 이름 | 타입 | 필수 여부 | 의미 |
|---|---|---|---|
| title | 문자열 | 예 | 공지 제목 |
| content | 문자열 | 예 | 공지 내용 |
| begintime | 숫자 | 예 | 공지 적용 시간 |
| expiretime | 숫자 | 예 | 만료 기간, 단위: 초 |
각 구성 항목은 독립된 파라미터 네임스페이스를 가집니다(i.e. 구성 항목 안에서 파라미터 이름은 고유하며, 서로 다른 구성 항목에서는 파라미터 이름이 중복될 수 있습니다). 구성 항목 수준의 파라미터는 여러 템플릿에서 사용할 수 있습니다.
방법 1: 새로 만들기
템플릿 파라미터 편집 페이지로 이동하면 오른쪽 구성 항목 파라미터 목록에서 이미 추가한 파라미터를 바로 선택할 수 있습니다.
파라미터를 추가해야 하면 오른쪽 위의 [+]를 클릭하여 파라미터를 새로 만듭니다. 새로 만든 후 템플릿에 추가하여 사용할 수 있습니다.
방법 2: JSON 파일을 가져와 생성
구성 항목 템플릿 파라미터를 생성할 때 새 비즈니스 모듈이라면 AE 시스템에서 파라미터를 수동으로 추가할 수 있습니다. 기존 비즈니스 모듈이고 시스템에 이미 완전한 설정 테이블이나 json 파일이 있다면 json 파일을 가져와 구성 항목 템플릿을 바로 생성할 수도 있습니다.
템플릿 편집 페이지 오른쪽의 선택적 변수 영역에서 검색 상자 옆의 업로드 아이콘(마우스를 올리면 파라미터 가져오기 표시)을 클릭하고 해석할 json 파일을 업로드합니다.
가져오기 방식 선택
- 교체 가져오기: 해당 템플릿에서 선택한 모든 파라미터를 자동으로 폐기하고 json 파일에서 해석한 새 파라미터를 다시 선택하며, 새 파라미터를 시스템에 저장합니다.
- 증분 가져오기: 해당 템플릿에서 선택한 모든 파라미터를 유지하고(데이터 타입도 기존 파라미터를 기준으로 함), json 파일에서 해석한 증분 새 파라미터를 추가하며, 새 파라미터를 시스템에 저장합니다.
참고: 새로 만든 빈 템플릿에 가져오는 경우 교체 가져오기와 증분 가져오기 중 어느 것을 선택하든 선택한 모든 파라미터를 전부 가져옵니다.
파라미터 타입 해석 규칙
- 빈 문자열
"", 텍스트 또는 문자이면 타입은 String입니다 - true/false가 인식되면 타입은 Boolean입니다(참고: 0,1은 숫자로 인식되며 타입을 수정할 수 있습니다)
- 숫자가 인식되면 타입은 Number입니다
- 정규표현식으로 날짜를 인식합니다
- 정규표현식으로 시간을 인식합니다
[]형식이 인식되면 타입은 배열입니다- { } 형식이 인식되면 타입은 객체입니다
- 가져올 때 json 형식으로는 아직 인식하지 않습니다
- 가져올 때 열거형 타입은 인식하지 않습니다
- 또한 배열 아래 중첩 계층의 인식 규칙도 위와 같습니다
해석에 실패하는 원인은 다음과 같을 수 있습니다:
- JSON 형식 오류: JSON 데이터는 올바른 괄호 짝, 따옴표 사용 등 엄격한 문법 규칙을 따라야 합니다. JSON 형식이 잘못되면 데이터를 올바르게 해석할 수 없습니다.
- 데이터 타입 오류: JSON의 값은 문자열, 숫자, 불리언, 배열, 객체 또는 null 등 유효한 데이터 타입이어야 합니다. 데이터 타입이 올바르지 않으면 데이터를 올바르게 해석할 수 없습니다.
- JSON 데이터 누락: JSON 데이터에서 일부 속성이 누락되면 해당 데이터를 올바르게 해석하지 못할 수 있습니다.
- 인코딩 문제: JSON 데이터에서 인코딩 문제가 발생할 수 있으며, 특히 데이터에 비 ASCII 문자가 포함된 경우에 그렇습니다. JSON 데이터를 해석할 때 같은 문자 인코딩을 사용해야 합니다.
템플릿 파라미터 구조 확인
- 파라미터 이름: JSON에서 해석한 파라미터 이름입니다
- 표시 이름: 기본적으로 같은 파라미터 이름을 표시 이름으로 입력하며, 직접 수정할 수 있습니다.
- 파라미터 타입: 추론하여 해석한 결과이며, 직접 수정할 수 있습니다.
- 필수 여부: 기본적으로 해석된 모든 파라미터의 필수 여부가 예이며, 직접 수정할 수 있습니다.
- 힌트 문구: 기본값은 비어 있음
파라미터 저장 및 템플릿 편집
가져오기에 성공하면 템플릿 관리 페이지로 이동하며, 템플릿을 다시 편집하고 저장할 수 있습니다.
파라미터 관리에 대한 자세한 내용은 구성 파라미터 관리를 참고하십시오.
템플릿 테스트 발송
템플릿 파라미터를 준비하고 구성 항목에 가져오기 방식을 연결한 후 구성 템플릿의 테스트 발송을 진행하여 연동 채널과 콘텐츠 형식이 정상인지 확인할 수 있습니다.
채널 연동 방식에 대한 자세한 내용은 구성 센터 채널 설정을 참고하십시오.
테스트 목표와 범위
구성 센터는 게임 콘텐츠 구성을 제공하므로 일반적으로 엄격한 테스트 절차를 거친 후 외부에 공개해야 합니다. 따라서 구성 센터는 구성 템플릿 테스트 발송, 전략 테스트 발송을 지원합니다. 그중 템플릿 및 전략 테스트에는 활성화, 일시 중지, 비활성화 전체 흐름 테스트가 포함되며, 채널 테스트는 템플릿 테스트와 함께 진행할 수 있습니다(채널이 구성 항목에 연결되어야 구체적인 발송 내용이 생깁니다)
템플릿 테스트 시점
| 테스트 | 상태 세분화 | 설명 |
|---|---|---|
템플릿 | 활성화, 비활성화 상태 모두 테스트 가능 |
|
템플릿 테스트 방법
Webhook 템플릿 테스트
테스트 절차:
작업 목록에서 테스트 발송을 클릭하면 테스트 발송 화면으로 이동합니다.
운영 환경 또는 테스트 환경을 선택하여 테스트할 수 있습니다(테스트 주소를 추가한 경우에만 테스트 환경을 클릭하여 사용할 수 있습니다).
테스트 계정 선택
- 운영 환경: 테스트 계정 필수, 테스트 환경: 테스트 계정 선택 사항
- 테스트 계정은 화이트리스트에서 선택하며, 다중 선택을 지원하고 최대 10개까지 선택할 수 있습니다.
클라이언트 템플릿 테스트
테스트 절차:
작업 목록에서 테스트 발송을 클릭하면 테스트 발송 화면으로 이동합니다.
테스트 디바이스에서 debug 모드를 켜야 합니다.
테스트 디바이스를 선택하고 템플릿 파라미터 내용을 입력한 후 발송 확인을 클릭하면 테스트 작업이 시작됩니다.
활성화만 테스트하거나, 활성화 - 비활성화 또는 활성화-일시 중지-비활성화의 전체 흐름을 테스트하도록 선택할 수 있습니다.
클라이언트 템플릿 테스트 발송 내용
클라이언트 구성 항목 템플릿을 테스트하면 시스템이 테스트 전략을 자동으로 생성하고, 테스트가 끝나면 이 전략을 자동으로 비활성화합니다.
| 모듈 | 테스트 발송 처리 | 비고 |
|---|---|---|
| 채널 | 테스트 발송 시 채널 커스텀 파라미터를 포함 | |
| 대상 환경 조건 | 템플릿 테스트 발송에서는 환경 조건을테스트하지 않음 | |
| 타겟 유저 | 기본적으로 모든 유저를 테스트 | |
| 구성 내용 | 템플릿 파라미터 내용(파라미터 구조와 값) 테스트 발송 시 유저가 입력한 내용대로 배포하며, 필수 항목 검증이 있음 | |
| 활성화 시간 | 테스트 발송을 클릭한 시간 | |
| 비활성화 시간 | 기본값은 영구 | 페이지에서 테스트 완료 또는 테스트 취소를 클릭하면 테스트 전략을 삭제 |
템플릿 상태 관리
구성 템플릿은 기본적으로 비활성화 상태이며, 테스트를 통해 구성 템플릿을 정상적으로 사용할 수 있음을 확인한 후 템플릿을 활성화할 수 있습니다.
활성화하면 구성 전략 생성 권한이 있는 유저가 내 전략에서 구체적인 콘텐츠 전략을 생성하고 게시할 수 있습니다.
전략이 안정적으로 실행되도록 템플릿 파라미터를 추가하거나 수정하려면 먼저 템플릿을 비활성화한 후 편집해야 합니다. 템플릿을 비활성화하면 전략 상태에 영향을 주는 경우에는 비활성화할 수 없습니다.
템플릿 JSON 구조
구성을 마친 템플릿 파라미터 구조가 운영 중인 비즈니스 파라미터 구조의 요구 사항에 맞는지 쉽게 검증하고 확인할 수 있도록, 템플릿 편집 페이지와 템플릿 목록 페이지에서 모두 템플릿 JSON 구조체를 조회하고 다운로드할 수 있습니다.