AdFlex

Advertising management system


Thank you for purchasing my application. If you have any questions that are beyond the scope of this help file, you can send them by email or through the contact form on the user's page. Thank you!

  1. Dedicated or virtual server or hosting

  2. Domain

  3. Version php 5.3.7 or higher

  4. Version MySQL 5.0 or higher

 

I tried to make the installation of the application as simple as possible.

  1. Extract the contents of the archive into the root directory of the site

  2. Set the rights to the file CONFIG.INI (666 or 777)

  3. Set permissions on the IMAGES folder (777)

  4. Go to http://yoursite.com

Hereinafter, yoursite.com means your domain

Fill in the form:

MySQL User - MySQL user name (check with your hosting provider)

MySQL Password - MySQL user password (check with your hosting provider)

MySQL Host - the address of the MySQL server (in most cases this is “localhost”)

MySQL DB name - is the name of the MySQL database, the installer will try to create a database with this name.

Note that on some hosting sites this may not work. You may need to create the database yourself in the server / hosting management panel.

If you created a database in the hosting control panel, just add its name in the field “MySQL DB name

Admin Email - Email administrator. Your email to enter the control panel.

Admin Password - Create a password to enter the control panel. The password is at least 8 characters long.

Press the “INSTALL” button. This completes the installation.


Video: Installation


 

Go to http://yoursite.com

In the “Email” field, enter the Email of the administrator that you specified during the installation.

In the “Password” field, enter the administrator password that you specified during the installation.

Press the “LOG IN


Video: Login to the system


 

Go to the list of sites “Sites”

In the right column are the buttons for managing the site.

Blocks(n) - the number of ad units on the site

Play - start advertising on the site

Stop - stop advertising on the site

Stats - detailed statistics on the site

Remove - delete the site from the system. Blocks are also deleted

Views - total number of impressions of ads on the site for all time

Clicks - the total number of clicks on ads on the site for all time

Ctr - the total CTR site for all time

To add a new site, click “Add site”. Enter the site name and click “OK”


Video: Adding a site


Go to the list of sites “Sites”

Click on the “Blocks” button in front of the corresponding site.

Before you will be a list of all the blocks of this site. In the right column are the control buttons for the unit.

Play - start the block

Stop - stop the display of the block

Stats - detailed block statistics

Edit - edit block

Copy - copy block

Remove - delete the block

Views - total number of block hits for all time

Clicks - total number of clicks per block for all time

Ctr - common Ctr block for all time

To add a new block, click the “Add block”

Enter the name of the block and click “Create”

The system provides you with the flexibility to customize ad units. Changing any settings of the block, you immediately see the result in the form of a block preview. Describe all possible block settings for too long. The best way to see the process of setting the block on the video.


Video: Adding an ad unit


 

Go to the “Campaigns” campaign list page

Before you will be a list of all advertising campaigns.

In the right column are the buttons for managing the campaign.

 

Ads(n) - add an advertisement to the campaign. Also, the button indicates the number of ads in the campaign.

Play - launch of an advertising campaign

Stop - stop advertising campaign

Stats - detailed statistics of the advertising campaign

Edit - editing an advertising campaign

Remove - delete an advertising campaign

Views - total number of impressions of an advertising campaign for all time

Clicks - total number of clicks of the advertising campaign for all time

Ctr - general Ctr advertising campaign for all time

 

Also, each campaign has a list of targeting icons.

When you hover over a mouse, the information on campaign targeting is displayed on them.

Countries - Country Targeting

Devices - device targeting

OS - OS targeting

Browsers - Browser targeting

Active hours - active campaign display hours (00 to 23)

Filtered sites - sites on which the given advertising campaign is NOT displayed

To add a new advertising campaign, click “Add campaign”

Enter the name of the campaign and click “Create”

Before you find the campaign targeting page.

 

Setting up an ad campaign targeting

Campaign name - name of the campaign

Active hours - hours of impressions. For example, you want to show the campaign only from 10am to 19pm.

Campaign start date - the start date of the campaign.

Campaign stop date - the date the campaign was stopped

Geo targeting - targeting by country. For example, you want to display advertising only to visitors from USA and CA

Device targeting - Device targeting. For example, you want to show ads only to visitors with PCs and Tablets

OS targeting - targeting by operating systems. For example, you want to show ads only to visitors with MacOS

Browser targeting - targeting by browsers. For example, you want to show ads only to visitors with Google Chrome

To NOT show the campaign at the following sites: - list of sites on which this campaign will NOT be displayed

Campaign link - the default link for all campaign ads. You can specify it later when creating the ad.

 

[CAMP_ID]  - Campaign id

[BLOCK_ID] Block id

[AD_ID]  - Ad id

[SITE_ID]  - Site id

[TIME_CLIK]  - Click date in the format YYYY-MM-DD_HH-MM-SS (2017-06-15_10-35-15)

 

After making the settings, click “Save campaign”


Video: Adding an ad campaign


Go to the “Campaigns” campaign list page

Click the “Ads(n)” button of the campaign in which you want to add the advertisement.

Before you will be a page with a list of announcements of this campaign.

Announcements as well as campaigns can be launched, stopped, edited, deleted.

To add an advertisement click on the button “New ad”

A pop-up window for adding an advertisement will appear.

Fill out the announcement data.

You can add an image to the announcement. It will be proportionally cut off.

All form fields (except images) are required.


Video: Adding ads


To view the statistics, go to the “Statistics” page.

You can find statistics on sites, ad units, advertising campaigns, ads. Statistics are grouped by country, device types, operating systems, browsers, IP addresses. You can sort by views, clicks and CTR.


Video: Statistics


Go to the “Settings” page

The following settings are available:

Time settings - set the time on the server. It is recommended to set the correct time according to your time zone.

Default page settings - the page where you will be redirected after authorization.

Statistics storage settings - delete old statistics.

Password settings - change password


Video: Adding ads


Go to the “Filter” page

Here you can enter ip addresses that will not be shown ads.


Video: IP blacklist


  1. Go to http://yoursite.com

  2. Follow the link “Forgot password?”

  3. In the “Email” field, enter the Email of the administrator that you specified during the installation.

  4. Press the “RESET PASSWORD”

 

After that, a letter with a link for password recovery will come to your inbox.

Follow this link and enter a new password in the form.

The link is one-time. This means that this link can only change the password once.

However, never give this link to other people.

Some components used in this product are made by third-party developers.

All used parties are free of charge for commercial use.

The components (libraries) and their licenses are used below.

 


 

Component: CodeIgniter

Link: https://www.codeigniter.com

License type: MIT (Free)

License link: https://www.codeigniter.com/userguide3/license.html

 


 

Component: mobiledetect

Link: http://mobiledetect.net

license type: MIT (Free)

License link: https://opensource.org/licenses/mit-license.php

 


 

Component: sypexgeo

Link: https://sypexgeo.net

license type: BSD (Free)

License link: https://sypexgeo.net/bsd_license.txt

 


 

Component: Crawler-Detect

Link: https://github.com/JayBizzle/Crawler-Detect

license type: MIT (Free)

License link: https://github.com/JayBizzle/Crawler-Detect/blob/master/LICENSE

 


 

Component: jquery

Link: https://github.com/jquery/jquery

License type: MIT (Free)

License link: https://github.com/jquery/jquery/blob/master/LICENSE.txt

 


 

Component: jquery-ui

Link: https://github.com/jquery/jquery-ui

license type: MIT (Free)

License link: https://github.com/jquery/jquery-ui/blob/master/LICENSE.txt

 


 

Component: clipboard.js

Link: https://zenorocha.github.io/clipboard.js

license type: MIT (Free)

License Link: https://zenorocha.mit-license.org

 


 

Component: bootstrap

Link: https://github.com/twbs/bootstrap

license type: MIT (Free)

License link: https://github.com/twbs/bootstrap/blob/master/LICENSE

 


Component: bootstrap-datepicker

Link: https://github.com/uxsolutions/bootstrap-datepicker

license type: Apache License 2.0 (Free)

License link: https://github.com/uxsolutions/bootstrap-datepicker/blob/master/LICENSE


 

Component: bootstrap-select

link: https://github.com/silviomoreto/bootstrap-select

License type: MIT (Free)

License link: https://github.com/silviomoreto/bootstrap-select/blob/master/LICENSE

 


Component: bootstrap-colorpicker

Link: https://github.com/itsjavi/bootstrap-colorpicker

license type: Apache License 2.0 (Free)

License link: https://github.com/itsjavi/bootstrap-colorpicker/blob/master/LICENSE

 


 

Component: Font-Awesome

Link: https://github.com/FortAwesome/Font-Awesome

license type: SIL OFL 1.1 (Free), MIT License (Free), CC BY 3.0 (Free)

license link (SIL OFL 1.1): http://scripts.sil.org/OFL

license link (MIT License): http://opensource.org/licenses/mit-license.html

license link (CC BY 3.0): http://creativecommons.org/licenses/by/3.0/