WbPromotion icon

WbPromotion

n8n node to interact with WB API

Overview

This node interacts with a specific API related to campaign parameters, particularly performing the "Post Adv Search Set Plus" operation. It allows users to send a request to update or set advanced search parameters for a campaign by specifying the campaign ID and a list of fixed phrases. This can be useful in marketing automation or campaign management scenarios where you want to programmatically adjust search-related settings for advertising campaigns.

Practical examples include:

  • Updating the search phrase filters for a given campaign.
  • Automating campaign parameter adjustments based on external data or triggers.
  • Integrating campaign management workflows with other systems via n8n.

Properties

Name Meaning
Id The unique identifier of the campaign to update. This is a required numeric value.
Pluse A JSON array containing a list of fixed phrases (up to 100) to be applied to the campaign's advanced search settings.

Output

The node outputs JSON data representing the response from the API after performing the "Post Adv Search Set Plus" operation. This typically includes confirmation of the update or details about the modified campaign parameters.

If the API returns binary data, it would represent raw response content, but based on the provided code and properties, the output is expected to be JSON structured data.

Dependencies

  • Requires an API key credential for authentication with the external service (referred generically as "an API key credential").
  • Depends on the base URL and OpenAPI specification defined in the bundled swagger JSON file.
  • Uses HTTP headers to specify JSON content type and accept JSON responses.
  • No additional environment variables are explicitly required beyond standard API authentication setup.

Troubleshooting

  • Common issues:

    • Invalid or missing campaign ID will cause the API request to fail.
    • Malformed JSON in the "Pluse" property may result in parsing errors before sending the request.
    • Exceeding the maximum allowed number of fixed phrases (100) could lead to API rejection.
    • Network or authentication errors if the API key is invalid or missing.
  • Error messages:

    • Errors related to "id" being required indicate that the campaign ID was not provided.
    • JSON parse errors for the "Pluse" field suggest incorrect JSON formatting.
    • API response errors should be checked for status codes and messages indicating authorization or validation failures.

Links and References

  • Refer to the external API documentation for campaign parameter management (not provided here).
  • n8n documentation on creating custom nodes and handling JSON input/output.
  • JSON syntax guides for correctly formatting the "Pluse" property input.

Discussion