A WordPress Sponsor Ad Management Plug-In
Getting Started
The first thing you should notice after activating the cd_ad_sponsor plug-in is the overview displayed on the admin dashboard. The left-hand column of the overview provides a count of each of the sponsors, program types, banner ads, schedules, and excluded IPs. You can click on an item in this column to display the management page associated with that item. The right-hand column displays count totals for click-throughs, impressions, running ads, pending ads, and expired ads. The cd_ad_sponsor Overview screen displays site-wide cumulative totals. That is, all totals are for all blogs regardless of the number of active blogs.
Figure 1. Ad Sponsor Overview
A new menu is added to the administration panel called, Ad Sponsors. You select a menu item to display the management page associated with that item. The following sections explain each of these menu items.
1The first option is Manage Sponsors. This is primarily a contact information page but is used internally to associate the various ads, programs, revenue types, and schedules. Sponsor information includes your log in credentials, the sponsor URL you use to log in, and data used to obtain help from a sponsor representative. As I said, this is primarily a reference list.
If you are using WordPressµ, the Sponsors you define apply across all blogs. That is, they are not blog specific. It is recommended that you define all Sponsors that you wish to promote regardless of the number of blogs you currently publish.
2The second option is Program Types. Sponsor Programs represent the various payment program types for a specific site or product offered by a sponsor. Program types include Pay Per Sign up (PPS), Revenue Sharing (REV), a referral program (REF), etc. Some sponsors offer more than one option for each program type, such as with or without a trial period. You should define each Program Type you wish to use for each Sponsor site or product. Each Program Type you define is later assigned to a specific Banner Ad.
If you are using WordPressµ, the Program Types are "Sponsor specific" and, therefore, apply across all blogs. It is recommended that you define all Program Types in which you have elected to participate for each of your sponsors.
3The third option is Revenue Types. This is the monetary method you apply to your ads. There are five pre-defined revenue types included in the cd_ad_sponsor installation. These revenue types are, CPD (Cost Per Day), CPC (Cost Per Click), CPM (Cost Per 1000 Impressions), OPEN, and REF (Webmaster Referral). You can define additional revenue types to meet your requirements.
There is one revenue type that warrants further discussion. The revenue type, CPD, is a special revenue type, in that, the cd_ad_sponsor plug-in uses this revenue type to place permanent ads, such as when a sponsor purchases a zone for a specific time period to the exclusion of other sponsor ads. Obviously, CPD ads are given priority over any other revenue types.
4The fourth option is Manage Ad Zones. Ad zones are the locations within your theme where qualified ads are placed. Ad zones are theme specific, which means that if you switch between more than one theme for your blog you will need to modify each theme to make use of this plug-in. You should also note that since no two themes are similarly designed, you may have a zone created for one theme that may not be able to be created in another theme.
Creating a zone within your theme is simply a mater of placing a function call at the desired location and passing the zone ID. I'll discuss creating zones later. For now, just understand that you are not limited in the number of zones you can create.
5The fifth option covers Banner Ads. These represent the image- or script-based advertisement for a specific sponsor site or product. Script-based Ads are usually obtained through Google, Amazon, etc. Image-based Ads (gif, jpg, png, etc.) have preference over any Script-based Ad definition. If both Image- and Script-based Ads are defined for the same scheduled zone, the Image-based Ad is used.
Each site or product, however, may have one or more ads based on your program type participation. For example, you may have elected to participate in a "Pay Per Sale" program and a "Revenue Sharing" program for a specific product. Subsequently, each program type has a unique URL. You must define a Banner Ad for each program type you wish to display.
If you are using WordPressµ, the Banner Ads apply to the currently active blog only. Banner Ads are Category dependent to prevent, for example, an ad for audio components appearing in a cooking utensil category. Unless, of course, that is what you intend. Script-based Ads, however, are determined by the sponsor. Therefore, you should select all categories when defining a script-based ad.
6The sixth option is Manage Schedules. Ad Schedules allow you to specify the Sponsor Ads displayed at a particular location (or zone) within a specified time frame.
If you are using WordPressµ, the Ad Schedules you define are specific to each blog. Although you may select from any Sponsor, and any Sponsor Program, you are only able to define Ad Schedules within the currently active blog.
7The seventh option is Manage Default Options. This option allows you to specify the purchase page URL for your site. You also define the default ALT/TITLE tag text associated with a default ad. This text is displayed when the visitor hovers over a default ad.
The cd_ad_sponsor images folder contains default images conforming to the IAB standards that you can use as-is or as a base to create your own.
8The final option allows you to define IP addresses you want excluded from the ad stats. Excluded IPs are compared to the user IP address to determine whether a click-through is registered for a Sponsor Ad. This exclusion is necessary to prevent false clicks, such as when the site administrator tests a displayed ad link. This feature is provided to accurately track CPC and CPM statistics in the cd_ad_sponsor plug-in only.
Excluded IPs have no bearing on those sponsor programs that also acquire the source IP. This means that programs, such as Google AdSense will still register your IP and may determine that a specific click is not valid. As of this writing, I have not found an interface method associated with these programs.



Hi Datadirt,
Thanks! Glad I could help.
You might want to make sure you have version 1.2. You can either download from my site or wp codex.
Note: The version number is in the readme.txt file. Since I still haven't heard back from the wp codex gurus I have not been able to fix their renaming of '_' to '-', subsequently, the update plugin feature on the plugins page does not work. :-/ Updates are done manually for now.
Let me know if you have any questions.
Have a great weekend too!
thx for the hint - just upgraded to the new version. Nice new feature!!! I'm running all my ad buttons via your plugin now.
Hi Coyote,
Is it possible not to cloak the link generated by this plugin ? since the link generated by this plugin is not xhtml 1.0 compliant
Thanks :)
Hello Anangga,
The 'cloaked' link consists of a parameter list which determines the appropriate banner URI as provided by a sponsor. I may, at some later date, re-work some elements of the plug-in, but I have no immediate plans to do so. I would, however, welcome any suggestions you may have to add to my to-do list.
Thanks
Coyote
Hi Coyote
I'm curious to know if you have tested this in 2.9.x? I've installed it and am running into a few strange things. I think it is 'me', and not the plugin, but I thought I would check just in case.
I'm working on http://m2live.org and have created 2 zones, one for each sponsor ad. The actual sponsor pic displayed for one (1) impression, then never showed again. I tried changing the revenue type code, as well as other settings with no avail.
Thanks, and it really does seem like an awesome plugin.
best,
Sean
Hello Sean,
Yes. I am running both 2.9.x single and mu versions of WP with this plug-in.
Looking at your site source code I see that you are running 'execphpwidget' immediately prior to the location of your sponsor ads within the sidebar. You do not need to execute any php. The user guide explains how to insert the function call in to your theme, and how to configure a multiple-ad zone.
If you are still experiencing difficulty please contact me on Skype or by email and I will assist you as best I can.
Best regards,
Coyote
Hi,
I am using WordPress 2.9.2.
I'm looking for an ad program that can support gif, jpg, and swf files.
Is this the right program for me?
Also, Can I manage multiple zones and campaigns and also view impressions and click-throughs
Also, does it support clicks and also, a small text advertise here so I can refer users to my email that want to advertise on my site.
Thank you.
Hello Larry,
Thank you for your interest. I will answer your questions in the order you submitted them.
The cd_ad_sponsor plug-in does support all standard graphics file formats, such as gif, jpg, png, etc. The swf file script and parameters should be added to the script-based ad section of the Manage Banner page.
I believe this program is right for you, but only you can make that determination.
You can have any number of zones defined within your theme. Impressions and click-through are also tracked. Campaigns would be determined by your configuration with your sponsor. Each campaign would then equate to a Program Type using this plug-in. You can read more about this in the User Guide.
The plug-in supports clicks for non-script-based ads. For example, AdSense is script-based and, therefore, cannot be tracked through the plug-in. Those statistics, however, are available through your sponsor that offers script-based ads.
Yes, you can include a text-link to display with ads that either redirects the user to your advertising page, or to your email address. You would simply add the anchor tag to your theme at the location where you want the link to appear.
I would like to recommend that you read the user guide on my new web site, http://cd-ad-sponsor.com. This is a new site I created specifically for this plug-in. There you will find the User Guide, Tutorials, etc. I will be adding more in the coming weeks.
If you have further questions, please do not hesitate to contact me on Skype or by email. I will be more than happy to help.
Best regards,
Coyote