2_16_Update_Guide.pdf

8/9/2019 2_16_Update_Guide.pdf

1/30

Page 1 of 30

CPV Lab 2.16 Update Guide - Copyright 2010 - 2013 CPVLab.comReproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab.com

Version 2.16Update Guide


2/30

Page 2 of 30


Table of Contents

2.16 Update Installation Instructions..............................................Advanced Update Option..

34

Version 2.16 Update List...

CPC Bidding / Pricing Options...

Ad Performance Stats....

Stats Group by Day & Hour....

Alert Profiles

Optimization Profiles.

Pre-Defined Traffic Source Tokens.... 16

Traffic Source Hidden Token Option............... 18

Configuration File Options for Advanced Users... 19

Campaign Redirect Updates.....

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


3/30

Page 3 of 30


2.16 Update Installation Instructions:

IMPORTANT:If you purchased CPV Lab before Jan. 10 th , 2012 and have not continued with the Annual Update Renewal, youwill 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 licenseemail, 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 thesize of your backup fileyou can easily backup the database manually, Check the user guidefor details: http://cpvlab.com/forusers/User_Guide.pdf

2 - Make Sure you are updating from at least version 2.12To check, click the "I" icon on the Campaigns Page If you are currently running version 2.12or above, proceed to the next step, if not...you will need to install the previous updates inorder 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 updateoption explained below)

5 - Then delete install.php and/or upgrade.php


4/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'thave all the previous files. For example, overwriting an existing folder that has 3 files init...with a folder that has only 1 file. In this case, make sure that the other 2 files are left intactand the other is overwritten. This appears to only affect Mac Users FTP Clients. I havent seenthis using Filezilla on Windows.

Advanced Update Option: For High Volume Users whenUpgrading from 2.15 to 2.16 ONLY

Users upgrading with large databases (millions of clicks), may run into timeout issues whenprocessing 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 upgradestatements directly in their database, using the PhPMyAdmin utility or any other MySQL toolprovided by their host.

NOTE: This update method should be used only by users with large databases that are used toworking with PhPMyAdmin or similar. If youre not familiar with PhpMyAdmin, use thestandard update process covered above by accessing the upgrade.php page.


5/30

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, overwritingthe existing CPV Lab files.

2. Open the PhpMyAdmin utility from cPanel, select the CPV Lab database and click on theImport tab

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


6/30

Page 6 of 30


4. Click on the Go button and PhpMyAdmin will start to execute the upgrade statementsfrom 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 Processcpvlabupgradescript.sql file option.

You will uncheck this option since you already executed the SQL upgrade statements directlyin PhpMyAdmin. It should look like this:

6. Click on the Upgrade button and the page will execute the last upgrade steps, then it willredirect 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.


7/30

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.


8/30


9/30

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

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 examplesabove. In those cases, youll simply add your own Unique Ad Identifier within your CampaignURL when placing it at the traffic source.


10/30

Page 10 of 30


For ExampleBing uses {AdId} as the token to capture the Ad ID from within your AdCenter AccountsoYour 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 yourCampaign URL for each ad if they dont offer the ability to pass this data like in the exampleabove.

For examplea Campaign with 3 Ads Setup, you could enter each Ad Destination URL as:

Ad 1http://YourCampaignURL.com/base.php?c=323&key=3e48ee4a6a49134cb4a5d218092a6677&keyword={keyword}&ad=1



We used simple #s (1, 2, 3) to separate the ads in this examplebut you can pre-fill any datahere you wish to use for separating the Ads from one another. Its NOT recommend to useblank spaces however such as: &ad=ad one

Instead of blank spaces use separating characters to avoid any breakage or mishandling ofURLs. So instead of &ad=ad one this would become &ad=ad_one or &ad=ad-one


11/30

Page 11 of 30


Ad Performance Stats

Along with CPC bidding/pricing options above, weve also added a separate Ad PerformanceSection in the Stats section.

Stats Group by Day & Hour

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

Day Hour


12/30

Page 12 of 30


Alert Profiles

Version 2.16 adds the ability to define multiple Alert Profiles and assign specific profiles tocampaigns. 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 isassigned to all campaigns. So the previous alert settings arent lost.

The Alert Profiles can be managed from the Alert Profiles page located under the Settingsmenu. You can add new profiles, edit existing profiles, delete profiles and set the default AlertProfile (used for new campaigns).


13/30

Page 13 of 30


When you want to assign a campaign an Alert Profile, go to the campaigns setup page andselect the desired profile from the dropdown control:

The Stats page will use the Alert Profile assigned to each campaign when displaying the alertsinformation (red color).


14/30

Page 14 of 30


Optimization Profiles

Optimization Profiles work very much like Alert Profiles and allow you to assign campaigns aspecific 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 allowyou to add/edit/delete Optimization Profiles and to define the default Optimization Profile(used for new campaigns).


15/30

Page 15 of 30


You can assign each campaign to a specific Optimization Profile from the campaign setuppages.

From the Optimize Campaign page within CPV Lab you can then select the Optimization Profilethat you want to apply to the selected campaign and view the results for:


16/30

Page 16 of 30


Predefined Traffic Source Tokens

You can define Traffic Source Tokens that can be easily used in the campaigns setup pages asextra tokens.

These predefined tokens can be entered in the Traffic Sources management page, when youadd 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 thewildcard 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:


17/30

Page 17 of 30


From the example above, campaign that uses this Traffic Source will show the 3 tokens forquick 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.


18/30

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 isrequired when posting back to them to mark a conversion. Being unique, this token will beable 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 forTraffic 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 andalso the parameter hidtkn used to receive and store the token values. CPV Lab will store theunique token for each click it receives and all you have to do is include it in the additionaltracking 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


19/30

Page 19 of 30


Configuration File Options for Advanced Users

In order to improve the speed of redirects between campaign pages and to offer morecustomizable options, we added a new configuration file where you can manually edit severalCPV 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:


20/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 enterany 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 abovepattern). The default format is m/d/Y

ThousandsSeparatorCSV used in the CSV files as the character that will separate thousandsdigits in numeric fields. The default value is blank in order to generate CSV files compatiblewith Microsoft Excel

DecimalSeparatorCSV used in the CSV files as the decimal separator for numeric fields. Thedefault value is .

CookieTimeout the tracking cookie length, the time interval that a cookie will be kept insidevisitors browsers. The value must be specified in seconds, there are several common cookielengths 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 redirectsto offer pages using the Double Meta Refresh methodsee details below

LoopRedirectPage this key holds the file name for the page that performs redirects to offerpages using the Redirect Loop methodsee details below

ClickbankSecretKey if defined, it must match the Secret Key you entered in your Clickbankaccount. If not defined, the Clickbank tracking code will not validate the calls received. Usingthe Secret Key option will bring extra security since the requests received will be validated andonly those requests that actually come from Clickbank will be processed.


21/30

Page 21 of 30


Changing Redirect Page Names

Starting with version 2.16 the pages that perform redirects can have custom names instead oftheir default names. In order to use a custom name for a redirect page you need to do 2things

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 filename/s.

As referenced in the Configuration File aboveDoubleMetaRedirectPage this key holds the file name for the page that performsredirects to offer pages using the Double Meta Refresh method

LoopRedirectPage this key holds the file name for the page that performs redirects tooffer pages using the Redirect Loop method

You can even place the redirect pages on another domain, the redirects will still work asbefore. If you place the redirect pages on different domains, you will enter the configurationvalues in the constants-user.php file with the full URL, as:

http://new-location/baseredirect.phphttp://new-location/baseloopredirect.php


22/30

Page 22 of 30


Campaign Redirect Updates

There are 3 redirect types (for campaign pages) available in CPV Lab, 2 of them that hide thereferrer, but are slower than the redirect that sends referrers:

Direct Redirect sends referrer

Double Meta Refresh hides referrerRedirect 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 campaignssetup page) is the redirect to the offer page. Other redirects, like landing page redirects andredirects between levels will be done with a Direct Redirect to greatly increase the redirectspeed.

So, we can have the following scenarios when one of the redirect methods that hide referrersis selected:

Campaign URL -> hide-referrer -> OfferCampaign URL -> show-referrer -> LP ->hide-referrer -> OfferCampaign 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 hide-referrer can be either Double Meta Refresh or Redirect Loop.


23/30

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. Thispage/url will be called in the event something happens to a visitor where CPV Lab cannotredirect the visitors to the next page.

If the tracking cookie gets deleted from the browser and the visitor clicks on a base2.php orbase3.php link, CPV Lab wont know what campaign that visitor is associated with (since thecookie 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.phpand 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 visitorswho remove cookies, then you will use base links like below to redirect between LPs and tothe 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 reasonwhy 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 justcover other cases by entering the Failure Page in the campaign setup page.


24/30


25/30

Page 25 of 30


For increase security and making sure the requests come from Clickbank and not from anothersource, you can use the Secret Key option. You will define this secret key in Clickbank and thenyou will enter it in the ClickbankSecretKey key from the constants-user.php file in the libfolder, like:

If you define the Secret Key it is very important to enter the same Secret Key both in Clickbankand 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 betracked correctly, but without the extra security brought by the Secret Key feature.


26/30

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

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

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 cloakpage to the Campaign URL

2. You will cloak the Campaign URL (the one from step 1 above, after removing tokenwildcards) 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 theoption 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 subIDparameter will be automatically sent to them (similar to the parameters in the Campaign URL)


27/30

Page 27 of 30


4. In the campaign setup page, enter the offer URLs with their cloaked values and append thesubID token to them:http://newdomain.com/offer1/ ?subid= orhttp://newdomain.com/offer1 ?subid= orhttp://newdomain.com/offer1/index.php ?subid=

Any of the above 3 URLs will work, you can choose which one you like better. Add theremaining 2 offer URLs in the same way.

5. Enter the cloaked Campaign URL in your network. You will have to append to the URL theparameters in bold that you removed from the original Campaign URL, so that the networkknows 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} orhttp://newdomain.com/campaign ?keyword=EDIT&ad={creativeid:}&state={state:default}&gender={gender:default} orhttp://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 cloakand move them to the cloak URLs, like I described above. And you have to check the option topass 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 willalso append the subID- the cloak page will redirect to the actual offer page and will forward the subID parameter toit


28/30

Page 28 of 30


If you will need at a later moment to change an offer URL, you will just have to generate a newcloak page for the new offer and upload it in the corresponding location (offer1, offer2, offer3folder from the newdomain.com domain). You won't have to change the offer URL in thecampaign setup page since the cloak URL remains the same, just the redirection from itchanges.

If you want to add new offers, you will have to generate the cloak page for them, then addthese cloak pages in the campaign setup page.

Of course you can change the folder names from the newdomain.com I used in this example toany 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 storereferrer data for all visitors. This option was added primarily for high volume users, who dontuse Referrer Data as a KPI within their campaigns.

If you dont use this data directly for optimization purposes, unchecking Capture Referrerwill save additional server resources by not capturing or storing this data.


29/30

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 capturedand stored in your campaigns, can now easily be removed from the Database, directly fromthe Settings Page.

Using the interface above you simply select a campaign or All Campaigns and then enter thedate range you want to remove referrer data for, then click Save. Thats itthe referrer datawill be removed from the Database to free up space and resources from unwanted data thatsno longer being used. Keep in mind, this cannot be undonewhen removing referrer data,make sure you have selected the proper campaign and date range.


30/30

Page 30 of 30

Knowledgebase &Helpdesk

@

www.TheLabHelpdesk.com

Date post:	01-Jun-2018
Category:	Documents
Upload:	santiago-fmg
View:	212 times
Download:	0 times

2_16_Update_Guide.pdf

Documents