This article will walk you through how to test/troubleshoot your CPA affiliate pixels.
| Table of Contents |
|---|
| Info |
|---|
What you’ll need:
|
Check Affiliate Profile Setup
Navigate to CRM → Affiliates and edit the affiliate profile to view the campaigns and pixels that have been assigned.
The affiliate must be added to the campaign that their traffic is running to and there should be a CPA pixel added into the pixels section for that campaign. If the affiliate is not assigned to a campaign, do this now.
In the Pixels tab -
Do you have a pixel for the appropriate campaign? If you do not, do this now.
Is it a Main Offer Pixel (only fires after Import Order) or Upsell Pixel (only fires after Import Upsell)?
An affiliate can only have one pixel for the main checkout and one for each upsell, per campaign
Is the pixel set up for a Specific Product? This will fire only if the campaign product ID is purchased as an upsell
Run a quick eye test
Commission Type: CPA
Pixel Type: must be Postback for Direct API integrations
Content: no typos and correct use of tokens
Please see this article for more information on adding your pixel.
| Info |
|---|
Confirm that:
|
Configure APIs on the funnel
Add Import Click API
If you have not already, have your developer implement the Import Click API call on your funnel and follow our Suggested API Flow documentation. This will store the passed values to the session allowing you to track clicks coming from the affiliate. If the customer completes the sale those passedValues are used to fire any pixels and can also be used within your pixel content.
| Note |
|---|
To store the passed values to a session before a sale is made, the Import Click call must pass the requestUri (containing the affId and passedValues) as well as the campaignId that the pixel is configured for. |
| Tip |
|---|
The very first Import Click call for a session will return a sessionId. Be sure this sessionId is being passed on the subsequent API calls for that customer’s order session. |
Add affId and sourceValue1-5 to Import Lead/Import Order API
If you would like you can also pass the affId and sourceValues on the Import Lead and/or Import Order API request.
Place a Test
Run a test using the Affiliate Test Link.
Open the affiliate’s test link in a new window or tab
Check if the generated affiliate values are present in the URL string
Use the Konnektive Place an order using the CheckoutChamp test card (0000000000000000 with cvv 100 and any current/future expiration date)
Check Results
Navigate to Reports → Customers → Order Details to find your test order
Check the Source and Campaign columns to immediately see if right campaign and affiliate were linked to order. If the source or campaign are incorrect, please click here.
Click the customer’s name to go to their Customer Profile page
Check the source values (under Other Info)
Does the campaign and source values line up with the passed values set for the affiliate and those that you saw created for the tracking string by the test link? If not, please click here.
Click on the customer’s orderId to go to the Order Details page
Click View Details next to the Pixels label inside the Details panel.
What is the response?
If testing an upsell pixel, check the campaign product IDs.
Ask the affiliate what they are seeing on their end and what that response means.
Sometimes the affiliate does not allow duplicate pixel tests. In this scenario you will need to ask the affiliate for a new test link.
If checking a non-test card order, is the credit card marked as prepaid?
No CPA pixels will fire for orders placed using a prepaid card.
| Info |
|---|
Confirm that:
|
If the pixel did not fire
| Anchor | ||||
|---|---|---|---|---|
|
If the affiliate info or campaign is not correct then the pixel will not fire. Look at the API logs (Forensics Tab on customer profile -or - Admin→Logs→API tab) to confirm which affiliateId, campaignId, and productId were sent in your Import Lead and/or Import Order call.
If any of these do not match how a pixel is setup, then a pixel will not fire.
OR
After you determine the issue and deploy a fix, place a new test and check the results again.
Pixel Flowchart
| View file | ||
|---|---|---|
|
What you'll need:
Campaign name or ID
Affiliate name or ID
Step 1.
Edit the affiliate’s profile page under CRM→Affiliates
Step 2.
Look at the Campaigns tab.
Are they in that campaign?
Step 3.
Look at the Pixels tab.
Do they have a pixel for that campaign?
If testing an upsell, do they have a pixel for that specific upsell?
Main Offer = any main offer - fires after Import Order
Specific Product - fires after Import Upsale w/ that campaign product ID
They can have one pixel for the main checkout and one for each upsell
Run a quick eye test
Commission Type: CPA
Pixel Type: must be postback for direct API integrations
Content: no typos jump out at you - correct use of tokens
Step 4.
Run a test using the Affiliate Test Link.
Open the affiliate test link in a new window or tab
Note the generated values in the URL tracking string
Use the Konnektive test card (0000000000000000 with cvv 100 and any current/future expiration date)
Step 5.
Look for the order in the Order Details Report.
Check the Source and Campaign columns to immediately see if right campaign and affiliate were linked to order.
If not, you can look at API logs (Forensics Tab on customer profile -or - Admin→Logs→API tab) to confirm which affiliate ID, campaignId, and productId were sent in your Import Lead and/or Import Order call. If any of these do not match how a pixel is setup, then a pixel will not fire.
OR
Step 6.
Go to the Customer Details page
Check the source values (under Other Info)
Does the campaign and source values line up with the passed values set for the affiliate and those that you saw created for the tracking string by the test link?
If checking a non-test order, is the credit card marked as prepaid?
No pixel will fire for orders placed using a prepaid card.
Step 7.
Go to the Order Details page.
If testing an upsell pixel, check the campaign product IDs
Click View Details next to the Pixels label inside the Details panel.
If a postback pixel, what is the response?
Ask the affiliate what they are seeing on their end and what that response means.
Sometimes the affiliate does not allow duplicate pixel tests, and the you will need to ask the affiliate for a new test link.
Is the pixel content what you/the affiliate expected?
Recheck the pixel setup