Knowledge Base         


How do I track sales with my affiliate network?


ClickMagick works with all networks that support tracking pixels, tracking code, Sub-IDs, server-to-server Postback URLs, and other standard tracking methods. For more information on the different methods with which you can track sales, read this article.

Select your affiliate network below to see how to integrate it with ClickMagick.



If you want to track sales with ClickBank, you can either set up a Postback URL (covered in this article) or use tracking pixels (Integrated Sales Reporting). You can read more about setting up Integrated Sales Reporting with ClickBank here:

How do I set up Integrated Sales Reporting in ClickBank?


ClickBank doesn’t use the term “Postback URL” so you won’t find that mentioned in any of their videos or documentation.

Instead, they call it their “Instant Notification Service” which requires setting up a “Secret Key” for added security. This article will cover how to set that up.
 
 
Caution: If you’re using the advanced “Entry Link” setting, you must use ClickBank’s “Integrated Sales Reporting” method because the “Instant Notification Service” is incompatible with the Entry Link setting.


So let’s get started!



Step 1 – Create a ClickBank “Secret Key”

The first thing you’ll need to do set up the Instant Notification Service is to create a “Secret Key” in ClickBank that it uses to communicate with other tools like ClickMagick.

Video: How to Create a ClickBank “Secret Key”


You can watch the quick video or read the steps below:
 
1.    Log in to your ClickBank account.
 
2.    Click the “Vendor Settings” tab near the upper-right corner of the page.
 
 
 
 
3.    Click “My Site” in the sub navigation menu bar.
 
 
 
 
4.   Scroll down to the “Advanced Tools” section …
 
 
 
 
5.    Click the “Edit” link in the upper-right corner.

 
 
 
6.    If the Secret Key is empty, you’ll need to create one. Simply enter any combination of UPPER CASE LETTERS or numbers, up to 16 characters. You will get an error if you use any lowercase letters, spaces, or symbols.

 
 
 
7.    If the “Instant Notification URL” section shows a red link that says “(request access)” (as shown in the screenshot above), click on that link to show a form. 

Select “Yes” for all the questions, click on the checkbox that says you agree to the Terms of Service and click on “Save Changes & Request API Access”.
 
 
 
 
8.    Finally, scroll back down to the same section and copy your Secret Key. We’ll be pasting that into ClickMagick in the next section.


Step 2 – Add the Secret Key to ClickMagick

Now that you have your Secret Key set up in ClickBank, you need to let ClickMagick know about it … 

Video: How to Add Your Secret Key to ClickMagick


Just head over to your Account Settings page and enter your “Secret Key” on the ClickBank tab.

If you’re following the steps outlined here, your Secret Key should be on the clipboard so just paste it into your settings and save your changes by clicking on the “Update Settings” button.

If you don’t click on the “Update Settings” button to save the changes, the Instant Notification Service will not work.
 
Note: If you have multiple ClickBank accounts that you want to set up with ClickMagick, just use the same secret key with each account. ClickMagick will work great with every ClickBank account you set up that uses the secret key you’ve entered in your Account Settings.



Step 3 – Add Your ClickMagick Instant Notification URL to ClickBank

Video: How to Add Your ClickMagick Instant Notification URL to ClickBank

 
1.    You’ll need to copy your unique ClickMagick Instant Notification URL and paste it into your ClickBank settings. First, copy this link exactly as you see it:

https://www.clkmg.com/api/s/cb/?uid=[USERID]
     
Note: The unique URL above is used only to link your ClickBank account with ClickMagick. It is not meant to be accessed directly in your browser, and if you do so you’ll see an error message which is totally normal.
 
 
2.    Go back to ClickBank to the Advanced Tools section where you created your Secret Key. You’ll find it in the “Vendor Settings” tab, under the “My Site” sub menu. Scroll down to “Advanced Tools”. and click “Edit”.
 
3.    In the first empty slot that says “Instant Notification URL:”, paste in the ClickMagick Instant Notification URL that you copied above.
 
4.    Make sure that version 7.0 or higher is selected in the drop-down.

  
 
5.    You MUST save your changes here before testing your setup in the next few steps, otherwise ClickBank’s system will say your URL doesn’t work. 
 
6.    Now that you’ve saved your changes, scroll back down to the Advanced Tools section and click “Edit” in the upper-right corner one last time …
 
7.    Click the “TEST IPN” link next to your URL to activate it in ClickBank’s system. You should see a “Verified” next to the version number if you followed the previous steps correctly.

  


Once you’ve tested your URL without error you’re done with the integration of your ClickMagick and ClickBank accounts.


Step 4 – Add the Unique ID to Your ClickBank Hoplinks



Now that you’ve integrated your ClickMagick account with Clickbank, you can use ClickMagick’s [clickid] token (for tracking links) or the [cmc_vid] token (for Campaigns) to pass a unique ID to your ClickBank hoplinks so ClickBank can track and report your sales back to ClickMagick.

For example, here’s a standard ClickBank hoplink:

https://xxx.yyy.hop.clickbank.net

So if you’re an affiliate promoting a “hoplink” using tracking links, your link would look like this:

https://XXX.YYY.hop.clickbank.net/?tid=[clickid] (Tracking Links)
https://XXX.YYY.hop.clickbank.net/?tid=[cmc_vid] (Campaigns)

If you’re a vendor promoting your own payment page, your link would look like this:

https://ITEM.VENDOR.pay.clickbank.net/?vtid=[clickid] (Tracking Links)
https://ITEM.VENDOR.pay.clickbank.net/?vtid=[cmc_vid] (Campaigns)

When you do this, each time someone clicks on your ClickMagick tracking link the system will automatically replace the [clickid] or [cmc_vid] token in your link with actual unique ID of the click being processed.

This will allow the ClickBank system to report sales back to the proper link in your ClickMagick account whenever a sale is made.

 
Note: If the ClickBank URL you want to promote already has a query string—meaning it already has a question mark) (?) in it—you need to add &tid=[clickid] (for tracking links) or &tid=[cmc_vid] (for Campaigns) to the end. Simply replace the question mark (?) in the examples above with an ampersand (&) character. Review the article on query strings for a complete explanation of this.
 


Step 5 – Verify Your Link Is Passing the Unique ID



Now that you set your tracking link up, you can click on it and make sure that your unique ID is successfully passing through.
 
To do that, we recommend that you download a Google Chrome extension called “Redirect Path”.

It’s a free extension that will allow you to check if the unique ID was passed through successfully to the affiliate offer page.

So once you click on your affiliate offer tracking link, you can click on the extension, and you should see something like this:

 


In this case, we were using a tracking link, so our [clickid] token got replaced by a number. If you were using Campaigns, then your [cmc_vid] token would have been replaced by a number as well, with “cmc” in front.

If you see something like this, that means the unique ID is successfully being passed through.

In order to check whether the entire postback URL process is set up correctly, you will have to actually make a sale.

And if you followed the steps and made it this far, then the sales should definitely show up properly in ClickMagick, so you should be good to go!

 
Note: We support all ClickBank transaction types including standard sales, re-bills, JV sales, JV re-bills, refunds, and chargebacks. When ClickMagick gets a refund or chargeback, the previously attributed conversion will simply be removed from your ClickMagick account as if it never happened.



The only way to track sales with MaxBounty is by setting up a Postback URL.

The key to understanding this setup is that you need to pass a unique “ID” from your tracking link to your MaxBounty offer, and that MaxBounty needs to send that ID back to ClickMagick.

You can do that in two simple steps.




Step 1 – Add a Click ID to Your Affiliate Link



The first step is to pass a unique ID generated by ClickMagick to MaxBounty via your affiliate link.
 
1.    Go to the Postback URL Builder tool and select whether you are using tracking links or Campaigns. We will select “Tracking Links” for this example. Also select MaxBounty from the dropdown.

  
 
 
2.    Copy your MaxBounty affiliate link and paste it in the affiliate link generator. Then click the “Generate New Affiliate Link” button.

  
 
 
3.    Copy your modified link and use it for the “Primary URL” of one or more tracking links.

 
 

This doesn’t change how your affiliate link works in any way, it simply sends some additional information to your affiliate network that allows ClickMagick to track your sales.
 

Step 2 – Add Your Postback URL to MaxBounty
 


The next step is to copy your custom ClickMagick Postback URL from the green box at the bottom of the Postback URL Builder.

 
 

Everyone’s URL will be different, so take the one that you see listed in your account and paste it inside of MaxBounty.

Every affiliate network is a bit different in terms of how and where you add your Postback URL, but with MaxBounty you would add it one time on your Profile page and it will be used for all your offers:

 


With other networks you may need to add the Postback URL to each specific offer.

If you have the choice of adding the Postback URL once in a global setting, we strongly recommend that so you can set it once and forget about it.

Also, when you add your Postback URL you may have to select a “type” to go with it (as shown in the MaxBounty example). Each affiliate network is a bit different, but always choose the option that says something like URL, Postback URL, etc. and never select pixel, iframe, HTML, etc.

If you can’t figure out where to add your Postback URL in your affiliate account to track your sales, just ask your affiliate manager or contact their customer support and they can tell you.
 
 
Troubleshooting your MaxBounty Postback URL Integration

If you run in to any problems, we built the ClickMagick Postback Debugger just for you!

You’ll find it in the Tools menu and it will provide you with all the tools and information you need to figure out the problem.

If you still can’t figure out what’s wrong after using the Postback Debugger, please submit a ticket to our Helpdesk with all the relevant details and we’ll be happy to take a look.

Please be sure to explain exactly what you’ve done based on the three steps in this tutorial (with screenshots if possible) and what’s not working as expected.

Remember, the more details you provide, the better we’ll be able to help.



CJ Affiliate (formerly known as Commission Junction) supports both Postback URLs aka server to server tracking, and Tracking Pixels. We recommend using a Postback URL, as it is the most accurate method.

To track your CJ Affiliate sales using a Postback URL, simply use the Postback URL Builder, select Commission Junction, and then follow the instructions.

The only difference with CJ Affiliate is that they need to manually “approve” you on their end, so you’ll also need to contact them and let them know you want to set up a Postback URL.

They will ask you for your Postback URL, at which time you simply give them the custom ClickMagick Postback URL that is generated for you by the Postback URL Builder.

They’ll also ask you which variables you want passed to your Postback URL.

These are evident from the Postback URL you give them, but you can confirm that you want the Sub-ID passed in the {url(sid)} location, and you want your commission amount passed in the {commission} location of the URL.

Once they set you up on their end, you should start seeing your CJ Affiliate sales in ClickMagick!



JVZoo doesn’t yet support industry-standard Tracking Pixels or Postback URLs so tracking conversions with JVZoo requires that you use Sub-IDs. This walkthrough will explain exactly how to set up a JVZoo product offer using Sub-IDs.

For example, let’s assume that you’re promoting an offer through JVZoo and your link looks like this:

https://www.jvzoo.com/c/3522/3665/

To track conversions, you need to pass a unique Sub-ID to your JVZoo affiliate link by adding ClickMagick’s [clickid] token to the end of the URL like this:

https://www.jvzoo.com/c/3522/3665/?tid=[clickid]

You would use this modified JVZoo link as your Primary URL when creating a ClickMagick tracking link for a particular affiliate offer.

Once you’ve added ?tid=[clickid] to the end of your affiliate link, ClickMagick will replace the [clickid] token with a unique number every time someone clicks on your tracking link. When JVZoo gets the click, it will record the value of the click ID in the tid column of your JVZoo stats along with your clicks and sales.


Syncing ClickMagick with JVZoo

To sync ClickMagick with JVZoo, you’ll need to manually download your conversion report from JVZoo occasionally and import it into your ClickMagick account.

Just follow these steps:
 
1.    The first thing you’ll need to do is export your transaction information from JVZoo. To do that, simply go the Affiliates menu at the top of the screen and select Transactions. From there, click on the Export button shown here on the lower right side of this screenshot:





Save the file where you can easily find it.
  
 
2.    Before you can import the data file into ClickMagick, you’ll need to edit the file slightly using a spreadsheet program like Microsoft Excel, Google Sheets, or Apple Numbers.

Specifically, you’ll need to rearrange the columns so that the first three columns are in this order: tid, payout, and completed (which holds date/time values). Delete all other columns and be sure to save the file in CSV format. If you save the file in Excel, Sheets, or Numbers format, it will NOT import into ClickMagick.
 
 
Tip: If you have any trouble rearranging the columns in your spreadsheet program, search the help documents for your spreadsheet—it’s usually quite simple to rearrange columns once you know how. If you still have trouble, contact us at our Helpdesk which you can find in the Help menu at the top of every page. Be sure to attach the file you exported from JVZoo so we can edit it for you.
 
Note: The JVZoo export feature sometimes leaves the tid value empty for sales that have been made even though those same sales show a tid value in your JVZoo transaction report. If you see a blank entry in the tid column for a particular sale, simply look at your JVZoo transaction report and manually copy the value to the spreadsheet. You might also want to mention the problem to the JVZoo support desk to alert them that this problem still exists.
  
 
3.   
The next step is to import your data into ClickMagick. Do this by going to the tracking link you want to update, then click on the Tools menu  to the right of the tracking link and select Add/Import Revenue.
 
 
4.    From the Add/Import Revenue page (shown above), select your file and click the Upload button. If you edited your file correctly and saved it in CSV format, your data should be imported and all of your stats should show accurately.
 
 
Caution: It’s important to remember that the sales and revenue-related stats you see in ClickMagick will only be accurate when you select a date range that exactly matches the date range of the conversion reports you’ve uploaded.
 
 
If you follow these steps, you should have no trouble importing your JVZoo data into ClickMagick.

That said, this entire process could be fully automated if JVZoo were to support industry-standard pixels and Postback URLs. If you’re interested in having this process fully automated, kindly asked your JVZoo representative to have pixel and Postback URLs supported by their system.



If your network isn’t listed here, that means it follows a fairly straightforward setup, so you can just use the Postback Builder to set it up. The instructions are also provided within this builder, but if you want to learn more about how to set up a Postback URL with your affiliate network, you can take a look at this article:

How do I track sales using Postback URLs?


You may not find your network explicitly named in our documentation, but it would be pretty amazing to us if ClickMagick didn’t work with it.


But what if the Postback Builder doesn’t list my network?

If you need to create a Postback URL for a network that isn’t already listed in the Postback Builder (which is unlikely), you can always post a ticket in our Helpdesk, but it’s generally easy enough to construct one yourself with a little guidance. That’s what we’ll cover here.

 
Note: This explanation assumes that you know what a “query strings” are and how to manipulate them. If you need a quick overview of what query strings are, take a moment to read this article:

What is a “query string”?

This discussion also assumes that you’re thoroughly familiar with Postback URLs and how to set them up. If you need a refresher on that, go review the articles mentioned earlier.

  
To set up a Postback URL, you’ll need to know the name of the Sub-ID variable to pass the unique ID token through in your affiliate link. This will commonly be something like s1, aff_sub, or tid. Every network uses its own preferred name for the unique ID. If you don’t know what this is for your network, you can ask their support desk for this information.

The second thing you’ll need is the Postback URL itself. Here is the generic Postback URL for your account:

https://www.clkmg.com/api/s/post/?uid=[USERID]&s1=&amt=0.00&ref=

All you need to do is replace the 0.00 value with the commission token that your network uses, and set the s1= variable to the Sub-ID variable you passed the [clickid] or [cmc_vid] to in your affiliate link.

To find these two tokens, you can search online for these phrases:

     “How do I pass a click ID or tracking ID to network”, and
     “Postback URL tokens for network

where “network” is the name of your affiliate network.

You can also ask your network’s support desk this question:

“How do I pass a click ID (or tracking ID) to the network with my affiliate link, and what tokens should I use in my Postback URL to return the click ID and commission amount?”

Even if you are using Campaigns, you can still ask them how to pass a click ID, since we can use the information they provide to tweak our postback URL accordingly. Their support desk should give you the format for your affiliate link, and they should provide you with the tokens to use in your Postback URL.

For example, suppose they tell you to pass in the click ID using the aff_sub variable and that the click ID is returned in the Postback URL using the {{TRACKID}} token. Suppose they also tell you to use the {{COMM}} token to return the commission value in the Postback URL.

You would then add the query string variable at the end of your affiliate link like this:

https://www.myaffiliateprogram.com/...?aff_sub=[clickid] (for Tracking Links)
https://www.myaffiliateprogram.com/...?aff_sub=[cmc_vid] (for Campaigns)

And in your generic Postback URL, you would set the s1= value to {{TRACKID}} and set the amt= value to {{COMM}}, like this:

https://www.clkmg.com/api/s/post/?uid=[USERID]&s1={{TRACKID}}&amt={{COMM}}&ref=

As long as you pass the [clickid] or [cmc_vid] in to the network using the variable name they require, and you insert the Postback URL tokens properly in your generic ClickMagick Postback URL, you should be good to go!

To see examples of this, just select different networks in the Postback Builder and review the different Postback URL settings.



Article 95 Last updated: 07/02/2020 7:00:50 PM
https://www.clickmagick.com/kb/?article=95