エクスポートに関するトラブルシューティング
このページでは、CSVワークフローとAPIワークフローの両方におけるエクスポートの一般的なトラブルシューティングシナリオについて説明します。
タブを使用して、デフォルトのBraze S3バケットにエクスポートするか、クラウドストレージパートナーにエクスポートするかを選択してください。
デフォルトのエクスポート送信先としてマークされたストレージパートナーがない場合、Brazeは独自のAmazon S3バケットを使用してエクスポートファイルを保持します。この設定のファイルは一時的なもので、4時間後に期限切れになります。
CSVエクスポート
ダッシュボードからCSVをエクスポートすると、Brazeはログインしているユーザーにダウンロードリンクをメールで送信します。このリンクは、BrazeのS3バケットでホストされているZIPファイルを指しています。ZIP内には、エクスポートを構成する複数の小さなファイルが収められています。
リンクを使用するには、Brazeダッシュボードにログインしている必要があります。また、ファイルは4時間のみ利用可能です。その後、リンクは機能しなくなり、データは削除されます。非常に大規模なエクスポート（500,000ユーザー以上）で繰り返し失敗する場合、エクスポートが失敗する可能性があります。その場合は、エクスポートをより小さなグループやフィールドに分割するか、ストレージパートナーの設定を検討してください。
一般的なエラー
AccessDeniedエラーが表示された場合、ファイルの有効期限がすでに切れているか、準備が完了する前に開こうとした可能性があります。大きなレポートほど生成に時間がかかるため、数分待ってから再試行してください。ExpiredTokenエラーは、4時間の時間枠が経過したことを意味します。エクスポートを再実行して、新しいリンクを生成してください。Looks like the file doesn't exist anymoreというメッセージは、通常、メールは送信されたもののファイルのS3へのアップロードがまだ完了していない場合に表示されます。数分待つと、通常は解決します。- 特定のフィールド（
-、=、+、@など）の先頭にアポストロフィが追加されるのは想定された動作です。たとえば、-1943はCSVでは'-1943になります。Brazeは、スプレッドシートプログラムがデータを誤って解釈するのを防ぐためにこの処理を行っています。これは、/users/export/segmentエンドポイントから返されるものなどのJSONエクスポートには適用されません。
APIエクスポート
クラウドストレージを使用せずにエクスポートAPIを通じてエクスポートを行うと、BrazeはファイルをそのS3バケットに書き込みます。メールは送信されません。代わりに、API応答に一時的なダウンロードURLが含まれます。エクスポートは、1行に1ユーザーを含む複数のJSONファイルが入ったZIPとして提供されます。
CSVエクスポートと同様に、APIからのリンクは4時間後に期限切れになります。リンクを早すぎるタイミングでクリックすると、ファイルの準備ができていないためにエラーが表示されることがあります。リクエストでcallback_endpointを指定すると、ファイルが利用可能になったときにBrazeから通知を受け取ることができます。
大規模なAPIエクスポートもタイムアウトすることがあります。その場合は、より小さなリクエストに分割するか、ストレージパートナーを接続してボリュームに対応してください。
一般的なエラー
AccessDeniedまたはExpiredTokenは、通常、リンクの期限が切れたか、まだ準備ができていないことを意味します。エクスポートを再度実行するか、もう少し待ってください。
ストレージパートナー（Amazon S3、Google Cloud Storage、Azure Blobなど）を接続し、ダッシュボードのテクノロジーパートナーページからデフォルトのエクスポート送信先としてマークすると、Brazeはエクスポートをバケットに直接書き込みます。この設定は、通常、大規模なエクスポートに対してより信頼性が高くなります。
CSVエクスポート
CSVエクスポートでは、Brazeがダウンロードリンクをメールで送信します。このリンクは、短い時間枠（通常は約4時間）後に期限切れになります。ストレージパートナーが接続され、デフォルトのエクスポート送信先としてマークされている場合、Brazeは接続されたバケットにもエクスポートのコピーを配信します。このコピーはお客様自身のインフラに保存され、有効期限とリテンションはお客様のストレージポリシーに従います。
クラウドストレージでは、CSVエクスポートはZIPファイルにバンドルされます。ZIP内には複数の小さなCSVファイルが収められています。大規模なエクスポートは、多くの場合チャンクに分割されます（たとえば、それぞれ約5,000ユーザー）。チャンクサイズは異なる場合があります。ファイルが小さいからといって、データが欠落しているわけではありません。メールで送信されたリンクが失敗しても、ストレージ内のコピーが成功していれば、バケットからデータを直接取得できます。
一般的なエラー
AccessDeniedは、Brazeがバケットに書き込めなかったことを意味します。認証情報と権限がまだ有効であることを再確認してください。ExpiredTokenは、Brazeがバケットへのアクセスを失ったことを示します。Brazeダッシュボードで認証情報を更新してください。- 一部のファイルが予想よりも小さく見える場合がありますが、これは正常な動作です。エクスポートプロセスでは、安定性のために意図的にファイルを分割しています。
- 特定のフィールド（
-、=、+、@など）の先頭にアポストロフィが追加されるのは想定された動作です。たとえば、-1943はCSVでは'-1943になります。Brazeは、スプレッドシートプログラムがデータを誤って解釈するのを防ぐためにこの処理を行っています。これは、/users/export/segmentエンドポイントから返されるものなどのJSONエクスポートには適用されません。
APIエクスポート
ストレージパートナーが接続された状態でAPIを通じてデータをエクスポートすると、エクスポートファイルはバケットに書き込まれます。メールは送信されません。Brazeが返すダウンロードURLには引き続き時間制限がある場合がありますが、基盤となるオブジェクトはお客様のストレージに存在し、リテンション設定に従います。各ZIPファイルには、1行に1つのJSONオブジェクトが含まれています。大規模なエクスポートは、単一のZIPではなく複数のZIPファイルに分割される場合があり、これにより通常、大量のエクスポートに対してこの方法の信頼性が高くなります。
一般的なエラー
AccessDeniedは、Brazeがバケットに書き込めない場合、またはオブジェクトがその後削除された場合に発生します。権限を確認し、外部の何かがファイルを削除していないか確認してください。ExpiredTokenは、Brazeのバケットへのアクセス認証情報が古くなっていることを意味します。ダッシュボードで更新してください。- ファイルが見つからない、または予想よりも小さい場合は、まずBraze以外の何かがオブジェクトを削除していないか確認してください。ファイルサイズ自体が小さくなることは想定された動作です。