| Google Ad Manager Module Installation and Usage |
| Written by Andreas Berger |
| Saturday, 29 November 2008 20:01 |
|
A step for step tutorial on how to install and use the bretteleben.de Google Ad Manager Module.
Installation and UsageThe Google Ad Manager Module allows to display Google Ad Manager Ad Slots on module positions. To work it needs the Google Ad Manager Plugin installed and activated.
1.) Log into your administration interface
2.) Go to "Extensions" > "Install/Uninstall"
3.) Select the Package File with the Google Ad Manager Module
4.) Click "Upload file & Install"
5.) If everything worked fine, you get the message "Install Module Success"
6.) Select "Extensions" > "Module Manager"
7.) Find the "bretteleben.de Google Ad Manager Modul" and click it
8.) The module expects two parameters. The first is your Google Ad Manager Publisher Id. In my case its ca-pub-"16digits".
If you are uncertain: If you tell the Google Ad Manager to produce Sample-HTML code, this code includes your Publisher ID.
9.) Insert your Publisher Id
10.) The second parameter is the Name of the Google Ad Manager Ad Slot to display. Insert it too.
11.) Now we change the common module parameters to fit our needs. First, disable the display of the title or change the title.
12.) We activate the module ...
13.)... choose the position to use ...
14.) ... and the pages to be displayed on.
15.) Click "Save" - done.
Optional Parameters
1.) Click "Other Parameters"
2.) The first block takes your data for custom Google Ad Manager target-parameters.
They always consist of the parameter (age, gender, interests, ...) plus the value (18To24, Male, cars, ...).
You can set up to five parameter-pairs. 2.) The second block takes your data for custom Google Ad Manager page-parameters.
They always consist of the parameter (background-color, link-color, ...) plus the value (FF0000, 939393, ...). They overwrite the values passed by the Google Ad Manager.
You can set up to nine parameter-pairs. 2.) The second block takes your data for custom Google Ad Manager slot-parameters.
They always consist of the Google Ad Slot name (set automatically by the module), the parameter (background-color, link-color, ...) plus the value (FF0000, 939393, ...). They overwrite the values passed by the Google Ad Manager.
You can set up to nine parameter-pairs. 2.) Thats all, click "Save" - done.
Thats it, have fun with the module! SupportIf you have questions or suggestions, please use the comment-function. Records about the behavior of this extension (positive or negative) are most welcome.If you use this extensions, you have the possibility to post a rating and a review at joomlaos.de or extensions.joomla.org. Furthermore I appreciate everyone, supporting me with a link back to www.bretteleben.de on his/her website. The extension itself does not produce any hidden links, eastereggs or whatever. |
| Last Updated on Sunday, 05 April 2009 13:33 |

























I only have an AdSense account not an Ad Manager account at Google. Nevertheless, I viewed my code from Google and found that it includes both a pub-16digit ID and a GamSlot number. I used those and followed the instructions on this page
However, all that appeared on my site was a box with the new module name and the code (where the X's and x's represent my Gam ID & Slot numbers.
{*begam} XXXXXXXXXXX/xxxxxxxxx {/begam}
Any idea of what's not working?
Hi Joe!
The Google Ad Manager Module always needs the Google Ad Manager Plugin to work.
And you need a - now - DoubleClick for Publishers (aka Google Ad Manager) account to use this extension. It does not work with AdSense directly.
Best regards
Andreas
I'm experimenting with the plugin and so far its looking good. I will follow up here with the results when finished.
-jay
In fact, this is a pure Ad Manager environment. Plugin + Module both come with full support for Ad Manager targeting. Of course it depends on the structure of your site, but in most cases a site can get drilled down with a clever combination of three or four different targeting criteria. The module can be used multiple times on different pages (just copy the module) and use different targeting values.
If you have 3 different module positions, you could use each of them for one targeting key with different values on different pages. Same goes for the plugin. These settings combined with your placements (with different targeting) in Ad Manager offers a lot of flexibility.
If you need dynamic targeting (i.e. parameters passed on a page by page basis), it would be necessary to patch the script, but with someone at hand who has a little knowledge of PHP and JavaScript it should be no problem either.
Best regards
Andreas
The problem I'm running into is that I have 200 different Joomla Sections & Categories that need to be individually targeted but at the same time being able to support a "Run of Site" option and to also build "Ad Packages" that use different combinations of slots for my advertisers.
I'm assuming that in a pure "Ad Manager" environment I would use "Placements" to accomplish this. Can this be accomplished with your plugin/module?
Thanks for all your hard work and willingness to share with the community.
Regards,
-Jay W.
Yes, the module only delivers code to the plugin. The plugin takes the code you insert in your articles PLUS the code from the modules and generates the necessary tags.
Best regards
Andreas
Do I need to install the plugin to use the module?
Well-done, I just installed your GAM module and works like wonder. I do want to see one more feature. I would like to have an auto-refresh option where I can set a timer to reload an other instance of my adslot in GAM.
Thank you,
Haider
Das "Tool" läuft eigentlich einwandfrei. Wenn Sie sich den Quelltext der Seite ansehen, dann sehen Sie, dass die erforderlichen Scripts im Kopf der Seite vollständig eingefügt wurden und auch das Script, das den einen, in der Seite vorhandenen Adslot aufruft (zumindest auf der Startseite und einer weiteren getesteten Seite war es jeweils 1 Slot - "6141101856"), ist da. Von dieser Seite her also alles in Ordnung.
Ruft man die Seite mit dem GAM Debug Parameter ?google_debug, oder (wenn bereits request paramneter da sind) &google_debug=1 auf, dann sieht man auch hier, dass das Plugin/Modul einwandfrei arbeitet und die GAM Scripts abgearbeitet werden.
Man sieht hier aber auch, dass es ein Problem gibt:
342 Warning Suppressing slot 6141101856 due to lack of content
Das bedeutet, von der Seite wird versucht, Werbung abzurufen, GoogleAdManager kann aber keine Werbung liefern.
Um das Problem zu beheben ist es also erforderlich, in Ihrem Ad Manager Account den Slot 6141101856 bzw. das Placement, zu dem er gehört, daraufhin zu überprüfen, ob er von LineItems adressiert wird und/oder ob er wenigstens Adsense enabled ist. Möglicherweise verhindert auch irgendein eingestelltes Targeting, dass Werbung ausgeliefert wird. Das Problem liegt jedenfalls im Bereich Ihres Ad Manager Accounts und muss auch dort behoben werden.
Gruss
Andreas
ich habe heute meine Channel direkt bei Googel geändert und seither werden gar keine mehr angezeigt.
Habe diesen Vorgang nicht zum Ersten mal durchgeführt, bisher immer mit erfolg.
Bei Googel hab ich schon nachgefragt und dort meinte man, das es evtl. am Tool liegen könnte.
Könnten Sie mir sagen, wie ich das Tool wieder zum Laufen bringe?
Ich verwende Joomla vers. 1.5.14
meine website www.empregoonline.eu
Yes, no problem, there is no limit.
Best regards
Andreas