借助 Google Ads 脚本,您可以在帐号中使用广告系列级定位设置。支持的定位条件包括广告投放时间、指定和排除的地理位置、指定邻近区域和平台等。本指南介绍了如何使用广告系列定位条件。
广告投放时间
通过广告投放时间,您可以控制何时投放广告。
检索
您可以使用广告系列定位条件的 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);
创建
如需创建新的广告投放时间,您可以使用 Campaign
的 addAdSchedule
方法。下面这段代码为广告系列创建自定义的广告投放时间,即帐号所在时区每周六上午 7 点到 11 点,出价调节系数为 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 Ads 脚本为广告系列定位或排除地理位置。
检索
您可以使用广告系列定位条件的 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 地理位置定位文档,查看在添加地理位置定位时使用的 ID 列表。如需跟踪地理位置定位目标的效果,您可以搜索 location_view
报告资源。
移除
您可以使用 remove
方法移除地理位置定位目标。
邻近区域
您可以使用 Google Ads 脚本将广告系列定位到某个地理位置周围一定半径内的区域(邻近区域)。
检索
您可以使用广告系列的定位条件上的 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
方法为其创建邻近区域定位目标。以下代码段将广告系列定位到坐标 (37.423021, -122.083739) 周围 20 公里处。
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 Ads 广告系列定位到所有平台(桌面设备、移动设备和平板电脑),因此您不能添加或移除 Platform
条件。此定位条件最常见的用途是设置广告系列的设备出价调整:
campaign.targeting()
.platforms()
.mobile()
.get()
.next().
setBidModifier(1.2);
平台 ID 在广告系列之间共享,有预先定义的值,详见 Google Ads API 平台附录。在解析报告时,这些 ID 会很有用。直接选择条件时,您可以使用 PlatformSelector
提供的辅助方法。