WbAnalytics icon

WbAnalytics

n8n node to interact with WB API

Actions19

Overview

This node interacts with a web-based advertising analytics API to retrieve keyword statistics for a specific advertising campaign over a defined time period. It is useful for marketers and analysts who want to monitor the performance of keywords within their advertising campaigns, enabling data-driven decisions to optimize ad spend and improve campaign effectiveness.

A practical example would be fetching keyword-level metrics such as impressions, clicks, or conversions for a campaign identified by its ID between two dates. This helps in understanding which keywords are driving traffic and conversions.

Properties

Name Meaning
Advert Id The unique numeric identifier of the advertising campaign (ID кампании).
From The start date of the period for which to retrieve statistics (Начало периода). Format: YYYY-MM-DD.
To The end date of the period for which to retrieve statistics (Конец периода). Format: YYYY-MM-DD.

Output

The node outputs JSON data containing keyword statistics related to the specified advertising campaign and date range. The structure typically includes an array of keyword entries, each with associated metrics such as impressions, clicks, cost, and other relevant performance indicators.

If the node supports binary data output, it would represent downloadable reports or files related to the keyword statistics, but based on the provided code and properties, the primary output is structured JSON data.

Dependencies

  • Requires access to the advertising platform's API that provides keyword-level analytics.
  • Needs an API authentication token or key configured in n8n credentials to authorize requests.
  • The base URL and API schema are derived from an imported Swagger/OpenAPI JSON definition.
  • No additional external dependencies beyond standard HTTP request capabilities and the API credential.

Troubleshooting

  • Common Issues:

    • Invalid or missing Advert Id: Ensure the campaign ID is correct and exists in the advertising platform.
    • Date format errors: Dates must be in YYYY-MM-DD format; otherwise, the API may reject the request.
    • Authentication failures: Verify that the API key or token is correctly set up in n8n credentials.
    • Network or API downtime: Check connectivity and API status if requests fail repeatedly.

  • Error Messages:

    • "Unauthorized" or "Authentication failed": Indicates invalid or missing API credentials.
    • "Invalid parameter" or "Bad request": Usually caused by incorrect Advert Id or improperly formatted dates.
    • "Not found": The specified campaign ID does not exist or is inaccessible with current credentials.

Resolving these typically involves verifying input parameters, ensuring proper credential configuration, and confirming API availability.

Links and References

Discussion