位置
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
針對某國家/地區指定廣告活動
function targetFrance(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();
// Target France (location id = 2250) and set a bid modifier of +50%. See
// https://developers.google.com/google-ads/api/reference/data/geotargets
// for details.
campaign.addLocation(2250, 1.5);
}
擷取廣告活動的目標地區清單
function getTargetedLocations(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().targetedLocations().get();
}
從廣告活動中移除目標地區
function untargetFrance(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();
// Remove targeting for France (location id = 2250). See
// https://developers.google.com/google-ads/api/reference/data/geotargets
// for details.
const targetedLocationIterator = AdsApp.targeting()
.targetedLocations()
.withIds([[campaign.getId(), 2250]]).get();
if (targetedLocationIterator.hasNext()) {
targetedLocationIterator.next().remove();
}
}
除非另有註明,否則本頁面中的內容是採用創用 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\u003eThese Google Ads scripts demonstrate how to target, retrieve, and remove location targeting for campaigns, specifically using France as an example with location ID 2250.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003etargetFrance\u003c/code\u003e applies a location target (France) and a bid modifier of +50% to a specified campaign.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetTargetedLocations\u003c/code\u003e returns a list of all locations targeted by a given campaign.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003euntargetFrance\u003c/code\u003e removes the location target for France from a specified campaign.\u003c/p\u003e\n"]]],[],null,["# Location\n\nTarget a campaign for a country\n-------------------------------\n\n```gdscript\nfunction targetFrance(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 // Target France (location id = 2250) and set a bid modifier of +50%. See\n // https://developers.google.com/google-ads/api/reference/data/geotargets\n // for details.\n campaign.addLocation(2250, 1.5);\n}\n```\n\nGet the list of locations targeted by a campaign\n------------------------------------------------\n\n```gdscript\nfunction getTargetedLocations(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().targetedLocations().get();\n}\n```\n\nRemove a targeted location from a campaign\n------------------------------------------\n\n```gdscript\nfunction untargetFrance(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 // Remove targeting for France (location id = 2250). See\n // https://developers.google.com/google-ads/api/reference/data/geotargets\n // for details.\n const targetedLocationIterator = AdsApp.targeting()\n .targetedLocations()\n .withIds([[campaign.getId(), 2250]]).get();\n if (targetedLocationIterator.hasNext()) {\n targetedLocationIterator.next().remove();\n }\n}\n```"]]