このページはAIにより自動翻訳されており、不正確な内容が含まれている可能性があります。翻訳の誤りを報告するには、 GitHubでイシューを作成してください.
Canvasデータサマリー分析のエクスポート
get
/canvas/data_summary
このエンドポイントを使用して、Canvasの時系列データのロールアップをエクスポートし、Canvas結果の簡潔なサマリーを提供します。
前提条件
このエンドポイントを使用するには、canvas.data_summary 権限を持つ APIキーが必要です。
レート制限
APIレート制限に記載されているように、このエンドポイントにはデフォルトのBrazeレート制限(1時間あたり250,000リクエスト)が適用されます。
リクエストパラメーター
| パラメーター | 必須 | データタイプ | 説明 |
|---|---|---|---|
canvas_id |
必須 | 文字列 | Canvas API識別子を参照してください。 |
ending_at |
必須 | 日時 (ISO-8601 文字列) |
データエクスポートの終了日。デフォルトはリクエスト時刻です。 |
starting_at |
オプション* | 日時 (ISO-8601 文字列) |
データエクスポートの開始日。 * length または starting_at のいずれかが必要です。 |
length |
オプション* | 文字列 | 返されるシリーズに含まれる ending_at より前の最大日数。1以上14以下(両端を含む)でなければなりません。* length または starting_at のいずれかが必要です。 |
include_variant_breakdown |
オプション | ブール値 | バリアント統計を含めるかどうか(デフォルトは false)。 |
include_step_breakdown |
オプション | ブール値 | ステップ統計を含めるかどうか(デフォルトは false)。 |
include_deleted_step_data |
オプション | ブール値 | 削除されたステップの統計を含めるかどうか(デフォルトは false)。 |
重要
タイムゾーンの整合: Brazeダッシュボードの分析は、ダッシュボードで設定された会社のタイムゾーンに基づいて日次で集計されます。統計がダッシュボードと一致するように、タイムスタンプが会社のタイムゾーンと揃っていることを確認してください。たとえば、会社の時刻がUTC+2の場合、タイムスタンプは12AM UTC+2にする必要があります。
リクエスト例
1
2
curl --location -g --request GET 'https://rest.iad-01.braze.com/canvas/data_summary?canvas_id={{canvas_id}}&ending_at=2018-05-30T23:59:59-05:00&starting_at=2018-05-28T23:59:59-05:00&length=5&include_variant_breakdown=true&include_step_breakdown=true&include_deleted_step_data=true' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
応答
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
{
"data": {
"name": (string) the Canvas name,
"total_stats": {
"revenue": (float) the number of dollars of revenue (USD),
"conversions": (int) the number of conversions,
"conversions_by_entry_time": (int) the number of conversions for the conversion event by entry time,
"entries": (int) the number of entries
},
"variant_stats": (optional) {
"00000000-0000-0000-0000-0000000000000": (string) the API identifier for the variant {
"name": (string) the name of the variant,
"revenue": (float) the number of dollars of revenue (USD),
"conversions": (int) the number of conversions,
"entries": (int) the number of entries
},
... (more variants)
},
"step_stats": (optional) {
"00000000-0000-0000-0000-0000000000000": (string) the API identifier for the step {
"name": (string) the name of the step,
"revenue": (float) the number of dollars of revenue (USD),
"conversions": (int) the number of conversions,
"conversions_by_entry_time": (int) the number of conversions for the conversion event by entry time,
"messages": {
"android_push": (name of channel) [
{
"sent": (int) the number of sends,
"opens": (int) the number of opens,
"influenced_opens": (int) the total number of opens (includes both direct opens and influenced opens),
"bounces": (int) the number of bounces
... (more stats for channel)
}
],
... (more channels)
}
},
... (more steps)
}
},
"message": (required, string) the status of the export, returns 'success' on successful completion
}
重要
influenced_opens フィールド: APIレスポンスでは、influenced_opens フィールドは開封の総数(直接開封と間接開封の両方を合わせたもの)を表します。Brazeダッシュボードでは、「間接開封」は直接開封を除いた間接開封のみを指します。これはAPIのレガシー命名規則によるものです。
New Stuff!