Клиент (Client)

  1. Пользователи Директа и их роли
  2. Методы

Объект Клиент (Client) соответствует рекламодателю или рекламному агентству.

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

Рекламодателю принадлежат его рекламные кампании.

Агентству логически подчинены рекламодатели — клиенты этого агентства.

Кампаниями рекламодателя управляют пользователи Директа в зависимости от назначенной роли.

Пользователи Директа и их роли

Пользователь, имеющий логин на Яндексе, становится пользователем Директа (у него появляется учетная запись в Директе), когда он становится представителем рекламодателя или агентства, то есть получает одну из следующих ролей:

  • главный представитель рекламодателя;

  • представитель рекламодателя;

  • главный представитель агентства;

  • представитель агентства;

  • представитель агентства по работе с клиентами.

Например:

  • Пользователь создает аккаунт в Директе, выбрав страну и валюту. В результате создается клиент — прямой рекламодатель, а пользователь становится главным представителем этого рекламодателя.

  • Представитель агентства регистрирует в Директе логин для нового клиента. В результате создается рекламодатель — клиент агентства, а пользователь с указанным логином становится главным представителем этого рекламодателя.

  • Другой пользователь назначает пользователя представителем рекламодателя или агентства.

Если пользователь Яндекса не является пользователем Директа, для него можно получить OAuth-токен, однако запросы к API Директа от его имени будут завершаться ошибкой.

Внимание.

Идентификатором пользователя является его логин на Яндексе. Если упоминается логин рекламодателя или агентства — имеется в виду логин его главного представителя. Идентификатором рекламодателя является ClientId.

Методы

Для рекламодателей

Для управления параметрами рекламодателя и настройками пользователя — представителя рекламодателя предназначен сервис Clients.

Методы: update | get

Любой представитель рекламодателя может получать и редактировать параметры рекламодателя и собственные настройки.

Главный представитель рекламодателя может, кроме собственных настроек, получать и редактировать настройки другого представителя: для этого необходимо передать логин представителя в HTTP-заголовке запроса Client-Login.

Для агентств

Для управления рекламодателями — клиентами агентства предназначен сервис AgencyClients. Запросы к сервису нужно выполнять от имени представителя агентства.

Методы: add | update | get

Для получения параметров агентства и настроек пользователя — представителя агентства предназначен метод Clients.get.

Подробнее см. в разделе Агентствам.