Kadam icon

Kadam

Interact with Kadam API (v1.4.x) for managing campaigns, clients, creatives, and more.

Actions24

Campaign → Update Placement Multiplier

AI-generated

Overview

The "Update Placement Multiplier" operation in the Campaign resource allows users to modify the bid multiplier for a specific ad placement within an advertising campaign. This multiplier adjusts how aggressively bids are placed on that particular placement, effectively increasing or decreasing the bid by a factor (e.g., 0.8x reduces the bid, 1.2x increases it). This operation is useful for advertisers who want to optimize their bidding strategy by customizing bids per placement to improve campaign performance or control costs.

Practical examples:

  • Increasing the multiplier for high-performing placements to gain more impressions or clicks.
  • Decreasing the multiplier for less effective placements to reduce spend.
  • Adjusting bids dynamically based on placement performance insights.

Properties

Name Meaning
Campaign ID The unique identifier of the campaign where the placement multiplier will be updated.
Placement ID The unique identifier of the specific placement within the campaign to update the multiplier for.
Multiplier The new multiplier value to apply to the placement's bid. Values like 0.8 or 1.2 are accepted; the 'x' prefix is added automatically.
Retry on Failure Boolean flag indicating whether the node should retry the request up to 3 times on temporary failures such as rate limits or network issues.

Output

The output JSON contains the response from the API after attempting to update the placement multiplier. It typically includes confirmation of success or details about the updated placement multiplier. If the operation fails, error information is included in the output JSON.

The node does not output binary data for this operation.

Dependencies

  • Requires an active connection to the Kadam API with valid credentials including an API token and application ID.
  • The node uses HTTP requests to the Kadam API endpoints.
  • Proper configuration of the Kadam API credentials in n8n is necessary for authentication.

Troubleshooting

  • Common issues:

    • Invalid or missing Campaign ID or Placement ID can cause the API to reject the request.
    • Providing a multiplier value less than zero will likely result in validation errors.
    • Network issues or rate limiting by the Kadam API may cause request failures.

  • Error messages and resolutions:

    • API Error: [error description] — Indicates an issue returned by the Kadam API, such as invalid parameters or authorization failure. Verify input values and credentials.
    • Unknown error occurred during the API request — Could indicate network problems or unexpected API responses. Check network connectivity and retry if enabled.
    • Unsupported resource — Occurs if the resource parameter is incorrect; ensure "Campaign" is selected.
    • Operation failed with status code XXX — HTTP error codes indicating issues like unauthorized access (401), forbidden (403), or not found (404). Confirm credentials and resource identifiers.

Enabling "Retry on Failure" can help mitigate transient errors like rate limits or temporary network failures.

Links and References

Discussion