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.

Google PSACentral
  1. From the Sponsor Name dropdown field, select Google.
  2. In the Program Site field, type, Google.
  3. In the Program Name field, type, AdSense.
  4. In the Program Type field, type, PPC. This is a Pay Per Click program type.
  5. In the Description field, type the description you want that will hep you identify this program type.
  1. From the Sponsor Name dropdown field, select PSACentral.
  2. In the Program Site field, type, AdCouncil.
  3. In the Program Name field, type, Autism Awareness.
  4. In the Program Type field, type, REF. This is a referral program type.
  5. In the Description field, type the description you want that will help you identify this program type.

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&quot 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.

Google PSACentral

No new Revenue Type is required.


  1. In the Revenue ID field, type the Id you want to assign to this revenue type. In this case, we'll type, 6, since we have five predefined revenue types.
  2. In the Revenue Type Name field, type, PSA. This revenue type is a Public Service Ad, PSA.
  3. In the Description field, type the description you want that will help you identify this revenue type, such as Public Service Ad.
  4. [Version 1.2.1, 12-07-2009]
    In the Rate field, type the amount you want charge for this revenue type. Since this is a Public Service Ad, you can leave this field blank, or enter 0.

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.

Google PSACentral
  1. In the Zone ID field, type the Id you want to assign to this revenue type. In this case, we'll type, 5, since this is the zone we noted on our sketch for the second zone in the sidebar.
  2. In the Zone Name field, type the name of this zone. In this case, we'll type, Sidebar2-240x400.
  3. In the Description field, type the description you want that will help you identify this zone, such as Ad is displayed in Sidebar content.
  4. In the Number of Rows field, leave this entry set to 1. This means we want one row in this zone.
  5. In the Number of Columns field, leave this entry set to 1. This means we want one column in this zone.
  6. In the Ad Frequency field, leave this value set to 0. There is no insertion frequency for this zone type.
  7. In the Default Ad URL field, type the URL to the default ad that should be displayed if no qualified sponsor ad exists. In this case we'll use a default ad provided in the cd_ad_sponsor plug-in Image folder, %YourPluginURL%/images/cd240x400p.jpg (Replace %YourPluginURL% with the Plugins URL on your site. For example, http://yourdomain.com/wp-content/plugins/cd_ad_sponsor/images/cd240x400p.jpg)
  1. In the Zone ID field, type the Id you want to assign to this revenue type. In this case, we'll type, 1, since this is the zone we noted on our sketch for the zone in the page header.
  2. In the Zone Name field, type the name of this zone. In this case, we'll type, PageHeader-468x60.
  3. In the Description field, type the description you want that will help you identify this zone, such as, Ad is displayed in Page Header adjacent to logo.
  4. In the Number of Rows field, leave this entry set to 1. This means we want one row in this zone.
  5. In the Number of Columns field, leave this entry set to 1. This means we want one column in this zone.
  6. In the Ad Frequency field, leave this value set to 0. There is no insertion frequency for this zone type.
  7. In the Default Ad URL field, type the URL to the default ad that should be displayed if no qualified sponsor ad exists. In this case we'll use a default ad provided in the cd_ad_sponsor plug-in Image folder, %YourPluginURL%/images/cd468x60p.jpg (Replace %YourPluginURL% with the Plugins URL on your site. For example, http://yourdomain.com/wp-content/plugins/cd_ad_sponsor/images/cd468x60p.jpg)

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.



Pages: 1 2 3 4

21 Responses to “Sponsor Ad Management User Guide”

  • Coyote says:

    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

  • marcus says:

    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

  • Coyote says:

    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.

  • flyboy says:

    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.

  • Coyote says:

    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

  • candys says:

    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?

  • Coyote says:

    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

  • candys says:

    Thx, did the trick.

  • roefie says:

    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.

  • Coyote says:

    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


Popular Posts

Quote of the day plugin

The Quote Of The Day plug-in manages quotes displayed on your WordPress or WordPressµ

Sponsor Ad Management User Guide

The cd_ad_sponsor plug-in was written to manage the sponsor ads that can be presented with

A WordPress Sponsor Ad Management Plug-In

I wrote the WordPress Sponsor Ad Management Plug-in to use within the WordPress and WordPr

Quote Of The Day
Finding the occasional straw of truth awash in a great ocean of confusion and bamboozle requires intelligence, vigilance, dedication and courage. But if we don't practice these tough habits of thought, we cannot hope to solve the truly serious problems that face us -- and we risk becoming a nation of suckers, up for grabs by the next charlatan who comes along.
~Carl Sagan