Skip to content

REST API

コネクテッドコンテンツを使用して、送信時に外部 REST API からメッセージに直接データを取得できます。これにより、自社サーバー、サードパーティサービス、または公開されている任意の API エンドポイントからのリアルタイム情報でメッセージをパーソナライズできます。

仕組み

コネクテッドコンテンツは、指定した URL に HTTP リクエストを送信し、レスポンスを保存して Liquid で参照できるようにします。メッセージに {% connected_content %} タグを追加すると、メッセージ送信時に Braze がエンドポイントを呼び出します。

1
2

{% connected_content https://api.example.com/user/{{${user_id}}}/recommendations :save recs %}
We think you'll love {{recs.top_pick}}!

コネクテッドコンテンツは GET リクエストと POST リクエストをサポートしています。Braze はサーバーが2秒以内に応答することを要求するため、エンドポイントは低レイテンシーになるよう設計してください。

一般的なユースケース

認証

Braze はコネクテッドコンテンツリクエストに対して、ベーシック認証、トークン認証、OAuth をサポートしています。認証情報は Braze ダッシュボードの設定 > コネクテッドコンテンツに安全に保存し、API 呼び出しで参照できます。

詳細については、コネクテッドコンテンツ API 呼び出しの作成を参照してください。

エラー処理

エンドポイントがエラーを返すかタイムアウトした場合、Braze はコネクテッドコンテンツのレスポンスの代わりに空の文字列をレンダリングします。保存された変数が null かどうかを確認することで失敗を検出し、条件に応じてメッセージを中止したりフォールバックコンテンツを表示したりできます。

詳細については、コネクテッドコンテンツの中止を参照してください。

パフォーマンスに関する考慮事項

Braze は大量のメッセージを配信するため、サーバーは数千の同時接続を処理できる必要があります。適切な場所でキャッシュを使用し、外部エンドポイントの過負荷を避けるためにメッセージにレート制限を設定してください。

コネクテッドコンテンツの完全なリファレンスについては、コネクテッドコンテンツを参照してください。
New Stuff!