Troubleshooting common cases where referral links don’t track, identifying the disconnect and how to respond to your Partner.
Troubleshooting with your Partner
Asking a few simple questions if your Partner reaches out about their referrals not tracking can help you narrow down where to start looking first.
Ask them: What is the customers' name and email address? What date did they sign up/purchase?
Why?: It's important to know their name, email + date of activity for searching reasons. If your Partner has proof of purchase from their referral, you can then search for the above information on your payment processing/order intake system. If you can identify that a purchase/sign up occurred somewhere in your system, it will then help you (and us) troubleshoot where tracking disconnected.
Ask them: What browser and device did they use? Is it the same browser and device they used to sign up with?
Why?: This immediately identifies where the cookie should have been placed. If the customer signed up using Safari on their phone and then purchased using Chrome on their desktop, in most cases the purchase won't track (more on that below)
Ask them: Which link did the Customer click?
Why?: Knowing which link they've published or sent out to their potential leads & referrals is the first step in the right direction. You need to know what link was used in the particular circumstance; once you know which link was used, ensure the "Goes To" landing page that their link redirects to is a landing page that has your JS snippet. No snippet = no tracking. When Partners create custom links, they have the option to change their "Goes To" landing page which can result in the wrong redirection.
Ask them: On the companies end - if you are a Shopify store, your Partners won't see the referral signup and purchase activity track right away
Why?: The Partner will only see the referral sign up and the reward generates when you fulfill the order in your Shopify Orders' dashboard. In this case, there is no issue with link tracking.
If the customer has clicked another Partner’s referral link
What this means: If a customer/referral first clicked on Partner A’s link and did not take any further action, but then clicked on Partner B’s link and made a purchase, Partner B would be the Partner that is associated to the referral and would be rewarded for that transaction.
The most recently clicked referral link is tied to any action that occurs after the link is clicked (sign up, transaction) and the Partner associated with the link will be tied to the referral.
Next Steps: As the company, you can make the call as to who you would like to reward for the referral, on a case-by-case basis. You can decline a reward from your invoice and manually create a new reward for the Partner you choose.
Referral has cleared their browsers’ cache & cookies
What this means: When a customer/referral initially clicks on a Partners’ referral link, it places a cookie on their browsers’ cache. If a customer/referral happens to clear their cache & cookies, it will remove the placed cookie and no longer track activity from the referral.
Next Steps: The referral will have to click back into their referrals’ link to be associated with the partner and to continue to get offers associated with their link.
The Referral blocks cookies
What this means: The customer/referral has opted out of and/or blocked cookie placement on their browser. This is especially common within the EU (specifically the GDPR policy), due to privacy laws; but anyone can disable cookies from placing.
Next Steps: Your partners’ referrals will have to enable cookies to track when clicking referral links, but there is no way to proactively make this happen. A partner who sees a lot of activity from EU may consider making a note to enable cookies to be placed when using their link. Otherwise, we are unable to track when they opt out.
What this means: This happens when your website code has been adjusted or overwritten and as a result the JS snippet breaks.
Next Steps: Reach out to your CSM or Support if you believe you’ve made changes to your code that may have affected your JS snippet integrations.
How to Respond: After a Partner has reached out indicating that their referral didn’t track in their Dashboard, you can:
1) Acknowledge that the link may not have tracked due to updates to your website
2) Ask for the customer's information so you can locate their purchase
3) Manually create the customer & rewards for the Partner by following these steps
How to see if a cookie has placed:
First, click the link in question. Then right-click your mouse > Click “Inspect” > Go to “Applications” > Click on Cookies > Filter by “GrowSumo” > If results show, the cookie has placed.
Why: When you click a referrals link, you will immediately be able to see if a cookie places in your browser. If the cookie isn't showing up, this is an immediate indicator that the integrations may have broken and need to be updated.
If using a different browser or device than originally used when clicking the referral link
What this means: If a customer/referral initially clicked the Partners’ link and signed up in Safari but then used Google Chrome to make their purchase, the activity would not track for that referral’s transaction because of the browser change.
Next Steps: It is challenging to prevent these situations, but if you can get confirmation that the referral did make a purchase and initially signed up with X Partner, you can make the decision to manually reward the Partner using the add a customer and record a sale process.
Additionally, you can use the Branch.io integration to help prevent the disconnection between browsers.
If Partners cookie has expired on Referrals’ browser
What this means: All referral links place a cookie within the customer/referrals’ browser and it remains active for 90 days.
The exception to this is if the customer clicks another partners link; that link then places a cookie in their browser and is active for 90 days after being clicked.
You can see cookie expiration by right-clicking and expanding all fields:
Overwriting `growsumo.data` in your website code
What this means: Code was adjusted within your website which has overwritten GrowSumo data.
Next Steps: Restore integrations; reach out to your CSM or Support for an action plan.
Not adding `public_key` to the snippet code found in our documentation
What this means: If this information is not included in the Snippet Code, it prevents the snippet data to associate any activity to your Company and affiliated Partners/their links.
Next Steps: Add your `public_key` to the snippet code
"A public key is created in public key encryption cryptography that uses asymmetric-key encryption algorithms. Public keys are used to convert a message into an unreadable format. Decryption is carried out using a different, but matching, private key. Public and private keys are paired to enable secure communication."
If your customer is using Safari as their browser and you don’t have the snippet on the landing page (their link destination)
What this means: Safari will not track and place a cookie unless you ensure you have a snippet added to your landing page/the link destination that your partners are using. If they happen to use a destination that doesn’t have a snippet, the cookie could be blocked and we wouldn't know until it’s reported that tracking isn’t occurring.
Next Steps: Ensure your Partners are using your landing page as your default destination link, and that your snippet is included on it. You may choose to manually add the customer and create a reward for the Partner.
The Referral typed in the URL manually
What this means: The customer/referral has manually typed the URL into their browser, instead of clicking the referral link
Next Steps: Have the referral click the referral link for proper tracking. If the referral has already made a purchase and you’d like to reward the partner, you can manually add a customer & record a sale.
Have more questions? Reach out to us at firstname.lastname@example.org!