=== Sponsor Ad Management === Contributors: wilecoyote Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=6922896 Tags: sponsor management,sponsor ad,ad management,advertising,sponsors,banner ad,banner ad management,wordpressmu Requires at least: 2.8.3 Tested up to: 2.8.6 Stable tag: 1.1.1 Manage sponsor ads within your WordPress/MU blog(s). == Description == * Author: [coyote](http://coyotesdesigns.com) * Overview: * User Guide: * Download: NOTE: The download from WordPress is incorrectly named. The download DOES contain the correctly named cd_ad_sponsor.zip file. Please extract cd_ad_sponsor.zip before uploading to your plugins folder. I wrote this plug-in to automate my sponsor ads on one of my blog networks where I have ~30 blogs, 109 sponsors, each sponsor has 9 program type combinations for each of their six or more sites; 109 * 9 * 6 = 5886 ads, / 30 blogs = 196.2 ads per blog. Doing this manually is a waste of time. I also wanted to track the performance of the sponsor ads, how many clicks to how many impressions. The cd_ad_sponsor Plug-in maintains a list of your sponsors (your clients), their associated Ads, including program types, revenue types, and scheduling, and the click-through and impressions resulting from the presentation of each AD. *** I cannot stress enough how important it is to read the User Guide BEFORE you attempt to use this plug-in. You can read the User Guide here, http://coyotesdesigns.com/sponsor-ad-user-guide/ *** 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. You sell Ads based on the zone and Revenue Type. Revenue Types are pre-defined as CPC (Cost Per Click), CPM (Cost Per Thousand impressions), or CPD (Cost Per Day). If you participate in a PPS, REV, or other Sponsor Program Type not based on user performance, use the Revenue Type, OPEN. 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. 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, it is recommended that you only define the minimum zones necessary to present your ads as desired within the current theme. 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 addition, you can define a frequency for a zone intended for embedding within post content. For Zones NOT intended to be embedded within a post should have the frequency set to zero (0). Only one Zone may have an Ad Frequency value greater than zero. Banner Ads represent the image- or script-based advertisement for a specific 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. Ad Schedules allow you to specify which Sponsor Ad is displayed at a particular location (or zone) within a specified time frame. Database entries for each ad are compared with the zone definitions to determine the appropriate banner ad to display. Once an ad has been presented, it will not be displayed again on the same page. If no sponsor ad is available for the specified zone, then a default ad (placeholder) is used. A placeholder type ad is defined for each of the pre-defined zones. The default link defined in the options menu directs the user to your ad purchase page. You will need to create this page, if necessary. The cd_ad_sponsor Plug-in does not track ad purchases. == Installation == Installation is straight-forward. 1. Download cd_ad_sponsor.zip to your local hard drive. 2. Extract the files. 3. FTP the cd_ad_sponsor files to your WP Plugins directory. (Single and MU versions) 5. Activate the plug-in through the 'Plugins' menu in WordPress. The plug-in documentation can be found at http://coyotesdesigns.com/sponsor-ad-management/ and the User Guide is available at http://coyotesdesigns.com/sponsor-ad-user-guide/ == Updates == Version 1.1.1 To update the cd_ad_sponsor plug-in: 1. Download cd_ad_sponsor.zip to your local hard drive. 2. Extract the cd_ad_sponsor.zip files. 3. FTP the cd_ad_sponsor files to your WP Plugins directory overwriting the existing files. Note: You are not required to de-activate then re-activate the cd_ad_sponsor plug-in. This update takes effect immediately upon successful upload. Version 1.1 To update the cd_ad_sponsor plug-in: 1. Download cd_ad_sponsor.zip to your local hard drive. 2. Extract the cd_ad_sponsor.zip files. 3. FTP the cd_ad_sponsor files to your WP Plugins directory overwriting the existing files. Note: You are not required to de-activate then re-activate the cd_ad_sponsor plug-in. This update takes effect immediately upon successful upload. == Changelog == = 1.1.1 = Nov 15, 2009 * Added JQuery expand/collapse feature to banner list, program list, and schedule list. The data listings are expanded by default. Click the Sponsor Name row to collapse or expand the data list as desired. = 1.1 = Nov 9, 2009 * Corrected typo in Banner Management that prevented correct revenue type from being displayed in Edit mode. * Updated queries in Schedule Management where multiple banners in some Program configurations were not being properly scheduled. * Updated query in program type AJAX request to display zone in Schedule Management dropdown options to assist with scheduling banner ads. * Updated Ad Impressions to count script-based Ads. * Updated UI in Schedule Management to display associated banner ad and corresponding zone. * Updated UI in Excluded IP to display host name for each IP. * Added option in Excluded IP Management to delete IP from excluded table. * Added option in Excluded IP Management to remove SE crawler counts from clickthrough table. * Added option in Default Options to enable removing SE crawler counts automatically. = 1.0 = Sep 2, 2009 * Initial release. No known issues. Currently running at CoyotesDesigns.com.