Here’s an AdWords script to apply shared campaign negative lists everywhere

Want to share campaign negative lists with a load of campaigns, but finding the interface a drag? Columnist Daniel Gilbert of Brainlabs has a script for that!

Chat with SearchBot

google-adwords-red3-1920

Do you use shared campaign negative lists? Shared lists are really useful for making sure all of your campaigns are excluding the same terms. Constantly mining search query reports means constantly finding new negatives, after all.

There are also shared lists for campaign placement exclusions, so you can make sure things like adsenseformobileapps.com and random YouTube videos are excluded from all Display campaigns.

But how do you know if a campaign is missing a shared list?

When you’ve made a batch of new campaigns, it’s a hassle to apply shared lists to all of them, and it’s easy to accidentally leave one off. Then, it’s hard to check if you’ve done it right.

If you go to the Shared Library in your account, you can go to each list and see the names of the campaigns that share the list, but you have to do that separately for each list. You can’t see more than 500 campaign names at a time, and you can’t just download those names to check them all with your Excel-fu. And, shared lists aren’t in Editor — you’re stuck with the clunky web interface.

What if I told you you don't have to use the AdWords interface?

But you’re not actually stuck with the clunky web interface. You have AdWords Scripts!

Okay, fine, you have to use the interface a little. But you just have to set up the right shared lists once. Once you’ve got a single campaign right, this Script can handle the rest — it looks at that campaign and uses it as a template, copying its shared lists to all the other campaigns.

At Brainlabs (my employer), we use this to avoid wasting time setting up the same things everywhere, and so it’s easy to add all the necessary negatives when a new campaign gets added a few months down the line. We also have an API version that works with Bing Ads and can work across many different accounts.

Obviously, you may not want the exact same set of lists in all campaigns. And there might be a list you only use with a couple of campaigns. So you have options to define which campaigns the lists are copied to. The script doesn’t remove any of the existing lists, it only adds — so when you’ve created some extra campaigns, you can rerun it, and it won’t mess with any extra lists you’ve applied to the old campaigns.

Want this in your account? Just copy the code below into a new AdWords Script, and change some of the options at the top:

  • There are two arrays, campaignNameContains and campaignNameDoesNotContain, used to filter which campaigns are affected. For example, if campaignNameContains is [“Brand”, “Generic”] then only campaigns with names containing “brand” or “generic” are included. If campaignNameDoesNotContain is [“Display”, “Competitor”] then any campaigns with names containing “display” or “competitor” are ignored.
    • This is not case-sensitive.
    • Leave blank, [], to not exclude any campaigns.
    • If you need to put a double quote into campaignNameContains or campaignNameDoesNotContain, put a backslash before it. For example, if the campaign name is 9″ Tablets, you’d enter it as 9\” Tablets.
    • If you’ve got campaigns split by match type, you could use something like “-Exact” or “|EM” to show which campaigns are Exact match; you could add that to campaignNameDoesNotContain so the lists only get added to Broad or Phrase match campaigns.
  • If ignorePausedCampaigns is true, then the script will only look at currently active campaigns. Set them to false if you want to look at currently paused campaigns.
  • campaignToCopy is the name of the template campaign, whose shared lists shall be copied. This is case-sensitive.
    • The template campaign can be paused, but it can’t be removed.
  • Set copyNegativeKeywordLists to true to share campaign negative keyword lists.
  • Set copyExcludedPlacementLists to true to share campaign excluded placement keyword lists.
    • Obviously, at least one of copyNegativeKeywordLists and copyExcludedPlacementLists needs to be true, otherwise the script won’t have any lists to share!
  • labelName is the name of the label which will be applied to campaigns once they’ve had the lists added. This means you can see which campaigns have been covered.
    • Campaigns that already have the label will be ignored: if the Script doesn’t cover them all in one run it can go again until it covers them all.

You may want to run the script more than once for different sets of lists. For example, say you had different lists for generic and brand campaigns. You might want to do one run with campaignNameDoesNotContain set to [“Brand”] and campaignToCopy set to a non-brand campaign’s name to cover all the generics.

Then, you could change the settings so campaignNameDoesNotContain is [], campaignNameContains is [“Brand”] and campaignToCopy is a brand campaign, allowing you to do a run on just the brand campaigns.

Notes:

  • AdWords Scripts can’t apply lists to Shopping, AdWords Express, Video or Universal App campaigns. Campaigns of these types are ignored.
  • The Script can’t tell the difference between “Search,” “Display” and “Search with Display Select” campaigns. You have to use the campaign names to make sure negative lists intended for Search don’t end up in Display campaigns.
  • Scripts can only run for 30 minutes, which may not be enough if you’ve got thousands of campaigns and lots of lists. But if the script times out, you can just run it again — it will say in the logs when everything has been covered.


Opinions expressed in this article are those of the guest author and not necessarily Search Engine Land. Staff authors are listed here.


About the author

Daniel Gilbert
Contributor
Daniel Gilbert is the CEO at Brainlabs, the best paid media agency in the world (self-declared). He has started and invested in a number of big data and technology startups since leaving Google in 2010.

Get the must-read newsletter for search marketers.