鄰近區域
透過集合功能整理內容 你可以依據偏好儲存及分類內容。
為廣告活動新增鄰近目標區域
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(); }
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-21 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間: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,["Add a proximity target to a campaign \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```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```"]]