Testing and Troubleshooting CPA Pixels
- Tyler Martorano
- Brandon Redmond
This article will walk you through how to test/troubleshoot your CPA affiliate pixels.
What you’ll need:
Campaign Name or Id
Affiliate Name or Id
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
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.
Confirm that:
Affiliate is assigned to the appropriate campaign
Pixel is created properly (including campaign)
Pixel content is accurate
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.
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.
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 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.
If the pixel did not fire
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
