DEV Community

NEXU WP
NEXU WP

Posted on

Trace Any WooCommerce Order to Its Affiliate in 5 Steps

What You'll Need

  • Affiliate Engine (learn more) installed and active
  • Access to your WordPress admin dashboard
  • The WooCommerce order ID in question

This method works for both cookie-tracked and coupon-based referrals, including edge cases like expired cookies or conflicting signals.


Step 1: Check the Referrals Tab for Direct Attribution

Start by searching the plugin's referral records. This is the fastest way to confirm or rule out attribution.

  1. Go to your WordPress dashboard and navigate to Affiliate Engine → Referrals.
  2. Use the search bar to filter by the WooCommerce order ID.
  3. If a record appears, you'll see:
    • The affiliate name/ID credited
    • The attribution method (cookie or coupon)
    • The commission status (pending, approved, reversed)

No record? Proceed to Step 2.


Step 2: Inspect the WooCommerce Order Notes

Affiliate plugins log attribution details directly in the order's metadata. Here's how to find them:

  1. Open WooCommerce → Orders and locate the order in question.
  2. Click to edit the order, then scroll to the Order Notes section at the bottom.
  3. Look for an automated note from Affiliate Engine (or your affiliate plugin) that includes:
    • The affiliate's name or ID
    • The commission amount
    • A timestamp matching the order date

Still no attribution clue? Move to Step 3.


Step 3: Trace the Affiliate's Visit History

If an affiliate claims they drove the order but no commission exists, their visit log can confirm whether their link was clicked.

  1. Navigate to Affiliate Engine → Visits.
  2. Filter by the affiliate's username or ID.
  3. Check for a visit record with:
    • A timestamp before the order date
    • The same landing page the customer used

Found a visit but no commission? The cookie likely expired before purchase (default lifetime is 30 days). Extend the cookie duration in the plugin settings to prevent this for future orders.


Step 4: Verify Coupon Overrides (If Applicable)

Coupons take priority over cookies when both exist. If the order used a coupon, that affiliate gets credit, even if another affiliate's cookie was present.

  1. In the WooCommerce order edit screen, check the Coupon(s) Used field.
  2. Cross-reference the coupon code with the Affiliate Engine → Coupons tab to find the owning affiliate.
  3. If the coupon belongs to a different affiliate than the cookie, the coupon owner receives the commission. This is intentional to prevent cookie-stuffing exploits.

Step 5: Diagnose Common Failure Points

If attribution is still missing, these are the most likely causes and fixes:

Symptom Cause Solution
Visits recorded but no commission Cookie expired before purchase Increase cookie lifetime in plugin settings
Social media traffic not tracked In-app browsers block cookies Assign unique coupons to social affiliates
Commission missing for coupon orders Coupon not linked to an affiliate Reassign the coupon in Affiliate Engine → Coupons
Referral record exists but no payout Order refunded during hold period Check the Referrals tab for reversed status

Key Takeaway

Affiliate attribution isn't mysterious, it's a cookie + coupon + order notes pipeline. By cross-checking these three sources, you can resolve 99% of disputes in under five minutes. For persistent issues, enable AJAX cookie setting in Affiliate Engine's tracking options to bypass caching conflicts.

For a deeper dive into how attribution rules work, including priority conflicts and edge cases, review the full technical guide.

Top comments (0)