인접
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
캠페인에 인접 타겟팅 추가
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 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-21(UTC)
[null,null,["최종 업데이트: 2025-08-21(UTC)"],[[["\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```"]]