基本設定

「基本設定」は、区間制御セグメントの基本構成セクションで、セグメント作成、名前指定、および必須設定パラメータを扱います。このガイドでは、セグメント作成プロセス、セグメント名指定のベストプラクティス、および不変性の考慮事項を含むセグメントキー構成について説明します。

概要

基本設定は、区間制御セグメントを作成および構成する場所です。トラフィック制御システムの基盤を設定するものと考えてください。ここで、セグメントのライフサイクル全体にわたってセグメントを識別および管理するための必須パラメータを定義します。

構成する項目

• セグメント名: 簡単に管理できる人間が読める名前
• セグメントキー: NetFUNNELエージェントが使用する一意の識別子

セグメント作成

最初のセグメントを作成する

新しい区間制御セグメントを作成するには：

1. セグメントリストにアクセス: NetFUNNELコンソールのセグメント管理セクションに移動
2. 作成ボタンをクリック: セグメントリストの右上にある '+' ボタンをクリック
3. タイプを選択: タイプで**「区間制御」を選択**
4. 構成を進める: 詳細な構成のために次のステップに進む

セグメント作成プロセス

セグメント作成プロセスはシンプルで、必須設定ステップを案内するように設計されています。区間制御を選択すると、セグメントの基本設定を定義できる構成画面に移動します。

構成プロセス

セグメント名

リストから簡単に区別できる名前を入力してください。これは純粋に管理の利便性のためのものです。

名前指定のベストプラクティス

何を制御するかを示す良い名前：

• "チェックアウトプロセス"
• "登録フロー"
• "予約区間"
• "決済処理"

このような混乱を招く名前は避けてください：

• "セグメント1", "テスト", "新しいセグメント"
• セグメントが実際に何を制御するかを示さない名前
• あまりにも一般的または一時的な名前

ヒント: 複数の環境がある場合、名前に含めてください：

• "チェックアウトプロセス - 本番"
• "チェックアウトプロセス - ステージング"

区間制御の名前指定ガイド：

• 制御される多段階プロセスまたは区間に焦点を当てる
• 同時ユーザー数管理の側面を示す（例：「決済フロー」は制御された同時ユーザーを意味する）

セグメントキー

セグメントキーは自動的に割り当てられ、作成時まで変更可能です（作成後は変更不可）。

セグメントキーとは何ですか？

セグメントキーをセグメントの身分証明書として考えてみてください。NetFUNNELエージェントがNetFUNNELサーバーと通信するとき、このキーを使用して特定の区間で同時に何人のユーザーがいるかを制御します。

区間制御の場合: キーは多段階プロセス全体（例：チェックアウト、登録）の間保持され、区間全体が完了したときにのみ返却されます。これは、該当区間内で制御された同時ユーザー数を維持します。

セグメントキーの動作方法

Web/JavaScript統合:

nfStartSection({
    projectKey: "your_project_key",
    segmentKey: "your_segment_key"    // これがセグメントキーです
}, function(response) {
    // 応答処理
    if (response.status === 'Success') {
        // ユーザーが区間に進入した
    }
});

Android統合:

Netfunnel.nfStartSection(
    projectKey = "your_project_key",
    segmentKey = "your_segment_key",  // これがセグメントキーです
    callback = yourCallback,
    activity = this
)

iOS統合:

Netfunnel.shared.nfStartSection(
    projectKey: "your_project_key",
    segmentKey: "your_segment_key"  // これがセグメントキーです
)

セグメントキーの特徴

• 一意の識別子: すべてのセグメントで重複は許可されない
• API使用: **API呼び出し（トラフィック制御コード）**で使用される
• 不変: セグメント作成後は変更不可
• 大文字小文字を区別: セグメントキーは大文字小文字を区別します

デフォルトキー形式

新しいセグメントを作成すると、NetFUNNELが次の形式でキーを自動生成します：

segKey_XXXX

ここで、XXXXは4桁の乱数です（例：segKey_1234, segKey_5678）。

セグメントキーのカスタマイズ

作成中にセグメントキーをカスタマイズして、より意味のあるものにすることができます：

良いカスタムキー：

• "checkout_process"
• "payment_flow"
• "registration_section"
• "booking_control"

このような問題のあるキーは避けてください：

• 空白や特殊文字を含むキー
• 長すぎるまたは短すぎるキー
• 命名規則に従わないキー

セグメントキーを変更できない理由

重要: セグメントキーの不変性

セグメントが作成されると、キーは変更できません。これは既存の統合に問題が発生しないように意図的に設計された決定です。

キー変更の問題点： セグメントキーを作成後に変更できると、既存の統合に問題が発生します：

1. コード依存性: アプリケーションコードがセグメントキーを参照する
2. 統合中断: キーを変更すると既存の統合が中断される
3. 予期しない動作: エージェントが動作を停止したり、予期しない動作をする可能性がある

別のキーが必要な場合の対処方法： セグメントキーを変更する必要がある場合：

1. 新しいセグメントを作成: 希望するキーで新しいセグメントを作成
2. コードを更新: 新しいセグメントキーを使用するようにアプリケーションコードを更新
3. 徹底的にテスト: 新しい統合が正しく動作することを確認
4. 既存セグメントを削除: 新しいセグメントが動作することを確認した後にのみ既存セグメントを削除

ベストプラクティス

作成する前に常にセグメントキーを慎重に計画してください。命名規則と全体的なトラフィック制御戦略にどのように適合するかを考慮してください。