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トリガーキャンペーンがトランザクション目的の場合は、ユーザーがトランザクションを行うたびにキャンペーンを受信できるよう、遅延をゼロ分に設定してください。
