Braze: Most-used fields#
The table below gives information about most-used fields that you can import from Braze. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
API name |
Adverity UI name |
Description |
Use in Adverity |
|---|---|---|---|
archived |
archived |
Indicates whether a campaign or Canvas is archived, meaning it is no longer active but its data is retained. |
dimension |
bounces |
bounces |
The number of messages that could not be delivered to the recipient’s email address and resulted in a bounce. |
metric |
button_clicks |
button_clicks |
The number of times buttons within messages (e.g., in-app messages or content cards) were clicked. |
metric |
campaign.id |
campaign.id |
The unique identifier for a specific campaign. |
dimension |
campaign.name |
campaign.name |
The name of the campaign. |
dimension |
campaign.tag |
campaign.tag |
A single tag associated with a campaign for organization. |
dimension |
campaign.tags |
campaign.tags |
A list of tags associated with the campaign, used for categorization and filtering. |
dimension |
canvas_id |
canvas_id |
The unique identifier for a specific Canvas (customer journey). |
dimension |
canvas_name |
canvas_name |
The name of the Canvas. |
dimension |
channel |
channel |
The communication channel used for the campaign or message (e.g., email, push, in-app). |
dimension |
channels |
channels |
A list of communication channels through which a campaign or message can be delivered. |
dimension |
clicks |
clicks |
The total number of clicks on messages or elements within a campaign. |
metric |
conversion_behaviors.type |
conversion_behaviors.type |
The type of conversion behavior defined for a campaign. |
dimension |
conversion_behaviors.window |
conversion_behaviors.window |
The time window during which a user’s action is considered a conversion for a campaign. |
metric |
conversions |
conversions |
The total number of conversions attributed to a campaign. |
metric |
created_at |
created_at |
The date and time when the campaign or Canvas was created. |
dimension |
created_at_timestamp |
created_at_timestamp |
The Unix timestamp when the campaign or Canvas was created. |
dimension |
delivered |
delivered |
The number of messages successfully delivered to the recipient. |
metric |
delivery_failed |
delivery_failed |
The number of messages that failed to be delivered to recipients. |
metric |
description |
description |
A descriptive text providing details about the campaign or Canvas. |
dimension |
draft |
draft |
Indicates whether the campaign or Canvas is currently in a draft state. |
dimension |
enabled |
enabled |
Indicates whether the campaign or Canvas is currently active and running. |
dimension |
enrolled |
enrolled |
The number of unique users enrolled in a campaign or variant. |
metric |
errors |
errors |
Information regarding any errors encountered during the processing or delivery of messages or campaigns. |
metric |
first_entry |
first_entry |
The date and time when the first user entered the Canvas flow. |
dimension |
first_sent |
first_sent |
dimension |
|
first_step_id |
first_step_id |
dimension |
|
first_step_ids |
first_step_ids |
A list of unique identifiers for the initial steps in a Canvas, especially relevant for those with multiple entry points. |
dimension |
has_post_launch_draft |
has_post_launch_draft |
A boolean indicating whether a campaign or Canvas has a draft version that was created after its initial launch. |
dimension |
id |
id |
A general unique identifier for an object or entity. |
dimension |
impressions |
impressions |
The total number of times a message or ad creative was displayed to users. |
metric |
last_entry |
last_entry |
The date and time when the most recent user entered the Canvas flow. |
dimension |
last_sent |
last_sent |
dimension |
|
message |
message |
Represents information related to a message, which could be its content or a status message. |
dimension |
messages.action |
messages.action |
The action associated with a message, such as opening a URL, deep linking, or performing a specific function. |
dimension |
messages.alert |
messages.alert |
The content of an alert message, typically used for push notifications or in-app messages. |
dimension |
messages.amp_body |
messages.amp_body |
The AMP (Accelerated Mobile Pages) HTML content for an email message. |
dimension |
messages.body |
messages.body |
The main content or body text of a message. |
dimension |
messages.channel |
messages.channel |
The specific communication channel for a message (e.g., email, push, in-app, SMS). |
dimension |
messages.from |
messages.from |
The sender’s address or name for an email message. |
dimension |
messages.headers |
messages.headers |
Custom headers defined for an email message. |
dimension |
messages.message |
messages.message |
The main content or body of a message. |
dimension |
messages.message_variation_id |
messages.message_variation_id |
The unique identifier for a specific variation of a message used in A/B testing. |
dimension |
messages.method |
messages.method |
The HTTP method (e.g., POST, GET) used for a webhook message. |
dimension |
messages.preheader |
messages.preheader |
The preview text displayed after the subject line in an email client. |
dimension |
messages.reply_to |
messages.reply_to |
The email address to which replies to a message should be sent. |
dimension |
messages.should_inline_css |
messages.should_inline_css |
A boolean indicating whether CSS styles in an email message should be inlined. |
dimension |
messages.should_whitespace_preheader |
messages.should_whitespace_preheader |
A boolean indicating whether to add whitespace to the preheader of an email message to hide subsequent content. |
dimension |
messages.subject |
messages.subject |
The subject line of an email message. |
dimension |
messages.title |
messages.title |
The title of a message, commonly used for push notifications or in-app messages. |
dimension |
messages.type |
messages.type |
The type of message (e.g., email, push, in-app, webhook). |
dimension |
messages.url |
messages.url |
A URL embedded within a message, often for tracking clicks or deep linking. |
dimension |
name |
name |
The name of an entity such as a campaign, Canvas, or Canvas step. |
dimension |
next_paths |
next_paths |
An array containing details about the possible paths a user can take from a given step within a Canvas. |
dimension |
next_paths.name |
next_paths.name |
The name of a specific path leading from one step to another in a Canvas. |
dimension |
next_paths.next_step_id |
next_paths.next_step_id |
The unique identifier of the next step in a Canvas path. |
dimension |
next_step_ids |
next_step_ids |
A list of unique identifiers for the subsequent steps directly following a message step in a Canvas. |
dimension |
opens |
opens |
The number of times a message, such as an email or in-app message, was opened by recipients. |
metric |
opt_in |
opt_in |
The action of a user consenting to receive marketing communications. |
metric |
opt_out |
opt_out |
The action of a user withdrawing consent to receive marketing communications. |
metric |
rejected |
rejected |
metric |
|
reported_spam |
reported_spam |
The count of instances where a message was marked as spam by recipients. |
metric |
revenue |
revenue |
The total revenue generated as a result of campaign activities or purchases. |
metric |
schedule_type |
schedule_type |
The type of scheduling action defined for a Canvas, indicating how and when it is set to run. |
dimension |
sent |
sent |
The total number of messages sent in a campaign. |
metric |
tag |
tag |
A tag used for categorization and filtering of various entities like campaigns, Canvases, or custom attributes. |
dimension |
time |
time |
The date or timestamp for which the associated data is reported, typically in ISO 8601 format. |
dimension |
total_clicks |
total_clicks |
The aggregate sum of all clicks on messages or elements, including multiple clicks by the same user. |
metric |
total_dismissals |
total_dismissals |
metric |
|
total_impressions |
total_impressions |
The aggregate sum of all message or ad displays, including multiple impressions for the same user. |
metric |
total_opens |
total_opens |
The aggregate sum of all message opens, including multiple opens by the same user. |
metric |
type |
type |
The category or type of an event or message within the Braze platform. |
dimension |
unique_clicks |
unique_clicks |
The number of distinct users who clicked on a message or element within a campaign. |
metric |
unique_dismissals |
unique_dismissals |
metric |
|
unique_impressions |
unique_impressions |
The number of distinct users who received an impression of a message or ad creative. |
metric |
unique_opens |
unique_opens |
The number of distinct users who opened a message. |
metric |
unique_recipients |
unique_recipients |
The total number of unique users who were targeted to receive messages within a campaign or variant. |
metric |
unsubscribes |
unsubscribes |
The total number of users who unsubscribed from messages or a subscription group. |
metric |
updated_at |
updated_at |
The date and time when the campaign or Canvas was last updated. |
dimension |
updated_at_timestamp |
updated_at_timestamp |
The Unix timestamp when the campaign or Canvas was last updated. |
dimension |
variation_api_id |
variation_api_id |
The unique identifier for a specific A/B test variation within a campaign or Canvas. |
dimension |
variation_name |
variation_name |
The name given to a specific A/B test variation within a campaign or Canvas. |
dimension |