Generate and add keyword variations on Google AdWords from .NET

Discussion in 'C#' started by JosipK, Dec 17, 2009.

  1. JosipK

    JosipK New Member

    Joined:
    Dec 17, 2009
    Messages:
    2
    Likes Received:
    0
    Trophy Points:
    0

    Introduction



    AdWords
    is Google's flagship advertising product. AdWords offers pay-per-click (PPC) advertising, and site-targeted advertising for both text and banner ads.

    The Google AdWords API lets developers build applications that interact directly with the AdWords platform. With these applications, advertisers and third parties can more efficiently and creatively manage their large or complex AdWords accounts and campaigns.

    The key object in AdWords system is Keyword – word that triggers an Ad. Ads and Keywords are grouped underneath parent object – AdGroup. Each keyword in some AdGroup can trigger any of the Ads in that AdGroup.

    Example: Let’s say that in AdGroup A are keyword X and Ad Y. When some user enters into Google’s search engine word X, AdWords system will show Ad Y.

    This article will explain how to programmatically add Keywords under some AdGroup. Presented is an application that adds all combinations of certain set of keywords under specified AdGroup. For that purpose application can use one of the following libraries:

    • Google api-adwords-dotnet
    • 3rd party AdWords API for .NET (GemBox.Ppc)

    Keywords



    Keyword is an object that specifies on which searches would be some Ad shown. Keyword is composed of two properties: Text and MatchType.
    MatchType closely define some Keyword. MatchType can have on of the following values:

    • Exact
    • Phrase
    • Broad
    Using Match Type user can specify which variations of Text will trigger some Ad. Although keyword that has Broad match will be triggered by the largest set of search words, it’s the most expensive. On the other hand keyword with Exact match will be triggered only if user searches for the word that is equal to the value that was specified by the Text property. Each of those approaches has some advantages and disadvantages.

    AdWordsKeywordGenerator app shows one approach that combines Match types that are provided by the AdWords platform.

    AdWordsKeywordGenerator



    AdWordsKeywordGenerator takes set of words and makes all combination with those words. After that it uploads them to the AdWords system.

    For example, if user specifies words “summer” and “hot”, AdWordsKeywordGenerator will upload keywords:
    • Summer (Exact match)
    • Hot (Exact match)
    • Summer hot (Exact match)
    • Hot summer (Exact match)
    One of the biggest advantages in this approach is that we can review statistics for each phrase. We could add only one word and specify Broad match, but then we couldn’t examine statistic for one specific phrase (in this sample, we couldn’t distinguish phrase “hot” from other phrases).

    To use application follow these steps:
    • Specify Account Information – information that is needed for logging. Help on this is here .
    • Specify API library that you want to use.
    • Specify AdGroup in which you want to add new keywords.
    • Add Source Words – words that you want to combine.
    • Generate Keywords – this will combine Source words.
    • Upload New Keywords.

    Implementation



    AdWordsKeywordGenerator is WPF application written in C# using Visual Studio 2008.
    Typical application workflow is:

    • Generating combinations of words
    • Logging to AdWords platform
    • Getting AdGroup
    • Adding new Keywords to AdGroup
    • Uploading changes to AdWords platform
    Generating combinations of words

    For Generating combination of words we use class KeywordGenerator. It has method GenerateCombinations that accepts list of source words, makes combinations and returns them in a new list.

    Uploading combinations

    For uploading combinations we can use two different libraries: google-api-adwords-dotnet (GoogleLibraryUploader class) and 3rd party AdWords .NET API (GemBoxPpcUploader class).

    GoogleLibraryUploader



    Uploading new keywords using google-api-adwords-dotnet is made of the following steps:

    • Logging to AdWords platform
    • Downloading all AdGroups
    • Selecting specified AdGroup
    • Creating new Keywords
    • Uploading new keywords
    Here’s the complete code:

    Code:
    internal class GoogleLibraryUploader : IUploader
           {
               // User.
               private AdWordsUser user;
        
               // Login.
               public void Login(string email, string password, string developerToken, string applicationToken, string userAgent,
                   bool useSandbox, string clientCustomerIdOrClientEmail)
               {
                   // This can be set in config file.
                   ApplicationConfiguration.email = email;
                   ApplicationConfiguration.password = password;
                   ApplicationConfiguration.developerToken = developerToken;
                   ApplicationConfiguration.applicationToken = applicationToken;
        
                   if (clientCustomerIdOrClientEmail.Contains('@'))
                       ApplicationConfiguration.clientEmail = clientCustomerIdOrClientEmail;
                   else
                       ApplicationConfiguration.clientCustomerId = clientCustomerIdOrClientEmail;
        
                   ApplicationConfiguration.adWordsApiUrl = useSandbox ? "adwords-sandbox.google.com" : "adwords.google.com";
        
                   this.user = new AdWordsUser();
               }
        
               // Upload keywords to AdGroup.
               public void UploadKeywordsToAdGroup(string campaignName, string adGroupName, IList<string> keywords)
               {
                   // Get AdGroupService.
                   AdGroupService adGroupService = (AdGroupService)this.user.GetService(AdWordsService.v200909.AdGroupService);
        
                   // Get All AdGroups
                   AdGroupPage page = adGroupService.get(new AdGroupSelector());
        
                   // Select specified AdGroup.
                   AdGroup adGroup = page == null || page.entries == null ? null :
                       page.entries.FirstOrDefault(x => x.campaignName == campaignName && x.name == adGroupName);
        
                   if (adGroup == null)
                       throw new System.ApplicationException("AdGroup with name " + adGroupName + " doesn't exists!");
        
                   // Create AdGroupCriterionOperations with new keywords.
                   List<AdGroupCriterionOperation> operations = new List<AdGroupCriterionOperation>();
                   foreach (string keyword in keywords)
                   {
                       // Create AdGroupCriterion
                       AdGroupCriterion criterion = new BiddableAdGroupCriterion()
                           {
                               adGroupId = adGroup.id,
                               adGroupIdSpecified = true,
                               criterion = new Keyword()
                               {
                                   text = keyword,
                                   matchType = KeywordMatchType.EXACT,
                                   matchTypeSpecified = true
                               }
                           };
        
                       // Create AdGroupCriterionOperation
                       AdGroupCriterionOperation keywordOperation = new AdGroupCriterionOperation()
                       {
                           @operator = Operator.ADD,
                           operatorSpecified = true,
                           operand = criterion
                       };
        
                       // Ad operation to the list.
                       operations.Add(keywordOperation);
                   }
        
                   // Get AdGroupCriterionService
                   AdGroupCriterionService adGroupCriterionService =
                       (AdGroupCriterionService)this.user.GetService(AdWordsService.v200909.AdGroupCriterionService);
        
                   // Upload new keywords.
                   adGroupCriterionService.mutate(operations.ToArray());
               }
           }
     

    GemBoxPpcUploader



    Uploading new keywords using GemBox.Ppc AdWords API is made of the following steps:

    • Logging to AdWords platform
    • Specifying that component download data on demand
    • Selecting specified AdGroup
    • Creating new Keywords
    • Uploading new keywords
    Here’s the complete code:
    Code:
       internal class GemBoxPpcUploader : IUploader
             {
                 // Account (contains user)
                 private AwAccount account;
          
                 static GemBoxPpcUploader()
                 {
                     // Set license. We use free version of GemBox.Ppc.
                     PpcInfo.SetLicense("FREE-LIMITED-KEY");
                 }
          
                 // Login.
                 public void Login(string email, string password, string developerToken, string applicationToken, string userAgent,
                     bool useSandbox, string clientCustomerIdOrClientEmail)
                 {
                     // Create Account.
                     this.account = new AwAccount(new AwUser(email, password, developerToken, applicationToken, userAgent, useSandbox, clientCustomerIdOrClientEmail))
                     {
                         // This enables automatic downloading so we don't need to call Download() method.
                         DownloadLazy = true
                     };
                 }
          
                 // Upload keywords to AdGroup.
                 public void UploadKeywordsToAdGroup(string campaignName, string adGroupName, IList<string> keywords)
                 {
                     if (this.account == null)
                         throw new ApplicationException("You haven't login to account!");
          
                     // Get Campaing.
                     Campaign camp = this.account.Campaigns.SingleOrDefault(x => x.Name == campaignName);
                     if (camp == null)
                         throw new ApplicationException("Campaign with name " + campaignName + " doesn't exists!");
          
                     // Get AdGroup.
                     AdGroup adGroup = camp.AdGroups.SingleOrDefault(y => y.Name == adGroupName);
                     if (adGroup == null)
                         throw new ApplicationException("AdGroup with name " + adGroupName + " doesn't exists!");
          
                     // Add new Keywords.
                     foreach (string keyword in keywords)
                         adGroup.Criterions.Add(new BiddableAdGroupCriterion()
                             {
                                 Criterion = new Keyword()
                                 {
                                     Text = keyword,
                                     MatchType = KeywordMatchType.EXACT
                                 }
                             });
          
                     // Upload changes.
                     this.account.UploadChanges();
                 }
             }
       
       

    Conclusion



    As always in programming, there is more than one method to achieve the same thing.

    Google api-adwords-dotnet is a set of proxy classes built from WSDLs plus some extra classes that enables logging to AdWords platform. It is completely free but it is not completely optimized for .NET platform and requires some manual work (casting, setting xxxSpecified properties, different ids, etc).

    On the other hand, GemBox.Ppc is optimized for .NET, encapsulates different AdWords services and provides many utilities out of the box. However, Free version has limitations.

    Download links



    Download the latest version of the application (together with the C# source code):
     
  2. technica

    technica New Member

    Joined:
    Dec 15, 2007
    Messages:
    107
    Likes Received:
    0
    Trophy Points:
    0
    Home Page:
    http://www.technicaltalk.net
    Thanks for sharing.
     
  3. shabbir

    shabbir Administrator Staff Member

    Joined:
    Jul 12, 2004
    Messages:
    15,375
    Likes Received:
    388
    Trophy Points:
    83
  4. shabbir

    shabbir Administrator Staff Member

    Joined:
    Jul 12, 2004
    Messages:
    15,375
    Likes Received:
    388
    Trophy Points:
    83

Share This Page

  1. This site uses cookies to help personalise content, tailor your experience and to keep you logged in if you register.
    By continuing to use this site, you are consenting to our use of cookies.
    Dismiss Notice