NEWS.md

In ryandexdirect: Load Data From 'Yandex Direct'

ryandexdirect 3.6.1

дата: 2020-08-20

• В результат возвразаемый функцией yadirGetAds() добавлены следующие поля:
  • TextImageAdTurboPageId - Идентификатор Турбо-страницы графического объявления, созданного на основе изображения (в группе текстово-графических объявлений).
  • SmartAdBuilderAdCreative - Идентификатор креатива смарт-баннера.
  • SmartAdBuilderThumbnailUrl - Ссылка на миниатюру для предварительного просмотра смарт-баннера.
  • SmartAdBuilderPreviewUrl - Ссылка на изображение для предварительного просмотра смарт-баннера.
  • CpmBannerAdBuilderHref - Ссылка на сайт рекламодателя медийного баннера.
  • CpmBannerAdBuilderTurboPageId - Идентификатор Турбо-страницы медийного баннера.
  • CpcVideoAdBuilderHref - Ссылка на сайт рекламодателя медийного видеообъявления (в кампании с типом «Текстово-графические объявления»)
  • CpcVideoAdBuilderTurboPageId - Идентификатор Турбо-страницы медийного видеообъявления (в кампании с типом «Текстово-графические объявления»)
  • CpmVideoAdBuilderHref - Ссылка на сайт рекламодателя видеообъявления (в кампании с типом «Медийная кампания»).
  • CpmVideoAdBuilderTurboPageId - Идентификатор Турбо-страницы видеообъявления (в кампании с типом «Медийная кампания»).
• В функцию yadirGetAds() добавлен аргумент Types, с помощью которого можно фильтровать объявления по их типу: TEXT_AD, MOBILE_APP_AD, DYNAMIC_TEXT_AD, IMAGE_AD, CPC_VIDEO_AD, CPM_BANNER_AD, CPM_VIDEO_AD, SMART_AD
• В функции yadirGetAdGroups() расширен фильтр по типу групп объявлений, теперь по умолчанию функция запрашивает группы объявлений всех возможных типов, включая группы для смарт баннеров.

ryandexdirect 3.6.0

дата: 2020-06-09

• В пакет добавлена функция yadirGetCostData(), которая запрашивает данные о расходах, кликах и показах по рекламным кампаниям, ключевым словам и объвлениям для дальнейшей загрузки в Google Analytics.
• Техническое обновление, исправлена опечатка в функции yadirGetForecast(), изза которой не корректно работал фильтр по регионам.
• Исправлена ошибка C stack usage 1592693 is too close to the limit.
• Исправлен обработчик ошибок в функции yadirGetReport(), который запускается аргументом SkipErrors = FALSE.
• В функции yadirGetReport() измененно дефолтное значение аргумента DateRangeType с 'LAST_30_DAYS' на 'CUSTOM_DATE'.
• Добавлена виньетка vignette("yandex-direct-cost-data", package = "ryandexdirect"), посвящённая функции yadirGetCostData()
• Актуализирована виньетка по авторизации.

ryandexdirect 3.5.0

дата: 2020-05-06

• Для удобства авторизации в ryandexdirect были добавлены опции, и поддержка переменных среды.
  • Опции:
  • ryandexdirect.user - логин по умолчанию
    • ryandexdirect.token_path - путь к папке с учётными данными по умолчанию
    • ryandexdirect.agency_account - агентсткий аккаунт по умолчанию
  • Переменные среды:
  • RYD_USER - логин по умолчанию
    • RYD_TOKEN_PATH - путь к папке с учётными данными по умолчанию
    • RYD_AGENCY - агентсткий аккаунт по умолчанию
• Добавлена функция yadirGetLogins(), с помощью которой вы можете получить список всех логинов, учётные данные по которым сохраненны в TokenPath, так же можно с помощью этой же функции переключиться из одного логина на другой.
• Добавлена функция yadirSetLogin(), которая позволяет в коде легко переключаться между логинами под которыми вы прошли авторизацию, если вы укажите логин под которым авторизация ещё не пройдена, то процесс авторизации будет запущен автоматически.
• Добавлена функция yadirSetAgencyAccount(), которая позволяет в коде легко переключаться между агентскими аккаунтами под которыми вы прошли авторизацию, если вы укажите логин аккаунта под которым авторизация ещё не пройдена, то процесс авторизации будет запущен автоматически.

ryandexdirect 3.4.0

дата: 2020-04-26

• Добавлена функция yadirGetForecast(), с помощью которой вы можете получить прогноза показов, кликов и затрат.
• Добавлена виньетка yandex-direct-keyword-bids, в которой подробно описан процесс запроса отчётов из сервиса WordStat и построении прогнозов с помощью функции yadirGetForecast().

ryandexdirect 3.3.0

дата: 2020-04-09

• Добавлена функция yadirGetWordStatReport(), с помощью которой вы можете получить отчёт из сервиса WordStat.

ryandexdirect 3.2.3

дата: 2020-03-05

• В функциях yadirGetKeyWords(), yadirGetAds(), yadirGetAdGroups() для загрузки кампаний теперь используется функция yadirGetCampaings() вместо устаревшей(yadirGetCampaignList()).
• Исправлена ошибка Error: Argument 5 is a list, must contain atomic vectors которая возникала при попытке загрузить ставки в кампаниях где не установлен приоритет ключевой фразы или автотаргетинга в функции yadirGetKeyWordsBids().

ryandexdirect 3.2.2

дата: 2019-10-31

• Функция yadirGetCampaignList() с версии 3.2.2 считается устаревшей. Она будет присутвовать в пакете, но не будет развиваться. Вместо неё рекомендуется использовать функцию yadirGetCampaign().
• В таблицу возвращаемую функцией yadirGetCampaign() добавлены новые поля:
  • SourceId - Идентификатор исходной кампании в у. е., если текущая кампания была создана автоматически при переходе рекламодателя на работу в валюту.
  • FundsMode - Тип финансовых показателей кампании:
    • CAMPAIGN_FUNDS — общий счет не подключен, финансовые показатели кампании возвращаются в поле CampaignFundsBalance;
    • SHARED_ACCOUNT_FUNDS — общий счет подключен, финансовые показатели кампании возвращаются в поле SharedAccountFundsSpend.
  • CampaignFundsBalance - Текущий баланс кампании в валюте рекламодателя, без учета НДС.
  • CampaignFundsBalanceBonus - Скидочный бонус. Параметр утратил актуальность.
  • CampaignFundsSumAvailableForTransfer - Сумма, доступная для переноса на другую кампанию, в валюте рекламодателя, без учета НДС.
  • SharedAccountFundsRefund - Параметр утратил актуальность, всегда возвращается значение 0.
  • SharedAccountFundsSpend - Сумма средств, израсходованных по данной кампании за все время ее существования, с учетом НДС.
  • AttributionModel - Модель атрибуции, используемая для оптимизации конверсий:
    • FC — первый переход.
    • LC — последний переход.
    • LSC — последний значимый переход.
    • LYDC — последний переход из Яндекс.Директа.
• В пакете появился документ со всеми устаревшими функциями, посмотреть его можно с помощью команды help("ryandexdirect-deprecated").

ryandexdirect 3.2.1

• В yadirGetKeyWordsBids исправлена ошибка возникающая при запросе данных по 1 ключевому слову.
• В yadirSetAutoKeyWordsBids исправлена ошибка object 'StrategyPriority' not found.

ryandexdirect 3.2.0

• В пакет добавлены функции для управления ставками ключевых слов
  • yadirGetKeyWordsBids
  • yadirSetKeyWordsBids
  • yadirSetAutoKeyWordsBids

Описание релиза на GitHub.

ryandexdirect 3.1.6

• В пакет добавлены виньетки
  • Подробная виньетка о загрузке статистики из рекламных аккаунтов Яндекс Директ: vignette("yandex-direct-get-statistic", package = "ryandexdirect")
  • Подробная виньетка про авторизацию и работу с учётными данными: vignette("yandex-direct-auth", package = "ryandexdirect")
• Для обработки лимита в 1 000 000 строк в функцию yadirGetReport добавлен аргумент FetchBy. Подробнее об этом можно узнать из описания релиза на GitHub.
• Исправлена проблема, которая возникала при запросе статистики сразу из нескольких клиентских аккаунтов.

Описание релиза на GitHub.

ryandexdirect 3.1.4

• В результат возвращаемый функцией yadirGetCampaign добалены следующие поля:
  • SearchBidStrategyType - Тип стратегии показа на поиске
  • NetworkBidStrategyType - Тип стратегии показа в сетях

Описание релиза на GitHub.

ryandexdirect 3.1.1

• Исправлена ошибка в функции yadirAuth, возникающая после обновления просроченного токена.

ryandexdirect 3.1.0

Удалены функции

• Из пакета удалены следующие функции: yadirGetSummaryStat, yadirGetCampaignListOld, yadirGetLogsData, yadirGetMetrikaGAData
• Функция yadirGetToken теперь так же может сохранять полученный токен в локальный файл, если пользователь даст на это разрешение, но обновляться такой токен по истечению срока не будет, т.к. к нему не привязан refresh token.
• Для сокращении имени, и приведения названия функций к одному вижу у функции yadirGetCampaignList появилась дублируюая функция yadirGetCampaign, для совмещения новой версии пакета с кодом написанным под более ранними версиями обе функции в нём остаются.
• В функции yadirGetCampaign и yadirGetCampaignList по умолчанию в фильтр по типу кампаний включена загрузка кампаний с типом 'CPM_BANNER_CAMPAIGN'.

ryandexdirect documentation built on March 31, 2023, 5:35 p.m.