このページは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がエクスポートファイルを直接書き込めるようになります。

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