WbPromotion icon

WbPromotion

n8n node to interact with WB API

Actions28

Overview

This node interacts with a campaign management API to update the list of excluded search phrases (negative keywords) for a specific advertising campaign. It is useful in scenarios where you want to refine your campaign targeting by excluding certain search terms that are not relevant or converting poorly, thereby optimizing ad spend and improving campaign performance.

For example, if you have a campaign promoting winter jackets but want to exclude searches related to "summer clothes," you can use this node to set those excluded phrases programmatically.

Properties

Name Meaning
Id The unique identifier of the campaign to update.
Excluded A JSON array of negative keywords (up to 1000 items) to exclude from the campaign's ads.

Output

The node outputs JSON data representing the response from the API after setting the excluded phrases for the specified campaign. This typically includes confirmation of the update or details about the current exclusion list.

No binary data output is involved.

Dependencies

  • Requires an API key credential for authentication with the external campaign management service.
  • The node uses a base URL configured from an imported OpenAPI specification.
  • Proper network access to the API endpoint is necessary.

Troubleshooting

  • Invalid Campaign ID: If the provided campaign ID does not exist or is incorrect, the API may return an error indicating the campaign was not found. Verify the campaign ID before running the node.
  • Malformed JSON in Excluded: The Excluded property expects valid JSON. Invalid JSON will cause parsing errors. Ensure the input is correctly formatted JSON.
  • Exceeded Limit of Excluded Phrases: The API limits the number of excluded phrases to 1000. Providing more than this may result in an error.
  • Authentication Errors: Missing or invalid API credentials will prevent successful requests. Confirm that the API key is correctly configured.
  • Network Issues: Connectivity problems or incorrect base URL configuration can cause request failures.

Links and References

  • Refer to the external campaign management API documentation for detailed information on the "set excluded phrases" endpoint.
  • JSON formatting guides to ensure correct input for the Excluded property.

Discussion