AvantGuard - Acumbamail icon

AvantGuard - Acumbamail

AvantGuard - Acumbamail

Overview

This node interacts with the Acumbamail API to retrieve information about campaign openers segmented by operating system. Specifically, for the "Campaigns" resource and the "Get Campaign Openers By Os" operation, it fetches data on which operating systems recipients used to open a particular email campaign. This is useful for marketers and analysts who want to understand the distribution of their audience's device usage, enabling them to tailor content or optimize campaigns for specific platforms.

Practical examples include:

  • Analyzing the percentage of opens from iOS vs Android devices.
  • Adjusting email design based on the most common operating systems among recipients.
  • Reporting campaign performance segmented by device type.

Properties

Name Meaning
Campaign Id Identifier of the campaign to retrieve information about. This is a required numeric value.

Output

The node outputs JSON data containing details about the campaign openers categorized by operating system. The exact structure depends on the API response but typically includes fields such as OS names and corresponding counts or percentages of openers.

If the node supports binary data output (not evident from the provided code), it would represent attachments or media related to the campaign data, but no such indication is present here.

Dependencies

  • Requires an API key credential for authenticating with the Acumbamail service.
  • Connects to the Acumbamail API endpoint at https://acumbamail.com/api/1.
  • Uses the @avantguardllc/n8n-openapi-node package for building properties and handling requests.
  • The node expects proper configuration of credentials within n8n to authorize API calls.

Troubleshooting

  • Missing or invalid Campaign Id: Ensure that the Campaign Id property is set and corresponds to an existing campaign in Acumbamail.
  • Authentication errors: Verify that the API key credential is correctly configured and has sufficient permissions.
  • API connectivity issues: Check network access to https://acumbamail.com/api/1 and ensure no firewall or proxy blocks the request.
  • Unexpected API responses: If the API changes or returns errors, review the response message for clues and update the node or credentials accordingly.

Links and References

Discussion