# Avito: описание выгружаемых полей

В этой статье собраны все поля, которые коннектор Avito выгружает в хранилище ROMI center. О периодичности выгрузки и расчёте денежных полей — в статье [Avito: как работает коннектор](https://help-ru.romi.center/avito-kak-rabotaet-konnektor).

Как читать таблицу:

*   **Название** — подпись поля в визарде подключения.
*   **Колонка в БД** — имя колонки в таблице хранилища.
*   **Поле API** — имя метрики в статистике Avito.
*   **Тип поля** — смысловой тип.

Каталог содержит 33 поля: дата, 8 полей объявления и пользователя, 24 метрики.

## Время

| Название | Колонка в БД | Тип поля |
| --- | --- | --- |
| Дата статистики | `stats_day` | Дата |

## Идентификация объявления

| Название | Колонка в БД | Поле API | Тип поля |
| --- | --- | --- | --- |
| Идентификатор объявления | `id` | `id` | Целое число |
| Название объявления | `item_title` | `item_title` | Строка |
| Адрес объявления | `item_address` | `item_address` | Строка |
| URL объявления | `item_url` | `item_url` | Строка |
| Идентификатор категории | `category_id` | `category_id` | Целое число |
| Название категории | `category_name` | `category_name` | Строка |

> **Примечание**
> Эти пять полей, кроме идентификатора, в статистике не приходят — при их выборе коннектор дополнительно обходит список объявлений аккаунта. Часть объявлений в этом списке иногда отсутствует, хотя статистика по ним есть: такие строки останутся без названия и категории.

## Пользователь

| Название | Колонка в БД | Поле API | Тип поля |
| --- | --- | --- | --- |
| Идентификатор пользователя | `user_id` | `user_id` | Целое число |
| Имя пользователя | `user_name` | `user_name` | Строка |

> **Примечание**
> Оба поля берутся не из статистики, а из самого подключения — одинаковые во всех строках.

## Показы и просмотры

| Название | Колонка в БД | Поле API | Тип поля |
| --- | --- | --- | --- |
| Просмотры | `views` | `views` | Целое число |
| Показы | `impressions` | `impressions` | Целое число |
| Целевые просмотры | `click_packages` | `clickPackages` | Целое число |

## Контакты и обращения

| Название | Колонка в БД | Поле API | Тип поля |
| --- | --- | --- | --- |
| Контакты | `contacts` | `contacts` | Целое число |
| Посмотрели телефон | `contacts_show_phone` | `contactsShowPhone` | Целое число |
| Написали в чат | `contacts_messenger` | `contactsMessenger` | Целое число |
| Посмотрели телефон и написали в чат | `contacts_show_phone_and_messenger` | `contactsShowPhoneAndMessenger` | Целое число |
| Откликнулись на скидку в чате | `contacts_sbc_discount` | `contactsSbcDiscount` | Целое число |

## Вакансии

| Название | Колонка в БД | Поле API | Тип поля |
| --- | --- | --- | --- |
| Отклики на вакансии | `job_contacts` | `jobContacts` | Целое число |

## Избранное

| Название | Колонка в БД | Поле API | Тип поля |
| --- | --- | --- | --- |
| Добавили в избранное | `favorites` | `favorites` | Целое число |

## Доставка и заказы

| Название | Колонка в БД | Поле API | Тип поля |
| --- | --- | --- | --- |
| Заказано товаров | `ordered_items` | `orderedItems` | Целое число |
| Стоимость заказанных товаров | `ordered_items_price` | `orderedItemsPrice` | Целое число |
| Доставлено товаров | `delivered_items` | `deliveredItems` | Целое число |
| Стоимость доставленных товаров | `delivered_items_price` | `deliveredItemsPrice` | Дробное число |

## Расходы

| Название | Колонка в БД | Поле API | Тип поля |
| --- | --- | --- | --- |
| Все расходы | `all_spending` | `allSpending` | Дробное число |
| Расходы на объявления | `spending` | `spending` | Дробное число |
| Расходы на размещение и целевые действия | `presence_spending` | `presenceSpending` | Дробное число |
| Расходы на продвижение | `promo_spending` | `promoSpending` | Дробное число |
| Остальные расходы | `rest_spending` | `restSpending` | Дробное число |
| Списано бонусов на объявления | `spending_bonus` | `spendingBonus` | Дробное число |
| Комиссия | `commission` | `commission` | Дробное число |

> **Важно**
> Все поля этого раздела, а также «Стоимость заказанных товаров» и «Стоимость доставленных товаров» — денежные: их можно выбрать в настройке «Поле расходов» и применить к ним исключение НДС и конвертацию валют. Первые шесть полей приходят в копейках и переводятся в рубли при записи; комиссия и стоимость заказанных/доставленных товаров приходят сразу в рублях.

## Активные объявления

| Название | Колонка в БД | Поле API | Тип поля |
| --- | --- | --- | --- |
| Активные объявления | `active_items` | `activeItems` | Целое число |
| Новые и опубликованные заново объявления | `new_active_items` | `newActiveItems` | Целое число |
| Активные с прошлого периода объявления | `old_active_items` | `oldActiveItems` | Целое число |

## Колонки конвертации валют

| Название | Колонка в БД | Тип поля |
| --- | --- | --- |
| Денежное поле в выбранной валюте | `<поле>_converted_<валюта>` | Дробное число |

Появляются по одной на каждую пару «выбранное денежное поле × выбранная валюта». Например, при выборе поля «Все расходы» и валют USD и EUR в таблице будут `all_spending_converted_usd` и `all_spending_converted_eur`.