Sponsor Ad Management User Guide
Manage Programs
Sponsor Programs represent the various payment program types for a specific site or product offered by a sponsor, such as PPS. 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. Each Program Type you define is later assigned to one or more Banner Ads.
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.
- Sponsor Name
- Select the sponsor you want to assign to this program type from the list of available sponsors.
- Program Site
- Enter the name of the sponsor site. You can have multiple program types per sponsor site. You should specify a site to help you identify which program you want to work with later.
- Program Name
- Enter the name of this program. The name should indicate the purpose of this program, such as a Join Page.
- Program Type
- Enter the 3-character type code for this program, such as REV. It is not required to use a 3-character designation for a program type, however, it is common practice to do so.
- Description
- Enter a description for this program type. The description is strictly for your reference.
After you are satisfied with your entries, click Save Changes. The Manage Programs page is displayed with your new sponsor program data.
To edit sponsor program data, click the program name.
Tutorial: Manage Programs
In this tutorial, we'll create a Program Type for Google, and a Program Type for the AdCouncil.
Start by clicking the Manage Programs option from the Ad Sponsors administration menu.
The Manage Programs page is displayed. You should see an empty listing.
Click the Add Sponsor Program button to display the Add Sponsor Program form.
| PSACentral | |
|---|---|
|
|
Review your entries. If your entries are correct, click Save Changes. The Manage Sponsors Program page is displayed with each program type listed under the associated sponsor.
Manage Revenue
Revenue Types describe the monetary purpose of an ad.
[Version 1.2.1, 12-07-2009]
The Rate data field was added to specify the default rate that you charge sponsors for the specified Revenue Type. This rate amount is used to calculate billing amounts as shown on the Banner Report page.
There are a number of standardized terms used to define different revenue types, which I have included in the default plug-in install. These types are:
- CPD
- Cost Per Day. A CPD type ad is where you sell a permanent ad spot placement to a sponsor. This "spot" is commonly referred to as Zone. You usually sell this type of ad for a fixed price for a fixed duration. For example, you might sell a CPD ad to a sponsor for $2500 to present their ad in the page header zone for a duration of one month. CPD type ads have a specific start- and end-date, where they are presented to the exclusion of any other ad associated with the same zone.
- CPC
- Cost Per Click. A CPC type ad is where you sell a non-permanent ad placement to a sponsor where the sponsor agrees to pay $x for each click initiated by your site visitors. CPC type ads have a specific start- and end-date, where they are presented in random order with other ads of a CPC or CPM type for the same zone. Pricing is usually given in cents per click, such as $0.05 per click.
- CPM
- Cost Per 1000 Impressions. A CPM type ad is where you sell a non-permanent ad placement to a sponsor where the sponsor agrees to pay $x per 1000 instances that their ad is displayed, regardless of the number of visitor clicks. Pricing is usually given in cents per thousand, such as $0.75 or $1.25 per thousand.
It is important that you understand the previous three Revenue Types. Specifically, a CPD type is used by the cd_ad_sponsor to specify that an ad is continuously displayed in a specific location for a specific duration. The price at which you sell a CPD ad does not have any bearing on the performance of your site visitors. That is, it does not matter whether a visitor clicks the ad or not. Because of this, the CPD Revenue Type is more expensive than the other two.
There are additional Revenue Types that you may wish to define, depending upon your requirements. For example, you may have ad spots where you pay a fee to the sponsor based on the performance of your site visitors, such as PPC. The cd_ad_sponsor plug-in will track these clicks. I have included two additional Revenue Types with the default installation.
- OPEN
- The OPEN revenue type is a catch-all case. You would use this type when you do not have a more specific revenue type defined.
- REF
- Referral. The REF type is used with a webmaster referral.
As a suggestion, you could create a revenue type for a flat fee. A FEE revenue type would be used where you charge a specific amount regardless of the scheduled time period. For example, you could charge a sponsor $100 for a one month schedule.
Another revenue type would be that of a courtesy. A CTY revenue type could be used in cases where you display a sponsor ad without charge. This could be used when displaying PSA ads.
You can define as many Revenue Types as you want.
- Revenue ID
- Enter a numeric revenue ID. Any integer value may be used. This value may correspond to your accounting software entries.
- Revenue Type Name
- Enter a name for this revenue type. You can use the 3-character abbreviations.
- Description
- Enter a description for this revenue type. This description is for your reference only.
- [Version 1.2.1, 12-07-2009] Rate
- Enter the amount you charge your sponsors for the specified Revenue Type.
After you are satisfied with your entries, click Save Changes. The Manage Revenue Types page is displayed with your new revenue type data.
To edit a revenue type, click the revenue ID.
Tutorial: Manage Revenue
In this tutorial, we'll create a Revenue Type for our Google program, and a Revenue Type for our AdCouncil program.
Start by clicking the Manage Revenue option from the Ad Sponsors administration menu.
The Manage Revenue Types page is displayed. You should see the five default Revenue Types listed.
Since there is a Revenue Type that applies to our Google sponsor, we only need to create a Revenue Type to assign to PSACentral. The reason being is that the AdCouncil does not pay you for displaying their ads. They are a Public Service Agency only. So we'll create a Revenue Type to match.
Click the Add Revenue Type button to display the Add Revenue Type form.
| PSACentral | |
|---|---|
|
No new Revenue Type is required. |
|
Review your entries. If your entries are correct, click Save Changes. The Manage Revenue Types page is displayed with each revenue type listed.
Manage Zones
Zones define the location or position within your theme where qualified Ads are placed. You are not limited to the number of zones you can define, however, I recommend that you only define the minimum number of zones necessary to present your ads as desired within the current theme. You can easily create a visually undesirable page by polluting your content with too many ads.
If you are using WordPressµ, the Zone IDs apply to the currently active blog only. This means that each blog and theme will have unique zone definitions. If you switch between themes for the same blog, you will need to modify each theme you intend to use.
Cautionary Note: If you intend to create a zone where sponsor ads are inserted between every nth paragraph within a post, one and only one Zone may have an Ad Frequency value greater than zero. I recommend that you name the Zone, Post Embed n, where n is the Ad Frequency value. See Embedding Ads within Posts later in this article for more information.
Each Zone you create may contain one or more Ads, as defined by the Rows and Cols parameters. The default is one row by one column which equates to placing a single Ad. In our sketch, I specified two ads to be placed in the content header zone, so I would indicate this by defining the zone to have a row value of one and a column value of two. Refer to our layout sketch and create each zone. Don't worry if you make a mistake. You can edit a zone to make the necessary changes.
- Zone ID
- This is an integer value you specify to identify this zone. This is the value you pass as the parameter from the function call. I'll describe the function call later. For now, just remember that the Zone ID is your numeric identification for this zone.
- Zone Name
- Enter a name for this zone.
- Description
- Enter a description for this zone.
- Number of Rows
- This value indicates the number of rows in which to place ads. The default value is 1.
- Number of Columns
- This value indicates the number of columns in which to place ads. The default value is 1.
- Ad Frequency
- The frequency defines the interval to elapse before displaying an ad. This parameter is intended to be used only where the post content is displayed, such as the single post page. The default value is 0.
- Default Ad URL
- This is the URL to the banner ad you want displayed when no qualified sponsor ad is available. This banner will link to your purchase page where sponsors may purchase ads on your site. No tracking is recorded for default ads.
After you are satisfied with your entries, click Save Changes. The Manage Ad Zones page is displayed with your new zone data.
To edit an ad zone, click the zone ID.
Tips
When defining a zone, make sure that you indicate in the zone name or description the intended use of this zone. For example, if you want to create a block of six ads, two rows by three columns, then mention that in the name or description fields, such as, sidebar-embed_1-2x3, sidebar-embed_2-3x3, etc.
When defining the number of rows and columns in which to place ads, you should know that the resulting display may not be what you expect due to your theme styles. You may need to modify the style in order to achieve the desired results. For example, if your sidebar is not wide enough to display three ad columns, the ads will wrap.
Tutorial: Manage Zones
In this tutorial, we'll create a zone for our Google ad, and a zone for our PSACentral ad. The zones we create are based on our theme sketch.
Start by clicking the Manage Zones option from the Ad Sponsors administration menu.
The Manage Ad Zones page is displayed. You should see an empty list.
Click the Add Zone button to display the Add Zone form.
| PSACentral | |
|---|---|
|
|
Review your entries. If your entries are correct, click Save Changes. The Manage Ad Zones page is displayed with each zone listed.
Repeat this process for the remaining zones outlined on our sketch.




Hello Jean-Marc,
I am already working on your feature request for the next release. Actually, I am not really happy with the way WP handles user names and passwords so I am creating an export function to pull a sponsor report that can later be emailed to individual sponsors. It is a little simpler than managing sponsor log ins.
I sent you an email.
Thank for your input!
Coyote
Hello,
This plugin looks dynomite! I had no problem installing and configuring it but for some reason the target url for each banner either defaults to the default setting or to the category landing page of the category I've selected that banner to display in. Anyone else experiencing this or have input as to what I may have configured incorrectly?
Thanks!
Mark
Hi Mark,
It sounds as if you have a minor config issue. I will be more than happy to help.
Do you have skype? If so, you can contact me at, coyotesdesigns. It would be much easier to check your configuration in an almost real-time chat vs. emailin' back and forth.
This plugin is unbelievably cool!
Question though... Is there way to delete a sponsors/banner/zones etc. in the admin interface? Seems this could get seriously out of hand after a few months.
Thanks, Coyote.
Hello flyboy,
Thanks! I appreciate your comments.
I did not code a delete function for two reasons, 1) It was not necessary for my needs, and 2) The relationships would cause a major headache for users. For example, deleting a sponsor would also require removing the associated program types, the associated banners, and any scheduled ads. I found it simpler for the user to edit an existing entry to include the desired data.
I do think that a delete function is viable. I am currently working on a reporting feature, which may necessitate an archival feature instead, or in addition to, a delete function. There are merits to both.
Please let me know if you have any questions.
Sincerely,
Coyote
Wow, plugin looks perfect but I receive an error when I try to create a sponsor. Have reinstalled twice and made sure all files are writable. Any ideas?
Hello candys,
If you will be so kind as to forward the exact error message to me, coyote [at] coyotesdesigns [dot] com, I will be more than happy to assist you.
[EDIT]
I have release version 1.2.4 to correct an error during new installs where the database tables were not created. I sincerely apologize for this oversight.
You can download the plug-in from the downloads page on this site, or from the WordPress plugins page.
[/EDIT]
Best regards,
Coyote
Thx, did the trick.
I've installed and activate this plugin but I can't add sponsors.
The following message is displayed after add sponsor:
"You do not have sufficient permissions to access this page."
What is the solution for this problem?
Thanks in advance.
Hi,
You should be logged in as administrator. What version of WP/PHP are you running? You can contact me on skype, coyotesdesigns, if you are still having difficulties and I will do my best to assist you.
~Coyote