廣告活動
透過集合功能整理內容 你可以依據偏好儲存及分類內容。
取得廣告活動
function getCampaigns() { // AdsApp.campaigns() will return all Display and Search campaigns // that are not removed by default. Other campaign types can be retrieved // by using their respective campaign selector methods. const campaignIterator = AdsApp.campaigns().get(); console.log(`Total campaigns found : ${campaignIterator.totalNumEntities()}`); return campaignIterator; }
依名稱擷取廣告活動
function getCampaignByName(name) { const campaignIterator = AdsApp.campaigns() .withCondition(`campaign.name = "${name}"`) .get(); if (campaignIterator.hasNext()) { const campaign = campaignIterator.next(); console.log(`Campaign Name: ${campaign.getName()}`); console.log(`Enabled: ${campaign.isEnabled()}`); console.log(`Bidding strategy: ${campaign.getBiddingStrategyType()}`); console.log(`Ad rotation: ${campaign.getAdRotationType()}`); console.log(`Start date: ${formatDate(campaign.getStartDate())}`); console.log(`End date: ${formatDate(campaign.getEndDate())}`); return campaign; } else { throw new Error(`No campaign named "${name}" found`); } } function formatDate(date) { function zeroPad(number) { return Utilities.formatString('%02d', number); } return (date == null) ? 'None' : zeroPad(date.year) + zeroPad(date.month) + zeroPad(date.day); }
擷取廣告活動統計資料
function getCampaignStats(name) { const campaignIterator = AdsApp.campaigns() .withCondition(`campaign.name = "${name}"`) .get(); if (campaignIterator.hasNext()) { const campaign = campaignIterator.next(); // You can also request reports for pre-defined date ranges. See // https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_campaign#getStatsFor_1, // DateRangeLiteral section for possible values. const stats = campaign.getStatsFor('LAST_MONTH'); console.log(`${campaign.getName()}: ${stats.getClicks()} clicks, ${stats.getImpressions()} impressions`); return stats; } else { throw new Error(`No campaign named "${name}" found`); } }
暫停廣告活動
function pauseCampaign(name) { const campaignIterator = AdsApp.campaigns() .withCondition(`campaign.name = "${name}"`) .get(); if (campaignIterator.hasNext()) { const campaign = campaignIterator.next(); campaign.pause(); } else { throw new Error(`No campaign named "${name}" found`); } }
取得廣告活動的裝置出價調節係數
function getCampaignBidModifiers(name) { const campaignIterator = AdsApp.campaigns() .withCondition(`campaign.name = "${name}"`) .get(); if (campaignIterator.hasNext()) { const campaign = campaignIterator.next(); console.log('Campaign name: ' + campaign.getName()); const platforms = {}; for (const platform of campaign.targeting().platforms()) { console.log(`${platform.getName()} bid modifier: ${platform.getBidModifier()}`); platforms[platform.getName()] = platform.getBidModifier(); } return platforms; } else { throw new Error(`No campaign named "${name}" found`); } }
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-28 (世界標準時間)。
[[["容易理解","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-07-28 (世界標準時間)。"],[[["The provided code snippets demonstrate how to interact with Google Ads campaigns programmatically using Google Ads Scripts."],["Functionality includes retrieving all campaigns, getting a specific campaign by name, and accessing campaign statistics."],["You can also pause campaigns and retrieve device bid modifiers for specific campaigns using the provided functions."],["Each function utilizes the `AdsApp.campaigns()` method to access and manipulate campaign data within your Google Ads account."],["Error handling is implemented to ensure smooth execution and inform users when a specified campaign is not found."]]],[]]