プッシュタスクのチャンネル設定

最終更新 2026/10/05

1.機能概要

エンゲージモジュールは現在、Webhook チャネル、通知、クライアントチャンネル、サードパーティプラットフォームチャンネル（WeChat、KakaoTalk、Douyin）の4つのリーチ方法に対応しています。Webhook チャネルを使って企業が独自に構築したチャンネルプラットフォームと連携することも、AEエンゲージモジュールにプリセットされた通知チャンネルをそのまま使って、一般的なアプリプッシュプラットフォームの機能を接続することもできます。また、AE SDKと連携してクライアントチャンネルを接続し、アプリ内でのリアルタイムなリーチを実現することもできます。サードパーティプラットフォームでは、WeChatミニプログラムのサブスクリプションメッセージ、KakaoTalk Brand Message、Douyinのレコメンドページゲームカードの接続に対応しており、これらのプラットフォームでのメッセージプッシュをより簡単かつスピーディーに行えます。

2. チャンネル新規作成

2.1 Webhook チャネル

チャンネル設定ページ（エンゲージ設定 > チャンネル設定）では、チャンネル新規作成と既存チャンネルの管理を行えます。管理操作には、テスト送信、チャンネルのオン/オフ、編集/削除などがあります。

2.1.1 チャンネル新規作成

右上の +チャンネル新規作成 をクリックすると、Webhookチャネルの作成ページに進みます。

• チャンネル名：Webhook チャネルの名前
• URL：プッシュメッセージを受信するインターフェースのアドレス。同じURLアドレスに複数のチャンネルを設定できます。
• カスタムリクエストヘッダー：オンにすると、このURLに送信されるリクエストにカスタムリクエストヘッダーを追加できます。
• 送信ID：メッセージプッシュの対象ユーザーの主体ID。ユーザープロパティのうち数値型と文字列型のプロパティを選択できます。ターゲットユーザー数の推定時には、送信IDが空のユーザーは除外されます（たとえば、ゲーム内メールシステムでメッセージを受け取る対象ユーザーのIDはキャラクターID、SMSシステムでメッセージを受け取る対象ユーザーのIDは携帯番号などです）
• チャネル認証：チャネル認証をオンにしてシークレットキーを入力すると、不正な呼び出しを防ぎ、チャンネルのセキュリティを高めることができます
• リーチファネル設定：リーチファネルをオンにすると、ファネルステップに関連付けるイベント名を設定できます。これにより、このチャンネルを使用するエンゲージタスクのデータ詳細ページで、設定したステップのコンバージョンデータを確認できます
• コンテンツテンプレート：このチャンネルからユーザーに送信する具体的な内容のテンプレートをカスタマイズできます。テキスト、動的テキスト、数値、単一選択ドロップダウン、日付、時間、オブジェクトグループなどのフィールドタイプに対応しています。たとえば、メール送信チャンネルでは、オブジェクトグループタイプでアイテムの内容（例：アイテムIDとアイテム数）を設定できます
• カスタムパラメータ：チャンネルの要件に応じて任意で追加します。このパラメータはパススルーされます

Webhook チャネルの接続に関するその他の技術情報については、Webhook チャネル接続ドキュメントを参照してください。

2.1.2 既存チャンネルの管理

• テスト送信

チャンネルの作成に成功すると、デフォルトではオフの状態になります。まずテスト送信を行い、送信に成功することを確認してからチャンネルをオンにしてください。

操作にある紙飛行機ボタンをクリックするとテスト送信のポップアップが開くので、選択したチャンネルの設定に応じて関連情報を入力します。

その後、「リクエスト確認」をクリックして、システムが生成したリクエスト構造体が今回のテスト送信の要件を満たしているかをプレビューできます。問題がなければ 「確認して送信」 をクリックしてテスト送信を行います。

操作に成功すると、今回のテスト送信が成功したかどうかのステータスもシステムから返されるため、ステータスの確認や問題の調査に役立ちます。

• チャンネルのオン/オフ

  • Webhook チャネルをオンにすると、新しいタスクの作成時にこのチャンネルを選択できます。
  • Webhook チャネルをオフにすると、新しいタスクの作成時に選択できなくなり（ドロップダウンに表示されません）、実行中のタスクは自動的に終了し、承認中のタスクは自動的に撤回されます。

• 編集/削除

チャンネルは無効にした後でなければ、編集や削除の操作を行えません。

2.2 通知

現在プリセットされているメッセージプッシュプラットフォームはFCM、JPush、APNsです。必要に応じて対応するアプリを接続できます。

2.2.1 FCM

• チャンネル名：FCMチャンネルの名前。重複した名前は使用できません
• 送信ID：プッシュ対象ユーザーのFCM registration tokenフィールド。先にFCM registration tokenをユーザープロパティとして送信しておく必要があります
• サーバーキー：このプロジェクトのFCMサーバー秘密鍵ファイルをアップロードする必要があります。キーの取得方法については、FCMサーバーキー取得ガイドを参照してください
• リーチファネル設定：リーチファネルをオンにすると、ファネルステップに関連付けるイベント名を設定できます。これにより、このチャンネルを使用するエンゲージタスクのデータ詳細ページで、設定したステップのコンバージョンデータを確認できます
• パススルーパラメータ：必要に応じてパススルーパラメータを追加できます。パススルーパラメータは主に、業務側アプリの内部業務ロジックの処理や特殊な表示要件に使用されます。

FCM registration tokenフィールドの送信とリーチファネル設定については、メッセージプッシュ技術接続ドキュメントのFCMプッシュに関する技術接続の内容を参照してください。

2.2.2 JPush

• チャンネル名：カスタムチャンネルの名前。重複した名前は使用できません
• 送信ID：プッシュ対象ユーザーのJPush IDフィールド。先にJPush IDをユーザープロパティとして送信しておく必要があります
• AppKey & MasterSecret：JPushプラットフォームで登録したアプリのAppKeyとMasterSecret。JPushアプリのパラメータの取得方法については、JPushアプリ接続パラメータ取得ガイドを参照してください
• リーチファネル設定：リーチファネルをオンにすると、ファネルステップに関連付けるイベント名を設定できます。これにより、このチャンネルを使用するエンゲージタスクのデータ詳細ページで、設定したステップのコンバージョンデータを確認できます
• パススルーパラメータ：必要に応じてパススルーパラメータを追加できます。パススルーパラメータは主に、業務側アプリの内部業務ロジックの処理や特殊な表示要件に使用されます。

JPush IDフィールドの送信とリーチファネル設定については、メッセージプッシュ技術接続ドキュメントのJPushプッシュに関する技術接続の内容を参照してください。

2.2.3 APNs

• チャンネル名：カスタムチャンネルの名前。重複した名前は使用できません
• 送信ID：プッシュ対象ユーザーのAPNs Tokenフィールド。先にAPNs Tokenをユーザープロパティとして送信しておく必要があります
• 証明書タイプ：P12またはP8証明書を選択して設定できます。また、本番環境または開発環境も選択できます。APNs証明書の取得方法については、APNsプッシュ証明書設定ガイドを参照してください
• リーチファネル設定：リーチファネルをオンにすると、ファネルステップに関連付けるイベント名を設定できます。これにより、このチャンネルを使用するエンゲージタスクのデータ詳細ページで、設定したステップのコンバージョンデータを確認できます
• パススルーパラメータ：必要に応じてパススルーパラメータを追加できます。パススルーパラメータは主に、業務側アプリの内部業務ロジックの処理や特殊な表示要件に使用されます。

APNs Tokenフィールドの送信とリーチファネル設定については、メッセージプッシュ技術接続ドキュメントのAPNsプッシュに関する技術接続の内容を参照してください。

2.2.4 テスト送信

チャンネルの設定が完了したら、チャンネル設定でチャンネルの効果を直接テストできます。対象チャンネルの操作列にあるテスト送信ボタン（下図を参照）をクリックすると、チャンネルのテストに進みます。

テスト送信時には、効果を確認するためのテストアカウントに対応する送信ID（AEのユーザーシーケンス機能でテストアカウントの送信IDを照会できます）と、メッセージ通知のタイトル、内容などの情報を入力する必要があります。ポップアップはチャンネルによって少し異なります。いずれもジャンプモード（アプリケーションを開く / Webページを開く / 指定したページを開く）とメッセージ大サイズ画像のURLを設定できます。APNsとJPushチャンネルでは送信環境（本番環境 / 開発環境）も選択する必要があり、JPushチャンネルにはさらに右側アイコンのアドレスがあります。FCMとAPNsチャンネルのポップアップには、チャンネルに設定されたパススルーパラメータも表示されます。「確認して送信」をクリックすると、スマートフォンで対応する効果を確認できます。

2.3 クライアントチャンネル

クライアントチャンネルを使用するには、プロジェクト単位のクライアントチャンネル機能を有効にし、AE SDKと連携する必要があります。この機能を試すには、担当のカスタマーマネージャーにお問い合わせください。

2.3.1 チャンネル新規作成

右上の +チャンネル新規作成 をクリックすると、クライアントチャンネルの作成ページに進みます。

• チャンネル名：クライアントチャンネルの名前
• メッセージタイプ：クライアントはプッシュメッセージを受信した後、「メッセージタイプ」によってクライアント内のさまざまなトリガーシナリオを区別します。たとえば、「ポップアップ」のメッセージタイプはpopupとして定義できます
• 送信ID：メッセージを受信する対象ユーザーのIDタイプ。選択肢はユーザープロパティ（数値型と文字列型のプロパティ）またはクライアントパラメータです。ターゲットユーザー数の推定時には、送信IDが空のユーザーは除外されます（たとえば、ゲーム内メールシステムでメッセージを受け取る対象ユーザーのIDはキャラクターID、SMSシステムでメッセージを受け取る対象ユーザーのIDは携帯番号などです）
• リーチファネル設定：リーチファネルをオンにすると、ファネルステップに関連付けるイベント名を設定できます。これにより、このチャンネルを使用するエンゲージタスクのデータ詳細ページで、設定したステップのコンバージョンデータを確認できます。リーチファネルのイベントには、エンゲージタスクから配信されるパススルーパラメータを含める必要があります。詳しくは、クライアントトリガー型SDK接続ドキュメントのリーチファネル設定を参照してください。
• コンテンツテンプレート：このチャンネルからユーザーに送信する具体的な内容のテンプレートをカスタマイズできます。テキスト、動的テキスト、数値、単一選択ドロップダウン、日付、時間、オブジェクトグループなどのフィールドタイプに対応しています。たとえば、メール送信チャンネルでは、オブジェクトグループタイプでアイテムの内容（例：アイテムIDとアイテム数）を設定できます
• カスタムパラメータ：チャンネルの要件に応じて任意で追加します。このパラメータはパススルーされます

2.3.2 テスト送信

チャンネルの作成に成功すると、デフォルトではオフの状態になります。まずテスト送信を行い、チャンネルの疎通を確認してからオンにして使用してください。操作列の紙飛行機ボタンをクリックすると、テスト送信のフローに進みます。

クライアントトリガー型のテスト送信にはテストデバイスが必要です。テストデバイスリストでテストデバイスを選択または追加し、デバッグモードをオンにしてください。デバッグモードをオンにする方法については、クライアントトリガー型接続ドキュメントを参照してください。

プッシュ内容を確認したら、送信をクリックしてテストを開始し、プログレスバーで進捗を確認します。プログレスバーに「データの取得タスク」の成功が表示されたら、デバイスでプッシュ内容を受信したかどうかを確認できます。今回のテスト送信の結果がシステムから返されるため、ステータスの確認や問題の調査に役立ちます。

2.3.3 チャンネルの管理

• チャンネルの有効化/無効化

  • クライアントチャンネルをオンにすると、新しいタスクの作成時にこのチャンネルを選択できます。
  • クライアントチャンネルをオフにすると、新しいタスクの作成時に選択できなくなり（ドロップダウンに表示されません）、実行中のタスクは自動的に終了し、承認中のタスクは自動的に撤回されます。

• チャンネルの編集/削除

チャンネルは無効にした後でなければ、編集や削除の操作を行えません。

クライアントチャンネルの接続に関する詳細は、クライアントチャンネル接続ドキュメントを参照してください。

2.4 サードパーティ（WeChat/KakaoTalk/Douyin）

「サードパーティ」タブには現在、「Wechat - サブスクリプションメッセージ」「KakaoTalk - Brand Message」「Douyin - レコメンドページゲームカード」の3種類のチャンネルがあります。プロジェクトで必要なチャンネルが表示されない場合や、その他のサードパーティチャンネルと連携する必要がある場合は、担当のカスタマーマネージャーにお問い合わせください。

ベストプラクティスについては、WeChatミニゲームのメッセージ連携のベストプラクティスを参照してください。

2.4.1 アプリ認証

「アプリ認証」の入口から、WeChatミニプログラムのテンプレート情報の呼び出しを認可できます。

同じミニプログラムでは同じAPP IDとAPP Secretを共有するため、認可は1回だけで済みます。

【サードパーティ】チャンネルの右上にある「アプリ認証」をクリックすると、図のような画面に進みます。アプリケーション名を自由に設定し、ミニプログラムに対応するAPP IDとAPP Secretを入力します。

入力した情報が正しければ、「接続して保存」をクリックすると、システムに接続成功と表示されます。

AppIDとAppSecretが有効と検証されると、access_tokenが2時間ごとに自動更新され、アプリの接続状態が正常に保たれます。

2.4.2 チャンネル新規作成

サードパーティ - WeChatサブスクリプションメッセージの右上にある +チャンネル新規作成 をクリックすると、サブスクリプションメッセージチャンネルの作成ページに移動します。

• チャンネル名：WeChatサブスクリプションメッセージチャンネルの名前

• 認可アプリを選択：チャンネルの新規作成時に、接続状態が正常なアプリを選択できます。チャンネルはそのアプリのWeChatバックエンドで利用可能なすべてのサブスクリプションメッセージテンプレートを自動で取得します。アプリの接続状態が異常な場合は、まず「アプリ認証」で確認してください。

• ユーザー Open ID：メッセージを受信するターゲットユーザーのIDタイプです。ユーザープロパティ（数値および文字列タイプのプロパティ）を選択できます。ターゲットユーザーの推定人数を算出する際、送信IDが空のユーザーは除外されます。Open IDの送信方法は技術ドキュメントを参照してください。

• ミニプログラム設定：サブスクリプションメッセージのカードをクリックしたときにミニプログラムの画面へ遷移するための設定です。これはチャンネルの粒度のパラメータ設定で、タスクの粒度で上書きできます。

  • ミニアプリタイプ：formal（正式版）、developer（開発版）、trial（体験版）があり、入力しない場合はデフォルトで正式版になります
  • ミニアプリ言語：zh_CN（中国語(簡体字)）、en_US（英語）、zh_HK（中国語(繁体字)）、zh_TW（中国語(繁体字)）があり、入力しない場合はデフォルトでzh_CN（中国語(簡体字)）になります
  • 転送先URL：テンプレートのカードをクリックした後の遷移先ページで、このミニプログラム内のページに限られます。パラメータ付きに対応しています（例：index?foo=bar）。このフィールドを入力しない場合、テンプレートからの遷移はありません。

• コンテンツテンプレート：

WeChatミニゲームのプッシュメッセージは、ユーザーがサブスクライブに成功した後でなければ、ユーザーのWeChatメッセージに送信できません。

アプリの認可と接続に成功すると、チャンネルはtokenを使って、WeChatバックエンドでユーザーが作成したすべてのサブスクリプションメッセージテンプレートを一度に取得できます。必要なテンプレートをチャンネルに保存し、エンゲージタスクで選択して使用できます。

【テンプレートリストを更新】ボタンをクリックすると、APIを再度呼び出してチャンネルの新しいテンプレートリストを取得できます。

• コンテンツテンプレートのパラメータが対応するすべてのタイプ

テンプレート内のパラメータのデータタイプはWeChatのメッセージテンプレートで定義されており、取得したパラメータタイプが優先されます。

WeChatのデータタイプ	タイプの説明	Mapping エンゲージの入力方法	説明	パラメータ仕様の制限
thing.DATA	事物	動的テキスト	漢字、数字、英字、記号の組み合わせが可能	20
number.DATA	数字	数値	数字のみ、小数可	32
letter.DATA	英字	テキスト	英字のみ	32
time.DATA	時間	時間	24時間制の時刻形式（年月日の追加に対応）。時間帯の入力に対応し、2つの時点は「~」記号でつなぎます
date.DATA	日付	日付	年月日形式（24時間制の時刻の追加に対応）。時間帯の入力に対応し、2つの時点は「~」記号でつなぎます
symbol.DATA	記号	動的テキスト	記号のみ	5
amount.DATA	金額	テキスト	通貨記号1つ＋10桁以内の数字のみ。小数可、末尾に「元」を付けられます	11
phone_number.DATA	電話番号	テキスト	数字、記号	17
car_number.DATA	ナンバープレート	テキスト	8文字以内。最初と最後の文字は漢字可、それ以外は英字または数字	8
name.DATA	名前	テキスト	10文字以内の漢字のみ、または20文字以内の英字・記号のみ	漢字 10 英字 20
phrase.DATA	漢字	テキスト	5文字以内の漢字	5

2.4.3 チャンネルの管理

• チャンネルの有効化/無効化

  • チャンネルスイッチをONにした後、アプリの接続に成功していればチャンネルは「接続正常」状態になり、そうでなければ「接続異常」状態になります。
  • チャンネルを有効にすると、新しいタスクを作成するときにそのチャンネルを選択できます。
  • チャンネルを無効にすると、新しいタスクの作成時に選択できなくなり（ドロップダウンに表示されません）、実行中のタスクは自動的に終了し、承認中のタスクは自動的に撤回されます。

• チャンネルの編集/削除

チャンネルは無効にした後でなければ、編集や削除の操作を行えません。

WeChatサブスクリプションメッセージチャンネルの接続に関する技術ドキュメントについては、WeChatサブスクリプションメッセージチャンネル接続ドキュメントを参照してください。

3. 頻度制御

頻度制御とは、複数のエンゲージタスクが同じリーチチャンネルを使用する場合に、1人のユーザーが一定期間内に同種のチャンネルから受け取るプッシュの最大回数を制限する仕組みです。各リーチ方法の頻度制御ルールを設定し、エンゲージタスクの作成時に頻度制御をオンにすることで、ユーザーへの過度な通知を減らすことができます。

「エンゲージ設定 > 頻度制御管理」に進み、チャンネルのスイッチをオンにすると編集状態になります。必要に応じて対象チャンネルの頻度制御ルールを編集できます（Webhook チャネルはチャンネルごとに設定）。複数の条件はAND関係です。編集が完了したら、右上の「保存」をクリックします。現在対応している周期の単位は、分、時間、日、週です。