Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This article will walk you through how to test/troubleshoot your CPA affiliate pixels.

Table of Contents
Info

What you’ll need:

  • Campaign

...

  • Name or

...

  • Id

  • Affiliate

...

  • Name or

...

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

...

  • 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.

Image Added

Image Added

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

...

...

Image Added

Please see this article for more information on adding your pixel.

Info

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.

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.

Image Added

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

...

Place an order using the CheckoutChamp test card (0000000000000000 with cvv 100 and any current/future expiration date)

...

Step 5.


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 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.

...

  • If the source or campaign are incorrect, please click here.

Image Added

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 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.

...

Image Added

Image Added

Image Added

Click on the customer’s orderId to go to the Order Details page

...

If testing an upsell pixel, check the campaign product IDs

...

Image Added

  • 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.

...

Image Added
  • 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.

Image Added
Info

Confirm that:

  • The pixel fired

  • The pixel content what you/the affiliate expected

...


If the pixel did not fire
Anchor
Pixel-didnt-fire
Pixel-didnt-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.

Image Added

OR

Image Added

After you determine the issue and deploy a fix, place a new test and check the results again.


Pixel Flowchart

View file
nameTroubleshooting CPA Pixels.pdf