Скрипты Google Рекламы позволяют работать с настройками таргетинга на уровне кампании в ваших аккаунтах. Поддерживаются расписания показа объявлений, целевые и исключенные местоположения, целевые радиусы и платформы. В этом руководстве рассказывается, как работать с целями кампаний.
Расписания показа объявлений
Расписание показа объявлений позволяет контролировать, когда будет показываться ваша реклама.
Получить
Получить расписание показа объявлений в кампании можно с помощью метода adSchedules для целей кампании.
В приведенном ниже фрагменте кода показано, как получить список всех критериев AdSchedule для кампании.
const campaign = AdsApp.campaigns()
.withCondition("campaign.name = 'My campaign'")
.get()
.next();
const adSchedules = campaign.targeting().adSchedules().get();
for (const adSchedule of adSchedules) {
// Process your ad schedule.
...
}
По умолчанию кампания показывается постоянно, поэтому вы не получите расписания показа объявлений, если не настроили его для своей кампании.
Обновить
Получив расписание показа объявлений, вы можете изменить его свойства напрямую. Например, вы можете изменить модификатор ставок в расписании показа объявлений следующим образом:
adSchedule.setBidModifier(1.1);
Создать
Чтобы создать новое расписание показа объявлений, используйте метод addAdSchedule класса Campaign.
Приведенный ниже фрагмент кода создает для кампании специальное планирование показа объявлений по субботам с 7:00 до 11:00 по часовому поясу аккаунта с модификатором ставок 1,1.
campaign.addAdSchedule({
dayOfWeek: "SATURDAY",
startHour: 7,
startMinute: 0,
endHour: 11,
endMinute: 0,
bidModifier: 1.1
});
Дополнительную информацию о допустимых значениях для каждого параметра, а также о дополнительных ограничениях, которые следует учитывать при создании расписаний показа объявлений, можно найти в нашей документации.
Удалить
Удалить расписание показа объявлений можно с помощью метода remove. Чтобы сбросить планирование показа объявлений в кампании, удалите все расписания, выполнив следующие действия:
const adSchedules = campaign.adSchedules().get();
for (const adSchedule of adSchedules) {
adSchedule.remove();
}
Местоположения
С помощью скриптов Google Рекламы можно также настраивать таргетинг на местоположения или исключать их.
Получить
Получить список целевых местоположений можно с помощью метода targetedLocations, который применяется к целям кампании.
Исключенные местоположения можно получить с помощью метода excludedLocations. Следующий фрагмент кода выбирает все целевые местоположения, которые получили более 100 показов за последний месяц.
const locations = AdsApp.targeting()
.targetedLocations()
.withCondition("metrics.impressions > 100")
.forDateRange("LAST_MONTH")
.orderBy("metrics.clicks DESC")
.get();
for (const location of locations) {
// Process the campaign target here.
...
}
Если в настройках кампании указаны все страны и регионы, список местоположений будет пустым.
Обновить
Получив адрес, вы можете изменить его свойства. Например, вы можете изменить модификатор ставок для местоположения следующим образом:
location.setBidModifier(1.1);
Создать
Вы можете создать целевые местоположения в кампании с помощью метода addLocation. Аналогичным образом можно исключить местоположение с помощью метода excludeLocation. В следующем фрагменте кода настраивается таргетинг кампании на США с модификатором ставок 1, 15 и исключением Нью-Йорка.
campaign.addLocation(2840, 1.15); // United States
campaign.excludeLocation(1023191); // New York city
Список идентификаторов, которые можно использовать при добавлении геотаргетинга, приведен в документации по геотаргетингу в Google Ads API. Чтобы отслеживать эффективность целевых местоположений, вы можете выполнять поиск по ресурсу location_view Report.
Удалить
Удалить целевое местоположение можно с помощью метода remove.
Прилегающие области
С помощью скриптов Google Рекламы можно осуществлять таргетинг кампании на определенный радиус (близость) вокруг местоположения.
Получить
Чтобы получить список целевых местоположений, используйте метод targetedProximities для целей кампании.
В следующем фрагменте кода выбираются все целевые местоположения, которые получили более 100 показов за последний месяц.
const proximities = AdsApp.targeting()
.targetedProximities()
.withCondition("metrics.impressions > 100")
.forDateRange("LAST_MONTH")
.orderBy("metrics.clicks DESC")
.get();
for (const proximity of proximities) {
...
}
Создать
Чтобы создать цель по расстоянию для кампании, используйте метод addProximity. В следующем фрагменте кода показано, как настроить таргетинг кампании на область в радиусе 20 км от точки с координатами 37.423021, -122.083739.
campaign.addProximity(37.423021, -122.083739, 20, "KILOMETERS");
Этот же метод можно использовать для создания целевой области в радиусе с модификатором ставок и адресом:
campaign.addProximity(37.423021, -122.083739, 20, "KILOMETERS", {
bidModifier: 1.15,
address: {
streetAddress: "1600 Amphitheatre Parkway",
cityName: "Mountain View",
provinceName: "California",
provinceCode: "CA",
postalCode: "94043",
countryCode: "US"
}
});
Обратите внимание, что система не проверяет, действительно ли адрес соответствует указанным координатам. Этот адрес используется только для того, чтобы изменить информацию, которая показывается в интерфейсе управления кампаниями.
Удалить
Чтобы удалить цель в радиусе, используйте метод remove.
Платформы
Чтобы получить список платформ, на которые настроен таргетинг кампании, используйте метод platforms для целей кампании.
Поскольку кампании Google Рекламы нацелены на все платформы (компьютеры, мобильные устройства и планшеты), вы не можете добавлять или удалять критерий Platform. Чаще всего этот критерий таргетинга используется для настройки корректировки ставок для устройств в кампании.
campaign.targeting()
.platforms()
.mobile()
.get()
.next().
setBidModifier(1.2);
Идентификаторы платформ являются общими для всех кампаний и имеют предопределенные значения, указанные в приложении к Google Ads API.
Эти идентификаторы могут быть полезны при анализе отчетов. При выборе критериев напрямую можно использовать вспомогательные методы, предоставляемые PlatformSelector.