BrazeEx.Api.ExportCanvas (braze_ex v1.0.1)
API calls for all endpoints tagged ExportCanvas
.
Link to this section Summary
Functions
Canvas Data Series Analytics
This endpoint allows you to export time series data for a Canvas.
Canvas Data Analytics Summary
This endpoint allows you to export rollups of time series data for a Canvas, providing a concise summary of a Canvas' results.
Canvas Details
This endpoint allows you to export metadata about a Canvas, such as the name, time created, current status, and more.
Canvas List
This endpoint allows you to export a list of Canvases, including the name, Canvas API identifier and associated tags. Canvases are returned in groups of 100 sorted by time of creation (oldest to newest by default).
Link to this section Functions
canvas_data_series_get(connection, opts \\ [])
@spec canvas_data_series_get( Tesla.Env.client(), keyword() ) :: {:ok, nil} | {:error, Tesla.Env.t()}
canvas-data-series-analytics
Canvas Data Series Analytics
This endpoint allows you to export time series data for a Canvas.
rate-limit
Rate limit
We apply the default Braze rate limit of 250,000 requests per hour to this endpoint, as documented in API rate limits.
response
Response
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
"data": {
"name": (string) Canvas name,
"stats": [
{
"time": (string) date as ISO 8601 date,
"total_stats": {
"revenue": (float),
"conversions": (int),
"conversions_by_entry_time": (int),
"entries": (int)
},
"variant_stats": (optional) {
"00000000-0000-0000-0000-0000000000000": (API identifier for variant) {
"name": (string) name of variant,
"revenue": (int),
"conversions": (int),
"conversions_by_entry_time": (int),
"entries": (int)
},
... (more variants)
},
"step_stats": (optional) {
"00000000-0000-0000-0000-0000000000000": (API identifier for step) {
"name": (string) name of step,
"revenue": (float),
"conversions": (int),
"conversions_by_entry_time": (int),
"messages": {
"email": [
{
"sent": (int),
"opens": (int),
"unique_opens": (int),
"clicks": (int),
... (more stats)
}
],
... (more channels)
}
},
... (more steps)
}
},
... (more stats by time)
]
},
"message": (required, string) the status of the export, returns 'success' when completed without errors
}
Tip: For help with CSV and API exports, visit Export troubleshooting.
parameters
Parameters
connection
(BrazeEx.Connection): Connection to serveropts
(keyword): Optional parameters:authorization
(String.t)::canvas_id
(String.t): (Required) String See Canvas API Identifier.:ending_at
(String.t): (Required) Datetime (ISO 8601 string) Date on which the data export should end. Defaults to time of the request.:starting_at
(String.t): (Optional) Datetime (ISO 8601 string) Date on which the data export should begin. Eitherlength
orstarting_at
is required.:length
(integer()): (Optional) Datetime (ISO 8601 string) Maximum number of days beforeending_at
to include in the returned series. Must be between 1 and 14 (inclusive). Eitherlength
orstarting_at
is required.:include_variant_breakdown
(boolean()): (Optional) Boolean Whether or not to include variant stats (defaults to false).:include_step_breakdown
(boolean()): (Optional) Boolean Whether or not to include step stats (defaults to false).:include_deleted_step_data
(boolean()): (Optional) Boolean Whether or not to include step stats for deleted steps (defaults to false).
returns
Returns
{:ok, nil}
on success{:error, Tesla.Env.t}
on failure
canvas_data_summary_get(connection, opts \\ [])
@spec canvas_data_summary_get( Tesla.Env.client(), keyword() ) :: {:ok, nil} | {:error, Tesla.Env.t()}
canvas-data-analytics-summary
Canvas Data Analytics Summary
This endpoint allows you to export rollups of time series data for a Canvas, providing a concise summary of a Canvas' results.
rate-limit
Rate limit
We apply the default Braze rate limit of 250,000 requests per hour to this endpoint, as documented in API rate limits.
response
Response
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
"data": {
"name": (string) Canvas name,
"total_stats": {
"revenue": (float),
"conversions": (int),
"conversions_by_entry_time": (int),
"entries": (int)
},
"variant_stats": (optional) {
"00000000-0000-0000-0000-0000000000000": (API identifier for variant) {
"name": (string) name of variant,
"revenue": (float),
"conversions": (int),
"entries": (int)
},
... (more variants)
},
"step_stats": (optional) {
"00000000-0000-0000-0000-0000000000000": (API identifier for step) {
"name": (string) name of step,
"revenue": (float),
"conversions": (int),
"conversions_by_entry_time": (int),
"messages": {
"android_push": (name of channel) [
{
"sent": (int),
"opens": (int),
"influenced_opens": (int),
"bounces": (int)
... (more stats for channel)
}
],
... (more channels)
}
},
... (more steps)
}
},
"message": (required, string) the status of the export, returns 'success' when completed without errors
}
Tip: For help with CSV and API exports, visit Export troubleshooting.
parameters
Parameters
connection
(BrazeEx.Connection): Connection to serveropts
(keyword): Optional parameters:authorization
(String.t)::canvas_id
(String.t): (Required) String See Canvas API identifier.:ending_at
(String.t): (Required) Datetime (ISO 8601 string) Date on which the data export should end. Defaults to time of the request:starting_at
(String.t): (Optional) Datetime (ISO 8601 string) Date on which the data export should begin. Eitherlength
orstarting_at
is required.:length
(integer()): (Optional) Integer Max number of days beforeending_at
to include in the returned series. Must be between 1 and 14 (inclusive). Eitherlength
orstarting_at
is required.:include_variant_breakdown
(boolean()): (Optional) Boolean Whether or not to include variant stats (defaults to false).:include_step_breakdown
(boolean()): (Optional) Boolean Whether or not to include step stats (defaults to false).:include_deleted_step_data
(boolean()): (Optional) Boolean Whether or not to include step stats for deleted steps (defaults to false).
returns
Returns
{:ok, nil}
on success{:error, Tesla.Env.t}
on failure
canvas_details_get(connection, opts \\ [])
@spec canvas_details_get( Tesla.Env.client(), keyword() ) :: {:ok, nil} | {:error, Tesla.Env.t()}
canvas-details
Canvas Details
This endpoint allows you to export metadata about a Canvas, such as the name, time created, current status, and more.
rate-limit
Rate limit
We apply the default Braze rate limit of 250,000 requests per hour to this endpoint, as documented in API rate limits.
response
Response
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
"created_at": (string) date created as ISO 8601 date,
"updated_at": (string) date updated as ISO 8601 date,
"name": (string) Canvas name,
"description": (string) Canvas description,
"archived": (boolean) whether this Canvas is archived,
"draft": (boolean) whether this Canvas is a draft,
"schedule_type": (string) type of scheduling action,
"first_entry": (string) date of first entry as ISO 8601 date,
"last_entry": (string) date of last entry as ISO 8601 date,
"channels": (array of strings) step channels used with Canvas,
"variants": [
{
"name": (string) name of variant,
"id": (string) API identifier of the variant,
"first_step_ids": (array of strings) API identifiers for first steps in variant,
"first_step_id": (string) API identifier of first step in variant (deprecated in November 2017, only included if the variant has only one first step)
},
... (more variations)
],
"tags": (array of strings) tag names associated with the Canvas,
"steps": [
{
"name": (string) name of step,
"id": (string) API identifier of the step,
"next_step_ids": (array of strings) API identifiers of steps following step,
"channels": (array of strings) channels used in step,
"messages": {
"message_variation_id": (string) { // <=This is the actual id
"channel": (string) channel type of the message (eg., "email"),
... channel-specific fields for this message, see Campaign Details Endpoint API Response for example message responses ...
}
}
},
... (more steps)
],
"message": (required, string) the status of the export, returns 'success' when completed without errors
}
Tip: For help with CSV and API exports, visit Export troubleshooting.
parameters
Parameters
connection
(BrazeEx.Connection): Connection to serveropts
(keyword): Optional parameters:authorization
(String.t)::canvas_id
(String.t): (Required) String See Canvas API Identifier
returns
Returns
{:ok, nil}
on success{:error, Tesla.Env.t}
on failure
canvas_list_get(connection, opts \\ [])
@spec canvas_list_get( Tesla.Env.client(), keyword() ) :: {:ok, nil} | {:error, Tesla.Env.t()}
canvas-list
Canvas List
This endpoint allows you to export a list of Canvases, including the name, Canvas API identifier and associated tags. Canvases are returned in groups of 100 sorted by time of creation (oldest to newest by default).
Archived Canvases will not be included in the API response unless the include_archived
field is specified. Canvases that are stopped but not archived, however, will be returned by default.
rate-limit
Rate limit
We apply the default Braze rate limit of 250,000 requests per hour to this endpoint, as documented in API rate limits.
response
Response
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
"canvases" : [
{
"id" : (string) Canvas API Identifier,
"last_edited": (ISO 8601 string) the last edited time for the message,
"name" : (string) Canvas name,
"tags" : (array) tag names associated with the Canvas,
},
... (more Canvases)
],
"message": (required, string) the status of the export, returns 'success' when completed without errors
}
Tip: For help with CSV and API exports, visit Export troubleshooting.
parameters
Parameters
connection
(BrazeEx.Connection): Connection to serveropts
(keyword): Optional parameters:authorization
(String.t)::page
(integer()): (Optional) Integer The page of Canvases to return, defaults to0
(returns the first set of up to 100).:include_archived
(boolean()): (Optional) Boolean Whether or not to include archived Canvases, defaults tofalse
.:sort_direction
(String.t): (Optional) String - Sort creation time from newest to oldest: pass in the valuedesc
. - Sort creation time from oldest to newest: pass in the valueasc
. Ifsort_direction
is not included, the default order is oldest to newest.:last_edit_periodtime_left_square_bracketgt_right_square_bracket
(String.t): (Optional) Datetime (ISO 8601 string) Filters the results and only returns Canvases that were edited greater than the time provided till now. Format isyyyy-MM-DDTHH:mm:ss
.
returns
Returns
{:ok, nil}
on success{:error, Tesla.Env.t}
on failure