# トリガー式のエンゲージタスク作成（リアルタイムプッシュ）

トリガー式プッシュは、リアルタイムに収集されたユーザーの行動や状態データに基づいて、指定された行動ルール条件を満たすユーザーに対して自動的にコンテンツ（プッシュ）を送信するプッシュ仕様です。定期的なエンゲージプッシュまたは手動プッシュと比較し、トリガー式プッシュでは固定された送信時間を設定する必要がありません。代わりに、ユーザーの行動シーケンスと組み合わせて適切なコンテンツを送信します。

使用例：ユーザーが5回連続で失敗した後、即座にパワーアップのパックを送信すること；ユーザーが期間限定のギフトパックを解除したが、一定時間内にそのギフトパックを購入しなかった場合、報酬がすぐ終了することを通知し早めの購入を促すことなど。

全体の処理フロー：

# 通知のタイミングを設定

現在、3つのトリガータイプがサポートされています：

【A完了】、【A完了後にBも完了】、【A完了後にB未完了】

# 1.1 プッシュルール

# A完了後

ユーザーが指定された行動イベントを完了した後、プッシュ通知が送信されます。

例えば、レベルが50に達すると、50レベル限定のギフトパックを通知します。

トリガールール

選択された開始と終了時間内で、毎日、毎週、毎月または周期的にAイベントを完了した後にプッシュ通知を送信することをサポートします。
例：5:00->翌日の5:00が1日、水曜日の5:00->次の水曜日の5:00が1週間などのカスタム設定ができます。
条件を満たした後すぐにプッシュ通知するか、x分/時間/日後に遅延してプッシュ通知することもサポートしています。最大30日まで遅延させることが可能です。

# A完了後にBも完了

ユーザーが指定されたイベントAを完了し、一定期間内にイベントBも完了した場合にプッシュ通知を送信します。例えば、ユーザーがストアを閲覧し、30分以内に商品の購入を1回完了した場合には、アイテム消費イベントへのガイドなどがトリガーされることができます。

トリガールール

選択された開始時間と終了時間の間にイベントAを完了し、その後の一定期間内にイベントBを完了してからプッシュ通知することをサポートします。
イベントAとBの間隔はx分/時/日でサポートされており、最大30日までの間隔が可能です。
複数のイベントルールをサポートし、イベントのプロパティにフィルタリングもサポートしています。
条件が満たされると即座にプッシュ通知することをサポートします。
条件が満たされるとx分/時/日遅延してプッシュ通知することをサポートし、最大30日までの遅延が可能です。

# A完了後にB未完了

ユーザーが指定されたイベントAを完了し、一定期間内にイベントBを完了しなかった場合にプッシュ通知を送信します。例えば、ユーザーが特定の期限付きギフトパックを入手してから5時間以内に購入を完了しなかった場合、ギフトパックの有効期限が近づいていることを通知するプッシュメッセージが発生します。

トリガールール

選択された期間内で、毎日、毎週、毎月または周期的にイベントAを完了し、一定の期間内でイベントBが未完了となった後にプッシュ通知を送信します。
イベントAとBの間隔はx分/時間/日をサポートしており、最大30日までの間隔が可能です。
条件を満たした場合に即座にプッシュ通知するか、条件を満たした後x分/時間/日遅延してプッシュ通知することがサポートされています。最大30日までの遅延が可能です。

# 1.2 プッシュコントロール

# タイムアウト制御

データの送信には遅延やネットなどの不安定な状況があるため、「トリガー計算完了時間」と「ユーザー行動発生時間」には一定の時間差があります。遅延を最小限に抑えるため、タイムアウト制御をオンにすることができます。タイムアウト制御をオンにすると、タイムアウトしたプッシュ通知は自動的にキャンセルされます。

例：ユーザーの戦闘終了時間は9:50であり、ネット不安定が発生したため、実際の送信時間は10:00です。タイムアウト制御を有効にし、5分間に設定すると、このユーザーに対しては送信されません。

# 頻度制御

頻度制御設定には、周期範囲内で1名のユーザーが受け取ることができるプッシュ通知の最大回数が制限できます。

例えば、ゲーム内のキャンペーンは週ごとに更新されるものであり、ユーザーに対して週に50回以上戦闘を完了させ、関連するアイテムを送信することを期待しています。ただし、そのユーザーが1回だけ送信を受け取るようにしたい場合は、「毎週」の累計完了を選択し、頻度制御で1人あたり最大1回の送信しか受け取らないよう設定できます。

# ターゲットユーザー選択

現在のバージョンでは、ターゲットユーザーをカスタマイズし、すべてのユーザーを選択するトリガーベースのエンゲージタスクがサポートされています。

カスタムコホート：カスタムトリガーユーザー条件を設定します。V4.2バージョンでは、直接報告されたユーザープロパティのみを使用して条件フィルタリングが可能です。
すべてのユーザー：トリガー後は、より詳細なフィルタリングは行われず、トリガー条件に合致する場合にプッシュ通知が実行されます。

# トリガー式タスクはA/Bテストに対応

トリガーベースのタスクはA/Bテストをサポートしており、詳細についてはA/Bテストを参照してください。

# FAQ

トリガー式のエンゲージタスクには数量の上限がありますか？

現在、単一プロジェクトで最大30個のトリガー式エンゲージタスクをサポートしています。数量の上限を増やす必要がある場合は、弊社スタッフに連絡して変更することができます。

トリガールールの開始時間と終了時間はどういう意味ですか？

開始時間と終了時間は、Aイベントの完了時に制約される時間範囲を指します。つまり、開始時間と終了時間内に発生しないAイベントは、トリガールールの計算に含まれないと理解できます。

エンゲージタスク周期を手動で選択できない理由は何ですか？

タスク周期は、タスクの開始および終了時刻を表します。トリガー式では、遅延送信設定が存在するため、タスク周期 = Aイベントの開始および終了時刻 + AおよびB間隔 + 遅延送信時間となります。これらは自動的に計算されるものです。

遅延送信やイベントAおよびイベントB間隔期間の「日」は自然日ですか、それとも24時間ですか？

日、時間、分はすべて秒単位で計算します。1日の遅延送信は24時間または86400秒の遅延を意味します。

なぜトリガー式エンゲージではターゲットユーザーを選択する際にプロパティしかサポートされていませんか？

現在、プロパティのみがサポートされており、物理的なプロパティのみが対象ユーザーとして選択可能です。将来的にはより多くのターゲットユーザーを絞り込む機能が追加される予定です。