構成テンプレート
構成テンプレートは業務機能のパラメータを保持するためのものです。構成項目の下に1つまたは複数の構成テンプレートを作成できます。使用シーンの例：
- アプリ内の内部メッセージの構成項目に、内部メッセージ機能のパラメータを保持するテンプレートを作成する
- イベントセンターの構成で、複数のテンプレートを作成してさまざまな形式のイベントを保持する
- 同じ業務機能でもプラットフォームによって機能パラメータの設計が異なる場合に、複数のテンプレートを作成して複数プラットフォームへの構成配信に対応する
- サイト系の構成項目で複数のリソース枠を接続する場合に、複数のテンプレートでそれぞれのリソース枠に対応する
構成テンプレートの作成
- テンプレート名：テンプレートの表示名です。たとえば、お知らせ、連続ログイン報酬、累計チャージ報酬など。
- テンプレートID：テンプレートの一意の識別子で、構成の取得に使用します。テンプレートIDは構成戦略とともに配信され、戦略が属する具体的なサブ機能を識別するために使用されます。作成後、テンプレートIDは変更できません。技術的な接続の詳細は構成センター技術接続ドキュメントを参照してください。
- 備考（任意）：テンプレートを使用する業務シナリオなどを記述します。
テンプレートパラメータの追加
テンプレートパラメータとは、下流の業務で解析可能な機能パラメータのことです。ゲーム内のお知らせのテンプレートパラメータの例：
| パラメータ名 | タイプ | 必須 | 意味 |
|---|---|---|---|
| title | 文字列 | はい | お知らせのタイトル |
| content | 文字列 | はい | お知らせの内容 |
| begintime | 数値 | はい | お知らせの有効開始時刻 |
| expiretime | 数値 | はい | 有効期間の長さ（単位：秒） |
各構成項目は独立したパラメータの名前空間を持ちます（つまり、構成項目内ではパラメータ名は一意で、異なる構成項目間ではパラメータ名が重複してもかまいません）。構成項目レベルのパラメータは、複数のテンプレートで使用できます。
方法1：新規作成
テンプレートパラメータの編集ページに入り、右側の構成項目のパラメータリストから追加済みのパラメータを直接選択できます。
パラメータを追加する場合は、右上の[+]をクリックして新しいパラメータを作成します。作成後、テンプレートに追加して使用できます。
方法2：JSONファイルをインポートして作成
構成項目のテンプレートパラメータを作成する際、新しい業務モジュールであれば、AEシステムでパラメータを手動で追加できます。一方、既存の業務モジュールで、システム内に整備済みの構成表やjsonファイルがある場合は、jsonファイルをインポートして構成項目のテンプレートを直接作成することもできます。
テンプレート編集ページ右側の「選択可能なパラメーター」欄で、検索ボックスの横にあるアップロードアイコン（ホバー時のヒントは「インポートパラメータ」）をクリックし、解析したいjsonファイルをアップロードします。
インポート方法の選択
- インポートの置換：そのテンプレートで選択済みのすべてのパラメータを自動的に破棄し、jsonファイルから解析した新しいパラメータを改めて選択して、新しいパラメータをシステムに保存します。
- インクリメンタルインポート：そのテンプレートで選択済みのすべてのパラメータを保持し（データ型も既存のパラメータに従います）、jsonファイルから解析した差分の新しいパラメータを追加して、新しいパラメータをシステムに保存します。
注： 新しい空のテンプレートを作成した場合は、インポート時に「インポートの置換」と「インクリメンタルインポート」のどちらを選択しても、選択済みのすべてのパラメータが全量インポートされます。
パラメータタイプの解析ルール
- 空文字列
""、テキスト、または英字の場合、タイプは String になります - true/false を識別した場合、タイプは Boolean になります（注：0、1は数字として識別されます。タイプは変更できます）
- 数字を識別した場合、タイプは Number になります
- 正規表現で日付を識別します
- 正規表現で時間を識別します
[]を識別した場合、タイプはArrayになります- { } を識別した場合、タイプはオブジェクトになります
- インポート時、json 形式としては識別しません
- インポート時、「列挙」タイプの識別には対応していません
- なお、配列内のネスト階層の識別ルールも上記と同じです
解析に失敗する主な原因：
- JSON形式のエラー：JSONデータは、括弧の正しい対応や引用符の使い方など、厳密な構文ルールに従う必要があります。JSON形式に誤りがあると、データを正しく解析できません。
- データ型のエラー：JSONの値は、文字列、数値、ブール値、配列、オブジェクト、nullなどの有効なデータ型である必要があります。データ型が正しくないと、データを正しく解析できません。
- JSONデータの欠落：JSONデータで一部のプロパティが欠落していると、そのデータを正しく解析できない場合があります。
- エンコードの問題：JSONデータでは、特に非ASCII文字が含まれる場合に、エンコードの問題が発生することがあります。JSONデータを解析する際は、同じ文字エンコードを使用してください。
テンプレートパラメータ構造の確認
- パラメータ名：JSONから解析されたパラメータの名前です
- 表示名：デフォルトではパラメータ名と同じ値が表示名として入力されます。自由に変更できます。
- パラメータタイプ：推定・解析によって得られたものです。自由に変更できます。
- 必須：デフォルトでは、解析されたすべてのパラメータが必須になります。自由に変更できます。
- ヒント：デフォルトは空欄です
パラメータを保存してテンプレートを編集
インポートに成功すると「テンプレート管理」ページに移動し、テンプレートを再編集して保存できます。
パラメータ管理の詳細は構成パラメータ管理を参照してください。
テンプレートのテスト送信
テンプレートパラメータの準備が完了し、構成項目に取得方法をバインドしたら、構成テンプレートのテスト送信を行い、接続チャンネルとコンテンツ形式に問題がないかを確認できます。
チャンネルの接続方法の詳細は構成センターのチャンネル設定を参照してください。
テストの目的と範囲
構成センターが提供するゲームコンテンツの構成は、通常、厳格なテストプロセスを経てから公開する必要があります。そのため、構成センターでは構成テンプレートのテスト送信、戦略のテスト送信に対応しています。テンプレートと戦略のテストには、オンライン、一時停止、オフラインの全プロセスのテストが含まれます。チャンネルのテストはテンプレートのテストと一緒に行えます（チャンネルを構成項目にバインドして初めて、具体的な送信内容が生じるため）
テンプレートのテストタイミング
| テスト | 状態の内訳 | 説明 |
|---|---|---|
テンプレート | 有効・無効のどちらでもテスト可能 |
|
テンプレートのテスト方法
Webhookテンプレートのテスト
テストの流れ：
操作リストで「テスト送信」をクリックすると、テスト送信画面に移動します。
「本番環境」または「テスト環境」を選択してテストできます（テスト環境は、テストアドレスを追加した場合にのみ選択できます）。
テストアカウントを選択します
- 本番環境：テストアカウントは必須、テスト環境：テストアカウントは任意
- テストアカウントは「ホワイトリスト」から選択します。複数選択に対応しており、最大10個まで選択できます。
クライアントテンプレートのテスト
テストの流れ：
操作リストで「テスト送信」をクリックすると、テスト送信画面に移動します。
テストデバイス側でdebugモードをオンにする必要があります。
テストデバイスを選択し、テンプレートパラメータの内容を入力したら、「確認して送信」をクリックしてテストタスクを開始します。
「オンライン」のみをテストすることも、「オンライン - オフライン」または「オンライン-一時停止-オフライン」の全リンクをテストすることもできます。
クライアントテンプレートのテスト送信内容
クライアントの構成項目テンプレートをテストすると、システムが「テスト戦略」を自動的に生成し、テスト完了後にこの戦略を自動的にオフライン化します。
| モジュール | テスト送信での処理 | 備考 |
|---|---|---|
| チャンネル | テスト送信にはチャンネルカスタムパラメータが含まれます | |
| 目標環境条件 | テンプレートのテスト送信では環境条件をテストしません | |
| ターゲットユーザー | デフォルトですべてのユーザーをテスト | |
| 構成内容 | テンプレートパラメータの内容（パラメータの構造と値） テスト送信時にユーザーが入力した内容で配信され、必須項目の検証があります | |
| オンライン時間 | テスト送信をクリックした時間 | |
| オフライン時間 | デフォルトは永続 | ページでテストの完了またはキャンセルをクリックすると、テスト戦略が削除されます |
テンプレートの状態管理
構成テンプレートはデフォルトで無効の状態です。テストを行い、構成テンプレートが正常に使用できることを確認したら、テンプレートを有効化できます。
有効化すると、構成戦略の作成権限を持つユーザーが「マイ戦略」で具体的なコンテンツ戦略を作成してリリースできるようになります。
戦略を安定して運用するため、テンプレートパラメータを追加・変更する場合は、先にテンプレートを無効にしてから編集操作を行う必要があります。テンプレートを無効にすると戦略の状態に影響する場合は、無効にすることはできません。
テンプレートのJSON構造
構成済みのテンプレートパラメータの構造がオンライン業務のパラメータ構造の要件を満たしているかを検証・確認しやすいように、テンプレート編集ページとテンプレートリストページのどちらでも、テンプレートのJSON構造を確認でき、ダウンロードもできます。