Analytics
AI-generatedOverview
This node integrates with the Braze platform to manage and analyze marketing campaigns. Specifically, the Analytics operation retrieves performance data for a specified campaign over a defined time range. This is useful for marketers and analysts who want to track how well their campaigns are performing, understand user engagement, and optimize future campaigns based on historical data.
Practical examples include:
- Fetching the last two weeks of analytics data for a specific campaign to evaluate its effectiveness.
- Retrieving campaign metrics up to a certain end date to generate reports or dashboards.
- Automating periodic extraction of campaign performance data for integration with other business intelligence tools.
Properties
| Name | Meaning |
|---|---|
| Campaign ID | The unique identifier of the campaign (API identifier from campaign details). |
| Length (Days) | Number of days to retrieve data for; must be between 1 and 100. Defaults to 14 days. |
| Ending At | Optional end date/time for the data range in ISO 8601 format. If not set, defaults to now. |
Output
The output is a JSON object containing the campaign's performance analytics data series retrieved from Braze. This typically includes metrics such as user engagement, conversions, impressions, clicks, and other campaign-specific KPIs aggregated over the requested time period.
The exact structure depends on Braze's API response but generally provides time-series data points relevant to the campaign's performance.
No binary data output is produced by this operation.
Dependencies
- Requires an active Braze API connection configured with a valid API key credential.
- Needs network access to Braze's API endpoints.
- The node uses the Braze instance endpoint derived from the provided credentials to make authenticated HTTP requests.
Troubleshooting
Common issues:
- Invalid or missing Campaign ID will cause the API request to fail.
- Specifying an invalid date format for "Ending At" may result in errors.
- Requesting a length outside the allowed range (1-100) might be rejected by the API.
- Network connectivity problems or incorrect API credentials will prevent successful data retrieval.
Error messages:
- Errors returned from Braze’s API are captured and surfaced with descriptive messages.
- Typical error responses include HTTP status codes and Braze-specific error codes/messages.
- To resolve errors, verify that the Campaign ID exists and is correct, check date formats, ensure API credentials are valid, and confirm network connectivity.