Version 2.17 FEATURE GUIDE
Contents
1. A complete referrer URL can look like http domain com page php c 11 amp cb 13b amp t 123453b0e2db284871894dd73e75249f amp d 1 2345 If the query string part isn t important and won t be used in reports it will make sense to capture the referrers without query string parameters and save database space like http domain com page php CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 27 of 37 5 CustomlpHeader If you have a server running a reverse proxy then the IP address for visitors will be passed using a custom header instead of the regular REMOTE_ADDR header In this case you will define the custom header in this configuration option and CPV Lab will use the custom header to read visitors IP addresses For example if you have Incapsula reverse proxy the IP address will be passed in the HTTP_INCAP_CLIENT_IP header so the configuration option from the constants users php file should be SGLOBALS CustomIpHeader HTTP_INCAP_CLIENT_IP 6 UrlEncodeParameters The parameters added to the landing pages or offers like Extra Tokens or Target Keyword are URL encoded before they get appended to the URL in order to be retrieved in the pages If you do NOT want to URL encode operations to these parameters set this option to false CPV Lab 2 17 Update Feature Guide2. Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 28 of 37 TrueCache Data Caching for High Volume Users CPV Lab 2 17 and above This feature addresses one of the biggest requests from Users More Volume and Fast Stats within the Interface Caching of data in CPV Lab means aggregating visitor details clicks and keeping them ina format that will allow reports stats to load faster and that the clicks table will have a reduced size A CRON job is also setup to remove old records from the clicks table to keep the DB clean and under control CPV Lab instances with small traffic figures should not use caching because it won t bring advantages in this case and will add an extra server load Caching is effective for CPV Lab Users that run high volume traffic As a general idea if you have less than 500 000 700 000 clicks in the clicks table and the CPV Lab interface and Stats pages are quick and responsive you most likely won t see a direct benefit from caching CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 29 of 37 Setting up the CRON Job The Cron job consists of a PHP page cron cache php that will be called periodically by the server and will perform the caching processes 1
3. file in the following format SGLOBALS option name option value If the option value is numeric then you don t have to add the enclosing double quotes CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com You can see a sample constants users php file below g worn nn amp WwW NH OWwWWWWONN NN NNN NNN KP PP RP PP PP Pe Or WHR O WD MON HW fF WHR OF WO DON HD WO amp WN PO lt php if isset SGLOBALS CONSTANTS _USER_INC gt GLOBALS CONSTANTS_USER_INC 1 GLOBALS DateFormat m d Y g i A GLOBALS DateShortFormat m d Y GLOBALS ThousandsSeparatorCSV GLOBALS DecimalSeparatorCSV GLOBALS CookieTimeout 2592000 GLOBALS DoubleMetaRedirectPage baseredirect php GLOBALS LoopRedirectPage baseloopredirect php GLOBALS ClickbankSecretKey GLOBALS ClickbankPixelLogging false GLOBALS AffiliateWindowPixelLogging false S GLOBALS RequestMethod auto GLOBALS CaptureFullReferrer false GLOBALS CustomIpHeader rh CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 25 of 37 Page 26 of 37 The new configuration options int
4. Ad gt Page gt Offer KW gt Page gt Offer Mobile Brand Mobile Carrier Mobile Model 98 Mobile Type of Device Offer by Usage Operating System Page by Usage Primary Metrics default i 2e Primary Metrics w Mobile 98 a ue Navigate to Settings gt Quick Stat Views to Create and Save your own custom views you can also drag and drop the column order for each custom view to display the information exactly as you wish is Quick Stat Views Ib Add Stat View Name Notes Campaign Data W Clicks amp Conversions Custom Tokens Revenue Data Referrers Eip El Views Visitors Extra1 E Cost El Referrer Domain El Page M Clicks LP Clicks J Extra2 E cpv cpc M Referrer Page El Page URL E CTR LP CTR H Extra3 F Revenue El category El Keyword Target CPC LP CPC Extra4 CI P L l Ad Creative Engage Extra5 LJ EPV EPC Eloffer El Conversions Extra6 El Ppv PPC El offer URL F cR F Extra7 F ecpM CPA Extras ROI _ CPSUB J Extra9 E subscribers Extra10 JSR Time amp Day Mobile Data El Day Mobile Browser Content Support Device Info Device Usage El Hour Browser Click to Call Brand Dual Orientation Browser Version Fla
5. 2 ID 12 URL http domain com p1 2 php Share 60 Level 2 LP ID 21 URL http domain com p2 php Share 100 Level 3 LP 1 ID 31 URL http domain com p3 1 php Share 50 Level 3 LP 2 ID 32 URL http domain com p3 2 php Share 50 1 offer page ID 91 URL http offer com offer1 php Share 50 2 offer page ID 92 URL http offer com offer2 php Share 50 Let s say you want to send visitors that land on the Level 1 LP 2 page directly to Level 3 and skip the Level 2 LP for them In this case you will modify the base2 php link from Level 1 LP 2 page to http cpviab base2 php clvl 3 This means that visitors will be redirected from Level 1 LP 2 page directly to a level 3 LP either Level 3 LP 1 either Level 3 LP 2 It s very important to keep the page IDs unique inside of a campaign in order to have the redirects working correctly CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 22 of 37 4 Linking to a Specific Option Group This was already possible in previous versions of CPV Lab using the id parameter appended to the base2 php or base3 php links but starting with version 2 17 it is recommended to use the new cogid parameter to specify the option group CPV Lab will rotate between all offers defined in the specific option group based on the shares For example if you have the Landing Page Sequen
6. CachingDelay option Specifies a time interval when clicks won t be aggregated by the Cron job For example if you run the Cron job every hour and set the CachingDelay to 600 seconds 10 minutes then clicks from the last 10 minutes before the Cron job execution won t be aggregated by this Cron job run These clicks will get aggregated by the next Cron job execution when again the last 10 minutes clicks will be skipped and so on This option is useful in order to aggregate clicks after visitors click to the offer page s for optimal caching of data CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 32 of 37 The CachingRemoveTime option Specifies the time interval to keep non aggregated clicks The non aggregated clicks will still be used by the Visitors Stats page and the Report Upload page so if your server has the resources it s recommended to keep 10 20 30 60 days of non aggregated clicks in the database together with the aggregated clicks It is important to keep some non aggregated data in the clicks table for Reports and Visitor Stats If you want to see Visitors Stats from the last 60 days then you have to keep 2 months of non aggregated data in the clicks table by configuring the CachingRemoveTime with a value of at least 5184000 seconds 60 days
7. Login into cPanel and find the Cron jobs page a PHD PPD a Eec a PHP PEAR PHP Fantastico Apache Image Packages Configuration De Luxe Handlers Manager gs FrontPage Extensions OA Index Error pages Manager Network Tools Enter the Cron job details in this page The recommended interval for the job to run is every 10 15 minutes or more Then enter as command cd home lt server name gt public_html cpvlab php cron cache php Or by an alternate command if the command above doesn t function properly on your server php home lt server name gt public_html cpvlab cron cache php Replace lt server name gt with the correct Server Name based on your server configuration This is a sample setup for the Cron job to run at 5 minutes over the hour every hour Add New Cron Job Minute 5 056 H Hour Every hour E Dey Everyday H Every monn a Everyweekday Command php home public_html cpv cron cache php iv lt a lt a lt lt Month Weekday Add New Cron Job Click the Add New Cron Job button and the new Cron job will appear in the jobs list MINUTE HOUR Day MONTH WEEKDAY COMMAND ACTIONS php home public_html cpv cron cache php Edit Delete CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab c
8. Page Offer URL or Campaign IF select redirect conditions ISP Carrier x is Continent Country State Region City Browser Browser Version Click To Call Cookie Support Data Rate Device Brand Device Model Device OS OS Version Dual Orientation Embedded Video Flash Support FLV Playback IFrames Support JavaScript Support a m Select Select Select Select Select Select Select Select THEN select redirect destination Redirect to LP Page A Redirect to Offer Rotate Active Offers Redirect to URL e Trends Heatmap Views to quickly identify top performing times of day by CTR CR ROI Subscriber Rate etc Data Type LP CTR Color Scale Day Hour CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com 4 09 4 24 4 13 4 11 4 36 3 90 Total 3 83 3 94 3 79 4 26 4 22 4 35 4 31 3 94 4 12 4 37 3 89 4 48 3 69 4 41 3 93 4 31 3 90 4 91 4 56 4 38 3 93 4 09 4 13 3 96 4 26 4 15 Export CSV Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 6 of 37 e Quick Stat Views feature for Target Performance Stats allows you to quickly change you Target Performance stats by specific data points Quick View Mobile Type of Device Select All Pag Ad gt Page gt Offer W Keyword gt Page CR KW gt
9. Pattern used to display dates DateShortFormat m d Y Pattern used to display short dates ThousandeSenaratorcsy Character used as thousands separator in export file Default is blank for Excel support DecimalSeparatorCsV Lara cuar Used as decimal separator in export file Default is For Excel support CookieTimeout 2592000 Time interval to keep the tracking cookie DoubleMetaRedirectPage baseredirect php Name of the page used for redirects using the Double Meta Refresh method LoopRedirectPage baseloopredirect php Name of the page used for redirects using the Redirect Loop method ClickbankSecretKey The Secret Key defined in Clickbank used only when tracking Clickbank conversions Controls if logging of Clickbank requests is enabled or ClickbankPixelLoggi fal ickbankPixelLogging alse ot Controls if logging for Affiliate Wi tsi AffiliateWindowPixelLogging false PIONS Ih TOBE INE TOT APATE WinBOW requests IS enabled or not The method used for external requests like additional RequestMethod auto pixels Controls if full referrer URLs are captured or just the CaptureFullReferrer false domain and page name without query string parameters Name of the custom header used to retrieve visitors CustomlpHeader IP addresses Wiencadebarsneier u Controls if the parameters appended to LP and Offer pages are URL encoded or not The options are defined in the constants users php
10. domain com lp php model sm_ device model PHP Snippet for Landing Page lt php echo isset S_GET model S_GET model gt Display Device Market Name Landing Page URL in CPV Lab http domain com lp php mname sm_ device marketing PHP Snippet for Landing Page lt php echo isset S_GET mname S_GET mname gt Display Keyword Target Landing Page URL in CPV Lab http domain com p php keyword target PHP Snippet for Landing Page lt php echo isset S_GET keyword S_GET keyword gt Display Additional Tokens Landing Page URL in CPV Lab http domain com p php token1 token1 PHP Snippet for Landing Page lt php echo isset S_GET token1 S_GET token1 gt Repeat for additional tokens in campaign token1 token2 token10 CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 18 of 37 Templating Campaigns If you want to create multiple campaigns with the same landing pages and offers but still need to know which campaign sent the visitor in the pages then you can use a template campaign and clone it The template campaign allows you to include the campid parameter in the landing page and offer URLs and all the campaigns cloned based on this template campaign will replace the wildcard with the act
11. save time in case you need to create campaigns with similar pages You can also modify each new campaign individually if you need to make small changes to it This feature will work even if you have different landing page URLs You can name your landing pages as e p2 php e p3 php e p4 php And then the template campaign will have the landing page URL as e http domain com lp campid ph When you clone this campaign 3 times you get 3 campaigns with the landing pages that will match the names from above e http domain com p2 php e http domain com p3 php e http domain com p4 php There are many variations for this feature and it can be used in multiple ways The main idea is that if you have the campid wildcard in a campaign and you clone it the wildcard will be replaced with the Campaign ID from the new campaign CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 20 of 37 Total Control Linking Options In CPV Lab 2 17 you have the option to link to a specific landing page offer level or path in addition to linking to a specific option group which was already possible Each option to link to a specific object is implemented using a different parameter that will be appended to the previous base page the page that redirects to the desired page 1 Linking to a Specific Lan
12. It s advised to start this with a higher value in order to not remove too much data initially and see how the server handles a larger number of non aggregated clicks As above for 60 Days or even higher using 7776000 seconds 90 days as the value for CachingRemoveTime and this means they will be able to upload reports for the last 90 days and also see Visitors Stats for the last 90 days Your Server Admin can fine tune these settings as they are server specific Each server has its own configuration and settings You Server Admin will be able to adjust these settings based on your server resources hardware and your individual needs for your volume of traffic They will check and monitor your Memory and CPU usage while the Caching CRON Jobs are running in order to see how much extra load it adds and can make adjustments to run the Cron job while not affecting other server processes if the requirements are high NOTE THIS DOES NOT REMOVE ANY DATA FROM YOUR STATS OR REPORTS CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 33 of 37 Common Questions about Caching Question Should I use caching Answer If you are tracking high volumes of traffic and notice any delays when loading stats or reports in the interface then Yes For Users that don t run high traffic do not need to enable caching as it wo
13. PLACEMENT OF SOFTWARE WHICH DOES NOT MEET THE ABOVE LIMITED WARRANTY UNLESS OTHERWISE STATED ABOVE THE SOFTWARE AND THE DOCUMENTATION SOLD WITH THIS PUBLICATION ARE PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND EITHER EXPRESS OR IMPLIED INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND PARTICULAR PURPOSE THE ENTIRE RISK ARISING OUT OF THE USE OR PERFORMANCE OF THIS SOFTWARE REMAINS WITH YOU IN NO EVENT WILL AUTHORS OR ANY OF ITS SUPPLIERS BE LIABLE FOR ANY LOST PROFITS LOST SAVINGS INCIDENTAL OR INDIRECT DAMAGES OR OTHER ECONOMIC OR CONSEQUENTIAL DAMAGES EVEN IF THEY HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES AUTHORS RESERVE THE RIGHT TO MODIFY THIS DOCUMENT AT ANY TIME WITHOUT OBLIGATION TO NOTIFY ANYONE IN NO EVENT SHALL AUTHORS OR ITS SUPPLIERS LIABILITY UNDER THIS AGREEMENT EXCEED THE SUM OF ANY AMOUNTS PAID HEREUNDER BY YOU TO AUTHORS OR THE SUPPLIER 4 TERMINATION The license will terminate automatically if you fail to comply with the terms conditions or limitations contained in this EULA including the payment of applicable license or other fees On termination you shall at Authors option either return or destroy all copies of the Software and documentation Otherwise this EULA shall remain in force until terminated You may terminate this EULA at any time by destroying all copies of the Software deleting any copies of the Software from your hard drives ceasing all use of the Software a
14. Page 1 of 37 Q CPV Lad Version 2 17 FEATURE GUIDE CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 2 of 37 END USER LICENSE AGREEMENT EULA FOR CPV LAB This End User License Agreement EULA pertains to the CPV Lab product called Software in this Agreement Read the terms and conditions of this End User License Agreement EULA before installing copying or using CPV Lab This End User License Agreement EULA is a legal agreement between you either an individual person or a single legal entity who will be referred to in this EULA as you or Customer and the owner s of CPV Lab Authors By clicking I accept installing copying or otherwise using any part of the above Software you agree to be bound by the terms of this EULA If you do not agree to the terms of this EULA promptly return the unused Software to your supplier for a full refund 1 GRANT OF NON EXCLUSIVE LIMITED LICENSE The Software is licensed not sold Any rights not clearly and expressly granted to you under this EULA are reserved to the Authors Provided you have paid all applicable fees and complied with this EULA then you are granted the following personal perpetual subject to termination as set forth below non exclusive non transferable limited rights a You may use the Software on a single d
15. Performance Offer Visitors 12 Signup Free Monitor CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 12 of 37 e Added ability to see older visitors in Visitors Stats control to choose the interval Visitor Stats Filters Select Campaign All Campaigns IP Interval Country Records to show Target Auto refresh every Option to view records by Visit Date in the Conversions List page p Conversions List Select Campaign All Campaigns Interval from 11 27 2013 Bel mm dd yyyy to 12 01 2013 a mm dd yyyy CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 13 of 37 Functions e Greatly expanded features to Pass and Post Data to amp from CPV Lab See below for details info Passing and Posting Data Allow keyword to be passed in the additional pixel URLs Option to pass mobile details to LP Allow wildcards in offer URLs for Extra Tokens token1 token2 ladtoken e Option to define a template campaign with the campid wildcard in URLs and clone for new campaigns See below for detailed info Templating Campaigns e Custom pixel page for Affiliate Window e Ability to fire the tracking pixel from JavaS
16. Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 31 of 37 A typical caching configuration section from the constants user php looks like this Controls if cached data are used in application true or false values you must also setup the Cache Cron job S GLOBALS UseDataCaching true The maximum number of clicks processed in a single Cron job execution GLOBALS CachingMaxItems 10000 The delay in aggregating clicks clicks from the last xxx seconds won t be aggregated yet in seconds 300 5 minutes 600 10 minutes 900 15 minutes 1800 30 minutes GLOBALS CachingDelay 600 The interval after which clicks are removed from the clicks table after these clicks have been aggregated in seconds 86400 1 day 432000 5 days 864000 10 days 1728000 20 days 2592000 30 days GLOBALS CachingRemoveTime 2592000 The CachingMaxltems option Should be set to a value that is greater than the number of visitors you usually receive in the time interval between 2 consecutive Cron job executions Setting this option to a large value will slow down the server on the first few Cron job runs if you have a large existing database with non aggregated data applies to upgrades because on new installations you won t have any non aggregated data initially The
17. ampaigns php Or by an alternate command if the command above doesn t function properly on your server php home lt server name gt public_html cpvlab cron campaigns php Replace lt server name gt with the correct Server Name based on your server configuration Add New Cron Job Common _ Ta Seltings Common Settings x Minute 15 Hour Everyhour W Day Every day m Month Everymonth E 4 Weekday Every weekday m Command php home public_html cpvlab cron campaigns php Add New Cron Job 3 Click the Add New Cron Job button and the new Cron job will appear in the jobs list Current Cron Jobs MINUTE HOUR DAY MONTH WEEKDAY COMMAND ACTIONS php home public_ html cpvlab cron Edit Delete campaigns php 15 CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 37 of 37 Knowledgebase amp Helpdesk www lTheLabHelpdesk com CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com
18. asted on the campaigns php page it is moved in a separate process so users won t have long intervals when logging into the application Activation In order to activate the Cron job in CPV Lab and stop performing those calculations inside the page you have to check the option Use Cron Job for data on campaigns php from the Settings page V Use Cron Job for data on campaigns php Installation The CRON job consists of a PHP page cron campaigns php that will be called periodically and will perform the calculations The job can be configured in cPanel by following the next steps 1 Login into cPanel and find the Cron jobs page es php php on a PHP PEAR PHP Fantastico Apache Image Packages Configuration De Luxe Handlers Manager 2 E 2 YY 5S a Ind Error FrontPage Network or pages Extensions ee Manager Tools G Submit a MIME Types Sunnnrt CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 36 of 37 2 Enter the Cron job details in this page The recommended interval for the job to run is Every 15 minutes meaning you have to enter 15 for Minute and for Hour Day Month Weekday these options can also be selected from the dropdown controls on the right Then enter the command cd home lt server name gt public_html cpvlab php cron c
19. bile device market name e lispcarrier will be replaced with the ISP Carrier name CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 15 of 37 The wildcard tokens that can be used in the offer page URLs are e subid will be replaced by the CPV Lab SubID e ltoken1 Itoken2 token10 will be replaced with the Extra Token 1 10 value e ladtoken will be replaced with the Ad Token value The wildcard tokens that can be used in the additional pixel URLs are e target will be replaced by the actual target keyword e subid will be replaced by the CPV Lab SubID e ltoken1 Itoken2 token10 will be replaced with the Extra Token 1 10 value e revenue will be replaced with the conversion revenue amount e tscode will be replaced with the traffic source hidden token value 3 Automatic passing of parameters through the base pages All base pages base php base2 php base3 php will forward all other parameters that are not Targets Ad Tokens or Extra Tokens to the next page which can either be a landing page or an offer page These parameters are forwarded unchanged exactly as they are received by the base page Example if you have a campaign with the following options e Target is captured from the keyword parameter e Pass Ta
20. ce campaign 1 landing page ID 1 URL http domain com Ip1 php Share 50 2 landing page ID 2 URL http domain com p2 php Share 50 Option Group 1 Offer1 ID 11 URL http offer com offer1 1 php Share 20 Option Group 1 Offer2 ID 12 URL http offer com offer1 2 php Share 80 Option Group 2 Offer 1 ID 21 URL http offer com offer2 1 php Share 20 Option Group 2 Offer2 ID 22 URL http offer com offer2 2 php Share 80 If you want to link from the first landing page to an offer from the first option group and to link from the second landing page to an offer from the second option group then you have to use the following links in your landing pages In the first landing page http cpvilab base3 php cogid 1 In the second landing page http cpvilab base3 php cogid 2 If you have existing campaigns that use the id parameter you can leave the campaigns unchanged as we ve preserved this functionality but for New campaigns use the new cogid parameter to link to a specific option group 5 Linking to a Specific Path In a Multiple Path campaign you have the option to send visitors to a specific path instead of rotating paths based on share This is possible using the clpth parameter appended to the Campaign URL For example if you want to always send visitors to the second path in a Multiple Paths cana then you will use the campale URL like This means that visitors will be always redirected to a landing page defined in the
21. cript script version of the pixel e Option to register referrers without query string default and with query strings e Allow selecting the request method to use for 3rd party pixels e Ability to read IP from different HTTP header with configurable setting for servers with reverse proxy e Option to change the Campaign Key e Ability to redirect to a specific path with the redirect profiles e Ability to define is not redirect conditions e Wildcards in the LP URL for the Geo metrics mm_continent mm_country mm_state mm_city e Redirect conditions based on the user agent e Option to copy redirect profiles from one campaign to other campaign e Option to register conversions only from statuses that represent a sale in Clickbank CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 14 of 37 Passing and Posting Data There are several options to pass data from CPV Lab to landing pages and offers 1 Using the predefined options in the campaign setup pages The following checkboxes control which parameters are passed e Pass Target to LP allows passing the target to the landing page using a parameter that can be specified in the corresponding textbox e Pass Target to Offer allows passing the target to the offer page using a parameter that can be specified in the corresponding tex
22. ding Page In order to link to a specific landing page from the Campaign URL you will use the clpid parameter in the Campaign URL followed by the Landing Page URL for the page you want to link to For example you have a campaign with the following details 1 landing page ID 1 URL http domain com lp1 php Share 33 2 landing page ID 2 URL http domain com Ip2 php Share 33 3 landing page ID 3 URL http domain com Ip3 php Share 34 By default CPV Lab will rotate through these 3 LPs based on the shares But if you want to always link some visitors to the second landing page you will use the clpid parameter in the Campaign URL for those visitors All visitors that come through this link will always land on the second landing page lp2 php no matter what the share percentage is set in the campaign It is very important to define unique Landing Page IDs inside a campaign The clpid parameter can also be used to link from a Level 1 landing page to a specific Level 2 landing page but in this case the parameter will be appended to the base2 php link instead of the Campaign URL If you have a Landing Page Sequence campaign then you can use the following link in a level 1 landing page In this example 21 is the Landing Page ID of a landing page located on the second level http cpviab base2 php clpid 21 CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is
23. es Traffic Sources and Affiliate Networks e Display only a fixed number of characters in columns with URL Data Ex Referrer URL Customizable in Settings Limit URL columns to 50 characters 0 for unlimited CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 11 of 37 e Conversions List page added options to Show Hide columns and add extra tokens 12 Options Selected x L R E E all Revenue SETAE 32 00 h593v8b Default Column Order 32 00 9uprd o Campaign Data E 32 00 7kvora5 JID 32 00 h593v8b F Campaign 32 00 rwbr n1 Keyword Target 26 00 r9lpy7ep Page 32 00 Quprd o Page URL 32 00 hablhucr a 32 00 rworend Ofer 32 00 Suprd6o H Offer URL 32 00 refv8sd Clicks amp Conversions 32 00 h4blhucr Visit Date 26 00 7kvoraS Conversion Date 32 00 oii boo SEN e Added Visit Date Time and Visit to Conversion Duration columns in Conversions List page Visit Date Conversion Date Conversion Duration Keyword Target 12 11 2013 12 11 2013 6 28 6 27 AM AM 1 min 0 sec home healthcare supply 12 11 2013 12 11 2013 6 13 6 11 AM AM 1 min 34 sec home medical supply 12 11 2013 12 11 2013 6 10 8 6 09 AM AM 34 sec medical supplies online e Avg Visit to Conversion Duration column in Offer Performance Stats x Offer
24. gated data in order to lower the page load times The Visitors Stats and Reports Upload pages will still use non aggregated data CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 34 of 37 Question Records disappeared from the clicks table Answer This is normal and it is done in order to keep the clicks table size under control Old visitors details will be removed from the clicks table only after they were aggregated so nothing is lost because reports can be obtained from the aggregated data You can configure the time to keep clicks in the database with the CachingRemoveTime configuration option Question have visitors that convert after a long interval of time 24 hours should I set the CachingDelay configuration option to not aggregate data from the last 24 hours Answer No that is not necessary Conversions will be marked correctly in the database even if the click of the visitor the converted was previously aggregated The conversion will be added to the aggregated records in this case Question want to upload a list of converting subIDs for old visitors that were already aggregated Will this work Answer Yes this will work and the uploaded conversions will be marked in the aggregated data This will work even if the original visitors details were re
25. le Data Points available E Mobile Data Mobile Browser Content Support Device Info Device Usage El Browser E Click to Call El Brand Fl Dual Orientation El Browser Version Flash Support Data Rate L Phone Support _ Cookie Support FLV Playback _ Device Model L Pointing Method El 3rd Party Cookies F MoV Playback El Device Name E QWERTY Keyboard Embedded Video MP4 Playback Device Type IFrames Support PDF Support _ ISP Carrier Cl Javascript Support Receive MMS l Market Name Receive PUSH Oos Receive SMS Clos Version RSS Reader Cl Screen Resolution El Screen Size Cl Wifi Support e Mobile Audience Stats Quickly View a Breakdown of your Mobile Visitors to identify top performing Brands Carriers Devices Data Rates and Specific Features Based on the Visitors Device Campaigns Add Campaign Stats B Reports Trends Blocked Traffic Stats Conversions List Mobile Audience Overall Campaign Performance Home Delivery Confirmed Signup Direc Shaak L OCD ok BTC Visitor Stats RA enue ae AMIANAN CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 5 of 37 If Then Redirects to redirect visitors based on multiple conditions using over 30 data options Send visitors to a Specific
26. moved from the clicks table Question want to remove a false conversion from the database for a visitor that was already aggregated Is this possible Answer Yes you will use the Stats Management page for this Settings gt Stats Management The conversion and the associated revenue will be removed from the aggregated data Question Do I need to keep running the Cron job for the Campaigns page cron campaigns php if I run the Cron job for caching cron cache php Answer No if you have caching enabled you can Remove the Cron job for the Campaigns page This process will be completed in the new CRON Job In fact the Cron job for the Campaigns page checks if caching is enabled and exits quickly in this case CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 35 of 37 CRON Jobs for Campaign Data Optional and recommended for high traffic users who DO NOT have caching enabled NOTE If you have TrueCache Enabled do not run the Campaign Data CRON Job as this process is already built in to Caching Process This feature gives you the option to move some operations from the Campaigns page in an offline process that can be run periodically as a Cron job These operations calculate data on the Campaigns Page The main advantage is that the amount of time required for the calculations isn t w
27. n t be required You also need to have some server knowledge in order to enable and customize caching on your server Question How often should setup the Cache Cron job to run Answer This depends on what you need to see in reports and if you need real time data and the delay in data that you can accept The default setting is to run the Cron job every hour but you can lower or increase this interval based on your needs It s very important that you don t set a very small interval that won t allow the previous Cron job execution to complete for example if the Cron job takes 2 minutes each time to execute and you set the interval between executions to 1 minute For Users with Solid Hosting 5 15 minutes will work well However users with lower performance servers may need a higher time interval to complete the CRON job Question Visitors don t appear in Stats I ve tested with the Campaign URL and no visitors appear in the Stats page Answer When the Stats page uses cached data there is a delay before the Cron job runs so visitors won t appear immediately You can use the Visitors Stats page to check real time traffic Question I m keeping non aggregated data in the clicks table together with aggregated data in the cache tables Which version of data will be used in reports Answer When caching is enabled with the UseDataCaching configuration option pages that allow caching will use the aggre
28. nd documentation and providing satisfactory proof to the Authors that you have done so The disclaimer of warranty and limitations on liability contained in Section 3 shall continue in force even after your rights to use the Software are terminated CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 3 of 37 Table of Contents Version 2 17 Update List 2 17 Primary Feature Sisidae irun Enean Oar a EEEE EEA 4 2 17 UO VSN CCS oarnicosusorsniernnnana n E i AA 8 217 INterf ICER 10 PAT FUNCIONS eucons T E OE 13 Detailed Information Passing and POSEN Data cp unwestovesisunsncesnasia ii E E RE 14 Templating CON glen orimsnmonares renna R 18 Total Control Linking ODtiONS sisisi 20 Confieuration OPtiONS sissano E REE EANA 24 TrueCache Caching for High Volume USePS s cscccsssssssssesseessscsssenscestecseeeeeaes 28 CRON Jobs for Campaigns Page Data iio dinsssiccsnnisuianitecsssvsgedsesiniseseieniadacuiaawaaniaden 35 CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 4 of 37 Version 2 17 Update List Primary Features e Full Mobile Detection and Stats including Mobile Carriers and Automatic Updates of Detection Databases every 2 weeks or less Over 30 Mobi
29. om Page 30 of 37 Edit Server Setting Before enabling caching increase the group_concat_max_len system variable in MySQL to a larger value at least 1048576 1MB for medium volumes of traffic for high traffic set to could be 10485760 10MB The maximum allowed value for this variable is 4294967295 4GB however you don t need to adjust this setting close to that This is a system variable that should be changed the web host since it cannot be modified from PhpMyAdmin on most servers Configuring Caching Caching can be configured based on the server settings and properties using 4 configuration keys from the constants user php file from the lib folder If these keys don t exist in your constants user php file you can add them at the end of the file before the last sign Option Name Default Value Description true if caching of data is used beside this UseDataCachi fal j seVataLacning oF option you also have to setup the Cron job The maximum number of clicks that are CachingMaxit 10000 i i ACNINEIVIAXLEmS processed in a single Cron job execution The delay in aggregating clicks clicks from the CachingDel 600 ACUE ay last xxx seconds won t be aggregated yet The interval after which clicks are removed from CachineR Ti 2592000 achingRemove lime the non aggregated state CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com
30. omain for personal purposes for each license you have acquired or copy the Software for archival and disaster recovery purposes provided any copy must contain all of the original Software s proprietary notices Each user using the Software must own a license b You may not decompile disassemble extract or otherwise reverse engineer any of the Software You shall not have the right to obtain or use any source code for the Software nor copy reproduce or distribute the Software except as provided above You agree not to share rent lease or loan the Software You may not make any commercial use of the Software code except as expressly permitted under this Agreement 2 COPYRIGHT The Software and documentation is copyrighted by the Authors All Rights Reserved Making unauthorized copies is prohibited by law No part of the software or documentation may be reproduced transmitted transcribed stored in a retrieval system or translated into any human or computer language without prior written permission 3 WARRANTY REMEDY AND LIMITATIONS A YOU ARE GRANTED A LIMITED WARRANTY THAT THE SOFTWARE WILL PERFORM IN SUBSTANTIAL ACCORDANCE WITH THE ACCOMPANYING USER MANUAL FOR 56 DAYS FOLLOWING YOUR RECEIPT OF THE SOFTWARE THIS IS YOUR ONLY WARRANTY B AUTHORS ENTIRE LIABILITY AND YOUR EXCLUSIVE REMEDY FOR ANY CLAIM YOU MAY HAVE AGAINST AUTHORS SHALL BE AT AUTHORS OPTION I RETURN OF AMOUNTS PAID FOR THE APPLICABLE SOFTWARE OR II REPAIR OR RE
31. param name S_GET param name gt For ssl ane you enter a Landing Page URL in the CPV Lab campaign setup page as When a visitor hits the page the wildcard gets replaced by the actual ISP Carrier let s say Verizon so gona will land on the following URL In order to display the ISP Carrier in the LP you will use the following code lt php echo isset _GET visitor_isp _GET visitor_isp gt Notice the parameter name visitor _isp is the exact same as it appears in the URL The parameter name in this case is visitor _isp and the parameter value is Verizon The parameter name can be anything it doesn t have to be visitor _isp it could be qqqqq or qazwsx or isp anything but it must match the PHP code used to retrieve it The above code will display Verizon on the Landing Page And the Landing Page must be saved as php for the PHP code to run You can display various data from the campaign to visitors using the same method above Display Device Brand Landing Page URL in CPV Lab http domain com lp php brand sm device brand PHP Snippet for Landing Page lt php echo isset S_GET brand _GET brand gt CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 17 of 37 Display Device Model Landing Page URL in CPV Lab http
32. re to Remove false conversions from database igs Remove False Conversions SublIds or ClickIDs one per line CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 9 of 37 e Remove clicks based on Extra Token values and SublD ClickID Ls Stats Management is Remove Stats Campaign All Campaigns iy Target Keyword Date from E to a3 mm dd yyyy IP Address e Ability to block traffic containing a specific text in the referrer lt q gt Add Blocked Traffic Rule Rule Name Block range of IPs from to Block User Agents containing Active CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 10 of 37 Interface e Multi Select Controls Added to Show Hide Dropdown Menu on All Pages Filters All Targets All Pages All Offers x e Ability to filter by Visitor Type Target Page and Offer in Stats All Visitors x a v Checkall x Uncheck all ix Traffic Source Campaign Visitors V Direct Visitors Device Type V Computer Visitors E Mobile Visitors i e Drag and Drop Re Ordering and Re Sizing of Columns in Stats Tables e Export Import Options to Move and Share Settings for Alert and Optimization Profil
33. rget to LP is checked and selected parameter is mytarget e Extra Token 1 is defined with parameter source and the option to pass it to LP is checked The LP URLis http domain com Ip php subid subid amp device sm device model Then if you have a visitor using an iPhone and calling the Campaign URL like http cpvlab base php c 1 amp key amp keyword ebooks amp source web amp additional ismobile The LP URL the visitor will be redirected to will be http domain com lp php subid qazwsx 1 1 amp device iPhone amp mytarget ebooks amp source web amp additional ismobi The parameters from the LP URL are e subid and device passed from the 2 wildcard tokens that where replaced with the actual values e mytarget passed because the Pass Target to LP option was checked e source passed because the option to pass Extra Token 1 to LP was checked e additional passed because it was forwarded by the base php page CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 16 of 37 Posting Data to Landing Pages The parameters passed to the landing pages can be displayed on the page with any programming language If you have a landing page saved as php then the simplest operation to display a parameter passed in the URL using the following PHP statement lt php echo isset S_GET
34. roduced in version 2 17 are 1 ClickbankPixelLogging This is used to test and identify issues with Clickbank conversions It should stay set to false until CPV Lab support tells otherwise 2 Affiliate WindowPixelLogging The same as above but will debug Affiliate Window conversions 3 RequestMethod Controls what method is used to make external requests like firing additional pixels Possible values are e auto default option CPV Lab automatically selects the request method based on server settings e contents use the file_get_contents PHP function for requests e curl use cURL for requests o If you know that your server doesn t allow the file_get_contents function then you can change this option to curl and the cURL library will be used for external requests o When set to auto CPV Lab will detect if the file_get_contents function is not enabled and will automatically switch to CURLrequests 4 CaptureFullReferrer The referrer URLs are composed from 2 parts first part is the domain page name and the second part contains the query string parameters The query string parameters are not important most of the times and will just take up space in the database That s why the default option is to capture referrers without query string parameters If you need to see the query string parameters then you have to set the CaptureFullReferrer option to true in the constants users php file
35. second path for that campaign CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 23 of 37 Linking Quick List When you want to link to a specific page offer level option group or path Simply append the corresponding parameter and the object ID in the previous base link Object Parameter Example Value Replace XX with Supported URL s Landing Page clpid amp clpid XX a valid Landing Page ID Campaign URL base2 php for Level 2 Offer Page cloid amp cloid XX a valid Offer ID base2 php or base3 php Level clvl amp clvl XX a valid Level index base2 php Option Group cogid amp cogid XX a valid Option Group index base2 php or base3 php Path clpth amp clpth XX a valid Path index Campaign URL CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Configuration Options Page 24 of 37 Configuration options can be used to control the look and behavior of CPV Lab These options can be modified by editing or adding lines in the constants user php file inside the lib folder You can see the available options and their default values in the table below Option Name Default Value Description DateFormat m d Y g i A
36. sh Support Data Rate Phone Support E Cookie Support L FLV Playback L Device Model Pointing Method E 3rd Party Cookies MOV Playback E Device Name E QWERTY Keyboard Embedded Video MP4 Playback E Device Type E IFrames Support El PDF Support E 1sp Carrier Javascript Support L Receive MMS Market Name Receive PUSH os LI Receive SMS JOS Version RSS Reader l Screen Resolution Screen Size LI Wifi Support CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 7 of 37 e Trends Ability to Filter by Target Page Offer and by specific days of the week Filters All Targets All Pages All Offers Filter by Day All Days W Monday WV Tuesday W Wednesday v Thursday v Friday v Saturday v Sunday e Record Desktop Laptop Users Operating Systems Browser and Versions e True Cache to enhanced Volume Capabilities Increase Responsiveness of User Interface CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Improvements Page 8 of 37 e Option to upload conversion date in the Update SubIDs page w Update Stats Enter Converting SubIDs Select Campaign All Campaigns Additional details Revenue Conversion Date e Improved featu
37. strictly prohibited without the authorized consent from CPVLab com Page 21 of 37 2 Linking to a Specific Offer Page Linking to a specific offer page from the landing page is done using the cloid parameter in the base2 php or base3 php link used to get to the offer If you have a campaign with the following details 1 landing page ID 1 URL http domain com p1 php Share 50 2 landing page ID 2 URL http domain com p2 php Share 50 1 offer page ID 11 URL http offer com offer1 php Share 20 2 offer page ID 12 URL http offer com offer2 php Share 80 If you want to always link from the first landing page to the first offer and from the second landing page to the second offer then you have to use the cloid parameter in the base2 php links from the landing pages like this LP1 will have the link as http cpvlab base2 php cloid 11 LP2 will have the link as http cpvlab base2 php cloid 12 As with Landing Page ID s It is very important to define unique Offer IDs inside the campaign 3 Linking to a Specific Level You can now link to a specific level inside a Landing Page Sequence campaign using the clv parameter followed by the level number In this case CPV Lab will rotate between all landing pages defined in that specific level based on the shares defined for the landing pages If you have a campaign with the following details Level 1 LP 1 ID 11 URL http domain com p1 1 php Share 40 Level 1 LP
38. tbox e Pass Cookie to Offer allows passing the tracking cookie to the offer page s in order to be posted back in the CPV Lab tracking pixel URL for marking conversions e Append SublD to LP Offer appends the CPV Lab SublD to the landing page or Offer page this option will not append the parameter it only appends the SublD value so the parameter must be specified in the LP Offer URL like amp SubID e Pass Ad Token to LP Offer only for CPC campaigns will append the Ad Token value using the same parameter that it was captured from e Pass Extra Token 1 10 to LP Offer will pass the Extra Token value using the same parameter that it was captured from 2 Using wildcard tokens in the LP Offer URLs CPV Lab offers predefined tokens that can be placed in the landing page and offer URLs and will be replaced with the actual values for each visitor before they get redirected to the URLs The wildcard tokens that can be used in the landing page URLs are e target will be replaced by the actual target keyword e subid will be replaced by the CPV Lab SubID e ltoken1 Itoken2 token10 will be replaced with the Extra Token 1 10 value e ladtoken will be replaced with the Ad Token value e sm_device_brand will be replaced with the mobile device brand e sm_device_model will be replaced with the mobile device model e sm_device_marketing will be replaced with the mo
39. ual Campaign ID The template campaign won t be used for tracking visitors all the campaigns cloned from the template campaign will do the tracking The template campaign will be defined just like a normal campaign but you will place the campid wildcard in the landing page and offer names and URLs where you want the Campaign ID to appear For example the template campaign will be CampaignID 1 e Landing Page Name LP for Campaign campid e Landing Page URL http domain com lp php source camp campid e Offer Name Offer for Campaign campid e Offer URL http offer com page php source campid Now Clone the template campaign and create the first campaign that will receive traffic CampaignlID 2 e Landing Page Name LP for Campaign 2 e Landing Page URL http domain com Ip php source camp2 e Offer Name Offer for Campaign 2 e Offer URL http offer com page php source 2 CPV Lab 2 17 Update Feature Guide Copyright 2010 2015 CPVLab com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab com Page 19 of 37 When you clone the template again you get the second campaign for traffic CampaignlID 3 e Landing Page Name LP for Campaign 3 e Landing Page URL http domain com lp php source camp3 e Offer Name Offer for Campaign 3 e Offer URL http offer com page php source 3 And so on You can clone the template campaign as many times as you need This will
Download Pdf Manuals
Related Search