Skip to content

APIトリガー配信でキャンペーンメッセージを送る

post

/campaigns/trigger/send

このエンドポイントを使用して、API トリガー配信を介して、指定したユーザーに即時の1回限りのメッセージを送信します。

APIトリガー配信により、Brazeダッシュボード内にメッセージコンテンツを収容しながら、APIを介してメッセージの送信タイミングと送信先を指定できる。

セグメントをターゲットにしている場合、リクエストの記録は開発者コンソール に保存されます。このエンドポイントを使用してメッセージを送信するには、API トリガーキャンペーンを構築する際にキャンペーン ID を作成しておく必要があります。

前提条件

このエンドポイントを使用するには、campaigns.trigger.send 権限を持つ API キーを生成する必要があります。

レート制限

Request body

リクエストパラメーター

パラメーター required データ型 説明
campaign_id 必須 string キャンペーン識別子を参照してください。
send_id オプション string 送信識別子を参照してください。
trigger_properties オプション オブジェクト トリガープロパティを参照してください。このリクエストのすべてのユーザーに適用されるパーソナライゼーションキーバリューペア。
broadcast オプション ブール値 キャンペーンやキャンバスがターゲットとするセグメント全体にメッセージを送信する場合は、broadcast を true に設定する必要がある。このパラメータはデフォルトで false です (2017年8月31日現在)。

broadcast をtrueに設定すると、recipients リストを含めることはできない。ただし、broadcast: true 、意図せずこのフラグを設定してしまうと、予想以上に多くの読者にメッセージを送ってしまう可能性があるため、設定には注意が必要である。
audience オプション 接続された観客オブジェクト 接続オーディエンスを参照してください。
recipients オプション 配列 受信者オブジェクトを参照してください。

send_to_existing_onlyfalse の場合、属性オブジェクトが含まれていなければなりません。

recipients が提供されず、broadcast がtrueに設定されている場合、メッセージはキャンペーンがターゲットとしているセグメント全体に送信される。
attachments オプション 配列 broadcast が true に設定されている場合、attachments リストを含めることはできません。
  • 受信者配列には最大50個のオブジェクトを含めることができ、各オブジェクトには1つの external_user_id 文字列と trigger_properties オブジェクトが含まれます。
  • send_to_existing_onlytrue の場合、Braze は既存ユーザーにのみメッセージを送信します。ただし、このフラグは、ユーザーのエイリアスでは使えません。
  • send_to_existing_onlyfalse の場合、属性が含まれていなければなりません。Brazeは、メッセージを送信する前に、id と属性を持つユーザーを作成する。

ユーザーのサブスクリプショングループのステータスは、attributes オブジェクト内にsubscription_groups パラメータを含めることで更新できる。詳細については、ユーザー属性オブジェクトを参照してください。

リクエスト例

応答の詳細

メッセージ送信エンドポイントのレスポンスには、メッセージのディスパッチに参照できるように、メッセージのdispatch_id が含まれる。dispatch_id はメッセージディスパッチの ID で、Braze から送信される各送信に固有の ID です。このエンドポイントを使用すると、バッチ処理されたユーザーセット全体に対して1つの dispatch_id を受け取ります。dispatch_id の詳細については、ディスパッチ ID の動作に関するドキュメントを参照してください。

送信エンドポイントを作成する

キャンペーンで属性オブジェクトを使う

Brazeには、attributes というメッセージングオブジェクトがあり、APIトリガーのキャンペーンを送る前に、ユーザーの属性や値を追加、作成、更新することができる。この API 呼び出しとして campaign/trigger/send エンドポイントを使用すると、キャンペーンを処理して送信する前に、ユーザー属性オブジェクトが処理されます。これにより、レースコンディションに起因する問題が発生するリスクを最小限に抑えることができる。

「このページはどの程度役に立ちましたか?」
New Stuff!