Configuration Editor

Navigation: Settings ➡️ Configuration Editor

The Configuration Editor page shows the default values for your ad tracker as they are the first time.

  • You only need to edit the settings that you are sure about, as the default values will work fine most of the times.

Configuration editor page

  • If you are unsure about what a setting is for, then you can click on the small 'i' icon and a tooltip window will open with more details.

Configuration tootltip

There are multiple categories of settings which can be changed:

  • General Appearance Settings - here you can change the appearance of the tracker like: date format, menu on top or on the left, the thousands separater.

General Appearance Settings

Option Name Default Value Description
Date/Time Format m/d/Y g:i A The pattern used to display dates in the application
Short Date/Time Format m/d/Y The pattern used to display dates in the short format in the application
Maximum Multiselect items 1000 The maximum number of items that will be displayed in the multiselect controls
Thousands Separator in CSV files The character used as thousands separator in the exported CSV reports
Decimal Separator in CSV files . The character used as decimal separator in the exported CSV reports
Pages Layout Menu on the left side - minimized General pages layout used in the application

Example: you can change the application layout with the option "Page layout"

  • There are 3 layouts available:
    • Menu on Top
    • Menu on the left (minimized)
    • Menu on the left (hidden)

Configuration choose layout

Configuration menu items

Tracking Settings

Option Name Default Value Description
Tracking Cookie Lifetime 30 Days Time interval to keep the tracking cookie in visitors' browser
External Requests Method Automatic The request method to use for external requests like 3rd party pixel calls
Custom Header for IP Address If the visitors' IP address is passed using a custom header, specify the header name here. Useful when running reverse proxies.
Capture Full Referrer OFF Whether to capture the full referrers including the query string or just the page names
Mobile Detection Method New Mobile Database The Mobile Detection Method to use
Computer Detection Method Alternative Computer Database The Computer Detection Method to use
Google Conversion Key The Key used to authenticate Google requests when uploading conversions to Google Ads
Bing Conversion Key The Key used to authenticate Bing requests when uploading conversions to Bing Ads
Encode URL Params ON Whether to apply URL encoding to parameters added by the tracking links
No Cost for Bots ON Whether to set 0 as the cost for bot traffic
Direct Traffic Logging OFF Whether to log direct traffic calls, use only when debugging direct traffic issues
Clickbank Secret Key The Clickbank Secret Key used in your Clickbank account
Clickbank Sale Status Statuses sent from Clickbank that will mark a conversion in CPV Lab Pro (default: SALE,JV_SALE,BILL,JV_BILL)
Capture Full Referrer this settings tells the tracker if it should capture the full referrer, with parameters, or only the page name
Check blocked Traffic this settings tells the tracker if it should ignore bot traffic coming from ad networks
Pages Rotation method this defines the algorithm used by the tracker to rotate the offers or landing page

Configuration editor tracking settings in CPV Lab

Landing Page Protection Settings

Option Name Default Value Description
Protection Timeout (minutes) 5 Maximum allowed time to access the Landing Page before it becomes inaccessible
Protection Level UserAgent + Time The level of LP protection - based on several metrics retrieved from visitors
Default No-access Message No Access Default message to show for unauthorized LP access

Configuration editor landing page protection settings in CPV Lab adn CPV One

Page Name Settings

In this section you can change the name of the pages used for tracking by your ad tracker.

  • For example:
    • if the links to the offers are tracked with based2.php, you can rename it to "gotooffer.php"
    • after you do the setting, all your link to the offer generated by the ad tracker will use this new page name
Option Name Default Value Description
Campaign URL Page base.php Name of the Campaign URL page
Offer Redirect Page base2.php Name of the Offer Redirect page
Offer Redirect LPS Page base3.php Name of the Offer Redirect for Landing Page Sequence campaigns page
Tracking Pixel / Postback URL Page adclick.php Name of the Tracking Pixel / Postback URL
Tracking Pixel iframe Page adclickf.php Name of the Tracking Pixel iframe
Tracking Pixel script Page adclicks.php Name of the Tracking Pixel script
Subscribers/Lead Pixel Page adsub.php Name of the Subscribers/Leads Pixel
Double Meta Refresh Page baseredirect.php Name of the Double Meta Refresh page
Redirect Loop Refresh Page baseloopredirect.php Name of the Redirect Loop Refresh Page

Configuration editor change tracking page name settings in CPV Lab and CPV One

Email Notification Settings

In this section you can define a SMTP server and all email details to get notifications from CPV Lab. All the notifications sent by CPV Lab and CPV One are sent based on the Alert Profiles you have defined.

Example when you can receive notifications:

  • if a campaign has received a number of visitors for the first time ( like reaching 1000k vsits)
  • When your can campaign gets more than 1000 visitors and less than 10 conversions /subscribers
  • etc

The Email Notification settings require the following information to have the STMP (email) setup and get notifications about your CPV Lab campaigns:

Option Name Default Value Description
SMTP Server The name of the SMTP (email) server to be used to send emails
SMTP Port The SMTP Port for the email server
SMTP Transport TLS (encrypted) The way the emails should be sent, encrypted or not
Email Login The email adress used to send the emails
Email Password The password for the email account used to send notifications
From Name CPV Lab Pro The name that should appear as FROM in the email
From Email The email to show up in the from
Email Subject CPV Lab Pro Notifications The email subject
Send HTML Email no If the emails should be sent in a HTML format or not
STMP Authentication On Use SMTP authentication when sending emails

Configuration editor email notifications s in CPV Lab and CPV One

True Caching Settings

This section from CPV Lab | CPV One is used to define if you want to aggregate your data in your reports.

  • it is very useful if you run high traffic (more than 100K visitors per day)
  • it will allow all the reports in the tracker to load faster

Here you will setup:

  • Whether to use cached data in reports;
    • you must also setup the Cache Cron job for this.
    • Here you can find more details about True Cache
  • By default it is Off
Option Name Default Value Description
Clicks to process at once 10000 The maximum number of clicks processed in a single Cron job execution
Delay in aggregating clicks 10 Minutes The delay in aggregating clicks in order to keep the most recent clicks not aggregated
Click removal delay 30 Days The interval after which already aggregated clicks are removed from the non-aggregated table
Conversion removal delay 30 Days The interval after which conversions cannot be marked in the aggregated data

Configuration editor true caching in CPV Lab and CPV One

Geo Cron Job Settings

The GEO Cron Job settings is used by CPV Lab users if they want to use a separate Cron Job for GEO data.

  • Important: you must also setup the Cache Cron job for this.
  • Here you can find more details about Capturing Geo Data
  • By default it is Off
Option Name Default Value Description
Clicks to geo-encode at once 2000 The maximum number of clicks geo-encoded in a single Cron job execution

Configuration editor true caching in CPV Lab and CPV One

Cron Jobs General Settings

The Cron Jobs section is used to setup information about the cron-jobs that are running behind CPV Lab. The settings here are important especially for CPV Lab users. For CPV One users, the cron-jobs are automatically managed by the devops team managing the CPV One server.

Configuration editor cron jobs settings in CPV Lab and CPV One

Last Updated: 6/14/2021, 11:18:56 PM