コンテンツにスキップ

ユーザーの作成と更新(一括)

post

/users/track/bulk

このエンドポイントを使用して、カスタムイベントと購入を記録し、ユーザープロファイル属性を一括で更新します。

このエンドポイントを使用するタイミング

/users/trackエンドポイントと同様に、このエンドポイントを使用してユーザープロファイルを更新できます。このエンドポイントは一括更新に適しています。

  • より大きなリクエスト: 1リクエストあたり最大1,000ユーザーを送信できるため、大規模なバックフィルや同期に必要なリクエスト数を減らせます。
  • 優先順位付け: ピークトラフィック時には、/users/trackへのリクエストが/users/track/bulkへのリクエストよりも優先されます。

オンボーディング中に多数のユーザープロファイルをバックフィルする場合や、日次同期の一部として大量のプロファイルを同期する場合に、このエンドポイントを使用してください。

よくある質問

このエンドポイントと/users/trackのどちらを使用すべきですか?

ユースケースに応じて、両方のエンドポイントを使い分けてください。

  • 大規模なバックフィルや同期には、/users/track/bulkを使用します。
  • リアルタイムのユースケースには、/users/trackを使用します。

/users/track/bulkで使用できる識別子は何ですか?

各リクエストオブジェクトに、external_id、braze_id、user_alias、email、またはphoneのいずれかを含めてください。

1回のリクエストに属性、イベント、購入を含めることはできますか?

はい。アカウントの合計リクエストオブジェクト制限の範囲内で、属性、イベント、購入を任意に組み合わせて含めることができます。

OpenAPIドキュメントをダウンロードして、スキーマの検証に使用できます。方法については、OpenAPIスキーマを使用したリクエスト検証を参照してください。

New Stuff!