Notice: There is no legacy documentation available for this item, so you are seeing the current documentation.
AffiliateWP uses cookies to track affiliates and visits so referrals can be generated. This article explains why the cookies are important, and how you can see them in your browser when testing the system to check a visit has been created.
How they work
A cookie is a small piece of data which is stored in a user’s web browser when they visit a website. When a customer comes to your website via an affiliate referral link (i.e. yoursite.com/?ref=123), AffiliateWP stores two main browser cookies in order to track the referring affiliate, and the visit. Their names are:
- affwp_ref – this cookie stores the affiliate’s unique ID
- affwp_ref_visit_id – this cookie stores the visit ID (the visit ID increments by 1, each time any referral link is used until the cookie expires or is deleted).
AffiliateWP also stores a third cookie for affiliate campaign tracking, affwp_campaign. This cookie will only be stored if an affiliate generates an affiliate referral URL with a campaign name from the Affiliate Area, and that link is clicked on by a customer.
Note: If your site is hosted on Pantheon, the cookies will be named wp_affwp_ref, wp_affwp_ref_visit_id, and wp_affwp_campaign
When a customer clicks on an affiliate’s referral link, and these cookies are successfully generated, a visit will appear in AffiliateWP » Visits screen. The cookies will then remain in the browser throughout the purchase or conversion process to track the correct affiliate so a referral can be generated for that affiliate. The cookies will also remain in the customer’s browser for a period of time specified by the site admin in the AffiliateWP » Settings » Commissions » Cookie Expiration setting, or until the customer clears their cookies.
If these cookies are not visible in the browser when your site is visited via an affiliate referral link, a visit will not be generated, and the affiliate will not be tracked. This is why it is important to test the system is working when you initially set up AffiliateWP.
Here’s how you can find the cookies in three popular browsers to check if a visit has been stored correctly:
Firefox
Follow these steps to view the AffiliateWP cookies in Firefox:
- Visit your product page or website via the affiliate referral link
- Go to the Tools menu in the top menu bar, scroll down to Browser Tools and select Web Developer Tools. This will display a section at the bottom of your browser window
- Click on the Storage tab across the horizontal menu bar in this section, click on Cookies in the left navigation menu – and click on the name of your website – the two cookies should be visible in the right-hand window
- Look for the affiliate ID cookie (i.e. affwp_ref=123) and the visit ID cookie (i.e. affwp_ref_visit_id=1). If the affiliate has created a campaign, the affwp_campaign cookie will also be visible.
Chrome
Follow these steps to view the AffiliateWP cookies in Chrome:
- Visit the product page or website page via the affiliate referral link
- Go to the View menu in the top menu bar
- Go to the Developer option
- Click on Developer Tools
- Click on the Application tab across the horizontal menu bar in this section, click on the Cookies drop-down menu in the Storage section on the left, and click on the name of your website – the affwp_ref and affwp_ref_visit_id cookies should be visible there. If the affiliate has created a campaign, the affwp_campaign cookie will also be visible.
Safari
Follow these steps to view the AffiliateWP cookies in Safari:
- Visit the product page or website page via the affiliate referral link
- Go to the Develop option in the top menu bar, and click on Show Web Inspector
- Click on the Storage tab across the horizontal menu at the top of this section, click on Cookies in the left navigation menu – and click on the name of your website – the affwp_ref and affwp_ref_visit_id cookies should be visible there. If the affiliate has created a campaign, the affwp_campaign cookie will also be visible.
Alongside each cookie name is a “value”. For the affwp_ref cookie this value is the affiliate’s unique ID (i.e. 123), and for the affwp_ref_visit_id cookie this is the visit ID. For the affwp_campaign cookie, the value is the name of the campaign the affiliate is tracking (i.e. a “twitter”, or “facebook” campaign, etc.). These values can help you identify which affiliate is being tracked, and show you how many visits have been made to your website through affiliate referral links in total.
Note: AffiliateWP counts unique visits. This means if there are AffiliateWP cookies still active in the browser, no new visit entries will be created. That said, the affiliate will still be tracked across all pages and posts as long as the cookies are present and active. (Also AffiliateWP does not track individual clicks or page views. )
Testing AffiliateWP and clearing cookies
When testing AffiliateWP, to ensure the system is working correctly, you may need to clear your cookies. Check out our article which explains how to do this for several popular browsers: How to delete AffiliateWP’s cookies from your browser.