همه کمپینهای حداکثر عملکرد را بازیابی کنید
function getAllPerformanceMaxCampaigns() { // AdsApp.performanceMaxCampaigns() will return all campaigns that are not // removed by default. const performanceMaxCampaignIterator = AdsApp.performanceMaxCampaigns().get(); console.log(`Total campaigns found : ${performanceMaxCampaignIterator.totalNumEntities()}`); return performanceMaxCampaignIterator; }
یک کمپین حداکثر عملکرد را با نام آن بازیابی کنید
function getPerformanceMaxCampaignByName(campaignName) { const performanceMaxCampaignIterator = AdsApp.performanceMaxCampaigns() .withCondition(`campaign.name = "${campaignName}"`) .get(); if (!performanceMaxCampaignIterator.hasNext()) { throw new Error(`No performance max campaign with name ${campaignName} found.`); } const performanceMaxCampaign = performanceMaxCampaignIterator.next(); console.log(`Campaign Name: ${performanceMaxCampaign.getName()}`); console.log(`Enabled: ${performanceMaxCampaign.isEnabled()}`); console.log(`Bidding strategy: ${performanceMaxCampaign.getBiddingStrategyType()}`); console.log(`Ad rotation: ${performanceMaxCampaign.getAdRotationType()}`); console.log(`Start date: ${formatDate(performanceMaxCampaign.getStartDate())}`); console.log(`End date: ${formatDate(performanceMaxCampaign.getEndDate())}`); return performanceMaxCampaign; } 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 getPerformanceMaxCampaignStats(campaignName) { const performanceMaxCampaignIterator = AdsApp.performanceMaxCampaigns() .withCondition(`campaign.name = "${campaignName}"`) .get(); if (!performanceMaxCampaignIterator.hasNext()) { throw new Error(`No performance max campaign with name ${campaignName} found.`); } const performanceMaxCampaign = performanceMaxCampaignIterator.next(); // Fetch stats for the last month. See the DateRangeLiteral section at // https://developers.google.com/adwords/api/docs/guides/awql#formal_grammar // for a list of all supported pre-defined date ranges. // Note: Reports can also be used to fetch stats. See // https://developers.google.com/google-ads/scripts/docs/features/reports // for more information. var stats = performanceMaxCampaign.getStatsFor('LAST_MONTH'); console.log(`${performanceMaxCampaign.getName()}, ${stats.getImpressions()} impressions, ` + `${stats.getViews()} views`); return stats; }
توقف کمپین حداکثر عملکرد
function pausePerformanceMaxCampaign(campaignName) { const performanceMaxCampaignIterator = AdsApp.performanceMaxCampaigns() .withCondition(`campaign.name = "${campaignName}"`) .get(); if (performanceMaxCampaignIterator.hasNext()) { const performanceMaxCampaign = performanceMaxCampaignIterator.next(); performanceMaxCampaign.pause(); } }
یک گروه دارایی را با نام آن بازیابی کنید
function getAssetGroupByName(campaignName, assetGroupName) { // Defined above const performanceMaxCampaign = getPerformanceMaxCampaignByName(campaignName); if (performanceMaxCampaign == null) { return null; } const assetGroupIterator = performanceMaxCampaign.assetGroups() .withCondition(`asset_group.name = "${assetGroupName}"`) .get(); if (!assetGroupIterator.hasNext()) { throw new Error(`No asset group found with name ${assetGroupName}.`); } return assetGroupIterator.next(); }
یک گروه دارایی را متوقف کنید
function pausePerformanceMaxAssetGroup(campaignName, assetGroupName) { // Defined above const assetGroup = getAssetGroupByName(campaignName, assetGroupName); assetGroup.pause(); console.log(`AssetGroup with name: ${assetGroup.getName()} ` + `has paused status: ${assetGroup.isPaused()}`); }
یک ویدیوی خاص را برای استفاده در یک گروه دارایی بازیابی کنید
function getVideoByYouTubeId(youTubeVideoId) { // You can filter on the YouTubeVideoId if you already have that video in // your account to fetch the exact one you want right away. const videos = AdsApp.adAssets().assets() .withCondition(`asset.type = YOUTUBE_VIDEO AND ` + `asset.youtube_video_asset.youtube_video_id = '${youTubeVideoId}'`) .get(); if (videos.hasNext()) { return videos.next(); } return null; }
یک ویدیوی خاص را به یک گروه دارایی اضافه کنید
function addVideoToAssetGroup(youTubeVideoId, campaignName, assetGroupName) { // Defined above const video = getVideoByYouTubeId(youTubeVideoId); const assetGroup = getAssetGroupByName(campaignName, assetGroupName); assetGroup.addAsset(video, 'YOUTUBE_VIDEO'); }
یک ویدیوی خاص را از یک گروه دارایی حذف کنید
function removeVideoFromAssetGroup(youTubeVideoId, campaignName, assetGroupName) { // Defined above const video = getVideoByYouTubeId(youTubeVideoId); const assetGroup = getAssetGroupByName(campaignName, assetGroupName); assetGroup.removeAsset(video, 'YOUTUBE_VIDEO'); }