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