構成センターのチャンネル設定
AEのエンゲージモジュールに構成センター機能が追加され、バージョンを再リリースすることなく、アプリの外観やアプリ内イベントの内容を更新できるようになりました。構成センターでは、Webhookサービスによる構成の配信と、クライアントSDKによる構成の取得の2つの構成取得方式を提供しています。この章では、2つの取得方式それぞれのチャンネルの設定方法について説明します。
- Webhookによる取得：比較的軽量なREST APIで開発・連携し、Webhookアドレスを提供して構成情報を取得し、適合処理を行った後にダウンストリームシステムに引き渡します。
- クライアントSDKによる取得：AE RemoteConfig SDKを統合し、クライアントで構成を取得します。
このドキュメントでは、2つの取得方式それぞれのチャンネル設定について説明します。チャンネルの作成が完了したら、構成項目にバインドし、構成テンプレートのテスト送信でチャンネルが有効かどうかを検証できます。
Webhook チャネル
入口：構成センター - チャンネル管理 - Webhook チャネル
チャンネル名
Webhook チャネルの名前です。
Url
メッセージプッシュを受信するインターフェースのアドレスです。
本番環境のインターフェースアドレスは、構成の配信に使用します。
テスト環境のインターフェースアドレスは、戦略のテスト送信による検証に使用します。
カスタムリクエストヘッダー
有効にすると、このURLに送信されるリクエストにカスタムリクエストヘッダー（ヘッダー名とヘッダー値）を追加して、Authorization、APIキー、またはビジネス識別子を渡すことができます。最大10個まで追加できます。
チャネル認証
チャネル認証を有効にしてシークレットキーを入力すると、不正な呼び出しを防ぎ、チャンネルのセキュリティを高めることができます。
ユーザーパラメータ
ユーザーレベルの構成配信を行う場合、AEシステムはターゲット条件を満たすユーザーの#user_idとチャンネルのユーザーパラメータをダウンストリームのサーバーにプッシュします。チャンネルにダウンストリームで解析可能なIDフィールドをユーザーパラメータとして追加してください（例：#account_id）。ユーザーパラメータは「ユーザーレベル構成」の配信時にのみ使用され、ターゲット環境を選択して配信する場合はユーザープロパティのデータは提供されません。
複数のダウンストリームシステムと連携する場合は、いずれかのユーザーパラメータをダウンストリームシステムドッキングIDフィールドとして指定できます（たとえば、複数のゲームサーバーに構成を配信する場合、サーバーIDをシステムドッキングIDフィールドとして指定します）。指定すると、構成の配信はフィールド値ごとに分割して処理されるため、Webhook中継サービスは対象システムへの転送のみを行えば済みます。具体的な配信形式はWebhook構成接続ドキュメントを参照してください。
環境パラメータ
環境パラメータは、構成戦略のターゲット環境を指定するために使用します。たとえば、マルチサーバーのゲームで一部のサーバーに対してあるイベントの構成を公開する場合や、あるシステム言語のユーザーに対してその言語の内部メッセージを配信する場合など、構成配信の対象が具体的なターゲットユーザーグループではなく環境条件である場合に使用します。
上記の2つのシナリオでは、「サーバー」と「言語」を環境パラメータとして追加できます。追加すると、構成戦略で環境条件の設定に使用できます。環境値はそのままダウンストリームのサーバーにパススルーで配信されます。
環境パラメータのタイプとして「文字列」を選択した場合は、環境パラメータに候補値を指定できます。候補値は次の2つの方法で指定できます：
- 下の入力ボックスで直接定義できます。たとえば、OSの値としてAndroid、iOSを定義します
- 構成表から候補値を取得することもできます（この場合、構成表の選択肢のみを環境値として選択できます。構成表の情報を最新に保つため、構成表APIを使って構成表を更新できます）。
- 同様に、複数のダウンストリームシステムと連携する場合は、いずれかの環境パラメータをダウンストリームシステムドッキングIDフィールドとして設定できます。設定すると、戦略の一時停止やオフライン化を行う際に、配信メッセージにもシステムドッキングIDの値の完全なリストが含まれるため、ダウンストリームの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 | OS | テキスト | 例：Android、iOSなど |
| #os_version | OS バージョン | テキスト | 例：iOS 11.2.2、Android 8.0.0など |
| #simulator | シミュレーターかどうか | ブール値 | デバイスがシミュレーターかどうか（true/false） |
| #system_language | システム言語 | テキスト | ユーザーのデバイスのシステム言語（ISO 639-1、すなわち2文字の小文字アルファベット）。例：zh, enなど |
| #zone_offset | タイムゾーンオフセット | 数値 | データ時刻のUTCからのオフセット時間数 |
| #device_id | デバイスID | テキスト | ユーザーのデバイスID。iOSではユーザーのIDFVまたはUUID、AndroidではandroidIDを取得 |