Як додавати UTM та витрачати на це мінімум часу

// This script sets the custom parameter campaign (_campaign) for all campaigns in the account. This parameter contains the campaign name transformed into a URL-compatible format and can be used in the tracking template or final URL suffix.

// Before applying: Ensure that this parameter is not used for another purpose to avoid overwriting important information. Also, check that there isn’t a campaign parameter with an empty value, as this can cause errors.

// [Schedule] The script should be scheduled to run regularly, e.g., every hour, to add parameters to new campaigns.

// It is also good to manually run it after adding new campaigns.

// [Warning] As of October 27, 2024: The script does not work for all campaign types, including Demand Gen and Video. These need to be updated manually using Google Ads Editor. 

// Remember: Changing a campaign name will leave the old names in historical data in Analytics. Therefore, avoid changing campaign names.

// © ADEQUATE www.adequate.digital 2024

// More info: https://adequate.digital/en/utms-for-google-ads-campaigns/

function main() {
  processAccount();
}

function processAccount() {
  // Process standard campaigns (Search and Display)
  var campaignIterator = AdsApp.campaigns().get();
  while (campaignIterator.hasNext()) {
    var campaign = campaignIterator.next();
    processCampaign(campaign);
  }

  // Process Shopping campaigns
  var shoppingCampaignIterator = AdsApp.shoppingCampaigns().get();
  while (shoppingCampaignIterator.hasNext()) {
    var campaign = shoppingCampaignIterator.next();
    processCampaign(campaign);
  }

  // Process Performance Max campaigns
  var pmaxCampaignIterator = AdsApp.performanceMaxCampaigns().get();
  while (pmaxCampaignIterator.hasNext()) {
    var campaign = pmaxCampaignIterator.next();
    processCampaign(campaign);
  }

  // Optional: Attempt to process Demand Gen campaigns with error handling
  try {
    var demandGenCampaignIterator = AdsApp.demandGenCampaigns().get();
    while (demandGenCampaignIterator.hasNext()) {
      var campaign = demandGenCampaignIterator.next();
      processCampaign(campaign);
    }
  } catch (e) {
    Logger.log('Demand Gen campaigns may not be supported in this account: ' + e.message);
  }
}

function processCampaign(campaign) {
  var campaignName = campaign.getName();

  // Percent-encode the campaign name
  var modifiedCampaignName = encodeURIComponent(campaignName);

  // Truncate to 250 characters
  if (modifiedCampaignName.length > 250) {
    Logger.log('Warning: The encoded campaign name for "' + campaignName + '" exceeds 250 characters and will be truncated.');
    modifiedCampaignName = modifiedCampaignName.substring(0, 250);
  }

  // Get existing custom parameters at the campaign level
  var customParameters = campaign.urls().getCustomParameters() || {};

  // Update or add the 'campaign' parameter
  customParameters['campaign'] = modifiedCampaignName;

  // Set the updated custom parameters back to the campaign
  campaign.urls().setCustomParameters(customParameters);

  Logger.log('Updated campaign "' + campaignName + '" with campaign=' + modifiedCampaignName);
}