Перенос сценариев расширений объявлений,Перенос сценариев расширений объявлений

Важно! Вы можете продолжать работать с текущими расширениями на основе каналов с помощью устаревших сценариев Google Рекламы. Однако расширения на основе каналов скоро станут недоступны, а расширения на основе объектов доступны только в новом интерфейсе сценариев Google Рекламы. Мы рекомендуем как можно скорее перенести устаревшие скрипты Google Рекламы в новую версию скриптов Google Рекламы.

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

Обзор

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

Существующая парадигма расширений на основе каналов устарела в пользу расширений на основе ресурсов. Расширения на основе фидов называются «устаревшими» расширениями в пользовательском интерфейсе Google Рекламы, а расширения на основе объектов называются «обновленными» расширениями в пользовательском интерфейсе Google Рекламы.

Начиная с 28 марта 2022 г. расширения на основе фидов будут перенесены в новые расширения на основе объектов. После переноса расширения на основе фидов перестанут обслуживаться. В этом руководстве описывается переход, независимо от того, есть ли у вас в аккаунте Google Рекламы рекламные расширения на основе фидов и объектов или в вашем аккаунте есть только рекламные расширения на основе фидов.

Подробности миграции

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

Получение расширений объявлений

Существующий набор селекторов расширений объявлений (например, SitelinkSelector может выбирать либо расширения объявлений на основе фидов, либо расширения объявлений на основе объектов. По умолчанию эти селекторы возвращают тот тип расширения объявлений, который в данный момент отображается. В следующей таблице приведены сводные данные. тип расширения объявления, которое показывается в данный момент (и, следовательно, будет возвращено по умолчанию):

Тип расширений объявлений в аккаунте
Только расширения объявлений на основе фидов	Расширения объявлений на основе фидов будут возвращены по умолчанию.
Только расширения объявлений на основе объектов	Расширения объявлений на основе объектов будут возвращены по умолчанию.
Расширения объявлений как на основе фидов, так и на основе объектов.	Расширения объявлений на основе объектов будут возвращены по умолчанию.

После переноса всех расширений объявлений на основе фидов все средства выбора расширений по умолчанию будут возвращать расширения объявлений на основе объектов. По-прежнему можно будет получать расширения объявлений на основе фидов с помощью метода withOnlyLegacy . Это полезно для сбора исторических показателей.

// This will return feed-based sitelink extensions before and after
// March 28, 2022.
const sitelinks = AdsApp.extensions().sitelinks().withOnlyLegacy().get();

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

Фильтрация расширений объявлений по идентификатору

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

// If these IDs belong to feed-based sitelink extensions, this code will return
// an empty iterator on or after March 28, 2022 (once the extensions have been
// migrated).
const ids = [123, 456, 789];
const sitelinks = AdsApp.extensions().sitelinks().withIds(ids).get();

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

Фильтрация расширений объявлений по статистике

При переносе расширения объявления на основе фида статистика соответствующего расширения объявления на основе объекта будет сброшена. Это следует учитывать при фильтрации расширений объявлений по статистике. Например, если вы запросите расширения дополнительных ссылок с Clicks > 100 за LAST_MONTH , вы можете увидеть меньше расширений объявлений, чем обычно, если ваши расширения объявлений на основе фидов были недавно перенесены.

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

Устаревшие методы

В рамках миграции некоторые поля больше не поддерживаются. Например, дата начала и дата окончания исключены из расширений фрагментов. Вызовы getStartDate() вернут null . Кроме того, будет зарегистрировано предупреждающее сообщение. См. следующую таблицу, чтобы понять, какие методы устарели:

Сорт	Устаревшие методы
Вызывать	Нет устаревших методов
Мобильное приложение	getSchedules
Номер телефона	getEndDate getStartDate
Цена	getEndDate getSchedules getStartDate
Дополнительная ссылка	Нет устаревших методов
Фрагмент	getEndDate getSchedules getStartDate

Обновление расширений объявлений

В рамках миграции некоторые поля больше не поддерживаются. Например, дата начала и дата окончания исключены из расширений фрагментов. Вызов setStartDate не повлияет на расширение объявления. Кроме того, будет зарегистрировано предупреждающее сообщение. См. следующую таблицу, чтобы понять, какие методы устарели:

Сорт	Устаревшие методы
Вызывать	Нет устаревших методов
Мобильное приложение	setSchedules
Номер телефона	clearEndDate clearStartDate setEndDate setStartDate
Цена	clearEndDate clearStartDate setEndDate setSchedules setStartDate
Дополнительная ссылка	Нет устаревших методов
Фрагмент	clearEndDate clearStartDate setEndDate setSchedules setStartDate

Создание расширений объявлений

Существующий набор конструкторов расширений объявлений (например, SitelinkBuilder способен создавать либо расширения объявлений на основе фидов, либо расширения объявлений на основе объектов. По умолчанию эти конструкторы будут создавать любой тип расширения объявлений, который в данный момент отображается. В следующей таблице приведены сводные данные. тип расширения объявления, которое показывается в данный момент (и, следовательно, будет создано по умолчанию):

Тип расширений объявлений в аккаунте
Только расширения объявлений на основе фидов	Расширения объявлений на основе фидов будут созданы по умолчанию.
Только расширения объявлений на основе объектов	Расширения объявлений на основе объектов будут созданы по умолчанию.
Расширения объявлений как на основе фидов, так и на основе объектов.	Расширения объявлений на основе объектов будут созданы по умолчанию.

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

Если вы хотите создать расширение на основе ленты, а не полагаться на поведение по умолчанию, вы можете сделать это, вызвав build(true) , а не build() , например:

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(true) means this will create a legacy phone number extension.
  .build(true)
  .getResult();

Если вы хотите создать расширение на основе активов и в настоящее время в вашей учетной записи есть только расширения на основе каналов, вы можете либо подождать до 28 марта, либо вызвать build(false) .

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(false) means this will create an asset-based phone number extension
  // even if the account currently only has feed-based extensions.
  .build(false)
  .getResult();

Неподдерживаемые поля

В рамках переноса расширений объявлений некоторые поля стали устаревшими. Например, дата начала и дата окончания исключены из расширений фрагментов. Вызовы withEndDate или withStartDate не окажут никакого влияния на расширение — вместо этого будет зарегистрировано предупреждающее сообщение. См. следующую таблицу, чтобы понять, какие методы устарели для каждого класса:

Сорт	Устаревшие методы
CalloutBuilder	withMobilePreferred
Разработчик мобильных приложений	withMobilePreferred withSchedules
ТелефонНомерСтроитель	withEndDate withMobilePreferred withStartDate
PriceBuilder	withEndDate withMobilePreferred withSchedules withStartDate
Конструктор дополнительных ссылок	withMobilePreferred
SnippetBuilder	withEndDate withMobilePreferred withSchedules withStartDate