基本設定

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

概要

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

構成する項目

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

セグメント作成

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

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

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

セグメント作成プロセス

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

構成プロセス

セグメント名

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

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

何をするか教えてくれる良い名前:

• "Eコマースチェックアウト"
• "製品ページトラフィック制御"
• "ユーザー登録待機列"
• "高トラフィックイベント制御"

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

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

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

• "Eコマースチェックアウト - プロダクション"
• "Eコマースチェックアウト - ステージング"

セグメントキー

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

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

セグメントキーをセグメントの身分証明書と考えてください。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. 既存のセグメントを削除: 新しいセグメントが動作することを確認した後にのみ既存のセグメントを削除

ベストプラクティス

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