Campagne
Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.
Recupera campagne
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; }
Ottieni una campagna per nome
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); }
Ottieni le statistiche di una campagna
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`); } }
Metti in pausa una campagna
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`); } }
Ottieni i modificatori di offerta per dispositivo di una campagna
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`); } }
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-21 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-08-21 UTC."],[[["\u003cp\u003eThe provided code snippets demonstrate how to interact with Google Ads campaigns programmatically using Google Ads Scripts.\u003c/p\u003e\n"],["\u003cp\u003eFunctionality includes retrieving all campaigns, getting a specific campaign by name, and accessing campaign statistics.\u003c/p\u003e\n"],["\u003cp\u003eYou can also pause campaigns and retrieve device bid modifiers for specific campaigns using the provided functions.\u003c/p\u003e\n"],["\u003cp\u003eEach function utilizes the \u003ccode\u003eAdsApp.campaigns()\u003c/code\u003e method to access and manipulate campaign data within your Google Ads account.\u003c/p\u003e\n"],["\u003cp\u003eError handling is implemented to ensure smooth execution and inform users when a specified campaign is not found.\u003c/p\u003e\n"]]],[],null,["# Campaigns\n\nGet campaigns\n-------------\n\n```gdscript\nfunction getCampaigns() {\n // AdsApp.campaigns() will return all Display and Search campaigns\n // that are not removed by default. Other campaign types can be retrieved\n // by using their respective campaign selector methods.\n const campaignIterator = AdsApp.campaigns().get();\n console.log(`Total campaigns found : ${campaignIterator.totalNumEntities()}`);\n return campaignIterator;\n}\n```\n\nGet a campaign by name\n----------------------\n\n```gdscript\nfunction getCampaignByName(name) {\n const campaignIterator = AdsApp.campaigns()\n .withCondition(`campaign.name = \"${name}\"`)\n .get();\n if (campaignIterator.hasNext()) {\n const campaign = campaignIterator.next();\n console.log(`Campaign Name: ${campaign.getName()}`);\n console.log(`Enabled: ${campaign.isEnabled()}`);\n console.log(`Bidding strategy: ${campaign.getBiddingStrategyType()}`);\n console.log(`Ad rotation: ${campaign.getAdRotationType()}`);\n console.log(`Start date: ${formatDate(campaign.getStartDate())}`);\n console.log(`End date: ${formatDate(campaign.getEndDate())}`);\n return campaign;\n } else {\n throw new Error(`No campaign named \"${name}\" found`);\n }\n}\nfunction formatDate(date) {\n function zeroPad(number) { return Utilities.formatString('%02d', number); }\n return (date == null) ? 'None' : zeroPad(date.year) + zeroPad(date.month) +\n zeroPad(date.day);\n}\n```\n\nGet a campaign's stats\n----------------------\n\n```gdscript\nfunction getCampaignStats(name) {\n const campaignIterator = AdsApp.campaigns()\n .withCondition(`campaign.name = \"${name}\"`)\n .get();\n if (campaignIterator.hasNext()) {\n const campaign = campaignIterator.next();\n // You can also request reports for pre-defined date ranges. See\n // https://developers.google.com/google-ads/scripts/docs/reference/adsapp/adsapp_campaign#getStatsFor_1,\n // DateRangeLiteral section for possible values.\n const stats = campaign.getStatsFor('LAST_MONTH');\n console.log(`${campaign.getName()}: ${stats.getClicks()} clicks, ${stats.getImpressions()} impressions`);\n return stats;\n } else {\n throw new Error(`No campaign named \"${name}\" found`);\n }\n}\n```\n\nPause a campaign\n----------------\n\n```gdscript\nfunction pauseCampaign(name) {\n const campaignIterator = AdsApp.campaigns()\n .withCondition(`campaign.name = \"${name}\"`)\n .get();\n if (campaignIterator.hasNext()) {\n const campaign = campaignIterator.next();\n campaign.pause();\n } else {\n throw new Error(`No campaign named \"${name}\" found`);\n }\n}\n```\n\nGet a campaign's device bid modifiers\n-------------------------------------\n\n```gdscript\nfunction getCampaignBidModifiers(name) {\n const campaignIterator = AdsApp.campaigns()\n .withCondition(`campaign.name = \"${name}\"`)\n .get();\n if (campaignIterator.hasNext()) {\n const campaign = campaignIterator.next();\n console.log('Campaign name: ' + campaign.getName());\n\n const platforms = {};\n for (const platform of campaign.targeting().platforms()) {\n console.log(`${platform.getName()} bid modifier: ${platform.getBidModifier()}`);\n platforms[platform.getName()] = platform.getBidModifier();\n }\n return platforms;\n } else {\n throw new Error(`No campaign named \"${name}\" found`);\n }\n}\n```"]]