REST API
コネクテッドコンテンツを使用して、送信時に外部REST APIからメッセージに直接データを取得できます。これにより、自社サーバー、サードパーティサービス、または公開されている任意のAPIエンドポイントからのリアルタイム情報でメッセージをパーソナライズできます。
仕組み
Connected Contentは指定したURLにHTTPリクエストを送信し、そのレスポンスを保存するため、Liquidで参照できます。メッセージに {% connected_content %} タグを追加すると、メッセージの送信時にBrazeがエンドポイントを呼び出します。
{% connected_content https://api.example.com/user/{{${user_id}}}/recommendations :save recs %}
We think you'll love {{recs.top_pick}}!
Connected ContentはGETリクエストとPOSTリクエストをサポートしています。Brazeはサーバーが2秒以内に応答することを求めるため、低レイテンシーになるようにエンドポイントを設計してください。
一般的なユースケース
| ユースケース | 説明 |
|---|---|
| 製品のおすすめ | レコメンデーションエンジンからパーソナライズされたおすすめ製品を取得します |
| リアルタイムの価格または在庫 | 送信時点の最新の価格や在庫レベルを表示します |
| 天気に基づくコンテンツ | 地域の天気データを取得してメッセージングを最適化します |
| ロイヤルティポイント残高 | 最新の報酬やアカウント残高を表示します |
| コンテンツフィード | 最新のブログ投稿、記事、ニュース項目を挿入します |
認証
Brazeは、コネクテッドコンテンツのリクエストで基本認証、トークン認証、OAuthをサポートしています。認証情報はBrazeダッシュボードの設定 > 認証情報管理で安全に保存し、APIコールから参照できます。
詳細については、コネクテッドコンテンツAPIコールの実行を参照してください。
エラー処理
エンドポイントがエラーを返した場合やタイムアウトした場合、BrazeはConnected Contentのレスポンスの代わりに空の文字列をレンダリングします。保存した変数がnullかどうかを確認することで失敗を検出し、条件に応じてメッセージを中止したり、フォールバックコンテンツを表示したりできます。
詳細については、Connected Contentの中止を参照してください。
パフォーマンスに関する考慮事項
Brazeは大量のメッセージを配信するため、サーバーは数千もの同時接続を処理できる必要があります。必要に応じてキャッシュを使用し、メッセージにレート制限を設定して、外部エンドポイントに過剰な負荷がかからないようにしてください。
Connected Contentの完全なリファレンスについては、Connected Contentを参照してください。