Google::Adwords::Campaign - A Google Adwords Campaign Object
This documentation refers to Google::Adwords::Campaign version 0.0.2
use Google::Adwords::Campaign; use Google::Adwords::CampaignService; # create a new campaign object my $campaign = Google::Adwords::Campaign; # set values for the campaign object $campaign->name('My Final Try'); $campaign->dailyBudget(10000000); # target a certain city in US $campaign->geoTargeting({ cities => [ 'Pelican, AK US' ], }); # create the campaign service object my $campaign_service = Google::Adwords::CampaignService->new(); # need to login to the Adwords service $campaign_service->email($email_address) ->password($password) ->developerToken($developer_token) ->applicationToken($application_token); # if you use a MCC $campaign_service->clientEmail($client_email); # now create the campaign my $campaign_response = $campaign_service->addCampaign($campaign); print "New campaign ID is :" . $campaign_response->id;
This object should be used with the CampaignService API calls
Mutators (read/write)
* dailyBudget
* enableSeparateContentBids
* name
* status
* startDay
* endDay
* languageTargeting
* geoTargeting
* networkTargeting
Accessors (read only)
* id
The following methods accept/return a hashref
languageTargeting()
A hashref with keys:
* languages - An arrayref of language codes
Example usage:
# set English and Hindi as my language targets $campaign->languageTargeting({ languages => [ 'en', 'hi' ], });
The language codes are available here:
http://www.google.com/apis/adwords/developer/adwords_api_languages.html
geoTargeting()
* countries - An arrayref of country codes
* regions - An arrayref of region codes
* cities - An arrayref of city codes
* metros - An arrayref of metro codes
# Set target countries as US and India $campaign->geoTargeting({ countries => [ 'US', 'IN' ], }); # Only target Adelaide in Australia $campaign->geoTargeting({ cities => [ 'Adelaide, SA AU' ], }); # By region, target Berlin in Germany $campaign->geoTargeting({ regions => [ 'DE-BE' ], }); # By metros, target Los Angeles $campaign->geoTargeting({ metros => [ '803' ], });
The codes are available here:
countries -
http://www.google.com/apis/adwords/developer/adwords_api_countries.html
regions -
http://www.google.com/apis/adwords/developer/adwords_api_regions.html
cities (outside the US) -
http://www.google.com/apis/adwords/developer/adwords_api_cities.html
cities (in the US) -
http://www.google.com/apis/adwords/developer/adwords_api_us_cities.html
metros (in the US) -
http://www.google.com/apis/adwords/developer/adwords_api_us_metros.html
From the Adwords website:
You can target campaigns by cities, countries, metros, and regions. However, a single campaign can only target one geographic area. For example, you can target a campaign by countries or regions, but not both. You can specify multiple values within a single type of geographic area. For example, you could target a campaign by more than one country.
More info is here:
http://www.google.com/apis/adwords/developer/adwords_api_geotarget.html
networkTargeting()
* networkTypes => arrayref of network names
Exmaple usage:
# target only the google search network $campaign->networkTargeting({ networkTypes => [ 'GoogleSearch' ], });
The network types are:
* GoogleSearch
* SearchNetwork
* ContentNetwork
When creating a new campaign, if no targeting is specified, the default targeting is GoogleSearch. SearchNetwork encompasses GoogleSearch, so GoogleSearch need not be specified when this value is included.
http://www.google.com/apis/adwords/developer/NetworkTarget.html
Google::Adwords::CampaignService
Rohan Almeida <rohan@almeida.in>
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.