Avito icon

Avito

Взаимодействие с API Авито для бизнеса

Actions29

Overview

This node integrates with the Avito API to manage advertising promotions. Specifically, the "Установить Ручную Ставку" (Set Manual Bid) operation under the "Продвижение" (Promotion) resource allows users to set a manual bid price for a specific advertisement's target action type. This is useful for advertisers who want precise control over how much they pay per user interaction, such as calls, clicks, or chat contacts.

Practical examples:

  • Setting a manual bid for paying per click on an ad to optimize ad spend.
  • Adjusting bids for calls generated by an ad to increase lead quality.
  • Defining daily spending limits to control budget usage automatically.

Properties

Name Meaning
ID Объявления Unique numeric ID of the advertisement to which the bid applies.
Ставка (в копейках) The bid amount in kopecks (1/100 of a ruble) for the selected target action. Must be ≥ 1.
Тип События Type of target action for which the bid is set. Options:
- Звонок [1]: Pay per call generated by the ad.
- Пакет кликов [5]: Pay per clicks leading to the ad (default).
- Мессенджер, передача контакта в чате [7]: Pay per contact via chat messenger.
Дневной лимит (в копейках) Optional daily spending limit in kopecks. If set, caps daily expenditure for this bid.

Output

The node outputs JSON data representing the result of the bid setting operation for each input item. Each output item corresponds to one input and contains the response from the Avito API regarding the bid update.

No binary data output is indicated.

Dependencies

  • Requires an API authentication token credential for Avito OAuth2 API.
  • The node depends on internal routing utilities (routePromotionOperation) to handle promotion-related operations.
  • No additional external dependencies are explicitly required beyond the Avito API access.

Troubleshooting

  • Common issues:

    • Invalid or missing advertisement ID will cause errors; ensure the ID is correct and exists.
    • Bid values less than 1 kopeck are rejected; verify the bid amount meets minimum requirements.
    • Incorrect action type selection may lead to unexpected billing behavior.
    • Exceeding daily limits or misconfigured limits might cause partial or failed bid updates.

  • Error messages:

    • "Unknown resource" error if the resource parameter is incorrect.
    • API errors returned from Avito will be passed through; check the message for details like invalid credentials or quota exceeded.
    • If continueOnFail is disabled, the node execution stops on first error; enabling it allows processing remaining items.

Links and References

Discussion