Google::Adwords::KeywordToolService - Interact with the Google Adwords KeywordToolService API calls
This documentation refers to Google::Adwords::KeywordToolService version 0.2
use Google::Adwords::KeywordToolService; use Google::Adwords::SeedKeyword; # create the keyword tool service object my $kwtool_service = Google::Adwords::KeywordToolService->new(); # need to login to the Adwords service $kwtool_service->email($email_address) ->password($password) ->developerToken($developer_token) ->applicationToken($app_token); # if you have a MCC $kwtool_service->clientEmail($client_email); # or $kwtool_service->clientCustomerId($customerid); # getKeywordsFromSite my $sitekeywordgroups = $kwtool_service->getKeywordsFromSite({ url => 'http://url.com', includeLinkedPages => 1, languages => [ 'en', 'fr' ], countries => [ 'IN', 'FR' ] });; print "Groups : " . join('|', @{$sitekeywordgroups->groups}) ."\n"; for ( @{$sitekeywordgroups->keywords} ) { print "Keyword # text : " . $_->text . " | searchVolumeScale : " . $_->searchVolumeScale ."\n"; } # getKeywordVariations my $seed1 = Google::Adwords::SeedKeyword->new ->text('world news') ->type('Broad'); my $seed2 = Google::Adwords::SeedKeyword->new ->text('independant news') ->type('Broad'); my $keyword_variations = $kwtool_service->getKeywordVariations({ seedKeywords => [ $seed1, $seed2, ], useSynonyms => 1, languages => [ 'en', 'fr', ], countries => [ 'US', 'IN', ], }); print "additionalToConsider \n"; for ( @{$keyword_variations->additionalToConsider} ) { print "Keyword # text : " . $_->text . " | searchVolumeScale : " . $_->searchVolumeScale . "\n"; } print "moreSpecific \n"; for ( @{$keyword_variations->moreSpecific} ) { print "Keyword # text : " . $_->text . " | searchVolumeScale : " . $_->searchVolumeScale . "\n"; }
This module provides an interface to the Google Adwords KeywordToolService API calls.
Given a URL, returns keywords based on words found on that web page or site, which can be used as keyword criteria for a campaign. The results are grouped by common keywords, with the groups ordered by decreasing relevance.
my $sitekeywordgroups = $service->getKeywordsFromSite({ url => 'http://url.com', includeLinkedPages => 1, languages => [ 'en', 'fr' ], countries => [ 'IN', 'FR' ] });;
Takes a hashref with following keys:
url => the site's location.
includeLinkedPages => whether to follow links on the page at the given url
languages => arrayref of language codes
countries => arrayref of country codes
A Google::Adwords::SiteKeywordGroups object.
Given a list of SeedKeywords, returns their variations in multiple lists within KeywordVariations. Each list represents a different kind of variation.
my $keyword_variations = $service->getKeywordVariations({ seedKeywords => [ $seed1, $seed2, ], useSynonyms => 1, languages => [ 'en', 'fr', ], countries => [ 'US', 'IN', ], });
seedkeyword => an array ref of Google::Adwords::SeedKeyword objects
useSynonyms => if set to 1, will use synonyms of source keywords as sources.
A Google::Adwords::KeywordVariations object.
Google::Adwords::SeedKeyword
Google::Adwords::SiteKeywordGroups
Google::Adwords::SiteKeyword
Google::Adwords::KeywordVariations
Google::Adwords::KeywordVariation
Rohan Almeida <rohan@almeida.in>
Mathieu Jondet <mathieu@eulerian.com>
Copyright (c) 2006 Rohan Almeida <rohan@almeida.in>. All rights reserved.
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
To install Google::Adwords, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Google::Adwords
CPAN shell
perl -MCPAN -e shell install Google::Adwords
For more information on module installation, please visit the detailed CPAN module installation guide.