# チャンネル管理
# 機能
エンゲージモジュールはカスタムチャネルとApp Push通知の2つの方法をサポートしています。カスタムチャネルを使用して企業独自のチャネルプラットフォームに連携することもできますし、TEエンゲージモジュールにあらかじめ用意されているアプリプッシュ通知チャネルを直接利用することもできます。これにより、一般的なアプリのプッシュ通知プラットフォームへの機能連携が実現します。
# 使用説明
# 2.1 カスタムチャネル
チャンネル管理ページでは、チャンネルの新規作成や既存チャンネルの管理、テスト送信、チャンネルの有効/無効、編集・削除などの管理操作が可能です。
チャンネルの新規作成
右上にある「チャンネル新規作成」をクリックし、カスタムチャネルを作成するページへ遷移します。
- チャンネル名称：Webhookチャンネルの名称、重複不可
- チャンネルURL：プッシュを受信するインターフェースアドレス、同じURLアドレスに複数のチャンネルを構成できます
- 送信ID：プッシュの送信先ユーザーIDタイプ、ユーザープロパティの数値および文字列タイプのプロパティが選択範囲となり、送信IDが空のユーザーはターゲットユーザーの人数の推定時にフィルタリングされます
- チャンネル鑑定：チャンネル鑑定を開始し、鍵を記入して非法呼び出しを防止し、チャンネルのセキュリティを向上させることができます
- リーチファネル設定：リーチファネルを開始すると、ファネルステップに関連する元イベント名を構成でき、このチャンネルを使用するエンゲージタスクデータの詳細ページで、構成されたステップの変換データを表示できます
- コンテンツテンプレート：ユーザーに送信する具体的なコンテンツのテンプレートをカスタマイズできます。文字列、ダイナミックテキスト、数値、オブジェクトグループなどのフィールドタイプをサポートしています。例えば、メール送信チャンネルでは、オブジェクトグループタイプを使用してアイテムコンテンツ（アイテムIDとアイテム数量）を構成できます
- カスタムパラメーター：チャンネル要件に応じてパラメーターを追加できます
カスタムチャンネル接続に関する詳細は、カスタム接続ドキュメントをご参照ください。
既存チャンネルを管理
- 送信テスト
チャンネルが正常に作成されると既定ではチャネルが無効のため、最初に送信テストを実行後、送信が成功したことを確認してからチャネルを有効にすることができます。
操作の小さな飛行機ボタンをクリックして、テスト送信ポップアップに入ることができます。選択したチャネルの設定に基づいて関連情報を入力してください。
その後、「リクエストを表示」をクリックして、システムが生成したリクエスト構造体が今回のテスト送信要件に合致するかどうかを確認し、問題がなければ「送信」をクリックしてテスト送信を行ってください。
操作が成功した後、システムは送信テストの成功状態を返しますので、状態を確認したり問題を解決するために便利です。
- チャンネルを有効/無効
- Webhook を有効にすると、新しいタスクを作成するときにこのチャネルを使用できます。
- Webhook が閉じられると、新しいタスクを作成するときに選択できなくなり (ドロップダウンには表示されません)、実行中のタスクは自動的に終了し、承認プロセスのタスクは自動的に取り消されます。
- 編集/削除
チャンネルを無効した後にのみ編集または削除できます。
# 2.2 App Push
プリセットされたApp Push通知には、FCM、JPush、およびAPNsがあります。必要に応じて対応するチャネルを設定できます。
FCM
点击右侧配置通道可以开始FCM通道配置。
- チャンネル名称：FCMチャンネルの名称、重複不可
- 送信ID：ユーザープロパティにFCMのtokenなど、メッセージを受信するターゲットユーザーのID種別、選択可能な範囲はユーザープロパティの数値と文字列タイプのプトパティです。ターゲットユーザー人数の予測時には送信IDが空のユーザーはフィルタリングされます
- 秘密鍵：このプロジェクトのFCM秘密鍵.jsonファイルをアップロードする必要があります
- リッチファネル設定：リッチファネルを開始すると、ファネルステップに関連付けられた元イベント名を設定できます。これにより、このチャネルを使用するエンゲージタスクのデータ詳細ページで、設定されたステップの変換データを表示できます
- 引き渡しパラメータ：ニーズに応じて引き渡しパラメータを追加することができます。引き渡しパラメータは、ビジネス側のアプリケーションの内部業務ロジック処理や特別な表示要件に主に使用されます
オーロラ
右側の「チャンネルの設定」をクリックし、オーロラチャンネルの設定を開始します。
- チャンネル名称：Webhookチャンネル名称、重複不可
- 送信ID: プッシュを受信する対象ユーザーの ID タイプ (ユーザープロパティのオーロラ のaurora_id など) 選択範囲は、ユーザープロパティの数値型および文字列型のプロパティです。 IDが空である場合はフィルタリングされます
- AppKey: オーロラPushプラットフォームに登録されたアプリケーションの AppKey
- MasterSecret: オーロラPush プラットフォームに登録されたアプリケーション MasterSecret
- リーチ ファネルの設定: リーチ ファネルを有効にした後、ファネルステップに関連付けられたメタ イベントの名前を構成できます。これにより、このチャネルを使用してエンゲージタスクデータの詳細ページで構成されたステップのコンバージョンデータを表示できます。
- 引き渡しパラメータ：ニーズに応じて引き渡しパラメータを追加することができます。引き渡しパラメータは、ビジネス側のアプリケーションの内部業務ロジック処理や特別な表示要件に主に使用されます。
アプリプッシュチャンネルの構成が完了したら、各アプリプッシュチャンネルで送信テスト、チャンネル有効/無効、編集/削除操作を実行することもできます。
APNs
右側の「チャネル設定」をクリックすると、APNsチャネルの設定が開始されます。
チャネル名：カスタムチャネルの名前、重複はサポートされていません
送信ID：メッセージを受け取る対象のユーザーIDタイプ、例えばAPNsのユーザー識別子IDなど。数値と文字列型プロパティが利用可能であり、送信IDが空のユーザーは予測人数時にフィルタリングされます。
証明書タイプ：P12またはP8証明書を選択することができます。また、本番環境または開発環境を選択することもできます。
リーチファネル設定：到達ファンネルを有効にすると、ファンネルステップに関連付けられた元イベント名を構成できます。これにより、エンゲージタスクデータ詳細ページで構成済みステップの転換データを確認することができます。
引渡しパラメータ：要件に応じて引渡しパラメータを追加することができます。引渡しパラメータは主にアプリケーション内部のビジネスロジック処理や特別な表示要件に使用されます。
App Push通知チャネルの設定が完了した後、各アプリのプッシュ通知チャネルに対して接続性テスト、チャネルのオン/オフ、および編集/削除操作を行うこともできます。
アプリプッシュチャンネル連携の詳細については以下のドキュメントを参照してください。