Объект является учетной записью пользователя в Директе.

В Директе зарегистрированы пользователи, ведущие рекламные кампании и в пользу которых ведутся кампании: прямые рекламодатели, агентства, клиенты агентств. Их логины в Яндексе служат идентификаторами учетных записей в Директе.

Учетные записи получают и редактируют с помощью методов GetClientInfo и UpdateClientInfo.

Главные представители

Главный представитель — это пользователь Яндекса, с которым ведутся финансовые расчеты за услуги Директа. Для него создается лицевой счет и с ним связываются кампании. У прямого рекламодателя главным представителем является он сам, у агентства — пользователь, действующий от лица агентства, например Генеральный директор.

Метод GetClientsUnits сообщает количество баллов, начисленных главному представителю (см. Балльные ограничения).

Представители

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

Представителей назначают в веб-интерфейсе Директа. В API список представителей получают с помощью метода GetSubClients (также возвращает список клиентов агентства).

У агентства может быть два типа представителей — с полномочиями вести кампании любых клиентов агентства и с полномочиями только на указанных клиентов, список которых определил главный представитель. Тип указан в параметре Role (метод GetSubClients).

Клиенты агентств

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

Агентство регистрирует субклиентов с помощью метода CreateNewSubclient, который по указанному логину создает учетную запись в Яндексе и в Директе. Агентство не может сделать субклиентом ранее зарегистрированного пользователя Яндекса, поскольку в этом случае пользователь лишается возможности создавать кампании в Директе от своего имени.

Учетные записи всех субклиентов возвращает метод GetClientsList. Выборочно по логину учетные записи получают методом GetClientInfo. Метод GetSubClients возвращает сокращенный состав сведений о клиентах и представителях агентства (логин, ФИО). В параметре Role указано, является ли пользователь клиентом или представителем.

Клиенты рекламных агентств могут получить доступ к API:
  • Если агентство предоставило клиенту доступ в веб-интерфейс только на чтение, то и через API клиент сможет только получать данные.
  • Если агентство предоставило клиенту право на редактирование кампаний, то клиент сможет управлять своими кампаниями как в веб-интерфейсе, так и через API.

Агентство настраивает права доступа своих клиентов с помощью метода UpdateClientInfo, а также в веб-интерфейсе (флажок редактировать кампанию на странице редактирования настроек клиента).