Actions42
- Ads Actions
- Campaigns Actions
- Creatives Actions
- Audiences Actions
- Pixels Actions
- Webhooks Actions
- Reports Actions
Overview
This node integrates with the Snapchat Ads API to manage and retrieve advertising data. Specifically, for the Reports resource with the Get Report operation, it fetches detailed information about a specific Snapchat advertising report identified by its Report ID within a given Ad Account.
Common scenarios where this node is beneficial include:
- Retrieving performance or analytics reports for Snapchat ad campaigns.
- Automating report fetching as part of marketing workflows.
- Integrating Snapchat ad reporting data into broader business intelligence or CRM systems.
For example, a user can automate the retrieval of a monthly campaign performance report by specifying the Ad Account ID and Report ID, then use the output data for further processing or visualization.
Properties
| Name | Meaning |
|---|---|
| Ad Account ID | The unique identifier of the Snapchat Ad Account from which to retrieve the report. This is required. |
| Report ID | The unique identifier of the Snapchat Report to fetch. |
Output
The node outputs JSON data representing the details of the requested Snapchat report. The structure of the JSON depends on the Snapchat API's response for the report but typically includes metrics, dimensions, and metadata related to the advertising report.
If the operation fails, the output JSON will contain an error field describing the issue.
The node does not output binary data for this operation.
Dependencies
- Requires a valid API key credential for the "N8N Tools API" service, which acts as a proxy or validation layer before calling the Snapchat API.
- Requires OAuth2 credentials configured for accessing the Snapchat Ads API.
- The node makes HTTP requests to the Snapchat Ads API endpoint (
https://adsapi.snapchat.com) via the helper class managing Snapchat API calls.
Troubleshooting
- Invalid subscription or API key error: If the node throws an error indicating invalid subscription or API key, verify that the API key credential for the external validation service is correct and active.
- Missing or incorrect Report ID: Ensure the Report ID provided exists and belongs to the specified Ad Account.
- Permission errors: Confirm that the OAuth2 credentials have sufficient permissions to access the Snapchat Ads account and reports.
- Network or API downtime: Temporary network issues or Snapchat API outages may cause failures; retry after some time.
- JSON parsing errors: When providing JSON input properties (not applicable here for Get Report), ensure the JSON is well-formed.