Торги
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Получить стратегии назначения ставок
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);
}
Установите ставку CPC по умолчанию для группы объявлений.
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);
}
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-21 UTC.
[null,null,["Последнее обновление: 2025-08-21 UTC."],[[["\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,["# Bidding\n\nGet bidding strategies\n----------------------\n\n```gdscript\nfunction getBiddingStrategies() {\n const bidStrategyIterator = AdsApp.biddingStrategies().get();\n return bidStrategyIterator;\n}\n```\n\nGet bidding strategies by name\n------------------------------\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\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\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\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```"]]