Avito icon

Avito

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

Actions29

Overview

This node integrates with the Avito API to manage promotional settings for advertisements. Specifically, the "Настроить Авто Продвижение" (Set Auto Promotion) operation allows users to configure automatic promotion parameters such as budget and target action types for a given advertisement.

Typical use cases include:

  • Automatically setting a daily, weekly, or monthly budget for promoting an ad.
  • Selecting the type of user interaction to pay for, e.g., clicks, calls, or messenger contacts.
  • Managing advertising spend efficiently by automating promotion settings based on campaign goals.

For example, a business could use this node to automatically allocate a daily budget for an ad campaign that pays per click, ensuring consistent exposure without manual intervention.

Properties

Name Meaning
ID Объявления Unique numeric identifier of the advertisement to be promoted.
Тип События Type of target event to pay for. Options:
- Звонок [1]: Payment for calls generated by the ad.
- Пакет кликов [5]: Payment for clicks leading to the ad (default).
- Мессенджер, передача контакта в чате [7]: Payment for chat contact submissions.
Бюджет (в копейках) Budget amount in kopecks (smallest currency unit), must be at least 1.
Тип Бюджета Duration over which the budget is spent. Options:
- Дневной (1d): Daily budget.
- Недельный (7d): Weekly budget.
- Месячный (30d): Monthly budget.

Output

The node outputs JSON data representing the result of the promotion configuration operation. This typically includes confirmation details or updated promotion settings returned from the Avito API.

The output structure is an array of objects, each containing a json field with the API response related to the promotion operation, paired with the input item index.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the Avito API.
  • The node depends on internal routing utilities (RouterUtils) to handle different operations.
  • No additional external dependencies are explicitly required beyond the Avito API access.

Troubleshooting

  • Common issues:

    • Invalid or missing advertisement ID (ID Объявления) will cause errors.
    • Setting a budget less than 1 kopeck will be rejected.
    • Incorrect Тип События or unsupported combinations may lead to API errors.
    • Network or authentication failures with the Avito API can interrupt execution.

  • Error messages:

    • "Unknown resource": Occurs if the resource parameter is not recognized; ensure "promotion" is selected.
    • API error messages will be passed through in the output JSON under an error field if "Continue On Fail" is enabled.

  • Resolution tips:

    • Verify all required fields are correctly set.
    • Ensure valid API credentials are configured in n8n.
    • Check network connectivity and API status.
    • Use "Continue On Fail" cautiously to handle partial failures gracefully.

Links and References

Discussion