Actions87
- Users Actions
- Shopping & Catalogs Actions
- Advertising & Campaigns Actions
- Advanced Analytics Actions
- Engagement Features Actions
- Business Tools Actions
- Search & Discovery Actions
- Pins Actions
- Boards Actions
Overview
The "Get Campaign Analytics" operation in the "Advertising & Campaigns" resource of this Pinterest integration node retrieves detailed analytics data for a specific advertising campaign within a given ad account. This allows users to monitor and analyze the performance of their Pinterest ad campaigns, helping optimize marketing strategies.
Typical use cases include:
- Tracking key metrics of a campaign such as impressions, clicks, conversions, and engagement over a specified time period.
- Integrating campaign performance data into broader marketing dashboards or reports.
- Automating alerts or actions based on campaign analytics thresholds.
For example, a marketer can use this node to fetch daily analytics for a campaign to evaluate its effectiveness and adjust budgets or targeting accordingly.
Properties
| Name | Meaning |
|---|---|
| Ad Account ID | The unique identifier of the advertising account that owns the campaign. |
| Campaign ID | The unique identifier of the campaign for which analytics are requested. |
These properties are required inputs to specify exactly which campaign's analytics data should be retrieved.
Output
The output is a JSON object containing the analytics data for the specified campaign. While the exact structure depends on the underlying API response, it typically includes fields such as:
- Metrics related to campaign performance (e.g., impressions, clicks, spend).
- Time-based breakdowns if applicable.
- Other relevant campaign details.
The node does not output binary data for this operation.
Dependencies
- Requires an active subscription and valid API key credential for the external "N8N Tools API" service that proxies Pinterest API calls.
- Requires Pinterest OAuth2 authentication credentials configured in n8n to authorize requests.
- The node internally uses an Ads Campaigns API client to interact with Pinterest's advertising endpoints via the N8N Tools API.
Troubleshooting
- Invalid Subscription or API Key: If the node throws an error indicating invalid subscription or API key, verify that your API key credential is correct and has an active subscription.
- Missing or Incorrect IDs: Ensure that the Ad Account ID and Campaign ID provided are accurate and correspond to existing entities in your Pinterest advertising account.
- Permission Errors: Accessing campaign analytics may require elevated permissions; ensure your Pinterest OAuth2 credentials have sufficient scopes.
- API Rate Limits: Frequent requests might hit rate limits imposed by Pinterest or the proxy API; consider adding delays or retries.
- Unexpected Response Structure: If the output JSON does not contain expected fields, check for changes in the Pinterest API or the proxy service.
Links and References
- Pinterest Ads API Documentation
- N8N Documentation on Credentials
- N8N Tools API Service (for subscription and API key management)