MatiousCorp/google-ad-manager-mcp

Утверждает позицию заказа, требующую утверждения. Используется, когда в Google Ad Manager включён процесс утверждения. Позиции заказа со статусом NEEDS_APPROVAL можно утвердить для разрешения показа. Аргументы: line_item_id: Идентификатор позиции заказа для утверждения. network_code: Необязательный код сети GAM для указания конкретной сети. Если не указан, используется сеть по умолчанию. Возвращает результат операции утверждения, включая новый статус.

Архивирует позицию. Архивированные позиции скрыты из стандартных представлений интерфейса, но их по-прежнему можно получить через API. Это полезно для очистки старых кампаний. Примечание: это действие нельзя отменить через API. Аргументы: line_item_id: Идентификатор позиции для архивации network_code: Необязательный код сети GAM для указания конкретной сети. Если не указан, используется сеть по умолчанию. Возвращает результат действия архивации, включая новый статус.

Связывает креатив с позицией заказа. Аргументы: creative_id: идентификатор креатива line_item_id: идентификатор позиции заказа size_override_width: необязательная ширина для переопределения размера size_override_height: необязательная высота для переопределения размера network_code: необязательный код сети GAM для указания конкретной сети. Если не указан, используется сеть по умолчанию. Возвращает сведения о связи.

Загружает все креативы из папки и связывает с line item. Аргументы: folder_path: Путь к папке с файлами изображений advertiser_id: ID рекламодателя line_item_id: ID позиции (line item) click_through_url: URL назначения при клике name_prefix: Необязательный префикс для названий креативов network_code: Необязательный код сети GAM для привязки к конкретной сети. Если не указан, используется сеть по умолчанию. Поддерживаемые форматы: jpg, jpeg, png, gif. Возвращает результаты для всех загрузок.

Проверяет подробный статус доставки для позиции заказа. Аргументы: line_item_id: Идентификатор позиции заказа для проверки. network_code: Необязательный код сети GAM для указания конкретной сети. Если не указан, использует сеть по умолчанию. Возвращает прогресс доставки, включая показы, клики и прогресс по цели.

Создаёт нового рекламодателя. Аргументы: name: Имя рекламодателя email: Необязательный адрес электронной почты address: Необязательный адрес network_code: Необязательный код сети GAM для нацеливания на конкретную сеть. Если не указан, используется сеть по умолчанию. Возвращает данные созданного рекламодателя.

Создаёт полную кампанию: находит/создаёт рекламодателя, заказ, позицию и загружает креативы. Аргументы: advertiser_name: Название рекламодателя order_name: Название заказа line_item_name: Название позиции end_year: Год даты окончания end_month: Месяц даты окончания (1-12) end_day: День даты окончания (1-31) creatives_folder: Путь к папке с изображениями креативов click_through_url: Целевой URL для всех креативов target_ad_unit_id: Идентификатор рекламного места для таргетинга (найти в интерфейсе GAM или через инструменты для рекламных мест) goal_impressions: Цель по показам (по умолчанию: 100000) line_item_type: Тип позиции (STANDARD, SPONSORSHIP, NETWORK, BULK, PRICE_PRIORITY, HOUSE и т.д.) creative_sizes: JSON-строка с размерами, например '[{"width": 300, "height": 250}, {"width": 728, "height": 90}]' network_code: Опциональный код сети GAM для таргетинга на конкретную сеть. Если не указан, использует сеть по умолчанию. Это полный рабочий процесс, который: 1. Находит или создаёт рекламодателя 2. Находит или создаёт заказ 3. Создаёт позицию 4. Загружает все креативы из папки 5. Привязывает креативы к позиции Возвращает полные результаты создания кампании.

Создаёт новую строку заказа. Аргументы: order_id: ID заказа, к которому добавляется строка name: Название строки заказа end_year: Год окончания (например, 2025) end_month: Месяц окончания (1–12) end_day: День окончания (1–31) target_ad_unit_id: ID рекламного места для таргетинга (находится в интерфейсе GAM или через инструменты работы с рекламными местами) line_item_type: Тип строки заказа. Допустимые типы: - SPONSORSHIP: Гарантированный, с оплатой за время (100% голосовой доли) - STANDARD: Гарантированный, с оплатой за достижение цели (конкретное количество показов) - NETWORK: Негарантированный, по всей сети - BULK: Негарантированный, с оплатой за объём - PRICE_PRIORITY: Негарантированный, конкурирует по цене - HOUSE: Внутренняя / собственная реклама (самый низкий приоритет) - CLICK_TRACKING: Только для отслеживания кликов - ADSENSE: Дозагрузка от AdSense - AD_EXCHANGE: Дозагрузка от Ad Exchange - BUMPER: Короткие видеоролики-бамперы - PREFERRED_DEAL: Программатик preferred deal goal_impressions: Цель по показам (по умолчанию: 100000) creative_sizes: JSON-строка с размерами, например '[{"width": 300, "height": 250}, {"width": 728, "height": 90}]'. Если не указано, используются размеры по умолчанию: 300x250, 300x600, 728x90, 1000x250 cost_per_unit_micro: Стоимость за единицу в микро-единицах (например, 1000000 = 1 MAD) currency_code: Код валюты (по умолчанию: MAD) network_code: Необязательный код сети GAM для таргетинга на конкретную сеть. Если не указан, используется сеть по умолчанию. Возвращает детали созданной строки заказа.

Создаёт новый заказ для рекламодателя. Аргументы: order_name: Имя нового заказа advertiser_id: Идентификатор компании-рекламодателя network_code: Необязательный код сети GAM для указания конкретной сети. Если не указан, используется сеть по умолчанию. Возвращает сведения о созданном заказе.

Создаёт сторонний креатив (HTML/JavaScript ad tag). Используется для тегов DCM/Campaign Manager, пользовательских HTML-объявлений или любых тегов стороннего рекламного сервера, которые нужно показывать через Google Ad Manager. Аргументы: advertiser_id: ID рекламодателя name: Название креатива width: Ширина креатива в пикселях height: Высота креатива в пикселях snippet: Фрагмент HTML/JavaScript кода (ad tag) expanded_snippet: Необязательный расширенный фрагмент для разворачиваемых креативов is_safe_frame_compatible: Совместимость креатива с SafeFrame (по умолчанию: True) network_code: Необязательный код сети GAM для нацеливания на конкретную сеть. Если не указан, использует сеть по умолчанию. Возвращает детали созданного креатива.

Дублирует существующую позицию. Аргументы: source_line_item_id: ID дублируемой позиции new_name: Имя новой позиции rename_source: Необязательное новое имя для исходной позиции network_code: Необязательный код сети GAM для работы с конкретной сетью. Если не указан, используется сеть по умолчанию. Возвращает сведения как об исходной, так и о новой позиции.

Находит рекламодателя по имени (частичное совпадение). Аргументы: name: Имя рекламодателя для поиска network_code: Необязательный код сети GAM для указания конкретной сети. Если не указан, используется сеть по умолчанию. Возвращает список соответствующих рекламодателей.

Находит рекламодателя по точному имени или создаёт, если не найден. Аргументы: name: Точное имя рекламодателя email: Необязательный email (используется при создании) network_code: Необязательный код сети GAM для выбора конкретной сети. Если не указан, используется сеть по умолчанию. Возвращает существующего или только что созданного рекламодателя.

Находит существующий заказ по имени или создаёт новый. Аргументы: order_name: Имя заказа advertiser_id: Идентификатор компании-рекламодателя network_code: Необязательный код сети GAM для указания конкретной сети. Если не указан, используется сеть по умолчанию. Возвращает существующий или только что созданный заказ.

Получает детали рекламодателя по ID. Аргументы: advertiser_id: ID рекламодателя/компании network_code: Необязательный код сети GAM для указания конкретной сети. Если не указан, используется сеть по умолчанию. Возвращает детали рекламодателя.

Получает детали креатива по ID. Аргументы: creative_id: Идентификатор креатива network_code: Опциональный код сети GAM для указания конкретной сети. Если не указан, используется сеть по умолчанию. Возвращает детали креатива, включая размер и целевой URL.

Получает URL предпросмотра для креатива, связанного с позицией заказа. Генерирует URL предпросмотра, который показывает, как креатив будет выглядеть на указанном URL сайта. URL предпросмотра загружает сайт с креативом, отображаемым в его рекламных слотах. Аргументы: line_item_id: Идентификатор позиции заказа creative_id: Идентификатор креатива site_url: URL сайта, на котором вы хотите просмотреть креатив (например, "https://abc.com") network_code: Необязательный код сети GAM для указания конкретной сети. Если не указан, используется сеть по умолчанию. Возвращает URL предпросмотра, который можно открыть в браузере.

Получает сведения о позиции заказа по идентификатору. Аргументы: line_item_id: ID позиции заказа network_code: Необязательный код сети GAM для указания конкретной сети. Если не указан, использует сеть по умолчанию. Возвращает сведения о позиции заказа, включая статус, даты и статистику.

Получает детали заказа по ID или имени. Аргументы: order_id: ID заказа (необязателен, если указан order_name) order_name: Имя заказа для поиска (необязательно, если указан order_id) network_code: Необязательный код сети GAM для указания конкретной сети. Если не указан, используется сеть по умолчанию. Возвращает детали заказа, включая все позиции.

Перечисляет всех рекламодателей. Аргументы: limit: Максимальное количество возвращаемых рекламодателей (по умолчанию: 100) network_code: Необязательный код сети GAM для указания конкретной сети. Если не указан, используется сеть по умолчанию. Возвращает список рекламодателей.

Перечисляет креативы для рекламодателя. Аргументы: advertiser_id: Идентификатор рекламодателя limit: Максимальное количество креативов для возврата (по умолчанию: 100) network_code: Необязательный код сети GAM для выбора конкретной сети. Если не указан, используется сеть по умолчанию. Возвращает список креативов.

Перечисляет креативы, связанные с позицией. Аргументы: line_item_id: Идентификатор позиции limit: Максимальное количество возвращаемых креативов (по умолчанию: 100) network_code: Необязательный код сети GAM для указания конкретной сети. Если не указан, используется сеть по умолчанию. Возвращает список креативов с их статусом привязки.

Перечисляет все заказы с позициями, в настоящее время показывающими рекламу. Аргументы: network_code: Необязательный код сети GAM для указания конкретной сети. Если не указан, использует сеть по умолчанию. Возвращает список заказов с их показывающими позициями, включая статистику показов и кликов.

Перечисляет все линейные элементы для заказа. Аргументы: order_id: Идентификатор заказа network_code: Необязательный код сети GAM для указания конкретной сети. Если не указан, используется сеть по умолчанию. Возвращает список линейных элементов с их статусом и статистикой.

Приостанавливает доставляющую рекламную позицию. Приостановка останавливает показ рекламы по позиции. Позицию можно возобновить позже с помощью resume_line_item. Аргументы: line_item_id: ID позиции для приостановки network_code: Необязательный код сети GAM для указания конкретной сети. Если не указан, используется сеть по умолчанию. Возвращает результат действия приостановки, включая новый статус.

Возобновляет приостановленную позицию. Возобновление позволяет ранее приостановленной позиции снова начать показ рекламы в соответствии с её расписанием и таргетингом. Аргументы: line_item_id: Идентификатор позиции для возобновления network_code: Необязательный код сети GAM для указания конкретной сети. Если не указан, используется сеть по умолчанию. Возвращает результат действия возобновления, включая новый статус.

Запускает пользовательский отчет с заданными измерениями и метриками. Аргументы: dimensions: JSON-массив имен измерений, например '["DATE", "ORDER_NAME", "LINE_ITEM_NAME"]' Допустимые измерения: DATE, WEEK, MONTH_AND_YEAR, ORDER_ID, ORDER_NAME, LINE_ITEM_ID, LINE_ITEM_NAME, LINE_ITEM_TYPE, CREATIVE_ID, CREATIVE_NAME, CREATIVE_SIZE, ADVERTISER_ID, ADVERTISER_NAME, AD_UNIT_ID, AD_UNIT_NAME columns: JSON-массив имен метрик, например '["TOTAL_LINE_ITEM_LEVEL_IMPRESSIONS"]' Допустимые метрики: TOTAL_LINE_ITEM_LEVEL_IMPRESSIONS, TOTAL_LINE_ITEM_LEVEL_CLICKS, TOTAL_LINE_ITEM_LEVEL_CTR, TOTAL_LINE_ITEM_LEVEL_CPM_AND_CPC_REVENUE, TOTAL_LINE_ITEM_LEVEL_ALL_REVENUE, TOTAL_INVENTORY_LEVEL_IMPRESSIONS, TOTAL_AD_REQUESTS, TOTAL_RESPONSES_SERVED, TOTAL_FILL_RATE date_range_type: Диапазон дат (TODAY, YESTERDAY, LAST_WEEK, LAST_MONTH, LAST_3_MONTHS, REACH_LIFETIME, CUSTOM_DATE) start_year: Начальный год для диапазона CUSTOM_DATE start_month: Начальный месяц (1-12) для диапазона CUSTOM_DATE start_day: Начальный день (1-31) для диапазона CUSTOM_DATE end_year: Конечный год для диапазона CUSTOM_DATE end_month: Конечный месяц (1-12) для диапазона CUSTOM_DATE end_day: Конечный день (1-31) для диапазона CUSTOM_DATE filter_statement: Необязательный фильтр (например, "ORDER_ID = 12345") timeout_seconds: Максимальное время ожидания завершения отчета (в секундах) network_code: Необязательный код сети GAM для нацеливания на конкретную сеть. Если не указан, используется сеть по умолчанию. Возвращает данные отчета с указанными измерениями и метриками.

Запускает отчет о доставке для заказов и позиций. Возвращает показы, клики, CTR и доход в разбивке по заказам и позициям. Args: date_range_type: Диапазон дат для отчета. Допустимые значения: - TODAY, YESTERDAY, LAST_WEEK, LAST_MONTH, LAST_3_MONTHS, REACH_LIFETIME - CUSTOM_DATE (требует параметры start и end date) start_year: Год начала (обязателен, если date_range_type равен CUSTOM_DATE) start_month: Месяц начала 1–12 (обязателен, если date_range_type равен CUSTOM_DATE) start_day: День начала 1–31 (обязателен, если date_range_type равен CUSTOM_DATE) end_year: Год окончания (обязателен, если date_range_type равен CUSTOM_DATE) end_month: Месяц окончания 1–12 (обязателен, если date_range_type равен CUSTOM_DATE) end_day: День окончания 1–31 (обязателен, если date_range_type равен CUSTOM_DATE) order_id: Необязательный ID заказа для фильтрации line_item_id: Необязательный ID позиции для фильтрации include_date_breakdown: Если True, включает дневную разбивку (по умолчанию: True) timeout_seconds: Максимальное время ожидания отчета (по умолчанию: 120) network_code: Необязательный код сети GAM для указания конкретной сети. Если не указан, используется сеть по умолчанию. Возвращает данные отчета со статистикой по показам, кликам, CTR и доходу.

Запускает отчёт по рекламным местам. Возвращает запросы объявлений, показы и процент заполнения в разрезе рекламных мест. Аргументы: date_range_type: Диапазон дат для отчёта (TODAY, YESTERDAY, LAST_WEEK и т.д.) start_year: Год начала (для CUSTOM_DATE) start_month: Месяц начала, 1–12 (для CUSTOM_DATE) start_day: День начала, 1–31 (для CUSTOM_DATE) end_year: Год окончания (для CUSTOM_DATE) end_month: Месяц окончания, 1–12 (для CUSTOM_DATE) end_day: День окончания, 1–31 (для CUSTOM_DATE) ad_unit_id: Идентификатор рекламного места для фильтрации (необязательно) include_date_breakdown: Если True, включает разбивку по дням (по умолчанию: True) timeout_seconds: Максимальное время ожидания отчёта (по умолчанию: 120) network_code: Код сети GAM для привязки к конкретной сети. Если не указан, используется сеть по умолчанию. Возвращает данные отчёта со статистикой по запросам объявлений, показам и проценту заполнения.

Обновляет свойства существующего креатива. Аргументы: creative_id: Идентификатор креатива для обновления destination_url: Новый URL назначения/перехода для креатива name: Новое имя для креатива network_code: Необязательный код сети GAM для нацеливания на конкретную сеть. Если не указан, используется сеть по умолчанию. Необходимо указать хотя бы один из параметров destination_url или name. Возвращает обновлённые сведения о креативе.

Обновляет свойства существующей позиции (line item). Аргументы: line_item_id: Идентификатор позиции для обновления name: Новое название позиции line_item_type: Тип позиции. Допустимые типы: - SPONSORSHIP: Гарантированный, на основе времени (100% доля показов) - STANDARD: Гарантированный, на основе цели (конкретное количество показов) - NETWORK: Негарантированный, по всей сети - BULK: Негарантированный, на основе объёма - PRICE_PRIORITY: Негарантированный, конкурирует по цене - HOUSE: Внутренняя/собственная реклама (самый низкий приоритет) delivery_rate_type: Как позиция доставляет показы: - EVENLY: Равномерно в течение кампании - FRONTLOADED: Больше в начале - AS_FAST_AS_POSSIBLE: Максимально быстро priority: Приоритет (1–16, зависит от типа позиции). Меньшие числа = выше приоритет. SPONSORSHIP: 4, STANDARD: 6-10, NETWORK: 12, BULK: 12, PRICE_PRIORITY: 12, HOUSE: 16 cost_per_unit_micro: Стоимость за единицу в микро-суммах (например 1000000 = 1 денежная единица) currency_code: Код валюты (например MAD, USD, EUR) goal_impressions: Цель по показам (обновляет primaryGoal.units) end_year: Год окончания end_month: Месяц окончания (1–12) end_day: День окончания (1–31) network_code: Опциональный код сети GAM для привязки к конкретной сети. Если не указан, используется сеть по умолчанию. Примечание: Для обновления нужно указать хотя бы одно поле. Дата окончания требует все три компонента (год, месяц, день). Возвращает обновлённые детали позиции со списком внесённых изменений.

Загружает креатив и связывает его с позицией заказа за один шаг. Аргументы: file_path: Путь к файлу изображения advertiser_id: Идентификатор рекламодателя line_item_id: Идентификатор позиции заказа click_through_url: URL перехода при клике creative_name: Необязательное название креатива network_code: Необязательный код сети GAM для указания конкретной сети. Если не указан, используется сеть по умолчанию. Возвращает сведения о креативе и связывании.

Загружает изображение креатива в Ad Manager. Аргументы: file_path: Путь к файлу изображения advertiser_id: ID рекламодателя click_through_url: URL перехода при клике creative_name: Необязательное название креатива override_size_width: Необязательная ширина для переопределения размера креатива (для показа в слот другого размера) override_size_height: Необязательная высота для переопределения размера креатива (для показа в слот другого размера) network_code: Необязательный код сети GAM для указания конкретной сети. Если не указан, используется сеть по умолчанию. Размер креатива извлекается из имени файла (например, '300x250' в 'banner_300x250.png'). Используйте override_size_width и override_size_height вместе, чтобы показывать креатив в слоте другого размера (например, показывать изображение 970x250 в слоте 1000x250). Возвращает сведения о созданном креативе.

Проверяет настройку позиции, включая заполнители креативов и привязки. Аргументы: line_item_id: Идентификатор позиции для проверки network_code: Необязательный код сети GAM для указания конкретной сети. Если не указан, используется сеть по умолчанию. Проверки: - Заполнители креативов (ожидаемые размеры) - Привязки креативов - Несоответствия размеров между креативами и заполнителями Возвращает результаты проверки с обнаруженными проблемами.

Проверяет полную настройку заказа, включая все позиции. Args: order_id: Идентификатор заказа для проверки. network_code: Необязательный код сети GAM для указания конкретной сети. Если не указан, использует сеть по умолчанию. Возвращает полную проверку заказа и всех его позиций.