← К справке

Avito Ads

Рекламные кампании и статистика

UnderscoreStat · 0.7.053

Справочник составлен по адаптеру и каталогу UnderscoreStat. Набор полей в конкретном ответе зависит от запроса, настроек и прав доступа.

Записей в справочнике — 131

Методы, параметры и ответ

ПолеОписание
POST /campaignsСписок кампаний в выбранном рекламном аккаунте.
POST /campaigns/{id}/statsСтатистика кампании за период.
dateFrom / dateToГраницы периода запроса.
campaign.idID кампании.
campaign.data[]Подневные строки кампании.
campaign.totalDataИтоги кампании за период.
campaign.data[].timestampДата строки с временной зоной.

Суточная статистика креатива

ПолеОписание
dateДата
campaign_idID кампании
campaign_nameНазвание кампании
group_idID группы
group_nameНазвание группы
creative_idID креатива
creative_nameНазвание креатива
viewsПоказы
clicksКлики
spend_rubРасход, ₽
bonus_rubРасход бонусами, ₽

Кампания

ПолеОписание
campaign.idКампания: ID
campaign.nameКампания: Название
campaign.accountIdКампания: accountId
campaign.advertiserIdКампания: advertiserId
campaign.contractIdКампания: contractId
campaign.additionalAgreementIDКампания: additionalAgreementID
campaign.managerIDКампания: managerID
campaign.userIdКампания: userId
campaign.statusКампания: Статус
campaign.statusReasonsКампания: Причины статуса
campaign.topStatusReasonКампания: Основная причина статуса
campaign.budgetКампания: Бюджет, ₽
campaign.budgetKopeksКампания: Бюджет, коп.
campaign.campaignTypeКампания: Тип кампании
campaign.paymentModelКампания: Модель оплаты
campaign.startDateКампания: Начало
campaign.endDateКампания: Окончание
campaign.createdAtКампания: Дата создания
campaign.updatedAtКампания: Дата изменения
campaign_jsonКампания — все поля (JSON)

Группа

ПолеОписание
group.idГруппа: ID
group.nameГруппа: Название
group.accountIDГруппа: accountID
group.advertiserIDГруппа: advertiserID
group.campaignIDГруппа: campaignID
group.managerIDГруппа: managerID
group.userIDГруппа: userID
group.statusГруппа: Статус
group.statusReasonsГруппа: Причины статуса
group.topStatusReasonГруппа: Основная причина статуса
group.actionsГруппа: actions
group.activityScheduleГруппа: Расписание (JSON)
group.audienceTypeГруппа: audienceType
group.budgetГруппа: Бюджет, ₽
group.budgetKopeksГруппа: Бюджет, коп.
group.budgetFrequencyГруппа: budgetFrequency
group.campaignTypeГруппа: Тип кампании
group.paymentModelГруппа: Модель оплаты
group.createdAtГруппа: Дата создания
group.updatedAtГруппа: Дата изменения
group.formatГруппа: format
group.frequencyCountГруппа: frequencyCount
group.frequencyPeriodГруппа: frequencyPeriod
group.frequencyRulesГруппа: frequencyRules
group.paceГруппа: pace
group.periodEndAtГруппа: periodEndAt
group.periodStartAtГруппа: periodStartAt
group.periodTimezoneГруппа: periodTimezone
group.priceГруппа: Ставка, ₽
group.priceKopeksГруппа: Ставка, коп.
group.priceControlГруппа: priceControl
group.scheduleTypeГруппа: scheduleType
group.startASAPГруппа: startASAP
group.haveCreativeГруппа: haveCreative
group.targetingAgeIDsГруппа: targetingAgeIDs
group.targetingInterestIDsГруппа: targetingInterestIDs
group.targetingLocationIDsГруппа: targetingLocationIDs
group_jsonГруппа — все поля (JSON)
group.activitySchedule.fridayГруппа: расписание — пятница
group.activitySchedule.mondayГруппа: расписание — понедельник
group.activitySchedule.saturdayГруппа: расписание — суббота
group.activitySchedule.sundayГруппа: расписание — воскресенье
group.activitySchedule.thursdayГруппа: расписание — четверг
group.activitySchedule.tuesdayГруппа: расписание — вторник
group.activitySchedule.wednesdayГруппа: расписание — среда
group.targetingGenderIDsГруппа: пол аудитории
group.targetingAudienceIDsГруппа: аудитории
group.targetingIncomeIDsГруппа: доход аудитории

Креатив

ПолеОписание
creative.idКреатив: ID
creative.nameКреатив: Название
creative.accountIDКреатив: accountID
creative.advertiserIDКреатив: advertiserID
creative.campaignIDКреатив: campaignID
creative.groupIDКреатив: groupID
creative.managerIDКреатив: managerID
creative.userIDКреатив: userID
creative.campaignTypeКреатив: Тип кампании
creative.paymentModelКреатив: Модель оплаты
creative.statusКреатив: Статус
creative.statusReasonsКреатив: Причины статуса
creative.topStatusReasonКреатив: Основная причина статуса
creative.titleКреатив: Заголовок
creative.descriptionКреатив: Описание
creative.buttonTextКреатив: Кнопка
creative.linkКреатив: Ссылка
creative.previewUrlКреатив: Предпросмотр
creative.legalInfoКреатив: Юридическая информация (JSON)
creative.kktuFieldsКреатив: ККТУ (JSON)
creative.createdAtКреатив: Дата создания
creative.updatedAtКреатив: Дата изменения
creative_jsonКреатив — все поля (JSON)
creative.legalInfo.kktuКреатив: код ККТУ
creative.legalInfo.notesКреатив: юридические сведения
creative.legalInfo.ageRestrictionКреатив: возрастное ограничение

Показатели API креатива

ПолеОписание
stats.timestampПоказатели API креатива: Дата и время API
stats.viewsПоказатели API креатива: Показы
stats.clicksПоказатели API креатива: Клики
stats.ctrПоказатели API креатива: CTR, доля из API
stats.spendПоказатели API креатива: Расход, целые ₽ из API
stats.spendKopeksПоказатели API креатива: Расход, коп.
stats.spendBonusПоказатели API креатива: Бонусный расход, ₽ из API
stats.spendBonusKopeksПоказатели API креатива: Бонусный расход, коп.
stats.cpcПоказатели API креатива: CPC, коп. из API
stats.cpmПоказатели API креатива: CPM, коп. из API
stats.videoViews25Показатели API креатива: videoViews25
stats.videoViews50Показатели API креатива: videoViews50
stats.videoViews75Показатели API креатива: videoViews75
stats.videoViews100Показатели API креатива: videoViews100
stats.q25Показатели API креатива: q25
stats.q50Показатели API креатива: q50
stats.q75Показатели API креатива: q75
stats.vtrПоказатели API креатива: VTR
stats_jsonПоказатели API креатива — все поля (JSON)