API トリガー配信
API トリガーキャンペーン（サーバートリガーキャンペーン）は、より高度なトランザクションユースケースに最適です。BrazeのAPIトリガーキャンペーンを使用すると、マーケターはキャンペーンのコピー、多変量テスト、再適格性ルールをBrazeダッシュボード内で管理しながら、自社のサーバーやシステムからコンテンツの配信をトリガーできます。メッセージをトリガーするAPIリクエストには、リアルタイムでメッセージにテンプレート化される追加データを含めることもできます。
API トリガーキャンペーンの設定
APIトリガーキャンペーンの設定にはいくつかのステップが必要です。まず、マルチチャネルまたは単一チャネルのキャンペーン（多変量テスト付き）を新規作成します。
次に、スケジュールされた通知の場合と同様にコピーと通知を設定し、API-Triggered Delivery を選択します。サーバーからこれらのキャンペーンをトリガーする方法の詳細については、APIトリガーキャンペーンの送信の記事をご覧ください。
APIトリガーと送信の間の遅延を削減する
トリガーエンドポイントを呼び出した後、メッセージの送信に予想以上の時間がかかる場合は、トリガー時にユーザープロファイルが準備できているかどうかを確認してください。
デフォルトでは、/campaigns/trigger/sendで send_to_existing_only は true に設定されています。Brazeは既存のユーザーにのみ送信し、その呼び出しで新規プロファイルを作成しません。ユーザーの作成または更新と送信を同じリクエストで行うには、send_to_existing_only を false に設定し、各受信者に attributes オブジェクトを含めてください。
メールキャンペーンの場合は、attributes 内に email（およびその他の必須配信フィールド）も含めてください。送信をトリガーした時点でプロファイルにメールアドレスがない場合、Brazeはプロファイルデータの到着を待ちながら約2時間リトライを行います。同じ呼び出しに email を含めることで、この遅延を回避できます。
リクエストパラメーター、例、リトライ動作の詳細については、APIトリガーキャンペーンの送信および受信者オブジェクトを参照してください。
このガイダンスはAPIトリガーキャンペーン（/campaigns/trigger/send）に適用されます。トランザクションメールエンドポイントは異なるリクエスト形式（recipient、単数形）を使用し、send_to_existing_only をサポートしていません。トランザクション送信でインラインでユーザーを作成するには、代わりに recipient オブジェクトに attributes を渡してください。
APIリクエストに含まれるテンプレートコンテンツの使用
メッセージのトリガーに加えて、APIリクエストにコンテンツを含めて trigger_properties オブジェクト内でメッセージにテンプレート化することもできます。このコンテンツはメッセージ本文で参照できます。trigger_properties とメッセージコピーでは、Liquidタグごとに中括弧を2つずつ使用してください。例: {{api_trigger_properties.${your_property}}}。{ や } の余分な追加は、APIトリガーのパーソナライゼーション失敗の一般的な原因です。
追加のコンテキストについては、以下のソーシャル通知の例をご覧ください。
APIトリガーキャンペーンの再適格性
ユーザーがAPIトリガーキャンペーンを受信する回数は、再適格性設定を使用して制限できます。これにより、APIトリガーが何回発火されたかに関係なく、ユーザーはキャンペーンを1回のみ、または指定された時間枠内で1回のみ受信します。
たとえば、APIトリガーキャンペーンを使用して、ユーザーが最近閲覧したアイテムに関するキャンペーンを送信するとします。この場合、各アイテムに対してAPIトリガーを発火しながらも、閲覧したアイテム数に関係なく、1日に最大1通のメッセージを送信するようにキャンペーンを制限できます。一方、APIトリガーキャンペーンがトランザクション目的の場合は、遅延をゼロ分に設定して、ユーザーがトランザクションを行うたびにキャンペーンを受信できるようにする必要があります。
