구성 센터 채널 설정
AE 운영 모듈의 구성 센터 기능을 사용하면 버전을 다시 출시하지 않고도 앱의 외관과 앱 내 이벤트 콘텐츠를 업데이트할 수 있습니다. 구성 센터는 Webhook 서비스로 구성을 배포하는 방식과 클라이언트 SDK로 구성을 가져오는 방식의 두 가지 구성 가져오기 방식을 제공하며, 이 섹션에서는 두 가져오기 방식의 채널 설정 방법을 설명합니다.
- Webhook으로 가져오기: 비교적 가벼운 REST API 개발로 연동하며, Webhook 주소를 제공하여 구성 정보를 받고 적절히 처리한 후 다운스트림 시스템에 전달합니다.
- 클라이언트 SDK로 가져오기: AE RemoteConfig SDK를 통합하여 클라이언트에서 구성을 가져옵니다.
이 문서에서는 두 가져오기 방식의 채널 설정을 설명합니다. 채널을 만든 후 구성 항목에 연결하고, 구성 템플릿 테스트 발송으로 채널이 정상적으로 작동하는지 검증할 수 있습니다.
Webhook 채널
진입 경로: 구성 센터 - 채널 관리 - Webhook 채널
채널 이름
Webhook 채널의 이름입니다.
Url
메시지 푸시를 받는 API 주소입니다.
운영 환경 API 주소는 구성 배포에 사용됩니다.
테스트 환경 API 주소는 전략의 테스트 발송 검증에 사용됩니다.
사용자 지정 헤더
활성화하면 해당 URL로 보내는 요청에 사용자 지정 요청 헤더(헤더 이름과 헤더 값)를 추가하여 Authorization, API Key 또는 비즈니스 식별자를 전달할 수 있습니다. 최대 10개까지 추가할 수 있습니다.
채널 검증
채널 검증을 활성화하고 키를 입력하면 불법 호출을 막고 채널의 보안을 높일 수 있습니다.
유저 파라미터
유저 단위 구성 배포를 진행할 때 AE 시스템은 타겟 조건을 충족하는 유저의 #user_id와 채널의 유저 파라미터를 다운스트림 서버로 푸시합니다. 채널에 다운스트림에서 파싱할 수 있는 id 필드를 유저 파라미터로 추가하십시오(예: #account_id). 유저 파라미터는 유저 단위 구성 배포 시에만 사용되며, 대상 환경을 선택하여 배포할 때는 유저 속성 데이터가 제공되지 않습니다.
여러 다운스트림 시스템과 연동하는 경우 특정 유저 파라미터를 다운스트림 시스템 연동 식별자 필드로 지정할 수 있습니다(예: 여러 게임 서버에 구성을 배포할 때 서버 ID를 시스템 연동 식별자 필드로 지정). 지정하면 구성 배포가 필드 값에 따라 분할 처리되므로 Webhook 중계 서비스는 대상 시스템으로만 전달하면 됩니다. 구체적인 배포 형식은 Webhook 구성 연동 문서를 참고하십시오.
환경 파라미터
환경 파라미터는 구성 전략의 대상 환경을 지정하는 데 사용됩니다. 예를 들어 멀티 서버 게임에서 일부 서버에만 특정 이벤트 구성을 공개하거나, 특정 시스템 언어의 유저에게 해당 언어의 사이트 내 메시지를 배포하는 경우처럼 구성 배포 대상이 구체적인 타겟 유저군이 아닌 환경 조건일 때 사용합니다.
위 두 시나리오에서는 "서버"와 "언어"를 환경 파라미터로 추가할 수 있으며, 추가한 후에는 구성 전략에서 환경 조건을 설정하는 데 사용할 수 있습니다. 환경 값은 그대로 다운스트림 서버로 전달됩니다.
환경 파라미터 타입으로 "텍스트"를 선택하면 환경 파라미터의 후보값을 지정할 수 있습니다. 후보값은 두 가지 방식으로 지정할 수 있습니다.
- 아래 입력란에서 직접 정의할 수 있습니다. 예: 운영 체제 값 Android, iOS
- 설정 테이블에서 후보값을 가져오도록 선택할 수도 있습니다(이 경우 설정 테이블의 옵션만 환경 값으로 선택할 수 있으며, 설정 테이블 정보를 최신 상태로 유지하려면 설정 테이블 API로 설정 테이블을 업데이트할 수 있습니다).
- 마찬가지로 여러 다운스트림 시스템과 연동하는 경우 특정 환경 파라미터를 다운스트림 시스템 연동 식별자 필드로 설정할 수 있습니다. 설정하면 전략을 일시 중지하거나 비활성화할 때 배포 메시지에 전체 시스템 연동 식별자 값 리스트도 포함되므로 다운스트림 Webhook 서비스에서 전달 처리를 하기 쉽습니다. 구체적인 배포 형식은 Webhook 구성 연동 문서를 참고하십시오.
클라이언트 채널
진입 경로: 구성 센터 - 채널 관리 - 클라이언트 채널
채널 이름
클라이언트 채널의 이름
유저 파라미터
구성과 함께 클라이언트로 배포하려는 유저 속성 정보를 유저 파라미터로 정의합니다. 클라이언트가 구성을 요청하면 해당 유저의 파라미터 정보를 실시간 계산하여 구성과 함께 배포합니다.
환경 파라미터
단말 디바이스가 요청할 때 함께 보낼 수 있는 요청 파라미터입니다. V4.4에서는 ThinkingData SDK가 자동으로 수집할 수 있는 파라미터만 환경 파라미터로 지원합니다. 지원 항목은 다음과 같습니다.
| 파라미터 이름 | 파라미터 표시 이름 | 파라미터 타입 | 설명 |
|---|---|---|---|
| #app_version | 앱 버전 | 텍스트 | APP의 버전 |
| #bundle_id | 앱 패키지 이름 | 텍스트 | APP 패키지 이름 또는 프로세스 이름 |
| #device_model | 디바이스 모델 | 텍스트 | 유저 디바이스의 모델. 예: iPhone 8 등 |
| #device_type | 디바이스 타입 | 텍스트 | 유저 디바이스의 타입. 예: iPad, iPhone 등 |
| #manufacturer | 제조사 | 텍스트 | 유저 디바이스의 제조사. 예: Apple, vivo 등 |
| #network_type | 네트워크 타입 | 텍스트 | 이벤트 발생 시의 네트워크 상태. 예: WIFI, 3G, 4G 등 |
| #os | 운영 체제 | 텍스트 | 예: Android, iOS 등 |
| #os_version | OS 버전 | 텍스트 | 예: iOS 11.2.2, Android 8.0.0 등 |
| #simulator | 에뮬레이터 여부 | 불리언 | 디바이스가 에뮬레이터인지 여부 true/false |
| #system_language | 시스템 언어 | 텍스트 | 유저 디바이스의 시스템 언어(ISO 639-1, 즉 영문 소문자 두 자리). 예: zh, en 등 |
| #zone_offset | 시간대 오프셋 | 숫자 | 데이터 시간과 UTC 시간의 차이(시간 단위) |
| #device_id | 디바이스 ID | 텍스트 | 유저의 디바이스 ID. iOS는 유저의 IDFV 또는 UUID, Android는 androidID를 사용 |