to View the User Manual
Contents
1. 4 Browse to the zip file containing the module forexample BannerAdvertisers_06 00 01_PA zip or BannerAdvertisers_06 00 01_Enterprise_PA zip 5 Ad Banner Manager 6 0 User Manual 5 Click the Install New Module hyperlink 6 Now repeat this process for the second module Now your modules are available to place on any page you want Generally you place an instance of the BannerAdvertisers on a single page and you place the BannerDisplay module in multiple places where you want banners to appear If you have multiple child portals it is possible to manage all your advertiser accounts on the main portal and allow the banners to be displayed on any or all child portals After you have installed your modules the first thing you will need to dois configure the BannerAdvertisers module Click the drop down menu for the module and click Edit This will bring you to the Edit page In order to prepare your module for use you must enter an email address under Contact Email Address this address will be the reply to address used by automated emails If you want to place instances of the BannerAdvertisers module on more than one portal in the same Host if you have configured child portals you can opt to check the Share Settings box This means that each module will use these same settings so that you don t have to reconfigure them for every place you have put the module This is especially useful if you want to modify the2. embedded in the URL a Session value or a Cookie When an Advertiser uploads a banner they can specify the value of the parameter to match on Tutorial Targeting Banner Ads by County Suppose you have a page on your site that places the name of a county in the URL For instance your URL might look something like this http www yoursite com somepage tabid 76 Default aspx county boise In this case you have a querystring with a name of county and a value of boise Using the Custom Parameters feature it is possible to allow Advertisers to specify a county name foreach banner and then display only banners that match the current county 1 In the Advertisers module click the Edit menu item or hyperlink to open the Advertisers Settings page 2 Check the Enable Custom Parameters check box 3 In the Caption text box type County Name 23 Ad Banner Manager 6 0 User Manual 4 Optional In the Custom Parameter Values setting enter a list of county names The names are entered one at atime by typing a name into the text box and clicking the Add Value button This will allow Advertisers to select the county name from alist rather than typing the name into a text box If you would rather allow Advertisers to type in the county name then skip this step 5 Choose a campaign and create a new banner You will now see an extra field in the form with the caption County Name and either a t
3. Ad Banner Manager 6 0 User Manual SMOKE RANCH DotNetNuke Modules Ad Banner Manager 6 0 User Manual Ad Banner Manager 6 0 User Manual EPO ele 5 Installation ANd confieuraton rrreceisrrrrc rt iiti tii itiiti OEEC EEA EENE E aii 5 Upgrading from Version 5 1 Or kaler 6 Changes tn Behavior cerca c sss fees cess crews sees E E N ieee ee reese 7 Whatis New SIno Tage ccvieciccedesaecvavacancesoutansuayapdesetacuen A re ved agdacebecsdeckedeeedsesevane 7 OVE NIEN eege 8 Creating Advertisers and Campaigns Typical Approach 8 Koap paler IER e See E oi ce Uda Sadao as 9 Approaches to Displaying and Targeting Banners 9 GROUPS ee See e SEE SA cies See cain ENEE ee Eed SE 10 Event Records erika Ee 11 Consolidating RECO S arien iea Er eres rare A 12 Consolidating Records Using the Web Interface 12 Consolidating Records Using SQL Server Management Studio 12 Automating Record Consolidation cccccccsesecceseeseeececeeeeceseseeceseeeesessaneeeeesaaaeeeegaaes 13 Deleting Records Using the Web Interface 13 Deleting Records Using SQL Server Management Studio 14 Common EE 14 Create an Advertiser ACCOUNT rener en renen ener ener SERA edd 14 Create a NEW cam Pal gN secsiccssscus Sae EA RER araa saveasesaasadavecavens so stseagtsssteies 15 Add image based banners to acampalgn 17 Add existing banners to acampalgn 17 Add Flash banne iSeries EEEE EEE AEAEE adaseccenadevacgadavevene 18 2 Ad Banner Manager 6 0 User M
4. e The banner Type size of the banner is not the same as the Type that was selected in the banner module e The campaign uses a date range and the starting date has not been reached 29 Ad Banner Manager 6 0 User Manual e The campaign has expired My Display module is set to show 2 or more banners but only 1 shows up Why Remember that one of the features of the module is that it is guaranteed not to show 2 banners from the same advertiser at the same time within a single display module So if your display module is set to show X banners you must have at least X advertisers each with an active campaign My Banner Activity Report does not show the correct number of clicks Remember that if Flash or Text banners are created without specifying a target URL then the clicks for these banners will not be tracked The hyperlink for adding Flash and Text banners does not appear It is possible to disable the ability to add Flash and Text based banners to campaigns that are based on the number of clicks To always allow these banners check the box that says Allow Flash and Text banners in all campaigns on the Edit page Tech Support Smoke Ranch Software offers free email tech support for all modules If have a tech support issue please send email to support smokeranch com Alternatively if you purchased the module from Snowcovered you can open a Help Desk ticket Feedback Contact Us For feature requests custom
5. email text Note that if you are only using the BannerAdvertisers on a single portal then this checkbox has no real effect Upgrading from Version 5 1 or Earlier Before upgrading this module on a live web server it is strongly recommended that you backup your existing database and that you write down exactly which versions of the modules you have installed Version 6 0 adds table indexes to the WT BM Events table forimproved performance of reports When installing the module on a site which contains large numbers of records in the events table it is possible that the database script could time out If your indexes fail to create successfully you can add them manually using the SQL Server Management Studio Simply execute the following SQL commands CREATE NONCLUSTERED INDEX IDX WT BM EVENTS EVENTDATE ON WT BM Events EventDate ASC GO CREATE NONCLUSTERED INDEX IDX WT BM EVENTS CAMPAIGNID ON WT BM Events Campaignid ASC Ad Banner Manager 6 0 User Manual Note that if you created your site with a custom object prefix then you will need to prefix the table name in the script above accordingly Changes in Behavior Default behavior has changed in the BannerDisplay module This behavior is governed by some new settings Max Rotations Now by default AJAX banner rotations are limited to 50 rotations for a single page view This is to prevent a single user from generating thousands of banner impressions by leaving their browser o
6. banners Portal administrators place this module wherever they would like one or more banners to be displayed The module is geared toward web site administrators who wish to centrally manage ad campaigns and banner placement but enable advertisers to upload and manage their own banner images Installation and configuration This version supports DNN 4 3 and greater induding DNN 5x Itis not compatible with DNN 3x If you have version 4 0 of the banner modules for DNN 4x you can safely upgrade to this version by installing over the top don t uninstall first if you wish to keep your data intact However it is strongly recommended that you backup your database before upgrading this module or any module on a live web server If you received this module in a single zip file you must first extract the 2 zip files contained therein which contain the 2 modules The two modules are installed separately just like any other modules To install a module follow these steps note that these instructions reference DotNetNuke 4 8 4 depending on your version the details may differ slightly Also if you are planning on displaying large amounts of banners millions of impressions you may want to enable the automated record consolidation after your install see section on Event Records 1 Login as Host 2 Goto Host gt Module Definitions 3 Choose Install New Module from the drop down menu click the down arrow in the upper left
7. of the module in pixels It is recommended to set these values when enabling AJAX rotation in order to keep the page from jumping whenever the banner display is refreshed Note that it may be enough to only set one value and leave the other at 0 If you are not using AJAX rotation then leave these values at 0 No conflict checkbox only change this value if you are having compatibility issues with another module on your page 6 Set Advanced options 21 Display one banner per advertiser if this box is checked then this instance of the module will only display a single ad banner from a given Advertiser at a time For instance if you only have a single advertiserin your system then checking this box will restrict the module from displaying more than a single banner at once Open links in new window check this box to allow image based banners to open in a new browser window when clicked Disable JavaScript embedding by default JavaScriptis used to embed Flash and Text based banners on the page However you can disable it here by checking a box Custom Parameter Name if your site contains querystring session or cookie values that you would like to use to filter banners then you can configure it here See the discussion on Custom Parameters elsewhere in this guide SQL Deluxe index thisis similar to the Custom Parameter Name but specifies the module to retrieve the parameter value from a SQL Deluxe report
8. that advertisers see when they login Click the Add New Campaign link Enter a title and select one of the three available models a Fixed campaign will run from starting to ending date with no restriction on the number of clicks or impressions b Number of impressions campaign will run until the specified number of impressions has been reached or until the ending date has been reached whichever comes first If no date range is specified then the campaign will start immediately and run until the impressions count has been reached c Number of clicks campaign will run until the specified number of clicks has been reached or until the ending date has been reached whichever comes first If no date range is specified then the campaign will startimmediately and run until the clicks count has been reached Select a campaign type a Generic banner ads from these campaigns will be displayed on pages that have been specified to pull ads from the general pool Each advertiser can only have one active Generic campaign at a time 15 Ad Banner Manager 6 0 User Manual b Targeted banner ads from targeted campaigns will only be displayed on pages that have been configured to pull ads from this specific campaign 6 Assign to a group optional Here you can assign the campaign to one or more Campaign Groups if desired 7 Choose portals a All portals this campaign will be available to all portals in this i
9. to be specified as an attribute in the HTML here is the place where you can add it If you entered the URL in the previous step because your ad banner supports the clickTAG variable then you do not need to make any modifications just click Next Preview Finish This step allows you to see what your banner will look like when displayed by the Banner Display module If you want to make a change click the Back hyperlink Otherwise clicking the Finish hyperlink will add this banner to the campaign Support click through counts in Flash banners If you want to use Flash based ad banners and you want the module to track clicks on your banner then your banners must implement the clickTAG variable You can find more information here http www adobe com resources richmedia tracking designers_guide When the BannerDisplay module renders the banner the target URL will be passed as the value of the clickTAG variable The Flash object should redirect the user to the URL that is passed To test whether your Flash banner implements this variable correctly simply add a new banner using the Flash Banner Wizard and in the Preview step you should be able to click the banner and be redirected to the target URL Approve banners 1 Login as a user with Edit access to the BannerAdvertisers module 2 From the Directory page click the Review Banners link Note that if there are banners to be approved this link will be bold and will displ
10. In the Advertiser Settings page click Edit in the BannerAdvertisers module context menu make sure the Enable PayPal integration box is checked and that you have entered your PayPal account email address in the text box provided 2 Select the type of currency your amounts will be specified in 3 If you are testing your site leave the PayPal sandbox mode box checked otherwise uncheck it 24 Ad Banner Manager 6 0 User Manual 4 When creating a new campaign enter a value greater than Oin the Amount Due box Be sure that the Approve this campaign box is NOT checked before you click the Create link Now when an advertiser visits your site to approve a campaign clicking the link on the site will redirect them to PayPal s site in order to submit payment Once they have completed this process they will be redirected back to your site Note that it may take a few minutes for the campaign to be updated while it waits for PayPal to submit the payment notification to your site Once the notification happens the campaignis marked as approved Testing PayPal Integration By default the module will have PayPal sandbox mode enabled which can be changed on the Edit page Sandbox mode will allow you to test out the round trip process of submitting and receiving payments In order to do this you must setup a developer account at https developer paypal com which in turn will allow you to create dummy seller and buyer accounts to use in y
11. Instant Payment Notification for more information In this situation you must manually set the campaign status to Approved The rest of the checkout process should work 25 Ad Banner Manager 6 0 User Manual fine the user will still be redirected to PayPal to submit payment and redirected back to your site Advertisers Settings To access the Advertiser Settings page dick the Edit menu itemin the module s drop down context menu Alternatively you can click on the Edit hyperlink at the bottom of the module note that this link may not show upif you are using certain module containers Share Settings This setting only applies if you are using a single DotNetNuke installation to host multiple portals and you want to have a separate instance of the module on each portal but you don t want to manage the settings such as custom email text separately Note that you don t need to install an instance of the Advertiser module on each portal in order to display banners on that portal Contact Email Address Emails sent using the Contact Us form will be sent to this address In addition automated emails sent by the module such as when a new campaign is created or a banner is rejected use this address as the from address Required Role This is the DNN Security Role that must be granted to a user account in order to be able to tie the account to an Advertiser account Max Banner File Size This is the maximum allowed
12. all the slots c Cell padding this property affects the padding of each cell in the table Since each banner image is displayed in its own cell setting this property will affect the padding around each banner 4 Select the display source a Generic banners will be randomly pulled from all active Generic campaigns in the system b Targeted banners will be pulled ONLY from the campaigns listed in the left list box To add campaigns select from the right list box and click the left arrow button This setting allows a page to be sponsored by a spedfic advertiser or group of advertisers Note that this list only contains campaigns that were created as Targeted campaigns Generic campaigns cannot be selected here c Advertiser groups banners will be pulled from all active Generic campaigns but only from Advertisers who have been assigned to the groups specified in the left list box To add groups select them from the list box on the right 20 Ad Banner Manager 6 0 User Manual d Campaign groups banners will be pulled only from active Targeted campaigns that belong to groups spedfied in the left list box To add groups select them from the list box on the right 5 Specify AJAX settings Display Interval this is the number of seconds to display a banner before the banner display list is refreshed Leave at this value at 0 to disable AJAX rotation Display Height and Width thisis the height and width
13. anual Support click through counts in Flash banners 19 AD PIOVE El EE 19 Place a banner on a portal page 20 Delete a banner and image est Zeene eege ee EEN Seed 22 Delete an advertiser account 22 View and Email Repor Soe kainanan giereg de Keeeed eege ease eg er Eeeeg Reese eg ee 23 Custom Parameters Target Banners by Matching Querystring Session or Cookie Values 23 Tutorial Targeting Banner Ads by Coupnty Targeting via Session or Cookievalues PayPal Integration Enterprise Editon 24 Testing PayPal Integration 25 Instant Payment Notficat on 25 Testing Localhost SME aaa eek ceca veceecalss eaece ded Ae REESEN 25 Advertisers SEIN EEN 26 Share SENES eege ae a N AEE OERA Tove boa ss oe see ee 26 Contact Emal Address uge Eeer kees vevsdevshch eave ee ee 26 Require d ROlesaisteccesiseceezat rele rese ase ee 26 Max Banner File SZE see aa a ENER en e 26 New Account Email Sek eroien e a EOE OEA EONO N 26 New Account Email TEXT eech seed ae A E AE AEEA a TA E ees 26 New Campaign Email Subject ccccccccccsseseeceeceeeececeseecesaesceeeseseeeeeassceessseeeeaanees 26 New Campaign Email TEN eee areena E NEENA NiE NENEN EE EAE 27 Updated Campaign Email Sublect 27 Updated Campaign Email Textevccccccccshcec Eessen 27 3 Ad Banner Manager 6 0 User Manual Banner Rejected Email Sublect 27 Banner Rejected Email Text 27 Enable Custom Parameters ege eein eege egie ee Eeer ES SSES eeh d Ze Een 27 Custom Parame
14. ask in the DNN Scheduler These options are explained in the following sections Consolidating Records As of version 6 0 the default behavior is to write event recordsin a consolidated format As such there is no need to manually consolidate records unless you either uncheck the Consolidate event records box in the BannerDisplay module or you are upgrading from a previous version and you already have a large number of records in your database To see how many records are currently in your database click the Reports link in the BannerAdvertisers module and click Manage Records There are three ways to consolidate the event records 1 Consolidate using the web interface 2 Manually execute the stored procedure using SQL Server Management Studio 3 Automate the consolidation of the previous day s records using the DNN scheduler Consolidating Records Using the Web Interface To consolidate event records using the web interface in the module follow these steps 1 In the BannerAdvertisers module click the Reports link 2 Click the Manage Records link 3 Enter the number of days and click the Consolidate Records Now link For example if you want to consolidate all the records for the previous 30 days enter 30 in the box provided If you have a great deal of records in the database or if your database is under heavy load then the consolidation operation may time out If thisis the case you will need to execute the consolidation
15. ay modules on the front page to only display banners from that group 3 Use Campaign Groups Using Campaign Groups is a great choice if you want to target banners based on campaigns rather than Advertisers Campaign Groups can also reduce administrative overhead when using Targeted Campaigns For instance suppose you want to target specific campaigns to specific sets of pages but you don t want to have to visit each page and update the BannerDisplay module configuration every time you create a new Targeted campaign The solution is to create groups and configure the BannerDisplay modules a single time From then on it is just a matter of adding new campaigns to the appropriate group 4 Use Targeted Campaigns Directly The ultimate in flexibility is achieved by creating Targeted campaigns and then selecting those campaigns where desired in the various BannerDisplay modules Even if you use groups you may decide to use this approach in select cases For example if you wanted to offer a special banner placement of a specific banner in a specific place you can assign the Targeted Campaign to the module directly rather than having to create a Campaign Group for it Groups Groups provide a convenient method to target groups of either Advertisers or individual campaigns and can reduce the administrative overhead of adding additional Advertisers and campaigns One use of groups is to create zones in your site Forinstance some sites cr
16. ay the number of banners waiting for approval 3 The Review Banners page will display up to five banners at a time displayedin order of date created If there are more than five banners you must approve or reject currently displayed banners and additional unapproved banners will take their place on the page 4 Multiple banners can be approved at once by selecting the corresponding checkboxes and clicking the Approve Selected link at the bottom of the page Banners must be rejected one at atime however by clicking the Reject hyperlink next to the image 19 Ad Banner Manager 6 0 User Manual 5 If you reject a banner you will be given an opportunity to enter comments which will then be emailed to the Marketing contact of the advertiser The banner is then immediately deleted from the system Place a banner on a portal page 1 Place the BannerDisplay module in the desired location on your portal 2 Click the Edit link on the module 3 Select banner size and layout properties a Banner Type this specifies the size of banners that will be displayed by this module b Rows and Columns this specifies the table layout that will be used to display the banners The number of banners displayed is equal to the number of rows multiplied by number of columns For example 2 rows and 3 columns will create a display of 6 banners Note that fewer banners may be displayed if there are not enough banners in the pool tofill
17. development requests or general questions send email to info smokeranch com If you like our modules please consider giving them a positive review in the store where you purchased them Thanks 30
18. e called Advertisers Note that the name of this role can be altered in the Advertiser Edit page You can create new roles on the Admin gt Security Roles page 2 Create a portal user and assign them to the Advertisers role You can create new users on the Admin gt User Accounts page 3 Forthe remaining steps you do not have to be logged in as an Administrator However you do have to have Edit access to the BannerAdvertisers module 4 Goto the Advertisers Directory and click the New Advertiser Link 5 Select the name of the user you created in step 2 from the User account dropdown list 14 Ad Banner Manager 6 0 User Manual Enter the contact information If the Marketing and Technical contacts are the same person check the Use Marketing contact info checkbox Emails sent from the system will be sent to the Marketing contact Click the Update link An email will be sent to the Marketing contact indicating that the account was created At that time the advertiser can log into the portal to view their account information To edit the information later locate the advertiser in the directory and click the Edit icon next to the company name Create a new campaign 1 5 Go to the Advertisers directory and locate the advertiser by using the alphabetical links or by clicking the Search link Once the advertiseris found click the Company name link to go to the Advertiser Profile page This page is also the page
19. eate zones based on page placement a PageTop zone and a PageBottom zone Another option is to divide the site based on high traffic pages or by topical area The key advantage of groups is that once you create your groups and assign them to your BannerDisplay modules you never have to visit your display modules again This is a big deal if you have 50 pages on your site each with multiple BannerDisplay module instances Once this initial configuration is done all that is left is to add each new Advertiser or campaign to the appropriate group s 10 Ad Banner Manager 6 0 User Manual Advertiser Groups Advertiser Groups can contain one or more Advertisers The banner pool for an Advertiser Group consists of all the Generic campaigns from each Advertiser in the group Campaign Groups Only Targeted campaigns can be added to a Campaign Group The banner pool for a Campaign Group consists of all the campaignsin the group Event Records By default when a banner is displayed or clicked on two things happen 1 The corresponding campaign statistics are updated Each campaign maintains a running total of impressions and clicks and these numbers get incremented 2 An event record is either created or updated Event records are storedin the WT BM Events table The purpose of these records is to allow for date range based reporting How event records are created in step 2 above depends on two settings on the Edit page of the BannerDisp
20. ext box or a drop down list Type or select boise Normally this step would be done by the Advertiser unless you are centrally managing all ads yourself Remember to approve the bannerif necessary 6 Go to the page where you want to display the banner ads and place a new BannerDisplay instance Configure the module as necessary so that your new banner will show up 7 Inthe BannerDisplay Edit page go to the Advanced Options section and type county without the quotes into the Custom Parameter name text box 8 Check the box that says If the custom parameters is not present or is empty then DO NOT display any banners Now when you visit the page no banners should display unless the querystring county boise appears in the URL Targeting via Session or Cookie values If the value to matchis to be pulled from the session or from a cookie check the Session or Cookie radio button from the Advanced Options section in the Edit Banners page Another option is to select the All option In this case the module will first look for a querystring If it does not find a value then it will look in the session and finally in the cookie PayPal Integration Enterprise Edition PayPal integration allows you as the administrator to set a price for a given campaign and require advertisers to submit paymentin order to approve the campaign In order to accept PayPal payments follow these steps 1
21. file size for uploaded images New Account Email Subject This is the subject text of the automated email that is sent when a new Advertiser account is created Note that you can prevent the email from being sent if you uncheck the Send Email Notification checkbox when creating the Advertiser account New Account Email Text This is the body text of the email that is sent when a new Advertiser account is created Refer to the embedded help text on the page to see the list of placeholders that can be induded in the text Simply copy and paste the placeholder text and it will be replaced automatically when the email is sent New Campaign Email Subject This is the subject text of the automated email that is sent when a new campaign is created Note that you can prevent the email from being sent if you uncheck the Send Email Notification checkbox when creating a new campaign 26 Ad Banner Manager 6 0 User Manual New Campaign Email Text This is the body text of the email that is sent when a new campaign is created Refer to the embedded help text on the page to see the list of placeholders that can be induded in the text Simply copy and paste the placeholder text andit will be replaced automatically when the email is sent Updated Campaign Email Subject This is the subject text of the automated email that is sent when a campaign is updated Note that you can prevent the email from being sent if you uncheck the Send Email No
22. for 2009 then attempt to run a report showing impressions for only December of 2009 the impression count will be O 13 Ad Banner Manager 6 0 User Manual Deleting records also affects the counts for individual banners as these counts are calculated by scanning the event records However the operation of your campaigns will not be affected since campaigns that are governed by impression or click counts always use the running totals and do not scan for event records To delete records follow these instructions 1 Login as a Host user 2 Go to the BannerAdvertisers module and click the Reports link 3 Click Manage Records link 4 Enter a date and click the Delete Records Now link Note that if you have avery large number of records then this operation may time out If this happens you will need to delete records manually using SQL Server Management Studio Deleting Records Using SQL Server Management Studio All event records are stored in the WT_BM_Events table Note that if you specified a custom object prefix then you will need to prefix the name of the table accordingly To delete records older than a certain date execute SQL such as the following delete from WI_BM Events where EventDate lt 1 1 2010 Note that this operation may take a fair amount of time if you have a very large number of records Common Tasks Create an Advertiser Account 1 Log into the portal as an Administrator and create a rol
23. hing here However if you want Advertisers to select the parameter value from a drop down list then enter the values for that list here For more information refer to the section on Custom Parameters earlierin this guide PayPal Integration Settings Enterprise Edition To enable PayPal integration check the Enable PayPal integration box and enter your PayPal account email address in the box provided For more information see the PayPal Integration section in this document 27 Ad Banner Manager 6 0 User Manual Additional Settings The Advertiser Settings page contains several additional settings represented by check boxes which can be enabled or disabled By toggling these settings you can control the following e Whether banners need to be approved e Whether individual banners can be restricted by user role Enterprise Edition e Whether campaigns can be targeted to specific portals e Whether Flash and Text banners can be included in all campaigns or are restricted to campaigns that do not rely on click through counts as their completion criteria e The default setting for sending email notifications for new or updated campaigns Refer to the embedded help text for more information on these settings BannerDisplay Settings These settings are accessed by clicking the Edit itemin the context menu of the BannerDisplay menu Size and Layout The Banner Type determines which size of banners will be displayed in this module whi
24. ided check box options Advanced Options Display only one banner per advertiser if you want to display multiple banners simultaneously from a single Advertiser you ll need to uncheck this box Open links in a new window this setting applies to image based and custom HTML banners Script based and Flash banners are not affected by this setting Do not use JavaScript to embed Flash and Text based banners this is a legacy setting and most users will likely always want this box to be checked Cache base URL it is recommended to leave this box checked unless your site switches between http and https connections or for other situations that may affect the base address of the page Insert event records and Consolidate event records see section on Event Records for more information on these settings Custom Parameter settings see section on Custom Parameters earlierin this document Banner Directory this setting is only requiredin rare circumstances 3rd party script Cut and paste this script into any location which you want banners to appear even external sites It is also possible to paste this script into instances of the Text HTML module which may be desirable if you want to display banners on multiple pages but only manage one BannerDisplay module instance Troubleshooting Why won t my banner show up There are several reasons why a banner may not be showing upin a banner module e The banner has not been approved
25. igns Banners placed in a Targeted campaign will never be displayed unless a BannerDisplay module is specifically configured to pull from that specific campaign Targeted campaigns can also be assigned to Campaign Groups whichin turn can be selected in BannerDisplay module instances see discussion on Campaign Groups for more details Approaches to Displaying and Targeting Banners The Ad Banner Manager offers many ways to display and target banner ads The following approaches are presented in order of increasing flexibility and complexity Of course these approaches are not mutually exclusive you can use them in any combination 1 Use Generic Campaigns The simplest approach to using the Ad Banner Manager is to use only Generic Campaigns and then place BannerDisplay module instances wherever desired with the only configuration options that differ between display modules being the banner type size and count This way Ad Banner Manager 6 0 User Manual every banner that is added to a campaign can randomly show up anywhere that size of banner is being shown 2 Use Advertiser Groups If you want the simplidty of using Generic campaigns but you want to target banners based on Advertiser you can use Advertiser Groups For instance suppose you wanted to only display banners from certain Advertisers on the front page In this case you could create an Advertiser Group named Front Page Advertisers and configure the BannerDispl
26. ity to view number of event records and consolidate them directly from the user interface e Option to disable event record generation for high traffic sites that do not need date range based reports e Added event record indexing for improved performance of reports e Improved UI for campaign lists 7 Ad Banner Manager 6 0 User Manual e List boxes now support multiple selection by holding Shift or Ctrl keys e Added new Copy Campaign feature as a replacement for Replace Campaign feature e Advertiser accounts can now be created without requiring a DNN user account although a DNN user account is necessary for advertisers to approve campaigns and manage their own banners e Added Max Rotations setting to optionally limit the number of banner rotations fora single page view e BannerDisplay module now embeds script tags in page header e Ability to display all banner types sizes togetherin a single BannerDisplay module Overview This section is designed to help you understand the available functionality of the Ad Banner Manager at a high level For step by step instructions refer to the various entries in the Common Tasks section Creating Advertisers and Campaigns Typical Approach The Ad Banner Manager allows administrators to create and manage campaigns and place banners while allowing Advertisers to upload their own banners and view their statistics A typical workflow looks like the following Create DotNetNu
27. ke user account to assodate with an Advertiser Create a DotNetNuke security role named Advertisers user account createdin Step 1 An automated email will be sent to the Advertiser Using the Advertisers module create a new Advertiser account assodate with the DNN Ad Banner Manager 6 0 User Manual Advertiser uploads banner images Administrator places instances of the BannerDisplay module on the pages where they would like banners to appear Step 7 Administrator approves uploaded banners Le Of course itis also possible for administrators to manage and upload banners themselves without requiring explidt involvement of Advertisers For instance administrators can approve campaigns and upload banners for any advertiser and can also configure the module so that banners do not need to be approved In this case steps 1 and 2 above are nolonger necessary as the Advertiser account nolonger requires an associated DNN user account Campaign Types When creating individual campaigns you can select one of two Campaign Types Generic or Targeted Generic Campaigns Banners placed in these campaigns are placed in the global pool of banners BannerDisplay modules that are configured to pull from Generic campaigns pull randomly from the pool of all Generic campaigns These campaigns also provide the banners displayed when using Advertiser Groups see discussion on Advertiser Groups for more details Targeted Campa
28. lay module under Advanced Options Insert event records Setting If this box is not checked then no event records are created This means that you will not be able to view reports based on date ranges however the running totals of impressions and clicks are still stored for each campaign This option is provided for web sites for which performance is a top priority and date range based reporting is less important Consolidate event records Setting If this box is not checked a separate event record is generated for every impression or click So if agiven banner is displayed 100 times then 100 event records will be generated and stored If however the box is checked then records will be consolidated on a per day basis for each module instance For example if a given BannerDisplay instance displays a certain banner 50 times on Monday and then 50 times on Tuesday only 2 records would be generated each record would have an occurrence value of 50 to maintain the correct count Writing record in a consolidated fashion reduces the total number of records and may significantly reduce the size of your database if you have a busy site However it may slightly reduce performance Another optionis to turn off record consolidation uncheck the box and perform mass consolidations later either manually through the user interface manually using 11 Ad Banner Manager 6 0 User Manual SQL Server Management Studio or by setting up the provided t
29. le the remaining settings in this section affect the HTML table that is generated to contain the banners The maximum number of banners displayed is determined by multiplying rows and columns For example setting rows to 2 and columns to 3 would display up to 6 banners Display Source These settings determine which campaigns to pull banners from AJAX Banner Rotation If the Display Interval is set to a value greater than 0 AJAX rotation will be enabled Note that the lower this number the more banners will be displayed Note that AJAX rotation increases the load on your site especially the database If you have a very busy site you may wish to disable rotation or set the interval to larger values The Max Rotations setting prevents large numbers of impressions from being generated ina single page view forexample if a user leaves their browser open overnight Setting this value to 0 will allow unlimited rotations If you have trouble with your page jumping during rotation you may need to set the Display Height and or Width Set these values to allow for the maximum space required for the banners that will be displayed 28 Ad Banner Manager 6 0 User Manual DNN 4x only Because AJAX rotation relies on JavaScript there is the possibility of conflicts with other modules If you experience conflicts you may wish to try enabling the no conflict option for jQuery or preventing the module from loading jQuery altogether using the prov
30. leted all banners images and campaigns must first be deleted If the advertiser account contains banners or images but no campaigns then a campaign must be created temporarily to provide access to the Campaign Details page The following steps detail this process 2 Select any arbitrary campaign 3 Remove all banners from the campaign by clicking the Remove link next to each banner 4 Delete all banners from the list under Add an existing banner For more information see Delete a banner and image in this document 5 Delete all internal images from the list under Add a new banner 22 Ad Banner Manager 6 0 User Manual 6 Click the Delete this campaign link at the top of the page Delete all other campaigns in like manner 7 Go back to the Directory and locate the Advertiser accountin the directory Click the Edit icon next to the company name 8 Click the Delete button at the bottom of the page View and Email Reports 1 Goto the Advertiser Directory and click the Reports link 2 Choose parameters and view report 3 To email report enter email address in the textbox at the bottom and click the Email this Report button Custom Parameters Target Banners by Matching Querystring Session or Cookie Values The Custom Parameters feature allows the Banner Display module to search for banners that match a parameter value supplied by the site This value could come from a querystring
31. nstallation b This portal only this campaign will only be visible in the current portal c Only selected portals this option allows you to specify which exact portals the campaign will be available to 8 Choose roles optional Enterprise Edition only Here you can restrict the campaign to only be visible to users with the specified DNN security roles a All Users leave this selected to allow all users to view banners from this campaign b Selected roles this option allows you to select the list of roles that will be able to view banners from this campaign This would restrict the visibility of the banners to users who are both logged in and have been assigned at least one of the specified roles 9 Select Display Options a Frequency Here you can set the relative frequency with which banners from this campaign are displayed If all campaigns are set to the same Frequency then banner selection is purely random within the given parameters of the BannerDisplay module settings of course Tip If you want to temporarily disable a campaign you can do so by simply changing the Frequency to Never b Position This is the position within a given BannerDisplay module Banners are ordered from left to right top to bottom If all campaigns are set to the same position then banners are ordered randomly Note that there will never be gaps in the banner display 10 Click the Create link If the Approve thi
32. of your banner The title will be used to identify your banner ad in the drop down list of existing banners which you will use if you want to add this banner to a new campaign in the future Due to the nature of Flash technology the module is unable to automatically detect the height and width of your ad The size of a standard banner ad is 468x60 If you do not know what the size of your banner is supposed to be you can inspect the HTML that accompanies your banner if you purchased the banner from a third party they should have provided this HTML along with the swf file Don t worry you will get an opportunity to preview the banner before adding it to your campaign If it does not look correct you can click the Back hyperlinks and come back to this step to modify the numbers Entering the URL If your Flash banner supports the industry standard clickTAG variable then enter the target URL in the box provided for instance if you want the banner to point to yoursite com then enter http www yoursite com This will allow click through counts to be recorded If your ad does not support the clickTAG variable then entering a URL will have no effect Step 3 18 Ad Banner Manager 6 0 User Manual This step allows you to make any modifications to the HTML that you require For most banners you won t need to do anything here However if your banner ad requires the navigation URL the URL that the banner launches when clicked
33. our testing For more information refer to the documentation on PayPal s site Instant Payment Notification The module s PayPal integration uses a feature called Instant Payment Notification IPN This means that once a buyer has submitted a payment the PayPal site makes a direct HTTP call to your DNN site to notify it that the payment has been made This means that your site must be publicly accessible via the Internet in order for this process to happen If your site uses an address such as localhost or a machine name that it not directly accessible from the PayPal servers then you will not receive the notification The IPN usually happens quickly but due to the nature of the Internet delays can occur If the IPNis not successfully made PayPal will retry at various intervals At the time of this writing PayPal indicates that failed IPN messages will be resent for up to four days after the original message For more information refer to the documentation on PayPal s web site https cms paypal com us cgi bin cmd _render content amp content_ID developer e_howto_admin_IPNintro You can view the list of payment notifications for a specific campaign by navigating to a campaign and clicking the Transactions link The Testing a Localhost Site If your test site is using localhost or a machine name or is otherwise inaccessible from the Intemet then campaigns will not be automatically approved after payment is submitted see section above on
34. parameter SQL Deluxe is another module offered by Smoke Ranch Software that provides the capability of writing interactive reports Ad Banner Manager 6 0 User Manual f 3 party script this option is provided to allow banners to be displayed outside of your DNN portal or inside your DNN portal using the Text HTML module if you wish Simply cut and paste this text anywhere you want to display banners The banners will be displayed according to the settings you have configured for this module such as banner type number of banners etc 7 Click the Update link If you are expecting to see the banner and it does not show up please see the Troubleshooting section in this document Delete a banner and image 1 Goto the Advertiser Profile page and dick on a campaign 2 Under the Add an existing banner section there is a dropdown list Note that only banners which are not part of the current campaign will show up in this list 3 Select the banner from the list and click the Delete Banner link If the banner is used by other campaigns it will be removed from those campaigns prior to being deleted 4 Now that the banner has been deleted you may wish to delete the image itself if it is an internal image To do this select the image from the Internal drop down list under the Add a new banner section 5 Click the Delete Image link Delete an advertiser account 1 Before an advertiser may be de
35. pen on a page that contains rotating banners If you want to maintain the old behavior unlimited rotations you will need to set this setting to 0 Note that this is a portal wide setting so you will only need to set itin a single BannerDisplay module instance Consolidate Event Records In the past each impression or click of a banner caused a single new record to be inserted into the events table Now by default records are writtenina consolidated fashion meaning that a single record can account for multiple impressions or clicks of a specific banner This may have a slight performance impact so the option exists to return to the previous method of inserting individual records by unchecking this box If you decide to turn off event record consolidation you may wish to enable the consolidation task in the DNN Scheduler See the Automating Record Consolidation section in this document What is New Since 5 1 The following section briefly lists the primary features and enhancements that were introduced since 5 1 BannerAdvertisers 5 01 00 and BannerDisplay 5 01 01 Refer to the Release Notes txt file in each zip file for a more detailed list of changes For more explanation of these features refer to the corresponding sections later in this guide e PayPal integration Enterprise Edition e DNN Scheduler task for automatic consolidation of event records e Option to consolidate event records on the fly as they are created e Abil
36. s campaign box is checked the campaign will be immediately approved If the Send Email Notification box is checked then an email will be sent to the Marketing contact indicating the creation of the campaign Note that the campaign will not become active until itis approved 16 Ad Banner Manager 6 0 User Manual 11 Typically the Approve this campaign box is left unchecked and then campaigns are approved by the advertiser but they can also be approved later by the administrator To approve the campaign click the name of the campaign in the list on the Advertiser Profile page and then click the appropriate link Add image based banners to a campaign Adding banners is typically done by the Advertiser However as an administrator you can also upload banners for any campaign by following the same steps 1 From the Advertiser Profile page click the name of the campaign from the list 2 If the campaign is not approved click the link to approve it 3 Select an image type a External if your image is hosted on a separate web server the URL can be entered here b Intemal click the Upload images link to upload bannerimages and enable the Internal radio button 4 Enter a title This text will also show up as the alt text when a user hovers over the image 5 If you selected an internal image then the Type is selected automatically Otherwise you will have to select a type based on the size of
37. stored procedure manually using SQL Server Management Studio Consolidating Records Using SQL Server Management Studio If you have a great deal of records in your events table you may not be able to use the web interface due to timeout issues Unfortunately the web is not a good options for executing long running tasks In this case you will need to use SQL Server Management Studio directly to execute the WT_BM_Consolidate_Events stored procedure if you have specified a custom object prefix in your database then you will need to prefix the name of the stored procedure as necessary This procedure takes 2 optional parameters PastDays int This parameter spedfies how many days in the past to begin looking for records It defaults to 1 yesterday NumbbDays int This parameter specifies the size of the time period It defaults to 1 1 day 12 Ad Banner Manager 6 0 User Manual For example to consolidate records for the previous 365 days through yesterday you would enter the following into a query window and runit execute WT BM Consolidate Events 1 365 Note that if your WT BM Events table is very large this may take a while to run the first time Also note that this stored procedure creates a TEMP table that is not deleted until the subsequent time the procedure is executed So if you are attempting to clear out space in your database you will want to execute the procedure twice The second time should happen very q
38. ter Value S See teers reier sereas eiren EE EEEE EAEE EEEE EEEE TE EEE EEEE rE AET es 27 PayPal Integration Settings Enterprise Edion 27 Additional e EE esse sce cele dene eege ees egsuegedegdgege eege es dg Eege eege Gegee se 28 BannerDis play SEtt HESE EE sae ance ed sana aude ame anes 28 SKRENE Lay ed E ceca dun cetens accel RES SE EE ee FEST FART ARD REESE ee De E 28 BIE E SOULE ED ET AE E T ANE EE E EEA EPA BOKSE 28 AJAX Banner ROCATION 22 risinn etn NT NAE ENN NAE EEEREN 28 AAVANCE GD hale EE 29 Trouble SHOOTING tege eeneg ege eege 29 Why won t my banner SHOW up 29 My Display module is set to show 2 or more banners but only 1 shows up Why 30 My Banner Activity Report does not show the correct number of clicks nnsseenesseennnse 30 The hyperlink for adding Flash and Text banners does not appear ssseessessssrereresessee 30 TECH SUD DOME osse a R A ted santana tl sae uated ca sees ceed ead ae uate dea eli Sasa 30 Feedback 7 Contact US eege egene dee een sedecveereedacteoreedseeioe FEE ER FREE PER 30 Ad Banner Manager 6 0 User Manual Introduction The Smoke Ranch Ad Banner Manager consists of two modules e BannerAdvertisers Module This module provides administration of advertiser accounts and campaigns Portal administrators access this module to create advertiser accounts and campaigns Advertisers use this module to manage their banners e BannerDisplay Module This module is used to display
39. tification checkbox when updating the campaign Updated Campaign Email Text This is the body text of the email that is sent when an existing campaign is updated Refer to the embedded help text on the page to see the list of placeholders that can be induded in the text Simply copy and paste the placeholder text andit will be replaced automatically when the email is sent Banner Rejected Email Subject This is the subject text of the automated email that is sent when a banner is rejected Banner Rejected Email Text This is the body text of the automated email that is sent when a banner is rejected Refer to the embedded help text on the page to see the list of placeholders that can be induded in the text Simply copy and paste the placeholder text andit will be replaced automatically when the email is sent If you modify the default text of this setting be sure not to delete the COMMENTS placeholder otherwise the reviewer s comments will not be included in the email Enable Custom Parameters Check the box to enable the Custom Parameters feature When enabled an extra field will appear in the form used to add new ad banners Enter the caption for this field in the box provided To learn more refer to the section on Custom Parameters earlier in this guide Custom Parameter Values This setting only applies if Custom Parameters are enabled If you want Advertisers to type in the parameter value then you do not need to do anyt
40. uickly and will eliminate the temporary records from the initial consolidation Automating Record Consolidation If you wish to turn off event record consolidation to improve banner display performance you may wish to enable automated consolidation to process the event records on a nightly basis The BannerAdvertisers module includes a custom task that can be scheduled in the DNN Schedule by following these steps 1 Login as Host 2 Go to Host gt Schedule 3 Click Add Item to Schedule 4 In the Class Name text box enter the following text without the quotes or spaces SmokeRanch BannerAdvertisers Components ConsolidationSchedulerClient SmokeRanch Bann erAdvertisers 5 Check the Schedule Enabled box 6 Under Time Lapse put a 1 in the text box and select Days 7 Click Update It is also recommended that you configure your portal to use Timer Method scheduler mode You can find the Scheduler Mode setting under Host gt Host Settings in the Other Settings section Deleting Records Using the Web Interface If you would prefer to delete records rather than consolidate then that is also an option Note that deleting event records will not affect the campaign totals for impressions and clicks butit will affect reports based on a date range For example if a given campaign has 100 000 total impressions reports will continue to reflect that amount even after the event records have been deleted However if you delete all records
41. your banner image 6 Enter the URL that the banner should point to and click the Add Banner link Note that the banner will not be displayed on a page until it has been approved Add existing banners to a campaign 1 A given banner can be added to more than one campaign To add an existing banner to a second campaign go to the campaign and select the banner from the Select existing banner dropdown list Only banners that have not been added to the current campaign will appear in this list 17 Ad Banner Manager 6 0 User Manual 2 Remember that banners will not appear in the portal until they have been approved You can eliminate the need for banners to require approval on the Edit page Add Flash banners The preceding sections describe how to add banners that are based on standard image formats jpeg gif png etc To add a Flash based banner you must click the Click here to add a Text or Flash based banner hyperlink that is displayed in the Add a New Banner section of your campaign page Note that it is possible to create Flash based or Text based banners that do not record clicks For this reason you can optionally restrict the ability to add Flash based banners to campaigns that are based on click counts To do this visit the Edit page Step 1 On this page you can either upload a new swf file or select one that you have uploaded previously Step 2 In this step you must enter a title and specify the size
Download Pdf Manuals
Related Search