Какой тип отчёта выбрать?

Выбирайте фиксированный тип отчёта, когда нужна стандартная разбивка: Campaign performance report группирует по кампаниям, Ad performance report по объявлениям, Search query performance report по поисковым запросам. Выбирайте Custom report , когда нужна своя комбинация группировок или UTM-метки: это единственный тип отчёта, в котором доступны UTM-поля и ссылка объявления.

Почему я не вижу выпадающий список Ad accounts?

Список **Ad accounts** содержит логины клиентов агентского аккаунта. Если вы подключили обычный рекламный аккаунт, выбирать нечего: Renta скрывает этот список и выгружает данные по самому подключённому аккаунту.

Yandex Direct

Yandex Direct отдаёт статистику набором типов отчётов: от сводки по аккаунту до поисковых запросов, плюс произвольный отчёт с собственной группировкой. Renta выгружает любой из них в хранилище данных вместе с метаданными кампаний и групп объявлений: показы, клики, расход, конверсии, доход и видеометрики.

Аутентификация

Renta использует OAuth для аутентификации в Яндексе. Вы будете перенаправлены на страницу Яндекса, чтобы предоставить Renta ограниченный доступ к аккаунту Yandex Direct.

Ваши учётные данные шифруются при передаче и хранении и не сохраняются в прикладной базе данных Renta. Вы сохраняете контроль и можете отозвать доступ в настройках аккаунта Яндекса в любой момент.

Подключение источника Yandex Direct

Перейдите в каталогStep 1

Откройте раздел Connections > Catalog в левом меню.
Откройте категорию Advertising и нажмите карточку Yandex Direct.

Карточка Yandex Direct в категории Advertising каталога Renta

Авторизуйте подключениеStep 2

Нажмите Log in to your Yandex Direct account. Вы будете перенаправлены на страницу Яндекса для предоставления доступа.

Страница авторизации подключения Yandex Direct в Renta

Выберите аккаунт ЯндексаStep 3

Яндекс покажет экран входа со списком прав, которые запрашивает Renta, включая использование API Яндекс.Директа. Выберите аккаунт с доступом к вашим рекламным кампаниям и подтвердите. После этого вы вернётесь в Renta.

Страница входа Яндекса с выбором аккаунта и списком запрашиваемых прав

Назовите подключение и сохранитеStep 4

Завершите настройку:

Source name.
Укажите имя источника данных. Оно используется только в интерфейсе Renta.
Access granted.
Убедитесь, что аккаунт подключён успешно.

Нажмите Save, чтобы завершить.

Если авторизация в Яндексе изменится (например, после смены пароля), нажмите Re-authorize на этом источнике. Подключение обновится на месте, и все построенные на нём пайплайны продолжат работать.

Настройка подключения Yandex Direct с именем источника и предоставленным доступом

Источник созданStep 5

Новый источник появится в списке Sources со статусом Active. Теперь его можно использовать в пайплайнах.

Список источников с новым источником Yandex Direct

Создание пайплайна Yandex Direct

После подключения источника создайте пайплайн, чтобы выгружать данные Yandex Direct в назначение.

Выберите Yandex Direct как источникStep 1

В левом меню нажмите New pipeline. На шаге Source выберите Yandex Direct в разделе Already connected и нажмите Next step.

Шаг выбора источника с Yandex Direct в разделе Already connected

Выберите подключение Yandex DirectStep 2

Выберите созданное ранее подключение Yandex Direct и нажмите Next step.

Выберите назначениеStep 3

На шаге Destination выберите назначение (например, Google BigQuery) и нажмите Next step.

Выберите подключение назначенияStep 4

Выберите подключение назначения, в которое нужно загружать данные, и нажмите Next step.

Настройка пайплайна

На последнем шаге выберите, какие данные Yandex Direct выгружать и как Renta будет их загружать.

Конфигурация отчёта

Сначала выберите тип отчёта. Он определяет группировку статистики и набор полей, доступных в списке Parameters.

Выбор типа отчёта Yandex Direct с настройками Parameters, Include VAT и Include discount

Тип отчёта	Описание
Account performance report	Статистика по всему рекламному аккаунту, без разбивки по кампаниям и объявлениям.
Campaign performance report	Статистика с группировкой по кампаниям.
Ad Group performance report	Статистика с группировкой по группам объявлений.
Ad performance report	Статистика с группировкой по объявлениям.
Criteria performance report	Статистика с группировкой по условиям показа: группа объявлений, идентификатор и тип условия.
Custom report	Статистика с произвольной группировкой. Единственный тип отчёта, в котором доступны UTM-метки и ссылка объявления.
Reach and frequency performance report	Статистика по медийным кампаниям, включая видеометрики: просмотры, квартили и досмотры. Кампании других типов игнорируются.
Search query performance report	Статистика с группировкой по группам объявлений и поисковым запросам, с ключевой фразой, по которой прошёл показ.
Campaign objects data	Атрибуты объекта кампании: имя, тип, статус, валюта, дневной бюджет, даты начала и окончания, менеджер и агентство.
Ad group objects data	Атрибуты объекта группы объявлений: имя, кампания, тип, подтип, статус, статус показов и параметры отслеживания.

Над типом отчёта появляется список Ad accounts, если подключён агентский аккаунт: в нём перечислены логины клиентов агентства, и пайплайн выгружает данные по выбранному логину. Для обычного рекламного аккаунта выбирать нечего, поэтому Renta скрывает этот список и выгружает данные по самому подключённому аккаунту.

Параметры

Выберите поля для таблицы назначения. Схема набора данных определяется выбранными здесь параметрами.

Выбор параметров Yandex Direct со вкладками Parameters и Selected и кнопкой Select All

Тип отчёта

Поиск

Название	Имя в API	Описание
Campaign Type text	`CampaignType`	Type of campaign.
Carrier Type text	`CarrierType`	Type of connection.
Ad Format text	`AdFormat`	The format of the ad.
Ad Network Type text	`AdNetworkType`	The type of ad network.
Age text	`Age`	The age category of the audience.
Avg Click Position float	`AvgClickPosition`	The average position of the clicks.
AvgImpressionPosition float	`AvgImpressionPosition`	Average ad display position.
Avg Effective Bid float	`AvgEffectiveBid`	Average rate per click including all adjustments.
Avg Traffic Volume float	`AvgTrafficVolume`	Average volume of traffic from the positions on which the ad was shown.
Avg Pageviews float	`AvgPageviews`	Average depth of site browsing, i.e. the number of pages viewed (according to Yandex Metrics).
AvgCpc float	`AvgCpc`	The average cost-per-click.
Bounce Rate float	`BounceRate`	Share of refusals in the total number of visits, in percent (according to Yandex Metrics).
Client Login text	`ClientLogin`	The login of the client.
Conversion Rate float	`ConversionRate`	The rate of conversions relative to the total number of clicks.
Conversions int	`Conversions`	The total number of conversions.
Cost float	`Cost`	The total cost of the campaign.
Cost Per Conversion float	`CostPerConversion`	The cost per individual conversion.
Criteria Type text	`CriteriaType`	The type of criteria used for the ad display.
Criterion Type text	`CriterionType`	The type of criterion used for the ad display.
Ctr float	`Ctr`	Click-through rate, the ratio of clicks to impressions.
Clicks int	`Clicks`	Number of clicks.
Click Type text	`ClickType`	Which part of the ad the user clicked on.
Device text	`Device`	The type of device used.
External Network Name text	`ExternalNetworkName`	The name of the external network.
Gender text	`Gender`	The gender of the audience.
Goals Roi float	`GoalsRoi`	Return on investment for the specified goals.
Impressions int	`Impressions`	The total number of ad impressions.
Income Grade text	`IncomeGrade`	The income grade of the audience.
Location Of PresenceId text	`LocationOfPresenceId`	The identifier for the location of presence.
Location Of Presence Name text	`LocationOfPresenceName`	The name of the location of presence.
Match Type text	`MatchType`	The type of match for the keyword.
Mobile Platform text	`MobilePlatform`	The mobile platform on which the ad was displayed.
Placement text	`Placement`	The placement of the ad.
Profit float	`Profit`	The profit generated from the campaign.
Revenue float	`Revenue`	The total revenue generated from the campaign.
Sessions int	`Sessions`	The total number of sessions.
Slot text	`Slot`	The ad slot in which the ad was displayed.
Targeting Category text	`TargetingCategory`	The category used for targeting the ad.
Targeting Location Id text	`TargetingLocationId`	The identifier for the targeting location.
Targeting Location Name text	`TargetingLocationName`	The name of the targeting location.
Weighted Ctr float	`WeightedCtr`	The weighted click-through rate.
Weighted Impressions float	`WeightedImpressions`	The number of weighted impressions.
Today date	`date_today`	Today's date
Year text	`year`	Year of the date
Year of week (Sun-Sat) text	`yearofweek`	Year of week for US weeks
Year of week (Mon-Sun) text	`yearofweekiso`	Year of week for ISO weeks
Year & month text	`yearmonth`	Year and month combined
Quarter text	`quarter`	Quarter of the year
Month text	`month`	Month of the year
Year & week (Sun-Sat) text	`yearweek`	Year and week for US weeks
Year & week (Mon-Sun) text	`yearweekiso`	Year and week for ISO weeks
Week (Sun-Sat) text	`week`	US week number
Week (Mon-Sun) text	`weekiso`	ISO week number
Day of week (Sun-Sat) text	`dayOfWeekName`	Day of week name for US weeks
Day of week text	`dayOfWeekNameIso`	Day of week name for ISO weeks (Mon-Sun)
Day of month text	`dayOfMonth`	Day of the month
Date date	`date`	Specific date

Название	Имя в API	Описание
Campaign Id text	`CampaignId`	The unique identifier of the advertising campaign.
Campaign Name text	`CampaignName`	The name of the advertising campaign.
Campaign Url Path text	`CampaignUrlPath`	The URL specified in the ad campaign settings.
Campaign Type text	`CampaignType`	Type of campaign.
Carrier Type text	`CarrierType`	Type of connection.
Ad Format text	`AdFormat`	The format of the ad.
Ad Network Type text	`AdNetworkType`	The type of ad network.
Age text	`Age`	The age category of the audience.
Avg Click Position float	`AvgClickPosition`	The average position of the clicks.
AvgImpressionPosition float	`AvgImpressionPosition`	Average ad display position.
Avg Effective Bid float	`AvgEffectiveBid`	Average rate per click including all adjustments.
Avg Traffic Volume float	`AvgTrafficVolume`	Average volume of traffic from the positions on which the ad was shown.
Avg Pageviews float	`AvgPageviews`	Average depth of site browsing, i.e. the number of pages viewed (according to Yandex Metrics).
AvgCpc float	`AvgCpc`	The average cost-per-click.
Bounce Rate float	`BounceRate`	Share of refusals in the total number of visits, in percent (according to Yandex Metrics).
Client Login text	`ClientLogin`	The login of the client.
Conversion Rate float	`ConversionRate`	The rate of conversions relative to the total number of clicks.
Conversions int	`Conversions`	The total number of conversions.
Cost float	`Cost`	The total cost of the campaign.
Cost Per Conversion float	`CostPerConversion`	The cost per individual conversion.
Criteria Type text	`CriteriaType`	The type of criteria used for the ad display.
Criterion Type text	`CriterionType`	The type of criterion used for the ad display.
Ctr float	`Ctr`	Click-through rate, the ratio of clicks to impressions.
Clicks int	`Clicks`	Number of clicks.
Click Type text	`ClickType`	Which part of the ad the user clicked on.
Device text	`Device`	The type of device used.
External Network Name text	`ExternalNetworkName`	The name of the external network.
Gender text	`Gender`	The gender of the audience.
Goals Roi float	`GoalsRoi`	Return on investment for the specified goals.
Impressions int	`Impressions`	The total number of ad impressions.
Income Grade text	`IncomeGrade`	The income grade of the audience.
Location Of PresenceId text	`LocationOfPresenceId`	The identifier for the location of presence.
Location Of Presence Name text	`LocationOfPresenceName`	The name of the location of presence.
Match Type text	`MatchType`	The type of match for the keyword.
Mobile Platform text	`MobilePlatform`	The mobile platform on which the ad was displayed.
Placement text	`Placement`	The placement of the ad.
Profit float	`Profit`	The profit generated from the campaign.
Revenue float	`Revenue`	The total revenue generated from the campaign.
Sessions int	`Sessions`	The total number of sessions.
Slot text	`Slot`	The ad slot in which the ad was displayed.
Targeting Category text	`TargetingCategory`	The category used for targeting the ad.
Targeting Location Id text	`TargetingLocationId`	The identifier for the targeting location.
Targeting Location Name text	`TargetingLocationName`	The name of the targeting location.
Weighted Ctr float	`WeightedCtr`	The weighted click-through rate.
Weighted Impressions float	`WeightedImpressions`	The number of weighted impressions.
Today date	`date_today`	Today's date
Year text	`year`	Year of the date
Year of week (Sun-Sat) text	`yearofweek`	Year of week for US weeks
Year of week (Mon-Sun) text	`yearofweekiso`	Year of week for ISO weeks
Year & month text	`yearmonth`	Year and month combined
Quarter text	`quarter`	Quarter of the year
Month text	`month`	Month of the year
Year & week (Sun-Sat) text	`yearweek`	Year and week for US weeks
Year & week (Mon-Sun) text	`yearweekiso`	Year and week for ISO weeks
Week (Sun-Sat) text	`week`	US week number
Week (Mon-Sun) text	`weekiso`	ISO week number
Day of week (Sun-Sat) text	`dayOfWeekName`	Day of week name for US weeks
Day of week text	`dayOfWeekNameIso`	Day of week name for ISO weeks (Mon-Sun)
Day of month text	`dayOfMonth`	Day of the month
Date date	`date`	Specific date

Название	Имя в API	Описание
Campaign Id text	`CampaignId`	The unique identifier of the advertising campaign.
Campaign Name text	`CampaignName`	The name of the advertising campaign.
Campaign Url Path text	`CampaignUrlPath`	The URL specified in the ad campaign settings.
Campaign Type text	`CampaignType`	Type of campaign.
Carrier Type text	`CarrierType`	Type of connection.
Ad Format text	`AdFormat`	The format of the ad.
Ad Group Id text	`AdGroupId`	The identifier of the ad group.
Ad Group Name text	`AdGroupName`	The name of the ad group.
Ad Network Type text	`AdNetworkType`	The type of ad network.
Age text	`Age`	The age category of the audience.
Avg Click Position float	`AvgClickPosition`	The average position of the clicks.
AvgImpressionPosition float	`AvgImpressionPosition`	Average ad display position.
Avg Effective Bid float	`AvgEffectiveBid`	Average rate per click including all adjustments.
Avg Traffic Volume float	`AvgTrafficVolume`	Average volume of traffic from the positions on which the ad was shown.
Avg Pageviews float	`AvgPageviews`	Average depth of site browsing, i.e. the number of pages viewed (according to Yandex Metrics).
AvgCpc float	`AvgCpc`	The average cost-per-click.
Bounce Rate float	`BounceRate`	Share of refusals in the total number of visits, in percent (according to Yandex Metrics).
Client Login text	`ClientLogin`	The login of the client.
Conversion Rate float	`ConversionRate`	The rate of conversions relative to the total number of clicks.
Conversions int	`Conversions`	The total number of conversions.
Cost float	`Cost`	The total cost of the campaign.
Cost Per Conversion float	`CostPerConversion`	The cost per individual conversion.
Criteria Type text	`CriteriaType`	The type of criteria used for the ad display.
Criterion Type text	`CriterionType`	The type of criterion used for the ad display.
Ctr float	`Ctr`	Click-through rate, the ratio of clicks to impressions.
Clicks int	`Clicks`	Number of clicks.
Click Type text	`ClickType`	Which part of the ad the user clicked on.
Device text	`Device`	The type of device used.
External Network Name text	`ExternalNetworkName`	The name of the external network.
Gender text	`Gender`	The gender of the audience.
Goals Roi float	`GoalsRoi`	Return on investment for the specified goals.
Impressions int	`Impressions`	The total number of ad impressions.
Income Grade text	`IncomeGrade`	The income grade of the audience.
Location Of PresenceId text	`LocationOfPresenceId`	The identifier for the location of presence.
Location Of Presence Name text	`LocationOfPresenceName`	The name of the location of presence.
Match Type text	`MatchType`	The type of match for the keyword.
Mobile Platform text	`MobilePlatform`	The mobile platform on which the ad was displayed.
Placement text	`Placement`	The placement of the ad.
Profit float	`Profit`	The profit generated from the campaign.
Revenue float	`Revenue`	The total revenue generated from the campaign.
Sessions int	`Sessions`	The total number of sessions.
Slot text	`Slot`	The ad slot in which the ad was displayed.
Targeting Category text	`TargetingCategory`	The category used for targeting the ad.
Targeting Location Id text	`TargetingLocationId`	The identifier for the targeting location.
Targeting Location Name text	`TargetingLocationName`	The name of the targeting location.
Weighted Ctr float	`WeightedCtr`	The weighted click-through rate.
Weighted Impressions float	`WeightedImpressions`	The number of weighted impressions.
Today date	`date_today`	Today's date
Year text	`year`	Year of the date
Year of week (Sun-Sat) text	`yearofweek`	Year of week for US weeks
Year of week (Mon-Sun) text	`yearofweekiso`	Year of week for ISO weeks
Year & month text	`yearmonth`	Year and month combined
Quarter text	`quarter`	Quarter of the year
Month text	`month`	Month of the year
Year & week (Sun-Sat) text	`yearweek`	Year and week for US weeks
Year & week (Mon-Sun) text	`yearweekiso`	Year and week for ISO weeks
Week (Sun-Sat) text	`week`	US week number
Week (Mon-Sun) text	`weekiso`	ISO week number
Day of week (Sun-Sat) text	`dayOfWeekName`	Day of week name for US weeks
Day of week text	`dayOfWeekNameIso`	Day of week name for ISO weeks (Mon-Sun)
Day of month text	`dayOfMonth`	Day of the month
Date date	`date`	Specific date

Название	Имя в API	Описание
Campaign Id text	`CampaignId`	The unique identifier of the advertising campaign.
Campaign Name text	`CampaignName`	The name of the advertising campaign.
Campaign Url Path text	`CampaignUrlPath`	The URL specified in the ad campaign settings.
Campaign Type text	`CampaignType`	Type of campaign.
Carrier Type text	`CarrierType`	Type of connection.
Ad Format text	`AdFormat`	The format of the ad.
Ad Group Id text	`AdGroupId`	The identifier of the ad group.
Ad Group Name text	`AdGroupName`	The name of the ad group.
Ad Id text	`AdId`	The identifier of the ad.
Ad Network Type text	`AdNetworkType`	The type of ad network.
Age text	`Age`	The age category of the audience.
Avg Click Position float	`AvgClickPosition`	The average position of the clicks.
Avg Effective Bid float	`AvgEffectiveBid`	Average rate per click including all adjustments.
Avg Traffic Volume float	`AvgTrafficVolume`	Average volume of traffic from the positions on which the ad was shown.
Avg Pageviews float	`AvgPageviews`	Average depth of site browsing, i.e. the number of pages viewed (according to Yandex Metrics).
AvgCpc float	`AvgCpc`	The average cost-per-click.
Bounce Rate float	`BounceRate`	Share of refusals in the total number of visits, in percent (according to Yandex Metrics).
Client Login text	`ClientLogin`	The login of the client.
Conversion Rate float	`ConversionRate`	The rate of conversions relative to the total number of clicks.
Conversions int	`Conversions`	The total number of conversions.
Cost float	`Cost`	The total cost of the campaign.
Cost Per Conversion float	`CostPerConversion`	The cost per individual conversion.
Criteria text	`Criteria`	The criteria used for the ad display.
Criteria Id text	`CriteriaId`	The identifier for the criteria used.
Criteria Type text	`CriteriaType`	The type of criteria used for the ad display.
Criterion Type text	`CriterionType`	The type of criterion used for the ad display.
Ctr float	`Ctr`	Click-through rate, the ratio of clicks to impressions.
Clicks int	`Clicks`	Number of clicks.
Click Type text	`ClickType`	Which part of the ad the user clicked on.
Device text	`Device`	The type of device used.
External Network Name text	`ExternalNetworkName`	The name of the external network.
Gender text	`Gender`	The gender of the audience.
Goals Roi float	`GoalsRoi`	Return on investment for the specified goals.
Impressions int	`Impressions`	The total number of ad impressions.
Income Grade text	`IncomeGrade`	The income grade of the audience.
Location Of PresenceId text	`LocationOfPresenceId`	The identifier for the location of presence.
Location Of Presence Name text	`LocationOfPresenceName`	The name of the location of presence.
Match Type text	`MatchType`	The type of match for the keyword.
Mobile Platform text	`MobilePlatform`	The mobile platform on which the ad was displayed.
Placement text	`Placement`	The placement of the ad.
Profit float	`Profit`	The profit generated from the campaign.
Revenue float	`Revenue`	The total revenue generated from the campaign.
Sessions int	`Sessions`	The total number of sessions.
Slot text	`Slot`	The ad slot in which the ad was displayed.
Targeting Category text	`TargetingCategory`	The category used for targeting the ad.
Targeting Location Id text	`TargetingLocationId`	The identifier for the targeting location.
Targeting Location Name text	`TargetingLocationName`	The name of the targeting location.
Weighted Ctr float	`WeightedCtr`	The weighted click-through rate.
Weighted Impressions float	`WeightedImpressions`	The number of weighted impressions.
Today date	`date_today`	Today's date
Year text	`year`	Year of the date
Year of week (Sun-Sat) text	`yearofweek`	Year of week for US weeks
Year of week (Mon-Sun) text	`yearofweekiso`	Year of week for ISO weeks
Year & month text	`yearmonth`	Year and month combined
Quarter text	`quarter`	Quarter of the year
Month text	`month`	Month of the year
Year & week (Sun-Sat) text	`yearweek`	Year and week for US weeks
Year & week (Mon-Sun) text	`yearweekiso`	Year and week for ISO weeks
Week (Sun-Sat) text	`week`	US week number
Week (Mon-Sun) text	`weekiso`	ISO week number
Day of week (Sun-Sat) text	`dayOfWeekName`	Day of week name for US weeks
Day of week text	`dayOfWeekNameIso`	Day of week name for ISO weeks (Mon-Sun)
Day of month text	`dayOfMonth`	Day of the month
Date date	`date`	Specific date

Название	Имя в API	Описание
Campaign Id text	`CampaignId`	The unique identifier of the advertising campaign.
Campaign Name text	`CampaignName`	The name of the advertising campaign.
Campaign Url Path text	`CampaignUrlPath`	The URL specified in the ad campaign settings.
Campaign Type text	`CampaignType`	Type of campaign.
Carrier Type text	`CarrierType`	Type of connection.
Ad Group Id text	`AdGroupId`	The identifier of the ad group.
Ad Group Name text	`AdGroupName`	The name of the ad group.
Ad Network Type text	`AdNetworkType`	The type of ad network.
Age text	`Age`	The age category of the audience.
Avg Click Position float	`AvgClickPosition`	The average position of the clicks.
Avg Impression Position float	`AvgImpressionPosition`	Average ad display position.
Avg Effective Bid float	`AvgEffectiveBid`	Average rate per click including all adjustments.
Avg Traffic Volume float	`AvgTrafficVolume`	Average volume of traffic from the positions on which the ad was shown.
Avg Pageviews float	`AvgPageviews`	Average depth of site browsing, i.e. the number of pages viewed (according to Yandex Metrics).
AvgCpc float	`AvgCpc`	The average cost-per-click.
Bounce Rate float	`BounceRate`	Share of refusals in the total number of visits, in percent (according to Yandex Metrics).
Client Login text	`ClientLogin`	The login of the client.
Conversion Rate float	`ConversionRate`	The rate of conversions relative to the total number of clicks.
Conversions int	`Conversions`	The total number of conversions.
Cost float	`Cost`	The total cost of the campaign.
Cost Per Conversion float	`CostPerConversion`	The cost per individual conversion.
Criteria text	`Criteria`	The criteria used for the ad display.
Criteria Id text	`CriteriaId`	The identifier for the criteria used.
Criteria Type text	`CriteriaType`	The type of criteria used for the ad display.
Criterion text	`Criterion`	The specific criterion used for the ad display.
Criterion Id text	`CriterionId`	The identifier of the specific criterion used.
Criterion Type text	`CriterionType`	The type of criterion used for the ad display.
Ctr float	`Ctr`	Click-through rate, the ratio of clicks to impressions.
Clicks int	`Clicks`	Number of clicks.
Click Type text	`ClickType`	Which part of the ad the user clicked on.
Device text	`Device`	The type of device used.
External Network Name text	`ExternalNetworkName`	The name of the external network.
Gender text	`Gender`	The gender of the audience.
Goals Roi float	`GoalsRoi`	Return on investment for the specified goals.
Impressions int	`Impressions`	The total number of ad impressions.
Income Grade text	`IncomeGrade`	The income grade of the audience.
Location Of PresenceId text	`LocationOfPresenceId`	The identifier for the location of presence.
Location Of Presence Name text	`LocationOfPresenceName`	The name of the location of presence.
Match Type text	`MatchType`	The type of match for the keyword.
Mobile Platform text	`MobilePlatform`	The mobile platform on which the ad was displayed.
Placement text	`Placement`	The placement of the ad.
Profit float	`Profit`	The profit generated from the campaign.
Revenue float	`Revenue`	The total revenue generated from the campaign.
RlAdjustmentId text	`RlAdjustmentId`	The identifier for the RL adjustment.
Sessions int	`Sessions`	The total number of sessions.
Slot text	`Slot`	The ad slot in which the ad was displayed.
Targeting Category text	`TargetingCategory`	The category used for targeting the ad.
Targeting Location Id text	`TargetingLocationId`	The identifier for the targeting location.
Targeting Location Name text	`TargetingLocationName`	The name of the targeting location.
Weighted Ctr float	`WeightedCtr`	The weighted click-through rate.
Weighted Impressions float	`WeightedImpressions`	The number of weighted impressions.
Today date	`date_today`	Today's date
Year text	`year`	Year of the date
Year of week (Sun-Sat) text	`yearofweek`	Year of week for US weeks
Year of week (Mon-Sun) text	`yearofweekiso`	Year of week for ISO weeks
Year & month text	`yearmonth`	Year and month combined
Quarter text	`quarter`	Quarter of the year
Month text	`month`	Month of the year
Year & week (Sun-Sat) text	`yearweek`	Year and week for US weeks
Year & week (Mon-Sun) text	`yearweekiso`	Year and week for ISO weeks
Week (Sun-Sat) text	`week`	US week number
Week (Mon-Sun) text	`weekiso`	ISO week number
Day of week (Sun-Sat) text	`dayOfWeekName`	Day of week name for US weeks
Day of week text	`dayOfWeekNameIso`	Day of week name for ISO weeks (Mon-Sun)
Day of month text	`dayOfMonth`	Day of the month
Date date	`date`	Specific date

Название	Имя в API	Описание
Campaign Id text	`CampaignId`	The unique identifier of the advertising campaign.
Campaign Name text	`CampaignName`	The name of the advertising campaign.
Campaign Url Path text	`CampaignUrlPath`	The URL specified in the ad campaign settings.
Campaign Type text	`CampaignType`	Type of campaign.
Carrier Type text	`CarrierType`	Type of connection.
Ad Format text	`AdFormat`	The format of the ad.
Ad Group Id text	`AdGroupId`	The identifier of the ad group.
Ad Group Name text	`AdGroupName`	The name of the ad group.
Ad Id text	`AdId`	The identifier of the ad.
Ad Network Type text	`AdNetworkType`	The type of ad network.
Age text	`Age`	The age category of the audience.
Avg Click Position float	`AvgClickPosition`	The average position of the clicks.
AvgImpressionPosition float	`AvgImpressionPosition`	Average ad display position.
Avg Effective Bid float	`AvgEffectiveBid`	Average rate per click including all adjustments.
Avg Traffic Volume float	`AvgTrafficVolume`	Average volume of traffic from the positions on which the ad was shown.
Avg Pageviews float	`AvgPageviews`	Average depth of site browsing, i.e. the number of pages viewed (according to Yandex Metrics).
AvgCpc float	`AvgCpc`	The average cost-per-click.
Bounce Rate float	`BounceRate`	Share of refusals in the total number of visits, in percent (according to Yandex Metrics).
Client Login text	`ClientLogin`	The login of the client.
Conversion Rate float	`ConversionRate`	The rate of conversions relative to the total number of clicks.
Conversions int	`Conversions`	The total number of conversions.
Cost float	`Cost`	The total cost of the campaign.
Cost Per Conversion float	`CostPerConversion`	The cost per individual conversion.
Criteria text	`Criteria`	The criteria used for the ad display.
Criteria Id text	`CriteriaId`	The identifier for the criteria used.
Criteria Type text	`CriteriaType`	The type of criteria used for the ad display.
Criterion text	`Criterion`	The specific criterion used for the ad display.
Criterion Id text	`CriterionId`	The identifier of the specific criterion used.
Criterion Type text	`CriterionType`	The type of criterion used for the ad display.
Ctr float	`Ctr`	Click-through rate, the ratio of clicks to impressions.
Clicks int	`Clicks`	Number of clicks.
Click Type text	`ClickType`	Which part of the ad the user clicked on.
Device text	`Device`	The type of device used.
External Network Name text	`ExternalNetworkName`	The name of the external network.
Gender text	`Gender`	The gender of the audience.
Goals Roi float	`GoalsRoi`	Return on investment for the specified goals.
Impressions int	`Impressions`	The total number of ad impressions.
Income Grade text	`IncomeGrade`	The income grade of the audience.
Location Of PresenceId text	`LocationOfPresenceId`	The identifier for the location of presence.
Location Of Presence Name text	`LocationOfPresenceName`	The name of the location of presence.
Match Type text	`MatchType`	The type of match for the keyword.
Mobile Platform text	`MobilePlatform`	The mobile platform on which the ad was displayed.
Placement text	`Placement`	The placement of the ad.
Profit float	`Profit`	The profit generated from the campaign.
Revenue float	`Revenue`	The total revenue generated from the campaign.
RlAdjustmentId text	`RlAdjustmentId`	The identifier for the RL adjustment.
Sessions int	`Sessions`	The total number of sessions.
Slot text	`Slot`	The ad slot in which the ad was displayed.
Targeting Category text	`TargetingCategory`	The category used for targeting the ad.
Targeting Location Id text	`TargetingLocationId`	The identifier for the targeting location.
Targeting Location Name text	`TargetingLocationName`	The name of the targeting location.
Weighted Ctr float	`WeightedCtr`	The weighted click-through rate.
Weighted Impressions float	`WeightedImpressions`	The number of weighted impressions.
UTM-medium text	`utm_medium`	Value of utm-medium extracted from ad url.
UTM-source text	`utm_source`	Value of utm-source extracted from ad url.
UTM-campaign text	`utm_campaign`	Value of utm-campaign extracted from ad url.
UTM-content text	`utm_content`	Value of utm-content extracted from ad url.
UTM-term text	`utm_term`	Value of utm-term extracted from ad url.
Ad URL text	`Href`	Extracted url of the ad with get parameters.
Today date	`date_today`	Today's date
Year text	`year`	Year of the date
Year of week (Sun-Sat) text	`yearofweek`	Year of week for US weeks
Year of week (Mon-Sun) text	`yearofweekiso`	Year of week for ISO weeks
Year & month text	`yearmonth`	Year and month combined
Quarter text	`quarter`	Quarter of the year
Month text	`month`	Month of the year
Year & week (Sun-Sat) text	`yearweek`	Year and week for US weeks
Year & week (Mon-Sun) text	`yearweekiso`	Year and week for ISO weeks
Week (Sun-Sat) text	`week`	US week number
Week (Mon-Sun) text	`weekiso`	ISO week number
Day of week (Sun-Sat) text	`dayOfWeekName`	Day of week name for US weeks
Day of week text	`dayOfWeekNameIso`	Day of week name for ISO weeks (Mon-Sun)
Day of month text	`dayOfMonth`	Day of the month
Date date	`date`	Specific date

Название	Имя в API	Описание
Campaign Id text	`CampaignId`	The unique identifier of the advertising campaign.
Campaign Name text	`CampaignName`	The name of the advertising campaign.
Campaign Url Path text	`CampaignUrlPath`	The URL specified in the ad campaign settings.
Campaign Type text	`CampaignType`	Type of campaign.
Ad Group Id text	`AdGroupId`	The identifier of the ad group.
Ad Group Name text	`AdGroupName`	The name of the ad group.
Ad Id text	`AdId`	The identifier of the ad.
Age text	`Age`	The age category of the audience.
AvgCpm float	`AvgCpm`	The average cost-per-impression.
Avg Impression Frequency float	`AvgImpressionFrequency`	Average frequency of impressions per user, to two decimal places.
Avg Impression Position float	`AvgImpressionPosition`	Average ad display position.
Avg Effective Bid float	`AvgEffectiveBid`	Average rate per click including all adjustments.
Avg Video Complete Cost float	`AvgVideoCompleteCost`	Average inspection price of a 100% clip, in RUB.
Avg Traffic Volume float	`AvgTrafficVolume`	Average volume of traffic from the positions on which the ad was shown.
Avg Pageviews float	`AvgPageviews`	Average depth of site browsing, i.e. the number of pages viewed (according to Yandex Metrics).
AvgCpc float	`AvgCpc`	The average cost-per-click.
Bounce Rate float	`BounceRate`	Share of refusals in the total number of visits, in percent (according to Yandex Metrics).
Client Login text	`ClientLogin`	The login of the client.
Conversion Rate float	`ConversionRate`	The rate of conversions relative to the total number of clicks.
Conversions int	`Conversions`	The total number of conversions.
Cost float	`Cost`	The total cost of the campaign.
Cost Per Conversion float	`CostPerConversion`	The cost per individual conversion.
CPV float	`CPV`	Cost per view for video ads in RUB.
Ctr float	`Ctr`	Click-through rate, the ratio of clicks to impressions.
Clicks int	`Clicks`	Number of clicks.
Device text	`Device`	The type of device used.
Gender text	`Gender`	The gender of the audience.
Goals Roi float	`GoalsRoi`	Return on investment for the specified goals.
Impressions int	`Impressions`	The total number of ad impressions.
Profit float	`Profit`	The profit generated from the campaign.
Revenue float	`Revenue`	The total revenue generated from the campaign.
Sessions int	`Sessions`	The total number of sessions.
Targeting Location Id text	`TargetingLocationId`	The identifier for the targeting location.
Targeting Location Name text	`TargetingLocationName`	The name of the targeting location.
Video Complete float	`VideoComplete`	The number of times the video ad was watched to completion.
Video Complete Rate float	`VideoCompleteRate`	The rate at which the video ad was watched to completion.
Video First Quartile float	`VideoFirstQuartile`	The number of times the video ad was watched to the first quartile.
Video First Quartile Rate float	`VideoFirstQuartileRate`	The rate at which the video ad was watched to the first quartile.
Video Midpoint float	`VideoMidpoint`	The number of times the video ad was watched to its midpoint.
Video Midpoint Rate float	`VideoMidpointRate`	The rate at which the video ad was watched to its midpoint.
Video Third Quartile float	`VideoThirdQuartile`	The number of times the video ad was watched to the third quartile.
Video Third Quartile Rate float	`VideoThirdQuartileRate`	The rate at which the video ad was watched to the third quartile.
Video Views float	`VideoViews`	The total number of views for the video ad.
Video Views Rate float	`VideoViewsRate`	The rate of views for the video ad.
Weighted Ctr float	`WeightedCtr`	The weighted click-through rate.
Weighted Impressions float	`WeightedImpressions`	The number of weighted impressions.
Today date	`date_today`	Today's date
Year text	`year`	Year of the date
Year of week (Sun-Sat) text	`yearofweek`	Year of week for US weeks
Year of week (Mon-Sun) text	`yearofweekiso`	Year of week for ISO weeks
Year & month text	`yearmonth`	Year and month combined
Quarter text	`quarter`	Quarter of the year
Month text	`month`	Month of the year
Year & week (Sun-Sat) text	`yearweek`	Year and week for US weeks
Year & week (Mon-Sun) text	`yearweekiso`	Year and week for ISO weeks
Week (Sun-Sat) text	`week`	US week number
Week (Mon-Sun) text	`weekiso`	ISO week number
Day of week (Sun-Sat) text	`dayOfWeekName`	Day of week name for US weeks
Day of week text	`dayOfWeekNameIso`	Day of week name for ISO weeks (Mon-Sun)
Day of month text	`dayOfMonth`	Day of the month
Date date	`date`	Specific date

Название	Имя в API	Описание
Campaign Id text	`CampaignId`	The unique identifier of the advertising campaign.
Campaign Name text	`CampaignName`	The name of the advertising campaign.
Campaign Url Path text	`CampaignUrlPath`	The URL specified in the ad campaign settings.
Campaign Type text	`CampaignType`	Type of campaign.
Ad Group Id text	`AdGroupId`	The identifier of the ad group.
Ad Group Name text	`AdGroupName`	The name of the ad group.
Ad Id text	`AdId`	The identifier of the ad.
Avg Click Position float	`AvgClickPosition`	The average position of the clicks.
Avg Impression Position float	`AvgImpressionPosition`	Average ad display position.
Avg Effective Bid float	`AvgEffectiveBid`	Average rate per click including all adjustments.
Avg Traffic Volume float	`AvgTrafficVolume`	Average volume of traffic from the positions on which the ad was shown.
Avg Pageviews float	`AvgPageviews`	Average depth of site browsing, i.e. the number of pages viewed (according to Yandex Metrics).
AvgCpc float	`AvgCpc`	The average cost-per-click.
Bounce Rate float	`BounceRate`	Share of refusals in the total number of visits, in percent (according to Yandex Metrics).
Client Login text	`ClientLogin`	The login of the client.
Conversion Rate float	`ConversionRate`	The rate of conversions relative to the total number of clicks.
Conversions int	`Conversions`	The total number of conversions.
Cost float	`Cost`	The total cost of the campaign.
Cost Per Conversion float	`CostPerConversion`	The cost per individual conversion.
Criteria text	`Criteria`	The criteria used for the ad display.
Criteria Id text	`CriteriaId`	The identifier for the criteria used.
Criteria Type text	`CriteriaType`	The type of criteria used for the ad display.
Criterion text	`Criterion`	The specific criterion used for the ad display.
Criterion Id text	`CriterionId`	The identifier of the specific criterion used.
Criterion Type text	`CriterionType`	The type of criterion used for the ad display.
Ctr float	`Ctr`	Click-through rate, the ratio of clicks to impressions.
Clicks int	`Clicks`	Number of clicks.
Goals Roi float	`GoalsRoi`	Return on investment for the specified goals.
Impressions int	`Impressions`	The total number of ad impressions.
Income Grade text	`IncomeGrade`	The income grade of the audience.
MatchedKeyword text	`MatchedKeyword`	The keyword that matched the user's search query.
Match Type text	`MatchType`	The type of match for the keyword.
Placement text	`Placement`	The placement of the ad.
Profit float	`Profit`	The profit generated from the campaign.
Query text	`Query`	The search query that triggered the ad.
Revenue float	`Revenue`	The total revenue generated from the campaign.
Targeting Category text	`TargetingCategory`	The category used for targeting the ad.
Weighted Ctr float	`WeightedCtr`	The weighted click-through rate.
Weighted Impressions float	`WeightedImpressions`	The number of weighted impressions.
Today date	`date_today`	Today's date
Year text	`year`	Year of the date
Year of week (Sun-Sat) text	`yearofweek`	Year of week for US weeks
Year of week (Mon-Sun) text	`yearofweekiso`	Year of week for ISO weeks
Year & month text	`yearmonth`	Year and month combined
Quarter text	`quarter`	Quarter of the year
Month text	`month`	Month of the year
Year & week (Sun-Sat) text	`yearweek`	Year and week for US weeks
Year & week (Mon-Sun) text	`yearweekiso`	Year and week for ISO weeks
Week (Sun-Sat) text	`week`	US week number
Week (Mon-Sun) text	`weekiso`	ISO week number
Day of week (Sun-Sat) text	`dayOfWeekName`	Day of week name for US weeks
Day of week text	`dayOfWeekNameIso`	Day of week name for ISO weeks (Mon-Sun)
Day of month text	`dayOfMonth`	Day of the month
Date date	`date`	Specific date

Название	Имя в API	Описание
ClientInfo text	`ClientInfo`	Client name (up to 255 characters). Default value is the name from the advertiser's settings.
CampaignId text	`CampaignId`	Campaign identifier.
CampaignName text	`CampaignName`	Campaign name (up to 255 characters).
StartDate date	`StartDate`	The start date for ad displays in the format YYYY-MM-DD. Must not be earlier than the current date.
EndDate date	`EndDate`	The end date for ad displays in the format YYYY-MM-DD. Ad displays stop at 24:00 Moscow time.
Type text	`Type`	Type of campaign. See Campaign Type section.
Status text	`Status`	Campaign status. See Campaign Status and State section.
State text	`State`	Campaign state. See Campaign Status and State section.
SourceId text	`SourceId`	Identifier of the original campaign in currency units if the current campaign was created automatically when the advertiser switched to working in currency.
Currency text	`Currency`	Campaign currency. Matches the advertiser's currency for all campaigns except for those in currency units that had copies made when the advertiser switched to real currency.
StatusClarification text	`StatusClarification`	Text clarification of the status.
StatusPayment text	`StatusPayment`	Campaign payment status. Description of payment statuses can be found in the Campaign Status and State section.
DailyBudget float	`DailyBudget`	Daily budget settings for the campaign.
BudgetMode text	`BudgetMode`	Display mode for ads: STANDARD or DISTRIBUTED. See the Average Daily Budget subsection of the 'Manual Bid Management' section in Help.
Manager text	`Manager`	Name of the personal manager at Yandex (for campaigns serviced by a personal manager).
Agency text	`Agency`	Name of the advertising agency (for campaigns serviced by an agency).
Today date	`date_today`	Today's date
Year text	`year`	Year of the date
Year of week (Sun-Sat) text	`yearofweek`	Year of week for US weeks
Year of week (Mon-Sun) text	`yearofweekiso`	Year of week for ISO weeks
Year & month text	`yearmonth`	Year and month combined
Quarter text	`quarter`	Quarter of the year
Month text	`month`	Month of the year
Year & week (Sun-Sat) text	`yearweek`	Year and week for US weeks
Year & week (Mon-Sun) text	`yearweekiso`	Year and week for ISO weeks
Week (Sun-Sat) text	`week`	US week number
Week (Mon-Sun) text	`weekiso`	ISO week number
Day of week (Sun-Sat) text	`dayOfWeekName`	Day of week name for US weeks
Day of week text	`dayOfWeekNameIso`	Day of week name for ISO weeks (Mon-Sun)
Day of month text	`dayOfMonth`	Day of the month
Date date	`date`	Specific date

Название	Имя в API	Описание
AdGroupId text	`Id`	Ad group identifier.
AdGroupName text	`Name`	Ad group name (up to 255 characters).
CampaignId text	`CampaignId`	Identifier of the campaign to which the ad group belongs.
Status text	`Status`	Status of the ad group.
Type text	`Type`	Type of the ad group.
Subtype text	`Subtype`	Subtype of the ad group, relevant for certain types of ad groups.
ServingStatus text	`ServingStatus`	The serving status of the ad group, indicating if ads are eligible to serve.
TrackingParams text	`TrackingParams`	GET parameters for tracking sources of clicks that are added to the URL of all ads in the group.
Today date	`date_today`	Today's date
Year text	`year`	Year of the date
Year of week (Sun-Sat) text	`yearofweek`	Year of week for US weeks
Year of week (Mon-Sun) text	`yearofweekiso`	Year of week for ISO weeks
Year & month text	`yearmonth`	Year and month combined
Quarter text	`quarter`	Quarter of the year
Month text	`month`	Month of the year
Year & week (Sun-Sat) text	`yearweek`	Year and week for US weeks
Year & week (Mon-Sun) text	`yearweekiso`	Year and week for ISO weeks
Week (Sun-Sat) text	`week`	US week number
Week (Mon-Sun) text	`weekiso`	ISO week number
Day of week (Sun-Sat) text	`dayOfWeekName`	Day of week name for US weeks
Day of week text	`dayOfWeekNameIso`	Day of week name for ISO weeks (Mon-Sun)
Day of month text	`dayOfMonth`	Day of the month
Date date	`date`	Specific date

Каждая строка списка показывает отображаемое имя, а под ним имя в API: Campaign Id для CampaignId. Именно имя в API становится именем колонки в таблице назначения, а значения, которые Yandex Direct отдаёт пустыми, попадают туда как NULL.

Отметьте нужные поля или нажмите Select All. Вкладка Selected показывает выбор со счётчиком.

В отчётах со статистикой доступны календарные поля: с ними можно группировать данные без функций работы с датами на стороне хранилища. Поля по неделям идут в двух вариантах: недели с воскресенья и недели по ISO, с понедельника.

В типе отчёта Custom report также доступны utm_source, utm_medium, utm_campaign, utm_content, utm_term и Ad URL. Renta заполняет эти колонки из ссылки объявления, поэтому в них попадают метки, которые вы задали в Yandex Direct. Они работают для текстовых кампаний, динамических текстовых кампаний и медийных кампаний с оплатой за показы; строки по кампаниям других типов выгружаются со своей статистикой, но UTM-колонки у них останутся пустыми.

Включите в отчёт параметр Date. С ним таблица назначения партиционируется по колонке date, и Renta загружает данные инкрементально. Он же включает настройку Overwrite Period, которая появляется под диапазоном дат. Без него Renta перезагружает весь диапазон дат при каждом запуске.

Поля Criteria, Criteria Id и Criteria Type нельзя сочетать с UTM-полями и ссылкой объявления. Кроме того, Reports API поддерживает не любую комбинацию полей, поэтому при создании пайплайна Renta проверяет выбранные параметры тестовым запросом. Если комбинация не поддерживается, вы получите ошибку конфигурации: уберите конфликтующие поля и попробуйте снова.

Динамические параметры в ссылках объявлений

Yandex Direct позволяет подставлять в ссылку объявления динамические параметры, чтобы ссылка передавала в аналитику кампанию, ключевую фразу или устройство. Renta подставляет значения строки, поэтому в выгруженных колонках оказываются читаемые данные, а не плейсхолдеры.

Объявление с меткой utm_campaign={campaign_id} даст идентификатор кампании в колонке utm_campaign.

Динамический параметр	Значение в выгруженной строке
`{ad_id}`, `{banner_id}`	Идентификатор объявления.
`{gbid}`	Идентификатор группы объявлений.
`{campaign_id}`	Идентификатор кампании.
`{campaign_name}`, `{campaign_name_lat}`	Имя кампании.
`{campaign_type}`	Тип кампании.
`{keyword}`	Ключевая фраза, очищенная от операторов соответствия. Для показов по ретаргетингу остаётся пустой.
`{phrase_id}`, `{adtarget_id}`	Идентификатор условия показа.
`{adtarget_name}`	Само условие показа.
`{retargeting_id}`	Идентификатор условия показа, заполняется только для аудиторных условий и ключевых фраз.
`{coef_goal_context_id}`	Идентификатор корректировки ставок для ретаргетинга.
`{match_type}`	Тип соответствия поискового запроса ключевой фразе.
`{addphrases}`	`yes`, если показ прошёл по дополнительной релевантной фразе, иначе `no`.
`{device_type}`	Тип устройства в нижнем регистре: desktop, mobile или tablet.
`{position}`	Средняя позиция клика, округлённая до целого.
`{position_type}`	`premium` для позиций с 1 по 4, `none` для позиции 0 и `other` в остальных случаях.
`{source}`	Площадка, на которой показано объявление. Для показов на поиске Яндекса подставляется `none`.
`{source_type}`	Тип сети в нижнем регистре: search или context.
`{region_name}`	Имя региона присутствия.
`{region_id}`	Идентификатор региона присутствия.

Параметр, которого нет в этом списке, останется в выгруженном значении в том виде, в каком он записан в ссылке.

НДС и скидка

Выберите, как Yandex Direct считает стоимостные метрики перед передачей в Renta. Обе настройки действуют на весь отчёт.

Переключатели Include VAT и Include discount под сп�иском выбранных параметров

Настройка	По умолчанию	Описание
Include VAT	YES	Включать ли НДС в стоимостные метрики. Именно эта настройка меняет Cost, Avg Cpc, Cost Per Conversion и остальные денежные поля.
Include discount	NO	Устаревшая настройка. Yandex Direct отменил агентскую скидку с 1 сентября 2015 года и помечает соответствующий параметр API как устаревший, поэтому на цифры он больше не влияет.

Стоимостные метрики приходят в валюте рекламодателя с двумя знаками после запятой.

Изменение Include VAT меняет стоимостные цифры, которые возвращает Яндекс, но не данные, уже загруженные в таблицу. Исторические строки сохраняют те значения, с которыми были загружены, пока Renta их не перезагрузит.

Имя таблицы и диапазон дат

Задайте имя пайплайна и исторический период для загрузки. Широкий диапазон при первом запуске загружается заметно дольше, чем несколько дней.

Integration name.
Имя пайплайна. Используется только в интерфейсе Renta.
Table name.
Имя таблицы назначения. Можно оставить сгенерированное имя или ввести своё.
Date start.
Первая дата периода выгрузки.
Date end.
Последняя дата периода выгрузки. Можно выбрать фиксированную дату или относительный вариант, например Today.

Период перезаписи

Период перезаписи определяет, сколько последних дней Renta перезагружает при каждом запуске. Настройка появляется после выбора параметра Date.

Выбор периода перезаписи Yandex Direct со значением Last 1 day

При каждом запуске Renta заново запрашивает данные начиная с даты последнего успешного запуска минус период перезаписи. Затронутые дни удаляются из таблицы назначения и вставляются заново, более старые данные не затрагиваются. Варианты идут от Without overwrite data до Overwrite all data; по умолчанию выбран Last 1 day.

Yandex Direct продолжает корректировать статистику задним числом, прежде всего когда отфильтровывает недействительные клики и возвращает их стоимость на баланс кампании. Яндекс указывает, что обычно данные стабилизируются в течение трёх дней, а в редких случаях корректируются и более старые цифры. Задайте период перезаписи не меньше Last 3 days, а для запаса Last 7 days.

Расписание

Выберите, как часто запускать пайплайн.

Тип расписания	Описание
Manual	Пайплайн запускается только вручную через интерфейс или по API.
Daily	Пайплайн запускается раз в сутки в указанное время обновления.
Interval	Пайплайн запускается через заданные интервалы времени.
Cron Expression	Пайплайн запускается по расписанию, заданному cron-выражением.

Для расписания Daily укажите Update time (точное время запуска), затем нажмите Create pipeline.

Выбор времени обновления и кнопка Create pipeline

Renta также поддерживает запуск по API и интеграцию с внешними оркестраторами, такими как Apache Airflow, Dagster и Prefect. Подробности в документации по расписаниям.

Новый пайплайн появится в разделе Pipelines на вкладке ETL, где можно отслеживать запуски, прогресс и имя таблицы назначения.

Список пайплайнов с новой интеграцией Yandex Direct

Ограничения

Reports API задаёт границы, которые действуют для любого пайплайна на этом источнике.

Ограничение	Описание
Глубина истории	Статистика доступна за предыдущие три года от текущего месяца. Более ранний Date start вернёт пустоту за ту часть диапазона, которая выходит за это окно.
История поисковых запросов	Поле поискового запроса ограничено последними 180 днями, поэтому `Search query performance report` нельзя загрузить глубже этого срока.
Campaign Id в медийных отчётах	`Reach and frequency performance report` требует идентификатор кампании, поэтому оставьте `Campaign Id` среди выбранных параметров.
Единая атрибуция	Любой тип отчёта относит показ или клик ровно к одному условию показа, региону и атрибуту аудитории.
В отчётах по объектам нет истории	`Campaign objects data` и `Ad group objects data` возвращают текущее состояние, поэтому удалённый в Yandex Direct объект пропадёт из таблицы при следующем запуске.

Стратегия синхронизации

Стратегия синхронизации зависит от того, включён ли в отчёт параметр Date.

Стратегия	Поддерживаемые типы отчётов	Описание
Инкрементальное обновление	Account performance report, Campaign performance report, Ad Group performance report, Ad performance report, Criteria performance report, Custom report, Reach and frequency performance report, Search query performance report (с выбранным параметром Date)	Каждая строка содержит свою дату, таблица назначения партиционируется по колонке `date`. При каждом запуске Renta запрашивает окно от даты последнего успешного запуска минус период перезаписи до конца диапазона дат: затронутые дневные партиции удаляются и вставляются заново, более старые партиции не затрагиваются.
Полная перезагрузка	Account performance report, Campaign performance report, Ad Group performance report, Ad performance report, Criteria performance report, Custom report, Reach and frequency performance report, Search query performance report (без параметра Date)	В таблице нет колонки даты для партиционирования, поэтому Renta запрашивает отчёт за весь настроенный диапазон дат и заменяет набор данных при каждом запуске.
Полная перезагрузка	Campaign objects data, Ad group objects data	Эти отчёты возвращают текущее состояние кампаний и групп объявлений, поля даты в них нет вообще, поэтому Renta перезагружает весь набор данных при каждом запуске.

Изменение выбранных параметров меняет схему таблицы, поэтому первый запуск после изменения перезагружает весь диапазон дат.

Часто задаваемые вопросы

Ready to get started?

Build your data pipeline today or get a personalized demo. Start free!

Need help?

Get expert support to ensure your project succeeds. We're here to help!

Feature requests?

Help shape our product! Share your ideas for new features and integrations.