Escolar Documentos
Profissional Documentos
Cultura Documentos
Version 2.16
Update Guide
Page 2 of 30
Table of Contents
2.16 Update Installation Instructions.............................................. 3
Advanced Update Option.. 4
Version 2.16 Update List... 7
CPC Bidding / Pricing Options... 9
Ad Performance Stats....
11
22
28
Page 3 of 30
Page 4 of 30
Note on Uploading:
Make sure that your ftp client doesn't remove files from folders that you overwrite that don't
have all the previous files. For example, overwriting an existing folder that has 3 files in
it...with a folder that has only 1 file. In this case, make sure that the other 2 files are left intact
and the other is overwritten. This appears to only affect Mac Users FTP Clients. I havent seen
this using Filezilla on Windows.
Page 5 of 30
3. Click on the Browse button and select the cpvlabscript215-216.sql file from the CPV Lab
version 2.16 upgrade package
Page 6 of 30
4. Click on the Go button and PhpMyAdmin will start to execute the upgrade statements
from that file. Once the process is finished you will get a confirmation message.
5. Run the upgrade.php page from your CPV Lab install and uncheck the Process
cpvlabupgradescript.sql file option.
You will uncheck this option since you already executed the SQL upgrade statements directly
in PhpMyAdmin. It should look like this:
6. Click on the Upgrade button and the page will execute the last upgrade steps, then it will
redirect to the Login page.
IMPORTANT:
You must run the upgrade.php page (with unchecked option) after executing the SQL
statements in PhpMyAdmin to perform the last steps that are required in the upgrade process.
Page 7 of 30
Improvements:
Optimize columns size in database
Improved queries from base pages for speed and volume
Improved Redirects for fast load times on all base links.
Improved error messages on campaign setup pages
Improve sorting in Stats
Improved additional server-to-server pixels curl library integration
Improved Clickbank Conversion Postback functionsdefine the Clickbank secret code more security when calling the Clickbank pixel
Changed the parameter for Failure Campaign ID instead of 'c' to avoid conflicting
parameters in offer pages/urls.
Page 8 of 30
Interface:
Predefined tokens for Traffic Sources; option to use these predefined tokens in the
campaign setup pages from simple dropdown menu options.
Added Tooltips in Campaign Setup Pages for reference.
Ajax Spinner images added to show when operations are running/executed from within
the interface.
Sort timezone options in dropdown on the Settings page
jQuery effects in many application pages, for example when showing/hiding sections or
removing items
Hide inactive campaigns in dropdown selection menus
Save sort conditions on the Campaigns page - when you login again the sorting order
will be saved from the previous visit
Functions:
Priority 0 option (used for direct traffic) - always removes the existing tracking cookie
Allow SSL redirects when Redirect Loop method is used
Option in the campaign setup pages to control if the referrers will be captured
Extra Tokens are not passed to Level 2+ LPs, only to Level 1 LP and Offer Pages (when
selected)
Ability to remove referrers from the database
Option to change/customize redirect page names
Page 9 of 30
When CPC is selected the Target Performance Stats, Trends and other relevant stats are
changed specifically for CPC bidding instead of CPV (Cost Per View).
For ExampleWhen CPC is selected:
Also, within the Campaign Setup Pages, when CPC is selectedan Ad Token section will open.
The Ad Token information is entered from Settings Traffic Sources page for each Traffic
Source.
For exampleWhen CPC is selected as the Bidding Type, and
Bing is selected as the Predefined Traffic Source:
Note: Not all traffic sources provide dynamic tokens to Ads or Creatives as in the examples
above. In those cases, youll simply add your own Unique Ad Identifier within your Campaign
URL when placing it at the traffic source.
Page 10 of 30
For Example
Bing uses {AdId} as the token to capture the Ad ID from within your AdCenter Accountso
Your Campaign URL may look like:
http://YourCampaignURL.com/base.php?c=323&key=3e48ee4a6a49134cb4a5d218092a6677
&keyword={keyword}&ad={AdId}
Other CPC/PPC Networks however, you may need to pre-fill a Unique Ad ID when placing your
Campaign URL for each ad if they dont offer the ability to pass this data like in the example
above.
For examplea Campaign with 3 Ads Setup, you could enter each Ad Destination URL as:
Ad 1
http://YourCampaignURL.com/base.php?c=323&key=3e48ee4a6a49134cb4a5d218092a6677
&keyword={keyword}&ad=1
Ad 2
http://YourCampaignURL.com/base.php?c=323&key=3e48ee4a6a49134cb4a5d218092a6677
&keyword={keyword}&ad=2
Ad 3
http://YourCampaignURL.com/base.php?c=323&key=3e48ee4a6a49134cb4a5d218092a6677
&keyword={keyword}&ad=3
We used simple #s (1, 2, 3) to separate the ads in this examplebut you can pre-fill any data
here you wish to use for separating the Ads from one another. Its NOT recommend to use
blank spaces however such as: &ad=ad one
Instead of blank spaces use separating characters to avoid any breakage or mishandling of
URLs. So instead of &ad=ad one this would become &ad=ad_one or &ad=ad-one
Page 11 of 30
Ad Performance Stats
Along with CPC bidding/pricing options above, weve also added a separate Ad Performance
Section in the Stats section.
Hour
Page 12 of 30
Alert Profiles
Version 2.16 adds the ability to define multiple Alert Profiles and assign specific profiles to
campaigns. Previously, only a single Alert Profile was applied to all campaigns.
When upgrading to version 2.16, previous Alert data is saved as Default Alert Profile which is
assigned to all campaigns. So the previous alert settings arent lost.
The Alert Profiles can be managed from the Alert Profiles page located under the Settings
menu. You can add new profiles, edit existing profiles, delete profiles and set the default Alert
Profile (used for new campaigns).
Page 13 of 30
When you want to assign a campaign an Alert Profile, go to the campaigns setup page and
select the desired profile from the dropdown control:
The Stats page will use the Alert Profile assigned to each campaign when displaying the alerts
information (red color).
Page 14 of 30
Optimization Profiles
Optimization Profiles work very much like Alert Profiles and allow you to assign campaigns a
specific optimization profile with set metrics goals.
When upgrading to 2.16, previous optimization data is saved as Default Optimization Profile.
The Optimization Profiles page is located under the Settings menu group. This page will allow
you to add/edit/delete Optimization Profiles and to define the default Optimization Profile
(used for new campaigns).
Page 15 of 30
You can assign each campaign to a specific Optimization Profile from the campaign setup
pages.
From the Optimize Campaign page within CPV Lab you can then select the Optimization Profile
that you want to apply to the selected campaign and view the results for:
Page 16 of 30
Page 17 of 30
From the example above, campaign that uses this Traffic Source will show the 3 tokens for
quick selection in the Extra Tokens section. When you select one of the predefined tokens,
details for it will automatically populate in the corresponding Extra Token.
Page 18 of 30
Notice the URL Append that includes the {POSTBACKID}' wildcard requested by SiteScout and
also the parameter hidtkn used to receive and store the token values. CPV Lab will store the
unique token for each click it receives and all you have to do is include it in the additional
tracking pixels using the {!tscode!} wildcard.
For a SiteScout additional pixel it will look like:
More details about this method and SiteScout can be found here:
http://docs.sitescout.com/display/rtb/Postback+Conversions
http://docs.sitescout.com/display/rtb/Conversion+Pixels
CPV Lab 2.16 Update Guide - Copyright 2010 - 2013 CPVLab.com
Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab.com
Page 19 of 30
Page 20 of 30
Here are the keys that can be configured with the constants-user.php file:
DateFormat the pattern used to display the date/time fields inside CPV Lab; you can enter
any PHP specific date format. The default format is m/d/Y g:i A
DateShortFormat the pattern used to display the date fields (short format for the above
pattern). The default format is m/d/Y
ThousandsSeparatorCSV used in the CSV files as the character that will separate thousands
digits in numeric fields. The default value is blank in order to generate CSV files compatible
with Microsoft Excel
DecimalSeparatorCSV used in the CSV files as the decimal separator for numeric fields. The
default value is .
CookieTimeout the tracking cookie length, the time interval that a cookie will be kept inside
visitors browsers. The value must be specified in seconds, there are several common cookie
lengths added as examples and the default value is 2592000 which means 30 days. Previously,
in version 2.15 or earlier, this option was available in the Settings page
DoubleMetaRedirectPage this key holds the file name for the page that performs redirects
to offer pages using the Double Meta Refresh methodsee details below
LoopRedirectPage this key holds the file name for the page that performs redirects to offer
pages using the Redirect Loop methodsee details below
ClickbankSecretKey if defined, it must match the Secret Key you entered in your Clickbank
account. If not defined, the Clickbank tracking code will not validate the calls received. Using
the Secret Key option will bring extra security since the requests received will be validated and
only those requests that actually come from Clickbank will be processed.
Page 21 of 30
Page 22 of 30
Where show-referrer appears in the above examples will be the Direct Redirect and hidereferrer can be either Double Meta Refresh or Redirect Loop.
Page 23 of 30
Page 24 of 30
Page 25 of 30
For increase security and making sure the requests come from Clickbank and not from another
source, you can use the Secret Key option. You will define this secret key in Clickbank and then
you will enter it in the ClickbankSecretKey key from the constants-user.php file in the lib
folder, like:
If you define the Secret Key it is very important to enter the same Secret Key both in Clickbank
and in CPV Lab in order to track conversions correctly.
If nothing is entered as the Clickbank Secret Key in CPV Lab, the conversions will still be
tracked correctly, but without the extra security brought by the Secret Key feature.
Page 26 of 30
3. You will cloak each offer URL with a PHP page that you will place as follows (also check the
option to pass parameters):
http://offer1.com - http://newdomain.com/offer1/index.php
http://offer2.com - http://newdomain.com/offer2/index.php
http://offer3.com - http://newdomain.com/offer3/index.php
Notice that you won't enter the &'subid=' part in the offer URLs that you cloak, the subID
parameter will be automatically sent to them (similar to the parameters in the Campaign URL)
Page 27 of 30
4. In the campaign setup page, enter the offer URLs with their cloaked values and append the
subID token to them:
http://newdomain.com/offer1/?subid=
or
http://newdomain.com/offer1?subid=
or
http://newdomain.com/offer1/index.php?subid=
Any of the above 3 URLs will work, you can choose which one you like better. Add the
remaining 2 offer URLs in the same way.
5. Enter the cloaked Campaign URL in your network. You will have to append to the URL the
parameters in bold that you removed from the original Campaign URL, so that the network
knows to pass the target, Ad ID and Extra Tokens. So the campaign URL will be:
http://newdomain.com/campaign/?keyword=EDIT&ad={creativeid:}&state={state:default}&
gender={gender:default}
or
http://newdomain.com/campaign?keyword=EDIT&ad={creativeid:}&state={state:default}&g
ender={gender:default}
or
http://newdomain.com/campaign/index.php?keyword=EDIT&ad={creativeid:}&state={state:
default}&gender={gender:default}
Any of the above 3 URLs will work.
And that's all, you just have to be careful to remove the parameters from the pages you cloak
and move them to the cloak URLs, like I described above. And you have to check the option to
pass parameters when cloaking pages.
The flow will be:
- visitors click on the cloaked Campaign URL
- the cloaked Campaign URL redirects to the actual Campaign URL and passes all parameters
received
- CPV Lab will choose one of the 3 offers, will redirect to the cloak page for that offer and will
also append the subID
- the cloak page will redirect to the actual offer page and will forward the subID parameter to
it
Page 28 of 30
If you will need at a later moment to change an offer URL, you will just have to generate a new
cloak page for the new offer and upload it in the corresponding location (offer1, offer2, offer3
folder from the newdomain.com domain). You won't have to change the offer URL in the
campaign setup page since the cloak URL remains the same, just the redirection from it
changes.
If you want to add new offers, you will have to generate the cloak page for them, then add
these cloak pages in the campaign setup page.
Of course you can change the folder names from the newdomain.com I used in this example to
any values instead of '/campaign/', '/offer1/', '/offer2/', '/offer3/'.
Added in 2.16 is the ability to choose per campaign, whether or not to capture and store
referrer data for all visitors. This option was added primarily for high volume users, who dont
use Referrer Data as a KPI within their campaigns.
If you dont use this data directly for optimization purposes, unchecking Capture Referrer
will save additional server resources by not capturing or storing this data.
Page 29 of 30
Similar to the feature above, clearing out old un-usable referrer data that you have captured
and stored in your campaigns, can now easily be removed from the Database, directly from
the Settings Page.
Using the interface above you simply select a campaign or All Campaigns and then enter the
date range you want to remove referrer data for, then click Save. Thats itthe referrer data
will be removed from the Database to free up space and resources from unwanted data thats
no longer being used. Keep in mind, this cannot be undonewhen removing referrer data,
make sure you have selected the proper campaign and date range.
Page 30 of 30
Knowledgebase &
Helpdesk
@
www.TheLabHelpdesk.com