KadamInstall

Overview

The node interacts with the Kadam advertising platform API to update existing advertising campaigns. Specifically, the "Update Campaign" operation allows users to modify various attributes of a campaign such as its status, budget limits, targeting parameters, and other optional settings.

This node is beneficial in scenarios where advertisers need to programmatically adjust campaign settings without manually logging into the Kadam platform. For example, marketers can automate pausing or activating campaigns based on performance metrics, update daily or total budgets dynamically, or refine targeting criteria like countries, devices, or languages to optimize ad delivery.

Practical examples include:

• Automatically pausing campaigns during weekends by updating the campaign status.
• Increasing the daily budget limit for high-performing campaigns.
• Adjusting country-specific bids or device targeting based on real-time analytics.

Properties

Output

The node outputs an array of JSON objects representing the updated campaign data returned by the Kadam API. Each output item corresponds to one input item processed.

The JSON structure typically contains the updated campaign fields reflecting the changes made. If the API returns multiple items or nested data, these are included accordingly.

No binary data output is produced by this operation.

Example output snippet (conceptual):

{
  "id": 12345,
  "name": "Updated Campaign Name",
  "status": 1,
  "dayLimit": 1000,
  "allLimit": 5000,
  "categories": [10, 20],
  "targetUrl": "https://example.com/new-target",
  "countryTargeting": [
    {"countryId": 1, "bid": 0.05},
    {"countryId": 2, "bid": 0.03}
  ],
  ...
}

Dependencies

• Requires an active Kadam API credential with an API token and application ID configured in n8n.
• The node uses the Kadam REST API endpoint https://api.kadam.net.
• Network connectivity to the Kadam API service is necessary.
• Optional retry logic can be enabled to handle transient errors like rate limiting or network timeouts.

Troubleshooting

• Invalid Campaign ID: If the provided campaign ID does not exist or is invalid, the API will return an error. Verify the campaign ID using the "Get Campaigns" operation before updating.
• Permission Errors: Ensure that the API credentials have sufficient permissions to update campaigns.
• Rate Limits: The Kadam API may enforce rate limits. Enable "Retry on Failure" to automatically retry requests on temporary rate limit errors.
• Invalid Parameter Values: Providing invalid values for fields like budgets (negative numbers), bids (less than minimum allowed), or malformed URLs may cause API errors. Validate inputs before execution.
• Partial Updates: Omitting optional fields means those attributes remain unchanged. To reset a field, check if the API supports explicit null or empty values.
• Network Issues: Temporary network failures can cause request errors. Use the retry option or ensure stable internet connectivity.

Common error message example:

• "API Error: Invalid campaign ID" — Check the campaign ID parameter.
• "API Error: Unauthorized" — Verify API token validity and permissions.
• "API Error: Rate limit exceeded" — Enable retry or reduce request frequency.

Links and References

• Kadam API Documentation (general): https://api.kadam.net/docs
• Kadam Campaign Management API Reference: https://api.kadam.net/docs/campaigns
• n8n Documentation on Credentials: https://docs.n8n.io/credentials/
• Best Practices for API Rate Limiting: https://developer.kadam.net/rate-limits

(Links are indicative based on typical API documentation URLs; please consult your Kadam account or support for exact references.)