> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/mcp/ru/exoclick-mcp-tools.md). # Доступные инструменты После подключения ваш ИИ-ассистент получит доступ к следующим инструментам. Вам не нужно вызывать их напрямую — просто задайте вопрос на естественном языке, и ИИ автоматически использует подходящий инструмент. ## Что разрешено делать при подключении При подключении ИИ-клиента вы выбираете уровень доступа для каждой возможности:
УровеньЗначение
ЧтениеИИ может просматривать эти данные.
ЗаписьИИ может просматривать эти данные и вносить изменения.
Нет доступаИИ не может использовать эту возможность вообще.
Эти настройки лишь ограничивают то, что ИИ может делать. Подключение никогда не может делать больше, чем уже разрешает ваша учетная запись. Возможности, которыми ваша учетная запись не обладает, а также возможности, которые еще недоступны, не отображаются. См. [Подключение ИИ-клиента](/mcp/ru/exoclick-mcp-connecting-ai-client.md) чтобы узнать, где это настраивается. ## **Статистика** Просматривайте данные о производительности вашей учетной записи с гибкой фильтрацией и группировкой. Доступно рекламодателям и издателям, каждый — только к своим данным. **Доступ:** Чтение ### Статистика рекламодателя Запрашивайте статистику рекламодателя с гибкими параметрами фильтрации и группировки. Этот инструмент позволяет анализировать показы, клики, конверсии, доход, расходы и другие показатели эффективности по любой комбинации измерений. #### Что можно спросить * Показатели кампании за период дат * Разбивка по стране, устройству, браузеру, операционной системе, зоне или любой другой доступной измеряемой величине * Лучшие или худшие результаты по любому показателю * Сравнение между периодами времени * Отфильтрованные представления (например, статистика по конкретной кампании или зоне) #### Примеры запросов * *Покажи мне лучшие кампании по расходам за последние 7 дней.* * *Каков мой eCPA по странам в этом месяце?* * *Сравни мои показы на этой неделе с прошлой неделей, сгруппировав по типу устройства.* * *У каких зон вчера был самый низкий CR?* Запрашивайте статистику рекламодателя с гибкими параметрами фильтрации и группировки. Этот инструмент позволяет анализировать показы, клики, конверсии, расходы и другие показатели эффективности по любой комбинации измерений. ### Статистика издателя Запрашивайте статистику издателя с гибкими параметрами фильтрации и группировки. Этот инструмент позволяет анализировать показы, клики, eCPM и другие показатели эффективности по любой комбинации измерений. #### Что можно спросить * Показатели зон за период дат * Разбивка по стране, устройству, браузеру, операционной системе, зоне или любой другой доступной измеряемой величине * Лучшие или худшие результаты по любому показателю * Сравнение между периодами времени * Отфильтрованные представления (например, статистика по конкретной кампании или зоне) #### Примеры запросов * *Покажи мне лучшие зоны по доходу за последние 7 дней.* * *Каков мой eCPM по странам в этом месяце?* * *Сравни мои показы на этой неделе с прошлой неделей, сгруппировав по типу устройства.* * *Какие зоны в моем мультиформатном размещении вчера показали лучшие результаты?* ## Кампании Просматривайте настройки кампании, не выходя из диалога Это **только для рекламодателей** инструмент. **Доступ:** Чтение или запись ### Просмотр #### **Что можно спросить** * Список ваших кампаний, отфильтрованный по статусу (идет, приостановлена) или найденный по названию * Полная конфигурация одной кампании (если вы запрашиваете несуществующую кампанию или кампанию, принадлежащую другому аккаунту, инструмент возвращает понятную ошибку «не найдено».) * Сколько кампаний у вас в заданном состоянии * Минимальная ставка для формата и категории в заданной стране * Какие параметры таргетинга может использовать ваша учетная запись Список кампаний возвращает id, название и статус каждой кампании. Запрос по одной кампании возвращает ее полную конфигурацию, включая: | Раздел | Что включает | | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Идентификация | Название, id, группа кампании, тип кампании, дата создания. | | Формат объявления | Тип и метка объявления, размер креатива. | | Ценообразование | Модель ценообразования (CPM, CPC и т. д.), цена, алгоритм оптимизации, привязанный биддер. | | Бюджет и показ | Общие и дневные лимиты бюджета, потраченная сумма, лимиты показов, режим показа, ограничение частоты. | | Расписание | Дата начала и окончания, часовой пояс, разбиение по времени суток. | | Таргетинг | Страны и регионы, языки, браузеры, операционные системы, устройства, операторы, провайдеры, категории, интересы, ключевые слова, диапазоны IP, сайты, зоны, RTB-инвентарь и списки ретаргетинга. Каждый из них возвращается как список таргетинга и список блокировки. | | Правила зон и сети | Таргетируются зоны или блокируются, настройки партнерской сети, заблокированные метки и категории товаров. | | Креативы | Каждая вариация с целевым URL, отображаемым URL, оффером, статусом и состоянием одобрения, а также сводным количеством одобренных, ожидающих, отклоненных и приостановленных вариаций. | Если поле содержит внутренний id, ответ также содержит рядом читаемое название, чтобы ИИ мог отвечать простым языком, а не сырыми id. #### **Примеры запросов** * *Сколько у меня активных кампаний?* * *Покажи все мои приостановленные кампании.* * *Покажи список моих кампаний в группе 5, отсортированных по названию.* * *Есть ли у меня кампании, таргетированные на Германию?* Результаты разбиваются на страницы. Для аккаунтов с большим количеством кампаний ИИ автоматически обработает пагинацию в нескольких запросах. ### Создание и обновление Доступно, когда для этого функционала соединению предоставлен доступ на запись. Без него любая запись возвращает ошибку разрешений. Существующие соединения остаются доступными только для чтения, пока вы не подключитесь заново и не установите для Campaigns режим Write. #### **Что можно спросить:** * Создай кампанию, включая ее название, тип объявления, модель ценообразования, ставку, таргетинг и креативы * Обнови настройки кампании и таргетинг, включая период дат и разбиение по времени суток * Запусти или приостанови кампанию * Добавь или обнови вариации креативов, а также запускай или приостанавливай их по отдельности * Скопируй кампанию, при необходимости переименовав ее или сменив тип объявления * Добавь зоны в кампанию или удали зоны из кампании LLM предлагает только те типы объявлений, категории, модели ценообразования и параметры таргетинга, которые доступны вашей учетной записи. #### **Примеры запросов:** * *Создай баннерную CPM-кампанию под названием Summer Sale, таргетируя Испанию, со ставкой 0.50.* * *Добавь вариацию 300x250 к кампании X, ведущую на example.com.* * *Повыши ставку на кампании X до 0.80.* * *Приостанови вариации в кампании X.* * *Скопируй кампанию X и вместо этого таргетируй зоны.* * Таргетировать зоны X и/или блокировать зону X Каждое изменение суммируется перед применением, поэтому ничего не будет записано, пока вы не подтвердите. #### **Чего ожидать** | Ситуация | Поведение | | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Новая кампания | Создается приостановленной, если вы не попросите запустить ее. | | Скопированная кампания | Сохраняет статус исходной кампании. | | Креативы | Используйте уже имеющиеся в вашей медиатеке ресурсы, указанные по id или названию. Если название совпадает более чем с одним ресурсом, вас спросят, какой именно, и ничего не будет изменено. | | Ставки и бюджеты | Устанавливаются в валюте вашей учетной записи. Ставки ниже минимальной цены для страны и формата отклоняются. | | Недоступные вам форматы | Типы объявлений и настройки, зарезервированные для администраторов или отключенные в вашей сети, нельзя использовать. | | Пока не поддерживается | Загрузка ресурсов, кампании Smart Bid и Dynamic CPA, архивирование, поведенческий ретаргетинг, таргетинг по интересам и пользовательский сетевой таргетинг. | ## Сайты и зоны Изучайте свои сайты и рекламные зоны в формате диалога, перечисляйте их, фильтруйте и ищите, а также подробно просматривайте настройки любого отдельного сайта или зоны, включая то, какие метки и категории товаров блокирует зона. Это **только для издателей** инструмент. **Доступ:** Чтение или запись ### Просмотр * Список ваших сайтов или зон, отфильтрованный по статусу, типам сайтов или типу объявления, либо найденный по названию * Зоны, принадлежащие определенному сайту * Полная конфигурация одного сайта или зоны * Какие из ваших зон активны **Запрос о сайте возвращает:** | Раздел | Что включено | | ------------- | --------------------------------------------------- | | Идентификация | Название, id, URL, описание. | | Классификация | Тип сайта (вебсайт, приложение и т. д.), категория. | | Статус | Активное состояние и статус одобрения. | **Запрос о зоне возвращает гораздо более полную конфигурацию, включая:** | Раздел | Что включено | | ------------------ | ------------------------------------------------------------------------------------------------------------------------- | | Идентификация | Название, id, id и название родительского сайта. | | Формат | Тип и метка рекламы издателя, размер, является ли зона адаптивной, а для мультиформатных зон — дочерние зоны и их макеты. | | Ценообразование | Минимальный CPM, тип пола (soft или hard), модели ценообразования. | | Управление показом | Ограничение частоты, ограничение показов, скорость обновления рекламы, ограничения браузера, резервные объявления. | | Внешний вид | Прикрепленная позиция, рамка и цвет, цвета текста, шрифт, настройка миниатюры. | | Видео | Настройки pre-roll, mid-roll и post-roll, конфигурация VAST, поддержка VAST wrapper, VMAP, оверлей CTA, время пропуска. | | Настройки pop | Метод триггера, классы триггера, задержка, резервный вариант, поведение новой вкладки. | | Блокировка | Метки, которые блокирует издатель, заблокированные категории товаров, правила соответствия. | | Категория | Основная и подкатегория. | | Флаги | Активное состояние, отслеживание инвентаря, уровень сертификации, shading ставок, BURL, диалог прозрачности рекламы. | Если поле содержит внутренний id, ответ также содержит рядом читаемое название, чтобы ИИ мог отвечать простым языком, а не сырыми id. Результаты разбиваются на страницы, поэтому большие аккаунты возвращаются пакетами, а не все сразу. #### **Примеры запросов** * *Какие из моих зон активны?* * *Каковы настройки на сайте X?* * *Покажи все зоны на моем сайте X.* * *У каких моих зон установлен CPM floor?* * *Покажи мне метки, заблокированные в зоне X.* * *Покажи мои сайты, которые все еще ожидают одобрения.* ### **Создание и обновление** Доступно, когда для этого функционала соединению предоставлен доступ на запись. Без него любая запись возвращает ошибку разрешений. Подключения, авторизованные до введения уровней доступа, доступны только для чтения, пока вы не подключитесь заново. #### **Что можно спросить:** * Создать сайт * Создать зону любого поддерживаемого типа объявления, включая RTB, нативный виджет, in-video VAST, web push, in-page push и мультиформат * Обновить название, описание или категорию сайта * Обновить настройки зоны или переместить ее на другой сайт #### **Примеры запросов:** * *Создай новый сайт для example.com в категории Entertainment.* * *Добавь баннерную зону 300x250 на мой сайт X.* * *Переименуй зону 1234567 в Homepage Top.* * *Перемести зону 1234567 на мой другой сайт.* Каждое изменение суммируется перед применением, поэтому ничего не будет записано, пока вы не подтвердите. #### **Чего ожидать** | Ситуация | Поведение | | ---------------------------------------- | ----------------------------------------------------------------------------------------------------- | | Новый сайт | Может быть возвращен как непроверенный, и в этом случае проверка завершается в панели администратора. | | Изменение категории сайта | Возвращает сайт в состояние ожидания одобрения. | | URL и тип сайта | Задаются при создании и не могут быть изменены позже. | | Тип объявления зоны | Задаются при создании и не могут быть изменены позже. | | Баннерные зоны и зоны мобильных баннеров | Требуют размера. | | RTB-зоны | Требуют партнера рекламной биржи и не используют размер. | | Недоступные вам форматы | Форматы, зарезервированные для администраторов или отключенные в вашей сети, нельзя создавать. | ## **Справка: инструменты по возможностям** Если ваш ИИ-клиент отображает сырые имена инструментов, это полный список. | Инструмент | Возможность | Доступ | | ----------------------------------- | -------------------------- | --------------- | | get\_advertiser\_global\_statistics | Статистика (рекламодатель) | Чтение | | get\_publisher\_global\_statistics | Статистика (издатель) | Чтение | | get\_campaigns | Кампании | Чтение | | get\_campaign | Кампании | Чтение | | get\_campaign\_groups | Кампании | Чтение | | get\_zone\_targeting\_options | Кампании | Чтение | | get\_minimum\_prices | Кампании | Чтение | | create\_campaign | Кампании | Запись | | update\_campaign | Кампании | Запись | | copy\_campaign | Кампании | Запись | | add\_campaign\_variation | Кампании | Запись | | play\_campaign\_variations | Кампании | Запись | | pause\_campaign\_variations | Кампании | Запись | | add\_campaign\_zones | Кампании | Запись | | remove\_campaign\_zones | Кампании | Запись | | get\_sites | Сайты и зоны | Чтение | | get\_site | Сайты и зоны | Чтение | | get\_zones | Сайты и зоны | Чтение | | get\_zone | Сайты и зоны | Чтение | | create\_site | Сайты и зоны | Запись | | update\_site | Сайты и зоны | Запись | | create\_zone | Сайты и зоны | Запись | | update\_zone | Сайты и зоны | Запись | | get\_collection | Поддерживающие | Всегда доступно | ## Публичный репозиторий навыков Вместе с MCP Server, ExoClick имеет доступ к [**публичному репозиторию готовых навыков**](https://github.com/EXADS/ai-skills), которые представляют собой оптимизированные промпты и рабочие процессы, разработанные для типовых рекламных задач. Эти навыки дают вам преимущество благодаря проверенным подходам к таким задачам, как ежедневный анализ эффективности, обзоры оптимизации кампаний и отчетность. | Навык | Что он делает | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | daily-top-campaigns | Показывает ваши самые эффективные рекламные кампании за один день. | | statistics-analysis | Анализирует эффективность рекламодателя за период дат и сравнивает ее с предыдущим периодом. | | fetch-advertiser-statistics | Получает статистику рекламодателя по любым поддерживаемым измерениям, может использоваться самостоятельно или как строительный блок для других навыков. | | fetch-publisher-statistics | Получает статистику издателя по любым поддерживаемым измерениям. | Навыки совершенно необязательны. MCP Server работает с любым промптом или вопросом, который вы напишете сами. Репозиторий навыков просто помогает быстрее начать и воспользоваться рабочими процессами, которые были протестированы и доработаны командой ExoClick. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.exoclick.com/mcp/ru/exoclick-mcp-tools.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.