2010-08-01
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 Usage

The 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.

Addition: If you don´t use Google Ad Manager yourself (i.e. sell your ad space to somebody using Google Ad Manager), this will be the Publisher-ID you get with the name of the AdSlot. It gets assigned to this AdSlot only.


 

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


In addition to this basic settings the module supports custom Google Ad Manager target-parameters, custom Google Ad Manager page-parameters and custom Google Ad Manager slot-parameters.

These are set under "Other 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, ...).

They are passed to the page, not the slot. For further information on these parameters please refer to the Google Ad Manager Help.

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.

They are passed to the page, not the slot. For further information on these parameters please refer to the Google Ad Manager Help.

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.

They are passed to the current slot. For further information on these parameters please refer to the Google Ad Manager Help.

You can set up to nine parameter-pairs.


 

2.) Thats all, click "Save" - done.


 

Thats it, have fun with the module!

Support

If 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
 
Comments (13)
{*begam} XXXXXXXXXXX/xxxxxxxxx {/begam}
13 Wednesday, 02 June 2010 21:04
Joe

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?

@Joe
Wednesday, 02 June 2010 21:19
A. Berger

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

GAM
12 Tuesday, 01 December 2009 11:43
JayW
Thanks Andreas.

I'm experimenting with the plugin and so far its looking good. I will follow up here with the results when finished.

-jay
@JayW
11 Monday, 30 November 2009 18:05
A. Berger
Hi 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
Using Placement tags instead of slots?
10 Monday, 30 November 2009 11:04
JayW
I have a news site and I'm experimenting with your plugin/modules - great implementation btw.

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.
@Kristjan
9 Monday, 23 November 2009 20:14
A. Berger
Hi Kristjan!

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?
8 Monday, 23 November 2009 18:15
Kristjan
Hallo -

Do I need to install the plugin to use the module?
Perfect
7 Saturday, 26 September 2009 13:06
Haider
Hi,


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
@Nana
6 Sunday, 30 August 2009 18:10
A. Berger
Hallo Nana!

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
Werbung wird nicht mehr angezeigt
5 Sunday, 30 August 2009 17:26
Nana
Hallo,
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
@Steffen
4 Friday, 19 June 2009 15:19
A. Berger
Hi Steffen!

Yes, no problem, there is no limit.

Best regards
Andreas
English
Panoramic Image Viewer
AddThis Social Bookmark Button
Who's Online
We have 30 guests online
Latest Items