You are on page 1of 30

Page 1 of 30

Version 2.16
Update Guide

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 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

Stats Group by Day & Hour.... 11


Alert Profiles.. 12
Optimization Profiles... 14
Pre-Defined Traffic Source Tokens.... 16
Traffic Source Hidden Token Option............... 18
Configuration File Options for Advanced Users... 19
Campaign Redirect Updates.....

22

Defining a Failure Page for a Campaign....... 23


Clickbank Conversion NotificationsUpdated from 2.15.. 24
Cloaking / Masking your Campaign URL & Base Links..... 26
Option Added: Capture Referrer Data......

28

Option Added: Remove Referrer Data from Database... 29

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 3 of 30

2.16 Update Installation Instructions:


IMPORTANT:
If you purchased CPV Lab before Jan. 10th, 2012 and have not continued with the Annual Update Renewal, you
will not be able to run version 2.16
You can however run version 2.15 and can access the update package in the users area:
http://CPVLab.com/Users
Or, update your license renewal at http://cpvlab.com/update_license
Complete the checkout process and your license will be updated automatically.
You must enter the correct email address for your existing licenseif youre unsure of your existing license
email, you can:
- Check your email, for your original purchase receipt
- In your FTP program, Navigate to your CPV Lab Directory, Open the License Folder and then open the
license.php file and youll see your existing license email address.
- Check your email addressed used to login to the users area at http://cpvlab.com/users
- Contact support through www.TheLabHelpdesk.com

1 - Backup your database from the Settings Page.


If you dont have enough memory assigned to run this PHP page on your server due to the
size of your backup fileyou can easily backup the database manually, Check the user guide
for details: http://cpvlab.com/forusers/User_Guide.pdf
2 - Make Sure you are updating from at least version 2.12
To check, click the "I" icon on the Campaigns Page If you are currently running version 2.12
or above, proceed to the next step, if not...you will need to install the previous updates in
order and then proceed with the v2.15 update once you have updated to version 2.12
3 - Upload all the files to the server, overwriting the existing files
4 - Access the 'upgrade.php' page and click on the Upgrade button.
This will update the current database with the new changes...That's It.
Leave 'Process 'cpvlabupgradescript.sql' file' checked (unless using the advanced update
option explained below)
5 - Then delete install.php and/or upgrade.php

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 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.

Advanced Update Option: For High Volume Users when


Upgrading from 2.15 to 2.16 ONLY
Users upgrading with large databases (millions of clicks), may run into timeout issues when
processing the update using the standard update process as described above, which is used in
most cases.
In order to avoid this situation, users with large databases are advised to run the SQL upgrade
statements directly in their database, using the PhPMyAdmin utility or any other MySQL tool
provided by their host.
NOTE: This update method should be used only by users with large databases that are used to
working with PhPMyAdmin or similar. If youre not familiar with PhpMyAdmin, use the
standard update process covered above by accessing the upgrade.php page.

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 5 of 30

Advanced Update Option (2.15 to 2.16) Steps Using PhpMyAdmin


1. Upload all files from the CPV Lab version 2.16 upgrade package on your server, overwriting
the existing CPV Lab files.
2. Open the PhpMyAdmin utility from cPanel, select the CPV Lab database and click on the
Import tab

3. Click on the Browse button and select the cpvlabscript215-216.sql file from the CPV Lab
version 2.16 upgrade package

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 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.

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 7 of 30

Version 2.16 Update List


Primary Features:
CPC Bidding/Pricing Options
Ad Performance Stats section
Optimization and Alert Profiles
Store Unique Token from Traffic Source as a separate token and allow Passing Token to
Additional Pixels
Allow {!subid!} placeholder in the offer URLs - will be replaced with the actual subID
before redirecting to the offer page
o Allow {!subid!} placeholder in additional pixels
Allow grouping after Day and Hour in Stats Page
Exported CSV files keep the sort conditions of the original table/grid that was exported

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.

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 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

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 9 of 30

CPC Bidding/Pricing Options


In 2.16 you now have the ability to easily track CPC (Cost Per Click) traffic sources.
On the Campaign Setup Pages, simply select the type of bidding for each campaignCPV or
CPC. Then enter your appropriate estimated bid.

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:

Or Plenty of Fish 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.

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 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

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 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.

Stats Group by Day & Hour


Using the Show/Hide dropdown menu in the Target Performance Section of the Stats, you can
now add columns for
Day

Hour

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 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).

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 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).

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 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).

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 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:

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 16 of 30

Predefined Traffic Source Tokens


You can define Traffic Source Tokens that can be easily used in the campaigns setup pages as
extra tokens.
These predefined tokens can be entered in the Traffic Sources management page, when you
add or edit a traffic source and consist of 3 fields:
Name the Token Name, will appear in Stats as the column header
URL Append the string that will be appended to the Campaign URL and includes the
wildcard sequences that get replaced by the Traffic Source with actual values
Parameter the parameter used to retrieve the values passed from Traffic Source
For example a Traffic Source that passes Age, Location and Browser can be defined like this,
with these 3 tokens:

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 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.

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 18 of 30

Traffic Source Hidden Token Option


Some Traffic Sources assign a hidden token (code) to each visitor they send and this token is
required when posting back to them to mark a conversion. Being unique, this token will be
able to identify the exact visitor that converted, so that the correct conversion gets tracked by
the Traffic Source. This can only be used and the Hidden Token only needs to be defined for
Traffic Sources that support it
In order to capture the hidden token in CPV Lab the following conditions should be met:
The Traffic Source needs to send the Hidden Token values to the Campaign URL
The parameter used by the Traffic Source to send the token must be entered in the TS
Hidden Token field from the campaign setup page
For example, lets see how SiteScout uses the Hidden Token. They offer the {POSTBACKID}'
wildcard that will get replaced with the actual hidden token value when it is placed in a URL.
So the setup for SiteScout will be:

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

Configuration File Options for Advanced Users


In order to improve the speed of redirects between campaign pages and to offer more
customizable options, we added a new configuration file where you can manually edit several
CPV Lab settings that dont require frequent changes. These are global settings that affect all
campaigns and most likely you wont have to change them againafter defining them once, or
just using the default values.
The new configuration file is located inside the lib folder and it is named constants-user.php.
The default values defined in this file look like in the image below:

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 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.

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 21 of 30

Changing Redirect Page Names


Starting with version 2.16 the pages that perform redirects can have custom names instead of
their default names. In order to use a custom name for a redirect page you need to do 2
things
First, Rename the baseredirect.php and/or baseloopredirect.php files using an FTP Client.
Then, Change the corresponding key in the constants-user.php file and specify the new file
name/s.
As referenced in the Configuration File above
DoubleMetaRedirectPage this key holds the file name for the page that performs
redirects to offer pages using the Double Meta Refresh method
LoopRedirectPage this key holds the file name for the page that performs redirects to
offer pages using the Redirect Loop method
You can even place the redirect pages on another domain, the redirects will still work as
before. If you place the redirect pages on different domains, you will enter the configuration
values in the constants-user.php file with the full URL, as:
http://new-location/baseredirect.php
http://new-location/baseloopredirect.php

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 22 of 30

Campaign Redirect Updates


There are 3 redirect types (for campaign pages) available in CPV Lab, 2 of them that hide the
referrer, but are slower than the redirect that sends referrers:
Direct Redirect sends referrer
Double Meta Refresh hides referrer
Redirect Loop hides referrer
Version 2.16 of CPV Lab brings several improvements designed to increase speed in redirects.
These changes mean that the only redirect that will hide-referrer (if selected in the campaigns
setup page) is the redirect to the offer page. Other redirects, like landing page redirects and
redirects between levels will be done with a Direct Redirect to greatly increase the redirect
speed.
So, we can have the following scenarios when one of the redirect methods that hide referrers
is selected:
Campaign URL -> hide-referrer -> Offer
Campaign URL -> show-referrer -> LP -> hide-referrer -> Offer
Campaign URL -> show-referrer -> Level 1 LP -> show-referrer -> Level 2 LP -> hide-referrer -> Offer

Where show-referrer appears in the above examples will be the Direct Redirect and hidereferrer can be either Double Meta Refresh or Redirect Loop.

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 23 of 30

Defining a Failure Page for a Campaign


Version 2.15 of CPV Lab added the option to define a Failure Page for a campaign. This
page/url will be called in the event something happens to a visitor where CPV Lab cannot
redirect the visitors to the next page.
If the tracking cookie gets deleted from the browser and the visitor clicks on a base2.php or
base3.php link, CPV Lab wont know what campaign that visitor is associated with (since the
cookie doesnt exist anymore) and wont know what Failure Page to redirect them to.
Starting with version 2.16 there is a parameter (clfpc) that can be added to the base2.php
and base3.php calls in order to tell CPV Lab what campaign ID the visitor was associated with,
so the correct Failure Page is displayed when necessary.
So if you have defined a Failure Page for your campaign and want to cover possible visitors
who remove cookies, then you will use base links like below to redirect between LPs and to
the offer pages:
http://yourdomain.com/base2.php?clfpc=xxx
http://yourdomain.com/base3.php?clfpc=xxx
http://yourdomain.com/base3.php?id=1&clfpc=xxx
where xxx will be replaced with the actual Campaign ID.
The Failure Page will be displayed even without specifying the clfpc parameter in the base
links in most cases, however not when the tracking cookie is removed. This is the only reason
why the clfpc parameter needs to be specified, for the cases where the cookie gets removed.
So its up to you to decide if you need to cover this case and add the clfpc parameter or just
cover other cases by entering the Failure Page in the campaign setup page.

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 24 of 30

Clickbank Conversion Notifications


When you have an offer from Clickbank, you can enable Clickbank instant notification in order
to get real-time information about conversions and the conversion amounts. You will need to
enter as the Instant Notification URL the following CPV Lab page:
http://yourdomain.com/adclick-cb.php
Clickbank will automatically send to the above URL the following parameters:
ctid the Clickbank transaction ID which must be setup to be the CPV Lab subID
caccountamount the conversion revenue (in cents)
CPV Lab will read those 2 values and mark the correct conversion in the database, as well as
store the actual revenue, then execute any additional server-to-server pixels setup for that
campaign.
Because the Clickbank performs a POST request, any 3rd party pixels entered as image, iframe
or script wont execute, so in this case only server-to-server 3rd party pixels will file (those are
entered as simple URLs in the campaign setup page).
The Clickbank pixel allows multiple conversions from the same subID. If the pixel fires more
than once for the same subID, CPV Lab will sum the revenues that were sent from Clickbank.

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 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.

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 26 of 30

Cloaking / Masking your Campaign URL & Base Links


The steps to cloak everything are the following:
1. If the campaign has Keyword Tokens, Ad Tokens or Extra Tokens that use wildcards in the
Campaign URL, you will have to adjust the campaign URL you enter in the Generate Cloaking
Page.
For example, if the campaign URL is:
http://yourdomain.com/base.php?c=11&key=qqqqqq&keyword={keyword}&ad={creativeid:}
&state={state:default}
Then the part in bold has to be removed and the Campaign URL used for cloaking will simply
be:
http://cpvlabinstall.com/base.php?c=11&key=qqqqqq
The reason for this is that those parameters in bold will be automatically sent from the cloak
page to the Campaign URL
2. You will cloak the Campaign URL (the one from step 1 above, after removing token
wildcards) with a PHP page that you will place at http://newdomain.com/campaign/index.php
Make sure you check the option to pass parameters in the Generate Cloaking Pages Page

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)

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 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

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 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/'.

Option: Capture Referrer Data

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.

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 29 of 30

Option: Remove Referrer Data from Database

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.

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 30 of 30

Knowledgebase &
Helpdesk

@
www.TheLabHelpdesk.com

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

You might also like