近程
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
向广告系列添加邻近区域定位目标
function addProximityTargets(campaignName) {
const campaignIterator = AdsApp.campaigns()
.withCondition(`campaign.name = "${campaignName}"`)
.get();
if (!campaignIterator.hasNext()) {
throw new Error(`No campaign with name "${campaignName}" found`);
}
const campaign = campaignIterator.next();
// Add a proximity target of 20 kilometers around Google New York office.
// To obtain coordinates of a given point on Google Maps,
// see https://support.google.com/maps/answer/18539
campaign.addProximity(40.741144, -74.002086, 20, 'KILOMETERS');
// You could also add proximity by an address. However, we don't validate
// if the address you put matches the given latitude and longitude. It has
// no functionality except to change what shows up in the Campaign
// Management interface.
// Add a proximity target of 10 kilometers around Google Mountain View
// office.
campaign.addProximity({
latitude: 37.423021,
longitude: -122.083739,
radius: 10,
radiusUnits: 'KILOMETERS',
bidModifier: 0.75,
address: {
streetAddress: '1600 Amphitheatre Parkway',
cityName: 'Mountain View',
provinceName: 'California',
provinceCode: 'CA',
postalCode: '94043',
countryCode: 'US'
}
});
}
获取广告系列的所有邻近区域定位目标的列表
function getTargetedProximities(campaignName) {
const campaignIterator = AdsApp.campaigns()
.withCondition(`campaign.name = "${campaignName}"`)
.get();
if (!campaignIterator.hasNext()) {
throw new Error(`No campaign with name "${campaignName}" found`);
}
const campaign = campaignIterator.next();
return campaign.targeting().targetedProximities().get();
}
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-21。
[null,null,["最后更新时间 (UTC):2025-08-21。"],[[["\u003cp\u003eThis script provides functions to add and retrieve proximity targets for Google Ads campaigns.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eaddProximityTargets\u003c/code\u003e enables adding location-based targeting by specifying coordinates, radius, and optionally an address for display purposes.\u003c/p\u003e\n"],["\u003cp\u003eYou can target a specific radius around a point using latitude, longitude, and radius with units (e.g., kilometers).\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetTargetedProximities\u003c/code\u003e retrieves all existing proximity targets associated with a given campaign.\u003c/p\u003e\n"]]],[],null,["# Proximity\n\nAdd a proximity target to a campaign\n------------------------------------\n\n```gdscript\nfunction addProximityTargets(campaignName) {\n const campaignIterator = AdsApp.campaigns()\n .withCondition(`campaign.name = \"${campaignName}\"`)\n .get();\n if (!campaignIterator.hasNext()) {\n throw new Error(`No campaign with name \"${campaignName}\" found`);\n }\n\n const campaign = campaignIterator.next();\n\n // Add a proximity target of 20 kilometers around Google New York office.\n // To obtain coordinates of a given point on Google Maps,\n // see https://support.google.com/maps/answer/18539\n campaign.addProximity(40.741144, -74.002086, 20, 'KILOMETERS');\n\n // You could also add proximity by an address. However, we don't validate\n // if the address you put matches the given latitude and longitude. It has\n // no functionality except to change what shows up in the Campaign\n // Management interface.\n\n // Add a proximity target of 10 kilometers around Google Mountain View\n // office.\n campaign.addProximity({\n latitude: 37.423021,\n longitude: -122.083739,\n radius: 10,\n radiusUnits: 'KILOMETERS',\n bidModifier: 0.75,\n address: {\n streetAddress: '1600 Amphitheatre Parkway',\n cityName: 'Mountain View',\n provinceName: 'California',\n provinceCode: 'CA',\n postalCode: '94043',\n countryCode: 'US'\n }\n });\n}\n```\n\nGet the list of all proximity targets for a campaign\n----------------------------------------------------\n\n```gdscript\nfunction getTargetedProximities(campaignName) {\n const campaignIterator = AdsApp.campaigns()\n .withCondition(`campaign.name = \"${campaignName}\"`)\n .get();\n if (!campaignIterator.hasNext()) {\n throw new Error(`No campaign with name \"${campaignName}\" found`);\n }\n\n const campaign = campaignIterator.next();\n return campaign.targeting().targetedProximities().get();\n}\n```"]]