このページはAIにより自動翻訳されており、不正確な内容が含まれている可能性があります。翻訳の誤りを報告するには、ページ右側の目次の下にあるフィードバックをご利用ください。

エクスポートエンドポイント

このエンドポイントコレクションを使用すると、KPI、アプリセッション、ユーザー、セグメント、キャンペーン、キャンバスに関するさまざまなレベルの詳細にアクセスしてエクスポートできます。パラメーターとリクエストボディを作成する際には、Brazeインスタンス、APIキー、およびAPI識別子を確認してください。

前提条件

始める前に、以下が揃っていることを確認してください。

要件	説明
Braze REST APIキー	呼び出す予定のエンドポイントに対する適切なエクスポート権限を持つREST APIキー。APIキーは特定のエンドポイントにスコープされ、作成後に権限を変更することはできません。詳しくは、REST APIキーを参照してください。
関連する識別子	エクスポートしたいデータの識別子（キャンペーンID、セグメントID、キャンバスIDなど）。これらはBrazeダッシュボードで確認できます。完全なリストについては、API識別子タイプを参照してください。
クラウドストレージの認証情報（オプション）	大規模なデータセットをエクスポートする場合は、Amazon S3、Microsoft Azure Blob Storage、またはGoogle Cloud Storageバケットを接続して、エクスポートファイルをストレージに直接書き込むことができます。

注

APIアクセス権を持たないマーケターやチームメンバーの場合は、組織内の開発者または管理者と連携して、APIキーと連携の設定を行ってください。

エクスポートできるデータ

以下の表は、エクスポートAPIで利用できるデータカテゴリをまとめたものです。

カテゴリ	含まれる内容	APIリファレンス
キャンペーン	パフォーマンス分析、キャンペーンの詳細、キャンペーン一覧、送信分析	キャンペーンエンドポイント
キャンバス	データシリーズ分析、分析サマリー、キャンバスの詳細、キャンバス一覧	キャンバスエンドポイント
セグメント	セグメント一覧、セグメント分析、セグメントの詳細	セグメントエンドポイント
ユーザーデータ	識別子またはセグメント別の完全なユーザープロファイル、グローバルコントロールグループ別のユーザー	ユーザーデータエンドポイント
KPIs	デイリーアクティブユーザー、マンスリーアクティブユーザー、デイリー新規ユーザー、日付別のアンインストール数	KPIエンドポイント
セッション	アプリセッションの時系列データ	セッションエンドポイント
カスタムイベント	イベント名、イベント一覧、時系列のイベント分析	カスタムイベントエンドポイント
カスタム属性	属性名	カスタム属性エンドポイント
購入	時系列の収益データ、プロダクトIDの一覧、購入回数	購入エンドポイント

エクスポートデータの配信方法

APIエクスポートは、ダッシュボードからダウンロードするCSVファイルとは異なり、JSON形式でデータを返します。配信方法は、クラウドストレージが接続されているかどうかによって異なります。

クラウドストレージなしの場合： BrazeはエクスポートファイルをBraze独自のS3バケットに書き込み、APIレスポンスに一時的なダウンロードURLを含めます。このURLは4時間後に有効期限が切れます。エクスポートはJSONファイルを含む圧縮アーカイブ（output_formatパラメーターに応じてZIPまたはGZIP）としてパッケージ化されます。JSONファイルの各行は1つのデータオブジェクトを表します。
クラウドストレージが接続されている場合： Brazeはエクスポートファイルを設定済みのバケットに直接書き込みます。APIレスポンスにはダウンロードURLは含まれません。ファイルは独自の保持ポリシーに従い、大規模なエクスポートではより信頼性が高い傾向があります。

ヒント

「クラウドストレージ」とは、ご自身のストレージバケット（Amazon S3、Microsoft Azure Blob Storage、Google Cloud Storageなど）を指します。パートナー連携 > テクノロジーパートナーでバケットを接続すると、Brazeがエクスポートファイルを直接書き込めるようになります。

エクスポートの配信とトラブルシューティングの詳細については、エクスポートのトラブルシューティングを参照してください。