기본 설정

"기본 설정"은 기본 제어 세그먼트의 기본 구성 섹션으로, 세그먼트 생성, 이름 지정 및 필수 설정 매개변수를 다룹니다. 이 가이드는 세그먼트 생성 프로세스, 세그먼트 이름 지정 모범 사례 및 불변성 고려 사항을 포함한 세그먼트 키 구성에 대해 다룹니다.

개요

기본 설정은 기본 제어 세그먼트를 생성하고 구성하는 곳입니다. 트래픽 제어 시스템의 기반을 설정하는 것으로 생각하세요. 여기서 세그먼트의 수명 주기 동안 세그먼트를 식별하고 관리할 필수 매개변수를 정의합니다.

구성할 항목

• 세그먼트 이름: 쉽게 관리할 수 있는 사람이 읽을 수 있는 이름
• 세그먼트 키: NetFUNNEL 에이전트가 사용하는 고유 식별자

세그먼트 생성

첫 번째 세그먼트 생성하기

새 기본 제어 세그먼트를 생성하려면:

1. 세그먼트 목록 액세스: NetFUNNEL 콘솔의 세그먼트 관리 섹션으로 이동
2. 생성 버튼 클릭: 세그먼트 목록의 오른쪽 상단에 있는 '+' 버튼 클릭
3. 제어 유형 선택: 제어 유형에서 '기본 제어' 선택
4. 구성 진행: 자세한 구성을 위해 다음 단계로 진행

세그먼트 생성 프로세스

세그먼트 생성 프로세스는 간단하며 필수 설정 단계를 안내하도록 설계되었습니다. 기본 제어를 선택하면 세그먼트의 기본 설정을 정의할 수 있는 구성 화면으로 이동합니다.

구성 프로세스

세그먼트 이름

목록에서 쉽게 구분할 수 있는 이름을 입력하세요. 이것은 순전히 관리 편의를 위한 것입니다.

이름 지정 모범 사례

추천:

• "이커머스 체크아웃"
• "제품 페이지 트래픽 제어"
• "사용자 등록 대기열"
• "고트래픽 이벤트 제어"

비추천:

• "세그먼트 1", "테스트", "새 세그먼트"
• 세그먼트가 실제로 무엇을 제어하는지 알려주지 않는 이름
• 너무 일반적이거나 임시적인 이름

팁: 여러 환경이 있는 경우 이름에 포함하세요:

• "이커머스 체크아웃 - 프로덕션"
• "이커머스 체크아웃 - 스테이징"

세그먼트 키

세그먼트 키는 자동으로 할당되며 생성 시까지 수정 가능합니다 (생성 후 수정 불가).

세그먼트 키란 무엇인가요?

세그먼트 키는 세그먼트의 신분증 역할을 합니다. NetFUNNEL 에이전트는 NetFUNNEL 서버와 통신할 때, 이 키를 사용하여 세그먼트를 지정합니다.

세그먼트 키 작동 방식

웹/JavaScript 통합:

nfStart({
    projectKey: "your_project_key",
    segmentKey: "your_segment_key"    // 이것이 세그먼트 키입니다
}, function(response) {
    // 응답 처리
    if (response.status === 'Success') {
        // 사용자가 진행할 수 있음
    }
});

Android 통합:

Netfunnel.nfStart(
    projectKey = "your_project_key",
    segmentKey = "your_segment_key",  // 이것이 세그먼트 키입니다
    callback = yourCallback,
    activity = this
)

iOS 통합:

Netfunnel.shared.nfStart(
    projectKey: "your_project_key",
    segmentKey: "your_segment_key"  // 이것이 세그먼트 키입니다
)

세그먼트 키 특징

• 고유 식별자: 모든 세그먼트에서 중복 허용 안 됨
• API 사용: API 호출 (트래픽 제어 코드)에 사용됨
• 불변: 세그먼트 생성 후 변경 불가
• 대소문자 구분: 세그먼트 키는 대소문자를 구분합니다

기본 키 형식

새 세그먼트를 생성하면 NetFUNNEL이 다음 형식으로 키를 자동 생성합니다:

segKey_XXXX

여기서 XXXX는 4자리 난수입니다 (예: segKey_1234, segKey_5678).

세그먼트 키 사용자 정의

생성 중에 세그먼트 키를 사용자 정의하면 더 의미 있게 만들 수 있습니다:

좋은 사용자 정의 키:

• "checkout_main"
• "product_pages"
• "user_registration"
• "event_traffic"

이런 키는 피하세요:

• 공백이나 특수 문자가 있는 키
• 너무 길거나 너무 짧은 키
• 명명 규칙을 따르지 않는 키

세그먼트 키를 변경할 수 없는 이유

중요: 세그먼트 키 불변성

세그먼트가 생성되면 키는 수정할 수 없습니다.

키 변경의 문제점:

1. 코드 종속성: 애플리케이션 코드가 세그먼트 키를 참조함
2. 통합 중단: 키를 변경하면 기존 통합이 중단됨
3. 예기치 않은 동작: 에이전트가 작동을 중지하거나 예기치 않게 동작할 수 있음

세그먼트 키를 변경해야 하는 경우:

1. 새 세그먼트 생성: 원하는 키로 새 세그먼트 생성
2. 코드 업데이트: 새 세그먼트 키를 사용하도록 애플리케이션 코드 업데이트
3. 철저한 테스트: 새 통합이 올바르게 작동하는지 확인
4. 기존 세그먼트 삭제: 새 세그먼트가 작동하는 것을 확인한 후에만 기존 세그먼트 삭제

모범 사례

항상 세그먼트 키를 신중하게 설정하세요. 명명 규칙과 전체 트래픽 제어 전략을 함께 고려하세요.