螢幕
透過集合功能整理內容 你可以依據偏好儲存及分類內容。
在現有廣告群組中加入刊登位置
function addPlacementToAdGroup(adGroupName, url, cpc) { const adGroups = AdsApp.adGroups() .withCondition(`ad_group.name = '${adGroupName}'`) .get(); if (!adGroups.hasNext()) { throw new Error(`No ad group with the name '${adGroupName}' was found.`); } const adGroup = adGroups.next(); if (adGroups.totalNumEntities() > 1) { console.warn(`Found ${adGroups.totalNumEntities()} ad groups with the ` + `name '${adGroupName}'. Adding placement to the ad group in campaign ` + `'${adGroup.getCampaign().getName()}'.`); } // Other display criteria can be built in a similar manner using the // corresponding builder method in the AdsApp.CampaignDisplay or // AdsApp.AdGroupDisplay class. const placementBuilder = adGroup.display() .newPlacementBuilder() .withUrl(url); // required if (cpc) { placementBuilder.withCpc(cpc); // optional } const operation = placementBuilder.build(); if (operation.getStatus() == 'SUCCESS') { const placement = operation.getResult(); console.log(`Placement with id = ${placement.getId()} and url = ${placement.getUrl()} was created.`); } else { console.warn(`Failed to create placement. Errors = ${operation.getErrors().join(', ')}`); } } 擷取現有廣告群組中的所有主題
function getAllTopics(campaignName, adGroupName) { return AdsApp.display() .topics() .withCondition(`campaign.name = '${campaignName}'`) .withCondition(`ad_group.name = '${adGroupName}'`); } 記錄現有廣告群組中所有目標對象的統計資料
function logAudienceStats(campaignName, adGroupName, dateRange = 'LAST_MONTH') { // Other display criteria can be retrieved in a similar manner using // the corresponding selector methods in the AdsApp.Display, // AdsApp.CampaignDisplay or AdsApp.AdGroupDisplay class. const audienceIterator = AdsApp.display() .audiences() .withCondition(`campaign.name = '${campaignName}'`) .withCondition(`ad_group.name = '${adGroupName}'`) .get(); console.log('ID, Audience ID, Clicks, Impressions, Cost'); for (const audience of audienceIterator) { const stats = audience.getStatsFor(dateRange); // User List IDs (List IDs) are available on the details page of // a User List (found under the Audiences section of the Shared // Library) console.log(`${audience.getId().toFixed(0)}, ${audience.getAudienceId()}, ` + `${stats.getClicks()}, ${stats.getImpressions()}, ${stats.getCost()}`); } } 除非另有註明，否則本頁面中的內容是採用創用 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\u003eThe provided code snippets demonstrate how to manage display targeting in Google Ads using scripts.\u003c/p\u003e\n"],["\u003cp\u003eIt includes functionalities to add placements to ad groups, specifying URLs and optional CPC bids.\u003c/p\u003e\n"],["\u003cp\u003eAdditionally, it showcases retrieving topics and audience performance statistics within specific ad groups and campaigns.\u003c/p\u003e\n"],["\u003cp\u003eExample functions cover topics such as adding placements, retrieving topics by campaign/ad group, and logging audience stats with customizable date ranges.\u003c/p\u003e\n"]]],[],null,["Add a placement to an existing ad group \n\n```gdscript\nfunction addPlacementToAdGroup(adGroupName, url, cpc) {\n const adGroups = AdsApp.adGroups()\n .withCondition(`ad_group.name = '${adGroupName}'`)\n .get();\n if (!adGroups.hasNext()) {\n throw new Error(`No ad group with the name '${adGroupName}' was found.`);\n }\n const adGroup = adGroups.next();\n if (adGroups.totalNumEntities() \u003e 1) {\n console.warn(`Found ${adGroups.totalNumEntities()} ad groups with the ` +\n `name '${adGroupName}'. Adding placement to the ad group in campaign ` +\n `'${adGroup.getCampaign().getName()}'.`);\n }\n\n // Other display criteria can be built in a similar manner using the\n // corresponding builder method in the AdsApp.CampaignDisplay or\n // AdsApp.AdGroupDisplay class.\n const placementBuilder = adGroup.display()\n .newPlacementBuilder()\n .withUrl(url); // required\n if (cpc) {\n placementBuilder.withCpc(cpc); // optional\n }\n const operation = placementBuilder.build();\n if (operation.getStatus() == 'SUCCESS') {\n const placement = operation.getResult();\n console.log(`Placement with id = ${placement.getId()} and url = ${placement.getUrl()} was created.`);\n } else {\n console.warn(`Failed to create placement. Errors = ${operation.getErrors().join(', ')}`);\n }\n}\n```\n\nRetrieve all topics in an existing ad group \n\n```genshi\nfunction getAllTopics(campaignName, adGroupName) {\n return AdsApp.display()\n .topics()\n .withCondition(`campaign.name = '${campaignName}'`)\n .withCondition(`ad_group.name = '${adGroupName}'`);\n}\n```\n\nLog stats for all audiences in an existing ad group \n\n```gdscript\nfunction logAudienceStats(campaignName, adGroupName, dateRange = 'LAST_MONTH') {\n // Other display criteria can be retrieved in a similar manner using\n // the corresponding selector methods in the AdsApp.Display,\n // AdsApp.CampaignDisplay or AdsApp.AdGroupDisplay class.\n const audienceIterator = AdsApp.display()\n .audiences()\n .withCondition(`campaign.name = '${campaignName}'`)\n .withCondition(`ad_group.name = '${adGroupName}'`)\n .get();\n\n console.log('ID, Audience ID, Clicks, Impressions, Cost');\n\n for (const audience of audienceIterator) {\n const stats = audience.getStatsFor(dateRange);\n\n // User List IDs (List IDs) are available on the details page of\n // a User List (found under the Audiences section of the Shared\n // Library)\n console.log(`${audience.getId().toFixed(0)}, ${audience.getAudienceId()}, `\n + `${stats.getClicks()}, ${stats.getImpressions()}, ${stats.getCost()}`);\n }\n}\n```"]]
