出價
透過集合功能整理內容 你可以依據偏好儲存及分類內容。
取得出價策略
function getBiddingStrategies() { const bidStrategyIterator = AdsApp.biddingStrategies().get(); return bidStrategyIterator; }
按名稱取得出價策略
function getBiddingStrategyIteratorByName(biddingStrategyName) { const biddingStrategiesIterator = AdsApp.biddingStrategies() .withCondition(`bidding_strategy.name = '${biddingStrategyName}'`) .get(); return biddingStrategiesIterator; }
設定廣告活動出價策略
function setVariousBiddingStrategies() { // This example snippet assumes the user has a campaign named "Online Sales". const campaignName = 'Online Sales'; const campaignIterator = AdsApp.campaigns() .withCondition(`campaign.name = '${campaignName}'`) .get(); if (!campaignIterator.hasNext()) { throw new Error(`No Campaign found with name "${campaignName}"`); } if (campaignIterator.totalNumEntities() > 1) { console.warn( `Found ${campaignIterator.totalNumEntities()} Campaigns with name "${ campaignName}", using just one of them`); } const campaign = campaignIterator.next(); // Set the campaign's bidding strategy to Manual CPC. campaign.bidding().setStrategy('MANUAL_CPC'); // By default, the Manual CPC strategy enables Enhanced CPC bidding. The user // can disable ECPC when setting the strategy by providing an extra argument. campaign.bidding().setStrategy('MANUAL_CPC', {enhancedCpcEnabled: false}); // Some standard bidding strategies, such as Target Return on Ad Spend, // require additional arguments when setting the strategy. Setting the // strategy to Target Return on Ad Spend without providing the required // additional arguments will fail. campaign.bidding().setStrategy('TARGET_ROAS', {targetRoas: 1.3}); // Extra arguments can also be specified through the BiddingStrategyArgsBuilder. const args = campaign.bidding.argsBuilder().withTargetRoas(1.3).withCpcBidCeiling(2.5); campaign.bidding().setStrategy('TARGET_ROAS', args); // If the user has defined a flexible bidding strategy for the campaign, then // this is also valid for `setStrategy`. For this example, assume the user // has a flexible bidding strategy named "My Shared Bidding Strategy". const strategyName = 'My Shared Bidding Strategy'; const strategy = AdsApp.biddingStrategies() .withCondition(`bidding_strategy.name = '${strategyName}'`) .get() .next(); campaign.bidding().setStrategy(strategy); }
設定廣告群組預設單次點擊出價
function setAdGroupDefaultCpcBid(campaignName, adGroupName){ const adGroup = AdsApp.adGroups() .withCondition(`campaign.name = '${campaignName}'`) .withCondition(`ad_group.name = '${adGroupName}'`) .get() .next(); // This bid will only be used for auction if a corresponding cpc // bidding strategy is set to the ad group. E.g. // // adGroup.bidding().setStrategy('MANUAL_CPC'); adGroup.bidding().setCpc(3.0); }
設定關鍵字單次點擊出價
function setKeywordCpcBid(campaignName, adGroupName, keywordText, keywordMaxCpcBid) { const keyword = AdsApp.keywords() .withCondition(`campaign.name = '${campaignName}'`) .withCondition(`ad_group.name = '${adGroupName}'`) .withCondition(`ad_group_criterion.keyword.text = '${keywordText}'`) .get() .next(); // This bid will only be used for auction if a corresponding cpc // bidding strategy is set to the parent ad group. E.g. // // adGroup.bidding().setStrategy('MANUAL_CPC'); keyword.bidding().setCpc(keywordMaxCpcBid); }
除非另有註明,否則本頁面中的內容是採用創用 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 manage bidding strategies programmatically, including retrieving, setting, and applying them to campaigns, ad groups, and keywords.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve existing bidding strategies and filter them by name to use or modify within your scripts.\u003c/p\u003e\n"],["\u003cp\u003eThe scripts provide examples of setting various bidding strategies for campaigns, like Manual CPC, Target ROAS, and Enhanced CPC, while demonstrating the use of required arguments and bidding strategy builders.\u003c/p\u003e\n"],["\u003cp\u003eIncluded are examples of how to programmatically set default CPC bids for ad groups and specific CPC bids for keywords, empowering granular bid control within your Google Ads campaigns.\u003c/p\u003e\n"],["\u003cp\u003eEnsure the corresponding CPC bidding strategy is set at the ad group level for keyword and ad group CPC bids to be used in auctions.\u003c/p\u003e\n"]]],[],null,["Get bidding strategies \n\n```gdscript\nfunction getBiddingStrategies() {\n const bidStrategyIterator = AdsApp.biddingStrategies().get();\n return bidStrategyIterator;\n}\n```\n\nGet bidding strategies by name \n\n```gdscript\nfunction getBiddingStrategyIteratorByName(biddingStrategyName) {\n const biddingStrategiesIterator = AdsApp.biddingStrategies()\n .withCondition(`bidding_strategy.name = '${biddingStrategyName}'`)\n .get();\n return biddingStrategiesIterator;\n}\n```\n\nSet campaign bidding strategy \n\n```mysql\nfunction setVariousBiddingStrategies() {\n // This example snippet assumes the user has a campaign named \"Online Sales\".\n const campaignName = 'Online Sales';\n const campaignIterator =\n AdsApp.campaigns()\n .withCondition(`campaign.name = '${campaignName}'`)\n .get();\n\n if (!campaignIterator.hasNext()) {\n throw new Error(`No Campaign found with name \"${campaignName}\"`);\n }\n\n if (campaignIterator.totalNumEntities() \u003e 1) {\n console.warn(\n `Found ${campaignIterator.totalNumEntities()} Campaigns with name \"${\n campaignName}\", using just one of them`);\n }\n\n const campaign = campaignIterator.next();\n\n // Set the campaign's bidding strategy to Manual CPC.\n campaign.bidding().setStrategy('MANUAL_CPC');\n\n // By default, the Manual CPC strategy enables Enhanced CPC bidding. The user\n // can disable ECPC when setting the strategy by providing an extra argument.\n campaign.bidding().setStrategy('MANUAL_CPC', {enhancedCpcEnabled: false});\n\n // Some standard bidding strategies, such as Target Return on Ad Spend,\n // require additional arguments when setting the strategy. Setting the\n // strategy to Target Return on Ad Spend without providing the required\n // additional arguments will fail.\n campaign.bidding().setStrategy('TARGET_ROAS', {targetRoas: 1.3});\n\n // Extra arguments can also be specified through the BiddingStrategyArgsBuilder.\n const args =\n campaign.bidding.argsBuilder().withTargetRoas(1.3).withCpcBidCeiling(2.5);\n campaign.bidding().setStrategy('TARGET_ROAS', args);\n\n // If the user has defined a flexible bidding strategy for the campaign, then\n // this is also valid for `setStrategy`. For this example, assume the user\n // has a flexible bidding strategy named \"My Shared Bidding Strategy\".\n const strategyName = 'My Shared Bidding Strategy';\n const strategy =\n AdsApp.biddingStrategies()\n .withCondition(`bidding_strategy.name = '${strategyName}'`)\n .get()\n .next();\n campaign.bidding().setStrategy(strategy);\n}\n```\n\nSet an ad group's default CPC bid \n\n```gdscript\nfunction setAdGroupDefaultCpcBid(campaignName, adGroupName){\n const adGroup = AdsApp.adGroups()\n .withCondition(`campaign.name = '${campaignName}'`)\n .withCondition(`ad_group.name = '${adGroupName}'`)\n .get()\n .next();\n\n // This bid will only be used for auction if a corresponding cpc\n // bidding strategy is set to the ad group. E.g.\n //\n // adGroup.bidding().setStrategy('MANUAL_CPC');\n adGroup.bidding().setCpc(3.0);\n}\n```\n\nSet a keyword's CPC bid \n\n```gdscript\nfunction setKeywordCpcBid(campaignName, adGroupName, keywordText, keywordMaxCpcBid) {\n const keyword = AdsApp.keywords()\n .withCondition(`campaign.name = '${campaignName}'`)\n .withCondition(`ad_group.name = '${adGroupName}'`)\n .withCondition(`ad_group_criterion.keyword.text = '${keywordText}'`)\n .get()\n .next();\n\n // This bid will only be used for auction if a corresponding cpc\n // bidding strategy is set to the parent ad group. E.g.\n //\n // adGroup.bidding().setStrategy('MANUAL_CPC');\n keyword.bidding().setCpc(keywordMaxCpcBid);\n}\n```"]]