В ryandexdirect добавлены модели атрибуции и возможность фильтрации по целям

Ещё 8 июня в официальном блоге API Яндекс Директ была опубликована новость "Модели атрибуции и цели в Reports", но в связи с высокой нагрузкой и отпуском у меня не было времени на внедрение этих параметров в ryandexdirect. И вот сегодня мне напомнили о том, что было бы неплохо уже внедрить этот функционал в пакет, собственно велкам.

Начиная с версии ryandexdirect 3.0.8 вам доступны два новых аргумента в функции yadirGetReport:.

• Goals - Идентификаторы целей Яндекс.Метрики, по которым требуется получить статистику (см. раздел Что такое цели. Типы целей помощи Яндекс.Метрики). Не более 10 элементов в массиве. Если параметр указан, то в отчете вместо полей ConversionRate, Conversions, CostPerConversion, GoalsRoi и Revenue с агрегированными данными по всем целям будут выведены аналогичные поля с именами вида <поле>_<id_цели>_<модель_атрибуции> и данными по каждой цели в отдельности.
• AttributionModels - Модели атрибуции, используемые при расчете данных по целям Яндекс.Метрики (см. раздел Модели атрибуции помощи Директа).

Возможные значения AttributionModels:

• FC — первый переход.
• LC — последний переход.
• LSC — последний значимый переход.

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

При использовании моделей атрибуции LSC и FC датой визита считается не дата фактического посещения сайта, а дата клика, который является источником визита. Таким образом, визит и его данные (глубина просмотра, достижение цели, доход и т. д.) будут отражены в отчете, если дата клика попадает в период отчета.

При повторном получении отчета за тот же период с теми же параметрами данные Метрики в отчете могут измениться, если с момента предыдущего получения отчета произошли визиты, источником которых являются клики, совершенные в период отчета.

Пример кода с использованием аргументов Goals и AttributionModels

library(ryandexdirect)
attributions_report <- yadirGetReport(ReportType    = "ACCOUNT_PERFORMANCE_REPORT",
                                      DateRangeType     = "LAST_MONTH",
                                      FieldNames        = c("Date", 
                                                            "Clicks", 
                                                            "Impressions", 
                                                            "Conversions"),
                                       Goals             = c(182453, 182452, 23458860),
                                       AttributionModels = c("LSC", "LC"),
                                       Login             = "your.login",
                                       TokenPath         = "C:/your/tokens")

ryandexdirect 3.0.0 - обновлённый R клиент для работы с API Яндекс Директ

Пакет для работы с API Яндекс Директ на языке R, ryandexdirect был значительно доработан:

• Был улучшен процесс авторизации в API
• Приведёны в порядок имена аргументов функций
• Во все функции был добавлен ряд новых аргументов

Обновление пакета

Для обновления или установки пакета достаточно запустить приведённый ниже код, при этом будьте внимательны новая версия пакета содержит довольно много изменений, и после обновления вам необходимо будет проверить работоспособность всех скриптов написанных на более ранних версиях ryandexdirect, в связи с чем я рекомендую сначала ознакомится со всеми доработками и только потом обновлять пакет.

install.packages("devtools")

devtools::install_github("selesnow/ryandexdirect")

Авторизация и работа с токенами

Основная часть доработок связана с процессом аутентификации в API, ранее токены приходилось хранить либо в коде в виде переменной, либо в блокноте, к тому же токены не обновлялись, т.е. через год после получения токена необходимо было повторно запрашивать новый токен, теперь процесс получения и обновления токенов полностью автоматизирован.

Вы по прежнему можете передавать токен в виде строки в агрумент Token при работе с любой из функций, но теперь это является устаревшим и не эффективным способом работы с функциями пакета ryandesxdirect.

В пакет добавлена новая функция для прохождения аутентификации в API yadirAuth, но отдельно вызывать её для получения токена больше не требуется, при любом обращении к API если вы в используемой функции явно не указываете никакой токен, любая функция пакета сначала будет искать файл с сохранёнными учётными данными в рабочей директории, или в папке которую вы укажите в аргументе AgencyAccount, если файл найден то учётные данные будут загружены из него, если файл не был найден то будет открыт браузер и вам потребуется разрешить приложению ryandexdirect доступ к своему рекламному аккауну, далее будет сформирован код авторизации, который вам необходимо вставить в R консоль в ответ на запрос "Enter authorize code:", после чего функция сама сохранит учётные данные в файл с именем login.yadirAuth.RData, где вместо login будет подставлен логин аккаунта к которому вы предоставили доступ, это необходимо для сохранения токенов полученных для разных аккаунтов. При следующих обращениях, все функции пакета будут запрашивать токен из сохранённого файла.

Обновление токена

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

Аргументы функции yadirAuth

• Login - имя пользователя или электронный адрес на Яндексе, с которого есть доступ к нужному вам рекламному аккаунту
• NewUser - логическое выражаение TRUE или FALSE, признак того, что у пользователя обязательно нужно запросить разрешение на доступ к аккаунту (даже если пользователь уже разрешил доступ данному приложению). Получив этот параметр, Яндекс.OAuth предложит пользователю разрешить доступ приложению и выбрать нужный аккаунт Яндекса. Параметр полезен, например, если вы хотите переключиться на другой аккаунт. По умолчанию установлено значение FALSE.
• TokenPath - путь к папке, в которой будут сохраняться учётные данные, по умолчанию это рабочая директория, но можно указывать любой путь, как абсолютный например "C:/my_r_files/tokens", так и относительны "tokens", при использовании относительного пути в рабочей директории будет создана папка с установленным вами названием, и в неё будут сохраняться файлы с расширением .RData в которых хранящие учётные данные.

Ещё раз обращаю внимание на то, что хоть вы в любой момент при желании можете пройти аутентификацию в API Яндекс Директ с помощью функции yadirAuth, но это действие не является обязательным, т.к. при использовании любой функции пакета будет запущен поиск файла с учётными данными, и если файл не будет найден, то автоматически будет запущен процесс авторизации и запроса токена.

Новые аргументы во всех функциях

Во все функции пакета были добавлены следующие аргументы:

• Login / Logins - Логин или вектор содержащий логины клиентов агентского аккаунта, в этот аргумент необходимо указывать логин в случае если вы запрашиваете данные из обычного рекламного аккаунта Яндекс Директ, или же логин клиентского аккаунта привязаного к вашему агентскому аккаунту, в таком случае в рабочей директории будет создан отдельный файл под каждый рекламный аккаунт, в котором будут хранится нужные для работы учётные данные.
• Token - С версии 3.0.0 этот аргумент больше не является обязательным, вы по прежнему можете передавать в него токены в виде строки, полученные с помощью функции yadirGetToken, так же можете передавать объекты учётных данных полученные с помощью новой функции yadirAuth, либо просто опустить данный агрумент.
• AgencyAccount - В случае если вы работаете с агентского аккаунта в этот аргумент необходимо передавать логин вашего агентского аккаунта, для каждого агентского аккаунта с которым вы работаете так же будет создан отдельный файл для хранения учётных данных.
• TokenPath - Путь к папке в которой хранятся все файлы с учётными данными, по умолчанию все функции пакета пытаются найти нужный файл с хранящимися учётными данными в текущей рабочей директории, но вы можете указывать абсолютный или условный путь к совершенно любой попке на вашем ПК, в которой вы хотите хранить все учётные данные ваших аккаунтов Яндекс Директ. Пример условного пути TokenPath = "yandex_token", в таком случае в рабочей директории будет создана папка yandex_token в которую и будут сохраняться все учётные данные, указав этот путь во всех функциях пакета вам не понадобится повторно запрашивать токены.

Работа с обычным рекламным аккаунтом

Таким образом при работе с обычным рекламным аккаунтом вам необходимо передавать логин этого аккаунта в аргументе Login или Logins. При запуске любой функции в первую очередь будет запущен процесс поиска учётных данных для заданного логина в папке, название или путь к которой указан в аргументе TokenPath. Если файл с учётными данными для заданного логина был найден то работа функции будет продолжена без вашего вмешательства, если учётные данные для данного логина ещё не были получены, или были получены но вы не указали путь к папке в которой данный файл был сохранён то автоматически будет запущен веб браузер и вам потребуется пройти авторизацию и разрешить доступ пакету ryandexdirect к вашему рекламному аккаунту, учётные данные при этом будут сохранены в локальный файл и при дальнейшей работе будут загружаться именно из файла.

Работа с агентским аккаунтом

Для получения статистики по рекламным аккаунтам прикреплённым к агентскому аккаунту необходимо использовать аргумент AgencyAccount, в который необходимо передать логин или почту для вашего агентского аккаунта, а в аргумент Login / Logins передавать логин клиента, или вектор содержащий логины клиентов данного агентского аккаунта, по которым вы хотите запросить какие либо данные или совершить ещё какие либо действия.

Авторизация в данном случае будет проходить по агентскому аккаунту.

Имена аргументов

Во всех функциях кроме функций для работы с Яндекс Метрикой были отформатированы и приведены к общему правила названия аргументов, теперь все аргументы во всех функциях пакета необходимо указывать с заглавной буквы, синтаксис всех функций приведён к ВерблюжьемуРегистру (UpperCamelCase), в связи с чем возможно после обновления ryandexdirect до версии 3.0.0 вам придётся частично внести правки в названия аргументов в коде написанном на более старых версиях ryandexdirect.

В версии 3.0.0 были переведены в ВерблюжийРегистр названия аргументов login и token в следующих функций: yadirGetClientList, yadirGetClientParam, yadirGetDictionary, yadirCurrencyRates. Соответственно после обновления пакета вам необходимо заменить в написанных ранее скриптах, в которых используются приведённые выше функции, имена аргументов login и token на Login и Token.

Загрузка списка ключевых слов, объявлений и групп объявлений

Этот блок доработок касается функций yadirGetAds, yadirGetAdGroups и yadirGetKeyWords, ранее аргумент CampaignIds был обязательным, теперь в случае если вы не указали по каким рекламным кампаниям вы хотите получить список объявлений, групп объявлений или ключевых слов вам не обязательно указывать список ID рекламных кампаний, функция сама загрузит все ID и вернёт все объявления, группы объявлений или ключевые слова из аккаунта.

Устаревшие функции

В связи с доработками пакета ряд его функций стал не актуален, но пока, что они остаются в составе пакета для совместимости со старым кодом написанном на более ранних функциях.

Название устаревшей функции	Назначение функции	Какой функцией заменить
yadirGetSummaryStat	Загрузка статистики по рекламным кампаниям	yadirGetReport
yadirGetToken	Запрос токена доступа к API	yadirAuth

Рекомендую переписать свои скрипты заменив устаревшие фукнции на те которые приведены в представленной выше таблице в качестве рекомендуемых.

Пример кода для загрузки статистики с помощью ryandexdirect 3.0.0

Загрузка данных из обычного рекламного аккаунта Яндекс Директ.

Перед запуском кода замените значение "yandex_login", передаваемое в аргумент Login функции yadirGetReport на логин под котор...

ryandexdiect 2.6.0 - Загрузка быстрых ссылок

За последние 3 месяца ryandexdirect был улучшен:

1. Исправлена ошибка, при использовании оператора IN при фильтрации данных в функции yadirGetReport. подробности.
2. Доработана функция yadirGetBalance, запрашивающая остаток средств на счетах в аккаунтах Яндекс Директ, обновление касаются запроса остатков балансов по клиентах агентских аккаунтов, ранее можно было за раз запросить данные максимум по 50 аккаунтам, сейчас можно запрашивать данные по любому количеству клиентов, подробнее.
3. В пакет добавлена функция yadirGetSiteLinks, с помощью которой вы можете получить список быстрых ссылок.

Возвращаемый функцией yadirGetSiteLinks дата фрейм содержит 4 поля.

• Id - Идентификатор набора быстрых ссылок.
• Title - Текст быстрой ссылки.
• Href - Адрес быстрой ссылки.
• Description - Описание быстрой ссылки для отображения объявления в расширенном формате.

ryandexdirect 2.5.0 - Остановка / Возобновление показов на уровне объявлений, ключевых слов и рекламных кампаний.

В версии ryandexdirect 2.5.0 били добавлены 6 новых функций, направленных на остановку и возобновление показов на уровне объявлений, ключевых слов и рекламных кампаний.

• yadirStartAds - Возобновить показы по объявлениям.
• yadirStopAds - Остановить показы по объявлениям.
• yadirStartCampaigns - Возобновить показы по рекламным кампаниям
• yadirStopCampaigns - Остановить показы по рекламным кампаниям
• yadirStartKeyWords - Возобновить показы по ключевым словам
• yadirStopKeyWords - Остановить показы по ключевым словам

Каждая функция имеет 3 обязательных аргумента.

Ids - Числовой или текстовый вектор, содержащий Id объявлений, рекламных кампаний или ключевых слов по которым необходимо возобновить или остановить показы.

Login - Строковое значение, ваш логин на Яндексе.

Token - Строковое значение, ваш API token.

Ограничения

За один вызов функции можно остановить или возобновить показы не более чем:

• 1000 рекламных кампаний
• 10000 объявлений
• 10000 ключевых слов

Пример кода, с помощью которого можно остановить показы на уровне рекламных кампаний

#Получаем токен
tok <- yadirGetToken()

#Получаем список рекламных кампаний
my_camp <- yadirGetCampaignList(Login = "Логин", Token = tok)

#Останавливаем показы объявлений
err <- yadirStopCampaigns(Login = "LOGIN", Token =  tok, Ids = my_camp$Id) 

Доработана функция yadirGetReport

Так же в этом релизе была значительно ускорена функция yadirGetReport, за счёт увеличения скорости парсинга полученного результата более чем в 5 раз.

ryandexdirect 2.4.4: Доработана функции yadirGetCampaignList

В версии 2.4.4 была улучшена функция yadirGetCampaignList.

• Добавлено 4 аргумента:
  • States - На вход принимает текстовый вектор, используется для для фильтрации кампаний в указанных состояниях. Описание состояний см. в разделе Статус и состояние кампании., допустимые значения ( "ARCHIVED" | "CONVERTED" | "ENDED" | "OFF" | "ON" | "SUSPENDED" ), пример использования (c("ON","SUSPENDED","CONVERTED"))
    • Допустимые значения: ARCHIVED, CONVERTED, ENDED, OFF, ONSUSPENDED
    • Пример использования: States = c("ON","SUSPENDED","CONVERTED")
  • Types - На вход принимает текстовый вектор, используется для фильтрации кампаний по типам, См. Тип кампании.
    • Допустимые значения: TEXT_CAMPAIGN, MOBILE_APP_CAMPAIGN, DYNAMIC_TEXT_CAMPAIGN
    • Пример использования: Types = c("TEXT_CAMPAIGN", "DYNAMIC_TEXT_CAMPAIGN")
  • Statuses- На вход принимает текстовый вектор, используется для фильтрации кампаний по указанными статусами. Описание статусов см. в разделе Статус и состояние кампании.
    • Допустимые значения: ACCEPTED, DRAFT, MODERATION, REJECTED
    • Пример использования: Statuses = c("DRAFT", "REJECTED")
  • StatusesPayment - На вход принимает текстовый вектор, используется для фильтрации кампаний по указанным статусам оплаты. Описание статусов см. в разделе Статус и состояние кампании..
    • Допустимые значения: DISALLOWED, ALLOWED
    • Пример использования: Statuses = c("DISALLOWED", "ALLOWED")
• Имена всех доступных 6-ти аргументов функции теперь необходимо указывать с большой буквы:
  • Logins
  • States
  • Types
  • Statuses
  • StatusesPayment
  • Token

Функция yadirGetReport теперь векторизирована.

Начиная с версии 2.4.1 функция yadirGetReport становится векторизирована, это означает что в аргумент Login можно на вход давать вектор логинов, после чего функция соберёт данные из всех рекламным аккаунтов переданных в векторе логинов.

Пример кода использования векторизированного варианта функции yadirGetReport.

library(ryandexdirect)
myToken     <- yadirGetToken()
clientList  <- yadirGetClientList(myToken)

stat        <- yadirGetReport(ReportType = "ACCOUNT_PERFORMANCE_REPORT", 
                              DateRangeType = "CUSTOM_DATE", 
                              DateFrom = "2017-01-01", 
                              DateTo = Sys.Date(), 
                              FieldNames = c("Date","Impressions","Clicks","Cost"), 
                              Login = clientList$Login, 
                              Token = myToken)

ryandexdirect 2.4.0 - Добавлена функция для загрузки остатка средств на общем счету

В ryandexdirect добавлена функция yadirGetBalance, с помощью которой можно получить все параметры общего счёта включая текущий остаток средств.

Аргументы:

Logins - Текстовый вектор содердащий Логин аккаунта рекламодателя на Яндексе, либо логин клиента агентсва.

Token - Токен дотупа к API

Структура возвращаемого функцией yadirGetAds дата фрейма:

Поле	Тип данных	Описание
Amount	chr	Текущий баланс общего счета (в валюте общего счета, указанной в параметре Currency).
AccountID	int	Идентификатор общего счета.
Discount/td>	int	Текущая скидка рекламодателя (в процентах). В настоящее время не применяется.
Login	chr	Логин рекламодателя — владельца общего счета.
AmountAvailableForTransfer	chr	Сумма, доступная для перевода с помощью операции TransferMoney (в валюте, указанной в параметре Currency).
Currency	chr	Валюта общего счета. Возможные значения: RUB, CHF, EUR, KZT, TRY, UAH, USD, BYN. Если параметр отсутствует или равен NULL, подразумеваются условные единицы (у. е.).
AgencyName	chr	Название рекламного агентства, обслуживающего счет. Для счетов, обслуживаемых рекламодателем самостоятельно, параметр отсутствует или равен NULL
SmsNotification.MoneyInSms	chr	Сообщать об зачислении средств на общий счет — Yes/No.
SmsNotification.SmsTimeTo	chr	Время, до которого разрешено отправлять SMS о событиях, связанных с общим счетом. Указывается в формате HH:MM, минуты задают кратно 15 (0, 15, 30, 45).
SmsNotification.SmsTimeFrom/td>	chr	Время, начиная с которого разрешено отправлять SMS о событиях, связанных с общим счетом. Указывается в формате HH:MM, минуты задают кратно 15 (0, 15, 30, 45).
SmsNotification.MoneyOutSms	chr	Сообщать об исчерпании средств на общем счете — Yes/No.
EmailNotification.MoneyWarningValue	int	Минимальный баланс, при уменьшении до которого отправляется уведомление. Задается в процентах от суммы последнего платежа. Предустановленное значение — 20.
EmailNotification.SendWarn	logi	Отправлять оповещение на почту о том что закончились средства на основном счёте.
EmailNotification.Email	chr	Адрес электронной почты для отправки уведомлений, связанных с общим счетом.

Пример кода для получения списка ключевых слов:

#Подключаем пакет
library(ryandexdirect)
#Получаем API token
my_token <- yadirGetToken()

#Получаем остаток средств общего счёта для аккаунта рекламодателя
my_balance <- yadirGetBalance(Logins = "vasya",  Token = "abcdef123456")

#Получаем список клиентских аккаунтов
my_client <- yadirGetClientList(Token = "abcdef123456")
#Получаем остатки средств на общих счетах всех клиентов агентского аккаунта
my_clients_balance <- yadirGetBalance(Logins = my_client$Login,  Token = "abcdef123456")

В пакет ryandexdirect добавлена возможность работы с API Яндекс метрики совместимым с Google Analytics Core Reporting API (v3)

В пакет ryandexdirect добавлена функция yadirGetMetrikaGAData предназначенная для работы с API Яндекс Метрики совместимым с Google Analytics Core Reporting API (v3) и даёт возможность использовать привычные параметры запросов при сборе статистики, если ранее вы работали с Google Analytics Core Reporting API (v3).

Пример работы с функций

#Подключаем пакет
library(ryandexdirect)

#Получаем токен разработчика
myToken <- yadirGetToken()

#Запрашиваем данные из API Яндекс Метрики
metrikData6 <- yadirGetMetrikaGAData(start_date = "2017-08-01",
                                     end_date = "yesterday",
                                     counter_ids = "ga:11111",
                                     metrics = "ga:sessions,ga:bounces,ga:users",
                                     dimensions = "ga:date,ga:sourceMedium",
                                     token = myToken)

Аргументы:

• start_date = Дата начала отчетного периода. Вы можете указывать дату в формате YYYY-MM-DD или использовать относительные временные значения: today, yesterday, NdaysAgo.
• end_date = Дата окончания отчетного периода. Вы можете указывать даты в формате YYYY-MM-DD или использовать относительные временные значения: today, yesterday, NdaysAgo.
• counter_ids = Номер счетчика, данные которого необходимо получить. Перед номером счетчика необходимо указать префикс ga:, пример: "ga:1111"
• dimensions = Группировки объединяют данные по критериям. Например, используйте параметр dimensions=ga:browser,ga:city, чтобы:
  • Получить данные по количеству посещений.
  • Сгруппировать эти данные по браузеру, который использовал посетитель и городу, в котором находился посетитель в момент посещения.
    Если по указанной группировке данные не были получены, возвращается значение (not set).
    Обратите внимание на следующие ограничения:
  • В состав одного запроса может входить не более 7 группировок.
  • Запрос не может состоять только из группировок, но должен содержать хотя бы одну метрику.
  • Не все группировки можно сочетать друг с другом в составе одного запроса. Подробнее о сочетании группировок и метрик можно почитать тут
• metrics = Метрики позволяют получать данные о статистике посещаемости и активности пользователей сайта. Если в запросе вы не укажете ни одной группировки, то API вернет общее значение метрики для выбранного временного интервала без разделения его на какие-либо группы.
  Обратите внимание на следующие особенности:
  • В состав одного запроса может входить не более 10 метрик.
  • Большинство метрик можно использовать в сочетании друг с другом при условии, что не выбрана ни одна группировка.
  • Не все метрики можно сочетать с другими метриками и группировками в составе одного запроса. Подробнее о сочетании группировок и метрик можно почитать тут
• filters = Фильтр позволяет ограничить данные, возвращаемые в результате запроса. Более подробно о правилах фильтрации можно узнать тут
  Обратите внимание на следующие особенности:
  • Фильтрация по группировке производится до использования группировок. Таким образом результирующая метрика представляет собой итоговое значение только для данных, удовлетворяющих условию группировки.
  • Фильтрация по метрике производится после использования метрик.
  • Вы можете использовать для фильтрации те группировки и метрики, которые не входят в состав вашего запроса.
• sort = В качестве сортировки собранных данных может быть использован список метрик и группировок. По умолчанию используется сортировка по возрастанию. Чтобы использовать сортировку по убыванию, укажите знак «-» в запросе перед списком метрик и группировок.В качестве значения параметра sort вы можете использовать только те значения группировок и метрик, по которым были получены данные.
• samplingLevel = Используйте данный параметр для указания уровня семплирования (количества визитов, использованных при расчете итогового значения).
  • Значение по умолчанию: HIGHER_PRECISION
    Допустимые значения:
  • HIGHER_PRECISION — возвращает наиболее точное значение, используя наибольшую выборку данных. Этот режим может потребовать дополнительное время и замедлить обработку запроса.
  • FASTER — возвращает быстрый результат на основе сокращенной выборки данных.
  • DEFAULT — возвращает результат на основе выборки, сочетающей скорость и точность данных.
• token = API токен полученный с помощью функции yadirGetToken

В пакет ryandexdirect добавлены 3 функции: yadirGetAds, yadirGetKeyWords, yadirGetAdGroups.

В пакет ryandexdirect добавлены 3 функции:

• yadirGetAdGroups - Получение списка групп объявлений
• yadirGetKeyWords - Получение списка ключевых слов
• yadirGetAds - Получение списка объявлений

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

Так же была доработана функция yadirGetCampaignList, теперь она работает без каких либо ограничений на количество возвращаемых рекламных кампаний, теперь вы можете получить полный список рекламных кампаний даже из аккаунтов в которых более 10 000 рекламных кампаний.

Добавлена функция yadirGetClientParam.

С помощью функции yadirGetClientParam вы можете получить основные параметра аккаунта Яндекс Директ.

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

Поле	Тип данных	Описание
Login	chr	Логин пользователя Директа.
ClientId	int	Идентификатор рекламодателя.
CountryId	int	Идентификатор страны рекламодателя из справочника регионов. Справочник регионов можно получить с помощью функции yadirGetDictionary.
Currency	chr	Валюта рекламодателя. Справочник валют можно получить с помощью функции yadirGetDictionary.
CreatedAt	chr	Дата регистрации пользователя в Директе, в формате YYYY-MM-DD.
ClientInfo	chr	ФИО пользователя Директа.
AccountQuality	num	Показатель качества аккаунта.
CampaignsTotalPerClient	int	Максимальное количество кампаний у рекламодателя.
CampaignsUnarchivePerClient	int	максимальное количество кампаний, не находящихся в архиве.
APIPoints	int	Суточный лимит баллов API.