Clickbank Instant Notification

• [Clickbank] (https://cpvlab.pro/blog/2023/02/28/clickbank-integration-cpv-lab/) uses a different format for the Postback URL and passes encrypted details about conversions.
• CPV Lab Pro (opens new window) offers a dedicated Clickbank Postback URL that will decrypt data and mark conversions in the database.
  • In order to decrypt data you need to define the same Secret Key both in Clickbank and in CPV Lab Pro.
  • The Secret Key can have a maximum of 16 uppercase letters and digits.

You’ll setup your campaign as you normally would but when entering your Clickbank offers you need to allow the steps below:

1. Select Clickbank as the Offer Source.

• Clickbank must be selected as the Offer Source or the SubIDs will not work correctly.
• CPV Lab Pro generally uses spacing characters _ in SubIDs, but these types of characters are not allowed in Clickbank Tracking IDs.
  • So when Clickbank (exactly as show) is selected then CPV Lab Pro will automatically change the spacing character in the SubIDs to “z” in order to pass correctly to Clickbank.
• Go to Sources -> Offer Sources and import Clickbank from the catalog.

2. Entering Clickbank Offer URLs

• Go to "LP & Offers" menu and add your Clickbank offers
  • make sure you select Clickbank as your Source
  • you can add the offers directly in the campaign setup as well
• When entering Clickbank Offer URLs, be sure to include the Tracking ID Parameter they support to the end of the offer URL followed by the "subid" macro as: &tid={!subid!}

3. Setup Clickbank Instant Notifications for Conversion Tracking

• In your Clickbank Account

  • go to the My Site page under Vendor Settings menu, then click Edit in the Advanced Tools section

  

  • enter the secret key that you set above
  • set the Instant Notification URL to: http://cpvlabpro-domain/adclick-cb70.php
    • make sure you replace cpvlabpro-domain with your actual domain name
  • Select Version 7.0 and then Click TEST IPN.

  

• If the URL is correct, you should see a Verified message appearing next to the URL

  

• Clickbank will automatically send the following parameters to the URL:

  • ctid – the Clickbank transaction ID which must be setup to be the CPV Lab Pro subID
  • caccountamount – the conversion revenue (in cents)

• CPV Lab Pro will read these 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 won’t execute

  • so in this case only server-to-server 3rd party pixels will fire (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 Pro will sum the revenues that were sent from Clickbank.

• Go to the Configuration Editor page (under Settings) and edit the Clickbank Secret Key and Clickbank Sale Status variables;

  • Enter the same Secret Key that you have entered in your Clickbank account previously:

  

Potential Issues & Solutions

1. Error message when entering the Instant Notification URL in Clickbank

Error:

• if you get the error : The service returned the response code 503 when entering the Instant Notification URL in Clickbank (image below)

• This error may appear when you have Cloudflare enabled on the tracking domain and "Bot Fight Mode" enabled in the Firewall section from Cloudflare.

Solution:

• Cloudflare will consider the Clickbank requests as bot requests and they will get blocked.
• The solution is to disable the "Bot Fight Mode" in the Firewall section from Cloudflare.

Find more details in the video below:

Video Tutorial for setting up your Clickbank campaign in CPV Lab (opens new window)