Advertising Module:Google Adwords
From ExtractValue Wiki
Google Adwords will be integrated into the Advertising Module of Centricity.
Important Note: All testing must be done in the Sandbox and not live!
The AdWords API Sandbox is an environment that replicates the API of the live site for developing, testing and debugging applications that use the AdWords API. There is no quota on the Sandbox system.
Contents |
Objectives
The Google Adwords API will allow Centricity to dynamically create and update Adwords marketing campaigns. This will happen by:
- Database sync between Centricity and Google Adwords
- Employ a consistent URL Schema for advertising a Group, Product, Tag, or News Article
- Pause and unpause campaigns from Centricity Admin
- Edit Ad creatives for a campaign from within Centricity Admin
- Manage general bidding from Centricity Admin
- Update Centricity Admin "on click" if Google Adwords has been manually altered through Google MyClientCenter (MCC)
Extract Value needs to have the ability to dynamically perform ad campaigns from within the admin.centricityhq.com application using Apility. Your objective is to create a new Kohana module named apility and port the Apility source files into it. Your controller's, models will be located here when adding the Apility application and it's features to the admin.centricityhq.com application.
Use Cases
| Case | Display URL | Actual URL | Redirect (if applicable) |
| Group short name | %shortgroupname%.domain.com | %shortgroupname%.domain.com/pages/landing-page-1 | domain.com/pages/shortgroupname/landing-page-1 |
| Tags | domain.com/tags/%tag% | domain.com/tags/%tag% | |
| News Article | domain.com/news/%article% | domain.com/news/%article% |
Pre-requisites
Documentation and Code Samples
- Read the documentation: Google Adwords API
- Use the following PHP library: Google APIlity
- See the following code samples: Code Samples
Google API Login/Pass
- User: google@clickevolver.com
- Developer Token: YY6qOd8jc9JdnWqkbzkNYA
- Application Token: DGsWWvgf0VbKZIF7EE6CJA
Dev Environment Setup
For instructions on how to access Centricity's database and set up your development environment, please see Subversion (SVN)
Google Apility
The ability application may be downloaded from here:
http://google-apility.sourceforge.net/index.html
Download and unzip the files. Please read the entire documentation located here:
http://google-apility.sourceforge.net/index.html
The previous link will explain in full detail the architecture theory behind Apility and it's structure.
Technical Specs v1.0 - Basic Sync
The Apility application will give us the ability to manage ad campaigns dynamically on the Google network. The application will be built into the Centricity admin (admin.centricityhq.com).
Database
Please design tables that will hold the information located here in figure one on this page:
http://google-apility.sourceforge.net/index.html Direct link: http://google-apility.sourceforge.net/resources/apility_organigram.png
The information to be held will follow the same login and table columns that are listed in that diagram.
CampaignService
Adwords Syncs to Centricity
There should be an UPDATE button which, when clicked, updates Centricity with relevant information that was manually inputted into Google Adwords. For example, if an individual manually pauses a campaign, then this should update Centricity.
Technical Specs v2.0 - Text Ads
AdService (Creatives)
The AdService reference is here.
- In the Centricity admin panel, we should be able to produce creatives with dynamic elements
