Actions6
Campaign Analytics
AI-generatedOverview
The Braze Analytics node fetches various types of time-series analytics data from Braze, a customer engagement platform. It supports retrieving detailed performance metrics for campaigns, sends, custom events, purchases, revenue, and app sessions. This node is useful for marketers and analysts who want to monitor campaign effectiveness, user behavior, and revenue trends over specific periods.
Common scenarios include:
- Tracking how a marketing campaign performs over the last two weeks.
- Analyzing custom event occurrences within an app.
- Monitoring purchase quantities or revenue generated by products.
- Understanding user session patterns in mobile or web applications.
For example, a user can configure the node to get campaign analytics for a specific campaign ID over the past 14 days, helping them evaluate engagement trends and optimize future campaigns.
Properties
| Name | Meaning |
|---|---|
| Operation | Type of analytics data to retrieve. Options: Campaign Analytics, Custom Events, Purchase Analytics, Revenue Data, Send Analytics, Session Analytics. |
| Length (Days) | Number of days to include in the data series (range 1-100). Defaults to 14. |
| Ending At | End date/time for the data series in ISO 8601 format. Defaults to current time if not specified. |
| Campaign ID | API identifier of the campaign to analyze. Required for Campaign Analytics and Send Analytics operations. |
| Send ID | Identifier of a specific send within a campaign (used in Send Analytics operation). |
| Event Name | Name of the custom event to analyze (used in Custom Events operation). |
| Unit | Time unit for aggregation (e.g., day) used in Custom Events and Session Analytics. |
| App ID | Identifier of the app to filter analytics data (optional for some operations). |
| Segment ID | Identifier of a user segment to filter data (optional for some operations). |
| Product ID | Identifier of a product to filter purchase or revenue data (optional for Purchase and Revenue Analytics). |
Output
The node outputs JSON objects containing the requested analytics data series. The structure depends on the selected operation but generally includes time-stamped metrics relevant to campaigns, events, purchases, revenue, or sessions.
Each output item corresponds to one input item and contains the raw response from Braze's API under the json field.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for authenticating with the Braze API.
- Needs the Braze instance endpoint URL configured via credentials.
- Uses HTTP GET requests to Braze's REST API endpoints for different analytics data.
Troubleshooting
Common issues:
- Missing or invalid API key will cause authentication failures.
- Incorrect campaign, send, event, app, segment, or product IDs will result in empty or error responses.
- Date parameters outside allowed ranges or incorrect formats may cause request errors.
Error messages:
- Errors returned by Braze API are captured and included in the output when "Continue On Fail" is enabled.
- Typical error messages include authorization failures, resource not found, or invalid parameter errors.
- To resolve, verify all IDs and credentials, ensure date formats are correct, and check API permissions.