Overview

This node integrates with the Bento API to perform various operations related to subscriber and email marketing management. Specifically, the 'Segment Metrics' operation fetches segment-level analytics for a specified Bento segment ID, providing metrics such as total subscribers, opens, clicks, and unsubscribes. This is useful for marketers and analysts who want to analyze the performance of specific audience segments within their email campaigns or marketing automation workflows.

Use Case Examples

1. A marketing team wants to retrieve detailed engagement metrics for a particular segment of their email list to evaluate campaign effectiveness.
2. An analyst uses the node to fetch segment statistics to generate reports on subscriber behavior and campaign interactions.

Properties

Output

JSON

• operation - The operation performed, e.g., 'segmentStats'.
• success - Boolean indicating if the operation was successful.
• segmentId - The segment ID for which metrics were fetched.
• apiResponse - Raw response data from the Bento API.
• summary
  • segmentId - Segment ID included in the summary metrics.
  • metrics
    * totalSubscribers - Total number of subscribers in the segment.
    * opens - Number of opens recorded for the segment.
    * clicks - Number of clicks recorded for the segment.
    * unsubscribes - Number of unsubscribes recorded for the segment.
• message - Human-readable message describing the result of the operation.

Dependencies

• Bento API credentials including publishableKey, secretKey, and siteUuid are required for authentication.

Troubleshooting

• Ensure the Segment ID is provided and correctly formatted; missing or invalid Segment ID will cause errors.
• Check that Bento API credentials are correctly configured and valid to avoid authentication failures.
• Network issues or Bento API downtime can cause request failures; verify network connectivity and Bento service status.
• Rate limiting by the Bento API may cause delays or errors; respect retry headers and limits.
• Payload size limits are enforced; ensure requests do not exceed maximum allowed size.

Links

• Bento API Segment Metrics Documentation - Official documentation for fetching segment metrics from Bento API.