نزدیکی
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
هدف نزدیکی را به کمپین اضافه کنید
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();
}
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-21 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 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```"]]