В январе 2026 г. в Google Ads API будет прекращена поддержка функции передачи объявлений

Среда, 9 июля 2025 г.

Что изменилось

Google прекращает поддержку функции передачи объявлений в Google Ads API.

С выходом версии 23 в январе 2026 года возможность создавать общие объявления будет удалена из всех поддерживаемых версий 28 января 2026 года.

  • Что случилось Функция "Общие объявления" перестанет поддерживаться во втором квартале 2026 года.
  • Каковы последствия? Исходные общие объявления перестанут показываться в общих группах объявлений.
  • Решение Чтобы ваши объявления продолжали показываться, мы автоматически создадим новую отдельную копию каждого из них. Эти новые копии будут показываться как обычные объявления.
  • Когда? Точная дата пока не определена. Мы сообщим ее позже.

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

Что такое совместное использование объявлений?

Проще говоря, "совместное использование объявлений" означает создание одного объявления и использование этого же объявления в нескольких группах объявлений.

Вместо того чтобы создавать одинаковые объявления для каждой группы, вы можете создать одно объявление и связать его со всеми нужными группами.

В чем причина этого изменения?

Это изменение связано с переходом на объявления на основе объектов. Будущее Google Рекламы – за форматами объявлений на основе объектов, такими как адаптивные поисковые объявления и кампании с максимальной эффективностью. В этих форматах объявление динамически собирается из набора объектов (заголовков, описаний, изображений), поэтому концепция статического объекта объявления, которым можно поделиться, менее эффективна.

Как подготовиться

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

Шаг 1. Проверьте приложение

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

Проверьте базу кода, особенно логику, которая взаимодействует с AdGroupAdService. Проверьте, не создали ли вы AdGroupAd, указав название ресурса существующего объявления, которое уже используется в другой группе объявлений.

Ваша текущая логика, которая скоро будет упразднена, может выглядеть примерно так:

  1. Создайте объект AdGroupAd, содержащий объект Ad.
  2. Создайте AdGroup.
  3. Создайте ещё один объект AdGroupAd, используя встроенный объект Ad из шага 1 и объект AdGroup из шага 2. (Эта функция будет удалена).

Шаг 2. Обновите логику создания объявлений

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

Новая логика, соответствующая правилам, должна выглядеть следующим образом:

  1. Для AdGroup_1:
    • Создайте AdGroupAd с помощью ad for ad_group_1.
  2. Для AdGroup_2:
    • Создайте AdGroupAd с помощью ad for ad_group_2.

Даже если рекламный текст идентичен, объявления должны быть созданы как отдельные объекты объявлений в API.

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

Шаг 3. Оцените влияние на отчеты

Если вы перестанете использовать одно объявление в нескольких группах и создадите для каждой из них уникальные объявления, это повлияет на статистику эффективности.

Важно! Статистика эффективности (показы, клики, конверсии) привязана к уникальному объявлению. У новых объявлений не будет статистики эффективности. Статистика по старым общим объявлениям сохранится, но не будет перенесена в новые объявления.

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

Перенос существующих общих объявлений

Шаг 1. Найдите общие объявления

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

SELECT
  ad_group_ad.ad.id,  -- This is the unique ID of the 'Ad' itself
  ad_group.id,        -- This is the unique ID of the 'AdGroup'
  ad_group_ad.status,
  ad_group_ad.ad.type,
  campaign.id,
  campaign.name,
  ad_group.name
FROM
  ad_group_ad
WHERE
  ad_group_ad.status IN ('ENABLED', 'PAUSED')
ORDER BY
  ad_group_ad.ad.id, ad_group.id

Если в результатах вы найдете ad_group_ad.ad.id, у которого в связанной коллекции ad_group.ids больше одной записи, это означает, что конкретное объявление (идентифицируемое по ad_group_ad.ad.id) связано с несколькими группами объявлений (каждая из которых идентифицируется по уникальному ad_group.id в коллекции).

Если ad_group.id связано с несколькими ad_group.id, то такое объявление считается общим.

Шаг 2. Соберите контент объявлений и связанные группы объявлений

Для каждого общего объявления, которое вы определили на шаге 1, вам нужно получить две вещи:

  1. Контент объявления (заголовки и описания).
  2. Список всех групп объявлений, в которых он сейчас активен.

Шаг 3. Создайте новое уникальное объявление ResponsiveSearchAd в каждой группе объявлений

Для каждой группы объявлений, определенной на шаге 2, создайте новое объявление ResponsiveSearchAd.

Рекомендация. Если вы используете развернутое текстовое объявление, не копируйте только три заголовка и два описания. Используйте их как отправную точку и добавляйте другие объекты. Эффективность ResponsiveSearchAds зависит от того, насколько разнообразны заголовки и описания, которые Google может тестировать. Рекомендуется добавить пять коротких заголовков, один длинный заголовок и пять описаний.

Ниже приведены ограничения для ResponsiveSearchAds.

Тип объекта Максимально допустимое значение Ограничение на количество символов Рекомендации
Короткий заголовок До 5 30 символов Добавьте все пять.
Длинный заголовок 1 90 символов Всегда указывайте 1.
Описание До 5 90 символов Добавьте все пять.

Ниже приведена концептуальная схема работы mutate с использованием AdGroupAdService.

  1. Проверьте каждый элемент ad_group.resource_name из результатов шага 2.
  2. Внутри цикла создайте новый объект AdGroupAd.
  3. Задайте для поля ad_group текущее значение ad_group.resource_name.
  4. Создайте объект Ad в AdGroupAd.
  5. Заполните поле responsive_search_ad, указав объекты:
    • Создайте список объектов AdTextAsset для заголовков.
    • Создайте список объектов AdTextAsset для описаний.
    • Задайте значения final_urls, path1 и path3, используя данные из старого объявления.
  6. Выполните запрос MutateAdGroupAds().

В результате в каждой группе объявлений будет свое уникальное ResponsiveSearchAds, готовое к показу.

Шаг 4. Удалите старые общие объявления

После того как вы создадите новые ResponsiveSearchAds и они пройдут проверку (статус ENABLED), можно будет удалить общие объявления.

  1. Определите название ресурса старого объекта AdGroupAd (связь между общим объявлением и группой объявлений).
  2. Используйте AdGroupAdService , чтобы выполнить изменение. В этом сервисе вы создадите AdGroupAdOperation. В объекте операции есть поле remove, в котором нужно указать название ресурса AdGroupAd, который вы хотите удалить.
  3. Наконец, вы вызываете метод mutateAdGroupAds в AdGroupAdService.

График прекращения поддержки общих объявлений

Настоятельно рекомендуем вам перенести общие объявления вручную.

  • Это лучший подход. Вы можете создавать новые объявления с уникальными изображениями и заголовками, адаптированными для аудитории каждой группы объявлений. Чем релевантнее объявления, тем лучше результаты.

Этап 1. С 28 января 2026 г.

  • Вы больше не можете создавать новые общие объявления.
  • Попытка связать одно объявление с новой группой объявлений будет заблокирована и приведет к ошибке. Если вы используете для этого автоматизированные инструменты или скрипты, они перестанут работать.

Этап 2. С 28 января 2026 г. по I квартал 2027 г.

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

Этап 3. I квартал 2027 г.

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

Рекомендуем ознакомиться с официальной документацией по Google Ads API и следить за новостями в блоге Google Ads Developer.

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

Автоматический процесс во II квартале 2026 г.

Если вы не предпримете никаких действий, мы автоматически разделим ваши общие объявления во втором квартале 2026 года.

Вот как будет работать автоматизированный процесс:

  • В одной группе объявлений останется исходное объявление. Оно будет сохранено только в одной группе объявлений (с наименьшим идентификатором).
  • Другие группы объявлений получат копии. Мы создадим новые копии исходного объявления для всех остальных групп объявлений, с которыми оно было связано.
  • Автоматически созданный контент будет сгенерирован заново. Настройки таких функций, как автоматизация объектов, будут скопированы. Однако сами объекты, созданные машиной (например, автоматически созданные заголовки или изображения), перенесены не будут. Наша система создаст совершенно новый набор для каждого скопированного объявления, что может повлиять на начальную эффективность.

Если у вас есть вопросы, задайте их на форуме.

Боб Хэнкок, команда Google Ads API

Ярлыки: google-ads-api