The User Guide can be downloaded here.
Contents
1. DIMBAL BANNER MANAGER ADMIN USER GUIDE Ax Dimbal Software HTTP WWW DIMBAL COM Table of Contents Table of Contents Introduction Dimbal Banner Manager Features Installation Downloaded Files Browsing the Included Fil System Requirements Installing the Code Connecting to the Servers Settin User Account and ase tables Installation Cleanup Installation Troubleshooting Black Display on the Login Page Manually Installing the Database Tables Option 1 Copy and Paste the SQL Statement Option 2 Running the SQL File Option 3 Web Administrator Assistance Basic Navigation Customizing Application Settings Managing Banners Banner Manager Create a Banner Editing a Banner Managing Zones Managing Users Reports Report Builder Example Reports Managing your Account Changing User Login E Mail Changing User Password Found a Bug Have a Feature Suggestion Bug Reporting Feature Suggestions Other Dimbal Applications Introduction Congratulations You have just purchased one of the most powerful Banner Management solutions available today Let s get started installing and setting up your application The Dimbal Banner Manager was engineered to be powerful feature rich and yet easy to implement With just a small snippet of code you can include individual Banners groups of Banners and more anywhere on your website Banners ads are a great way to help monetize your website content In addition a Banner Management applic2. below will appear Please confirm that the URL entered is correct he URL Definad did nor rerun as successful Please verify the intallation folder The URL tothe Installation Folder with walling i EX upton dinbalcon insall folder exe rfoad raidtn NOTE If an error occurs connecting to the Database it will present a message similar to the one below Please double check the values entered in the provided fields the majority of the problems at this stage are from incorrect Database login information nc your SQ Daai a n SS Gong Tor ar O Bins dindal sonal older meee Database Server Address Database Name Database Login User Name Database Login Password NOTE If you have continued trouble with connecting to your Database please contact our Support team at http www dimbal com supnort Please provide the 5 values above so that we can diagnose connection issues Setting up the User Account and Database tables Now that the Installation URL is set and we can connect to your database it is now time to create the Admin User and the other Database tables You can do this by using Step 2 on the setup php page This will look like the following Application Setup Page IMPORTANT For security reasons please remove this fle fom your deployment afer sening up the Application Setup Steps Stp 1 Connect wo the Servers COMPLETED Step 2 Create the Admin Account Once installed use
3. the form below to setup the default Admin User Admin Email Admin Password 6 or more characters AL Dane Login to the Application Fill out the form to create the admin user o Admin Email Enter the email address for the main Admin User This e mail address is also the username to login to the system o Admin Password Enter the password for the main Admin User NOTE The password must be at least 6 characters in length otherwise an error will be shown such as the one in the following example Aa Ema Admin Paso or more chacie 223 ae When you hit submit several things will happen behind the scenes The Database tables for the application will be created within the Database The Admin user will be installed using the credentials you provided above o Sample data for the application will be created If these actions cannot be performed then an error message will be displayed An example of this error message is below There was an error creating she Database Tables naling te ft User Account If he MSL User Accoun provided de Admin Email Admin Password 6 or more characters This can often be caused by the MySQL User not having proper permissions to create tables on the designated database If this occurs you have two options to work around this You can try connecting to the Database with a different MySQL user account such as one that has proper permissions as outlined in the
4. you successfully see the setup php page then it is now time to setup your config file so the application knows how to connect to your website and database NOTE Before doing any interactions with any production or sensitive databases it is advised to make a backup of any existing data and or setups Installation URL The installation URL is filled out for you This is the URL location of where the Dimbal code was installed to Please double check that the provided URL value is correct NOTE Please ensure a trailing slash is included on the end of the URL Database Information The Dimbal Banner Manager needs a MySQL Database to run against Generally this Database is setup by your webhost Please consult your webhost account for the connection information There are 4 pieces of information that we need to proceed 1 Database Server Address The server address for your database This might be localhost or an IP address 192 168 0 1 or a domain name database myhost com 2 Database Name This is the name of the MySQL Database that we should connect to 3 MySQL Login Username A username for a MySQL user account to login to the database 4 MySQL Login Password An associated password for the MySQL user account above Hit the Submit button to save this information You should then be presented with the second step of the installation process NOTE If an error occurs with the Installation URL an error similar to the one
5. Banners into logical buckets Then instead of calling a single Banner directly you can then call the Zone A random Banner from that zone will then be displayed on each request For example let s assume that you manage a blog about Technology You might have several Banners relating to various technology affiliates that you work with You can then create a zone for each major technology component that you blog about such as Software Hardware SEO and so forth You can then place all of the Banners relating to SEO services into the SEO zone Then on blog posts about SEO you can call the SEO zone to show those targeted Banners Zones within the Banner Manager are also a great way to target specific ad sizes You may find that a particular spot within your website can only support a designated size ad such as a 250x250 square You can add all of your 250x250 ads into this Zone Access the Zone Manager from the Zones tab Mall inthe navigation bar Creating editing and managing Zones is very similar to creating editing and managing Banners Managing Users As an administrator you have the ability to manage users assigned into the application There are two levels of user accounts detailed in the table below ROLE DESCRIPTION User Full control over all Advertisers Banners Zones and Reports Admin All User Role permissions Also has ability to change application settings and has full control over all U
6. archive to a destination on your computer 2 Be sure not to alter the contents within the resulting folder You can move the folder as a whole but do not move the intemal contents of the folder 3 Copy the folder into a destination of your choice on your web host This step is often accomplished using an FTP client to copy files to your web host If you need assistance you will need to contact your web administrator or web host We often recommend to place it at the root level for your domain So if your domain is http example com then the code would be located at http example com dbm 4 You should now be able to open a browser and navigate to a setup landing page using the directory you choose in the step above This landing page is called setup php and is at the root of the folder structure For example http example com dbm setup php The setup landing page will look something similar to the below image Application Setup Page IMPORTANT For secur reasons please remove thi fle rom your deployment afer sering up he Application Setup Steps Step 1 Connect to the Servers Piense emer your Server information below and then hit save Your WebHfos shouid have your MySQL Darsbase connection information easily available or you Tho URL 1o the Insalaton Folder wit ling Database Server Address Database Name an Database Login User Nae Database Login Paswomt Connecting to the Servers If
7. as an errur creating the Database Tables alli the first User Account the MSS Ver Accoun pron pot kave CREATE TABLE permissions please see he Uner Guide for mannat nella af the Database Tabler Admin Eraik Admin Password 6 or more characters This section will help you achieve this To manually install the database tables please following the steps below 1 Unzip the dbm_sql zip archive to a spot on your computer Run the SQL statements contained within the archive against your database This step will vary depending on what tools your web host has made available to you We will provide a couple different options below for you to choose from Option 1 Copy and Paste the SQL Statements One option is to copy and paste the SQL statements into a MySQL administration tool such as PHPMyAdmin 1 Open the PhpMyAdmin tool or other MySQL Administration tool provided by your webhost 2 Navigate to the Database you want to use You will need to select the database in order to use it a Ifa Database does not exist then you may need to create it Instructions for this will vary depending on the MySQL Administration tool being used 3 Once you are in the Database you want to use there should be a SQL command box that you can enter SQL commands into The image below provides an example of this command box within a Database called localhost localhost Databases ASAL Statue g Users Export un SQL query queries on serv
8. ation can help you run internal promotions display random content and highlight new posts and information The Dimbal Banner Manager is written using PHP and MySQL Many web hosts support PHP and MySQL they are free open source technologies If your web host does not support PHP and MySQL please contact us for assistance in finding a web host that does Support is available for you along the road as you use the Dimbal Banner Manager If you get stuck or need any help please just visit htto iwww dimbal com support for any help or assistance The Dimbal Banner Manager is directed and enhanced based upon user feedback Please do not hesitate to submit ideas or feature suggestions Don t forget to visit http www dimbal com for other great software products Itis my hope that you enjoy using the Dimbal Banner Manager Please do not hesitate to contact us if there is anything we can help with Thank you Ben Hall Dimbal Software Dimbal Banner Manager Features The Dimbal Banner Manager is engineered to be a powerful Banner Management application It is feature rich and packed with options that allow flexibility and customization Below is just a high level overview of some of the features found within the Dimbal Banner Manager Have a feature suggestion Visit htto iww dimbal com to submit it Money Back Guarantee If you are not totally satisfied with your purchase we will give you a refund plain and simple One Time Purcha
9. criteria such as the start date number of responses etc 4 Search Results in this section each individual Banner will be listed along with some quick access data about the Banner Create a Banner To create a new Banner you can do so by either selecting the Add new Banner option from the menu Banner Manager Add New Banner Alternatively you can select the Create New button from the Banner Manager Dashboard After you have selected to create a new Banner you will be taken to an edit page without any information on it This will be the template for your new Banner More details on editing your Banner will be covered in the next section Editing a Banner To edit your Banner you need to select the edit button within the Banner Manager Show 10 entries ID Status Edit Banner inf y rva Poi manager 1 QB savriser oinal a a ad DPM 125x125 V1 Alternatively if you select to create a new Banner then you will be automatically taken to the Banner editor When the Banner editor is brought up it should look something like this Banner Editor she ee ra mesure nove rouse oto Sar The left hand side of the editor holds the name of the fields that can be manipulated Underneath the name is a brief explanation of what each feature does On the right hand side is where you can change or enter the appropriate value for each item Managing Zones Zones allow you to group
10. er localhost D Clear 4 Open the SQL file mentioned earlier that is contained in the archive 5 Copy the entire block of code found within that SQL file The SQL block of code will look something similar to the following CREATE TABLE IF NOT EXISTS cimbalExample id int 11 unsigned NOT NULL AUTO_ INCREMENT email varchar 255 NOT NULL data modiumbiob PRIMARY KEY id email ENGINE InnoDB DEFAULT CHARSET utf8 6 Paste the entire block of code into the PhpMyAdmin SQL command box 7 Press enter or execute or whatever submit button is present to run the SQL commands against your Database 8 A Status message should appear indicating that the SQL commands were either successful or failed Option 2 Running the SQL File An alternate method to setting up the Database tables manually is to have your MySQL Admin tool execute the SQL file directly This is very similar to the above process we will explain it below 1 Open the PhpMyAdmin tool or other MySQL Administration tool provided by your webhost 2 Navigate to the Database you want to use You will need to select the database in order to use it a Ifa Database does not exist then you may need to create it Instructions for this will vary depending on the MySQL Administration tool being used 3 Once you are in the Database you want to use there should be an option to run an external SQL file This is often c
11. er Manager in in the Banners themselves Let s spend some time going over how the Banners work and what you can do to manage them Banner Manager To manage the Banners go to the Banners tab in the menu bar Billfland then select Manage Banners If you have not yet created a Banner you will see an empty table such as the one below This is fine o gt No Saved Objects on File e Ifyou have created some Banners then you will see a Banner Manager such as the example provided below Banner Manager E M ortai oren rte sm aO A ameona vO A orrara O Aan TES merana ma one 3 ona i TETES ns me xO ASIEN ws e ona me Let s explore the various parts of the Banner manager Throughout the application many of the managers follow a similar organization so as to make administering the different parts of the application as easy as possible tag eux enact ape pene osx eon eto oim au Joar herratae oar Ga CETE S EF mae rO pe i aE n oe 20 3 gyamn 4 bE peenem Enea 202 a a eae a EF a 1 Title Area Title of the page follows the same style throughout the application This helps you know if you are on the main Manager the main Editor and so forth 2 Create New Button This is a quick access button to easily create a new Banner 3 Search Area This is a powerful search utility that allows you to search for Banners within your system based upon
12. llection of files but do not alter it s organization of folder structure More on these files will be explained below DBM Manual pdf This is the User Manual for installing and using the software Please read it carefully before installing and using the software dbm_sql zip This is the MySQL database script in case you need to run it manually to setup the database If you do not have access to your database then you will need your web administrator to run it against your web application readme txt A simple readme document describing the included files System Requirements Before you try to install the software it is important to verify that your web host meets the proper specifications This software is written using the LAMP stack Which means that it is written in PHP and MySQL and requires a Linux and Apache based web host Please verify that your web host supports PHP and MySQL applications If they do not please contact us for assistance in finding a web host that does This software is designed to run on multiple versions of PHP and MySQL However for proper compatibility and optimal performance we recommend the following minimum versions e PHP 5 4 x MySQL 5 5 x Installing the Code Your first step is to install the code onto your web host This can be achieved using a simple copy and paste action or an FTP client We will walk you through the basic steps 1 Unzip the dbm_zip
13. lly as well as within a particular zone Useful to see if a successful banner holds weight within a new zone Reports by Advertiser Learn how banners do according to advertiser Installation Downloaded Files Your software is available via Instant Download This means that your entire software package will be available for download immediately after purchasing The software is currently not shipped on a CD If you would like a CD archive one can be purchased by contacting us Once you have completed your purchase you should receive a download link to your software This link will be displayed on the confirmation page once your purchase has completed You will also receive the link via e mail immediately upon purchase completion Trouble receiving your E Mail E mails can often be delayed by up to 15 mins E mails can also often be caught by spam filters Please check your spam filters for the e mail if you cannot find it If you did not receive your download link please contact us at hitp www dimbal com support for assistance in locating your receipt Once you have the download link you should be able to download a ZIP file that contains all the files you will need Unzip this archive file to a spot on your computer Browsing the Included Files There are several files included with your software purchase File Description dbm zip This is the main collection of files and code that make your software function Unzip this co
14. onsidered an IMPORT Select this option The image below shows an example of the Import options Stute SOL f Scorch Query gE import 8 Operations t Z Importing into the database example File to Import Fle may be compressed oz bzip2 zip or uncompressed A compressed fies name must and in lorma feomprossion Example sal zip Browee your computor Crosse Fie Ne fle chosen Mac 3208 Character aet at the fie uta Partial Import Alow ho interruption ofan import in case tho soript detects itis olosa to the PHP timeout transactions Number of rons to skip staring from tho first row 10 Format sa Format Specitie Options SOL compaiity mode NONE Dorot use avro_sNenevew lot zero values 4 Using the File selector navigate to the SQL file provided with the application and choose it 5 Validate any other options that may be present such as ensuring that the file is interpreted as a SQL file if that option exists 6 Hit submit or enter or whatever submit button is present 7 A Status message should appear indicating that the SQL commands were either successful or failed Option 3 Web Administrator Assistance If the options above have all failed then please do not hesitate to get in contact with us for support It may be necessary that we ask your web host for assistance if there are in fact permission issues or other restrictions If you want to contact your webho
15. orting Did you find a bug within the application if so then we do apologize for the inconvenience The best way to report bugs is by getting in touch with our support team You can let us know of the issue at the following URL htto www dimbal com support Feature Suggestions The Dimbal products are driven by customer suggestions and input The features that are requested the most are the ones that we prioritize for future releases Let us know if you have a great feature idea so we can work on including it in a future release The best way to make feature suggestions is through our support site at http www dimbal com support Other Dimbal Applications Here at Dimbal Software we are always trying to create new and useful applications to help you run and manage an effective and profitable website If you liked the Dimbal Banner Manager then you will love some of these other software options available from Dimbal Software Visit http www dimbal com for more information Dimbal Poll Manager Allows you to easily host and manage online polls with little to no effort Show graph based results to users schedule start end dates and group polls into logical groups for random display Dimbal Form Processor Allows you to handle form submissions with minimal effort Process results save information into a database and more Dimbal Link Manager Powerful Link Management software that allows you to track clicks on link
16. permissions section above 2 You can follow the section below entitled Manually Installing the Database Tables to connect directly to your MySQL host and install the tables manually Installation Cleanup Once you are able to successfully connect to the Database and the Database tables have been setup properly you should see the following screen indicated that the installation has completed Application Setup Page IMPORTANT For security reasons please eae this le fom your deployment aher seting up the Application Setup Steps Step 1 Connect to the Servers COMPLETED Step 2 Croate the Admin Account COMPLETED All Done Login to the Application AI Done Additional senings can be changed from the Admin gt App Senings mena Hitcontnae to remove this setup ile and to go to the Jogin sereen Cova Legin ta aapiesnen When you hit the Continue button you will be redirected to login page The setup php file will also be deleted from the web installation Once redirected you should see a login page similar to following Enter the Username and Password you choose during the setup process into the Login Form Hit submit and you should now be logged into the application Congratulations You have now successfully installed the Dimbal Banner Manager In later sections we will discuss how you can further customize your application Installation Troubleshooting Our goal is to make the ins
17. rovides a preview of the selected banner Top Performing Banners Allows you to see a list of Sorted Banner lists according to different metrics These include top performing according to impressions licks ctr and creation date Click and Impression Distribution Allows you to see the distribution of pressions and or clicks across your zone advertiser or application Useful in quickly seeing your top performing ads by selected grouping method Managing your Account Users can administer their own account with ease This can be done by accessing the My Account tab III on tne navigation bar Using this menu they can select the change user properties such as their login email or the password Changing User Login E Mail Select the Change Email option from the My Account tab on the navigation bar A screen similar to the following will then be presented Change E Mail Address E nange your ac vena na ry oe Use this form to enter a new E Mail address to use as your user login Please note that after changing your user email you will be logged out and will need to re login again Changing User Password Select the Change Password option from the My Account tab on the navigation bar A screen similar to the following will then be presented Password Use this form to enter a new password to use as your user password during login Found a Bug Have a Feature Suggestion Bug Rep
18. s minimize long URL s and even create QR codes with full hit racking supported Dimbal FAQ Management Save money on your customer service requests by providing a robust FAQ system Allows for both standalone display or embedded display so you can place FAQ articles right into product pages and blog posts Dimbal Control Panel The Dimbal Control Panel allows for easy management of all your Dimbal Software Products Provide a single dashboard to launch and manage your applications
19. se There are no renewal fees or subscription fees Once you purchase the software you can deploy it with your web application Support Need help Support is available via online forums documentation and e mail inquiries Administration Panel A powerful administration panel is provided to assist in the administering of your software Unlimited Banners There is no limit to the number of Banners that you can add into the system Add as many as you would like Advertisers You can define advertisers and in turn assign banners to designated advertisers Unlimited Advertisers There is no limit to the number of Advertisers that you can add into the system Add as many as you would like Start Date An option to allow the Banner to automatically begin on a specified date End Date An option to allow the Banner to automatically end on a specified date Status Multiple status states to help you manage Banners that are being created are live are expired and are deleted Impression Counter The total number of times that the Banner has been accessed is tracked automatically Click Counter The total number of times that the Banner has been clicked is tracked automatically Zones Zones allow you to group your Banners into logical groups and display a random Banner from that group Detailed Reporting Dozens of reports are available to run to get information about your banner management system Reports by Zone Learn how banners perform globa
20. ser objects Access the User Manager from the Admin tab Mil in the navigation bar Then select Manage Users Creating editing and managing Users is very similar to creating editing and managing Banners and or zones Reports One primary feature that sets the Dimbal Banner Manager apart from other Banner management software is the powerful analytic tools built into the system During this section we will go over how to access the Banner reporting features and get the most from your collected data Report Builder To access the Reporting tools use the Reports tab Ml tom the navigation bar You win then be taken to the Report Builder dashboard and should see a control panel that looks similar to the following ait Report Builder SP crete geste reponse get menmun vate am your coletes de a met 95 The above controls are designed to allow you to access your reporting information as fast and easy as possible Example Reports Below are some examples of the various reports that you can run from the report builder Executive Overview Allows you to see in a quick fashion exactly how many impressions and clicks all of your ads are receiving Banner Performance and Preview Allows you to see how many impressions licks and ctr the banner has received Also compares impressions clicks and ctr with all other banners for the same advertiser In addition it p
21. st for assistance you can provide them with the SQL file that came with the application If you start a support ticket with them you can use the following verbiage to help them understand the request To lt My Web Host gt I would like to ask for assistance setting up a new PHP MySQL application on my web server The url to the installed application is http lt lt Enter Your Install URL gt gt Specifically would like to ask for assistance setting up the Database for this application Attached to this message have provided the SQL file that contains the sql statements to create the database tables Please run it against my database Also can you please confirm for me what the Database Server Address the Database Name the MySQL Login Username and the associated Login Password is Thank you Your web host should have no trouble running the associated SQL file If they do for whatever reason please contact our support team Basic Navigation The Dimbal Banner Manager is designed to be easy to use and fast to navigate A powerful navigation bar allows for fast movement across the various tools and components of the application Below is the Navigation bar that Admin users will see Home Adverisers Banners Zones Reports Myaccount Admn Dimbal Sotware Below is the Navigation Bar that non Admin users will see Home Advertisers Banes Zones Repor s MyAccount Dimbal Software Below is a brief description of
22. tallation process as simple and painless as possible However we understand that some webhosts and web servers are setup very differently and may require specialized tweaking The following sub sections hope to outline some of the common issues that may be run into depending on your web host settings Black Display on the Login Page Upon completing the setup process you will be redirected to the login page If the login page is mostly black and looks similar to following there may be an issue with your installation url An example of this is below This is caused by a bad Installation URL If the setup php page is stil on your webserver you can use that page to correct the issue You can also correct this issue manually by editing the config file Use the following steps to manually edit the config file 1 Download the following file to your local computer includes inc configRuntime php 2 Within this file you should see a declaration similar to the following 3 Change the URL value to be the full URL to where your application is installed to Be sure to include the trailing 7 at the end of the url 4 Upload this file back to your web server Manually Installing the Database Tables If you were able to go through the setup page without any issues then you do not need to pay attention to this section If you received an error trying to setup the admin user you may need to manually install the Database Tables There w
23. what each tab is designed for Returns you to the main dashboard for the application Advertisers Manage your Advertisers Create new Advertisers Delete Existing Advertisers Banners Manage your Banners Create new Banners Delete Existing Banners Zones Manage your Zones Create new Zones Delete Existing Zones G Build reports on Banners Zones and the application as a whole ZE Access and change settings relating to your account such as changing your login e mail and login password Allows Admin users to modify application settings as well as manage user accounts Ee Access support services reach the main Dimbal homepage and get other assistance Customizing Application Settings The Dimbal Banner Manager comes with a powerful Application Settings control panel that allows you to adjust various application settings using this control panel you can enable and disable features customize the look and feel and many other options Access this feature by going to the Admin Menu Ill and then selecting Application Settings You should see a page that looks similar to the following image Site Admin Settings You can change various settings to manipulate how your application looks and feels You can also use this page to enable and disable various features For example you can choose to Allow new user registrations or to tum this feature off Managing Banners The heart of the Dimbal Bann
Download Pdf Manuals
Related Search