Quick Start: WooCommerce

Get referral tracking running on your WooCommerce store in under 10 minutes. The AdvocateLoop plugin handles everything — referral link detection, automatic discount application, and conversion tracking on order completion.

Prerequisites

• WordPress 5.8 or higher
• WooCommerce 6.0 or higher
• An AdvocateLoop account (sign up here)

Step 1: Install the plugin

1. In your WordPress admin, go to Plugins → Add New
2. Search for “AdvocateLoop” or upload the plugin ZIP file
3. Click Install and then Activate

Step 2: Connect your brand

1. Go to WooCommerce → AdvocateLoop in your WordPress admin
2. Enter your API Key and Brand ID from the AdvocateLoop dashboard (Settings → API Keys)
3. Click Save Changes

The plugin will verify the connection and show a green checkmark when connected.

Step 3: Configure your referral program

In the AdvocateLoop dashboard at app.advocateloop.com:

Configure → Rewards

1. Set your customer discount — the discount referred customers receive (e.g., 15% off)
2. Set your advocate reward — what advocates earn per successful referral (e.g., $10 store credit)
3. Set your attribution window — how long a referral link stays valid (default: 30 days)

Configure → Widget

1. Set the Headline, Description, Button text, and Success message for both the Share and Claim widgets

Configure → Tracking — optionally add custom referral URL parameters or adjust tracking options.

Configure → Notifications — choose which program emails AdvocateLoop sends on your behalf.

Step 4: Add the referral widget

The widget lets visitors claim their referral discount and lets customers sign up as advocates. Add it to any page:

Option A: Shortcode (recommended)

Add this shortcode to any page or post where you want the widget to appear:

[advocate_loop_widget]

Step 5: Test it

1. Create a test advocate — In the AdvocateLoop dashboard, go to Advocates and create a test advocate with your email. Note the referral code (e.g., V2AVMRDJ).

2. Visit your store with the referral link — Open an incognito/private browser window and visit:

   https://yourstore.com/?ref=V2AVMRDJ

3. Check that the discount applies — Add a product to cart and go to checkout. The referral discount should be automatically applied as a coupon.

4. Complete a test order — Place the order. Check the AdvocateLoop dashboard — you should see a new claim and conversion.

Next steps

You’re live. To go deeper:

• What Happens on Your Store — what your referred customers experience, and where activity shows up
• Discounts & Coupons — fine-tune the referral discount (caps, stacking, first-purchase)
• Plugin Settings — every plugin setting explained
• Troubleshooting — full validation checklist and fixes

Plugin settings reference

Setting	Description	Default
API Key	Your AdvocateLoop API key	Required
Brand ID	Your brand’s UUID	Required
Debug Mode	Show detailed logging in browser console	Off
WooCommerce Integration	Enable automatic discount and conversion tracking	On

Troubleshooting

Discount not applying at checkout

• Ensure your cart meets the minimum applied in the app (Configure → Rewards - Limits & conditions)
• Open browser console and check for [AdvocateLoop] log messages
• Confirm your discount settings are configured in the AdvocateLoop dashboard
• Verify the visitor arrived through a referral link (?ref=CODE in URL)

Conversion not recording

• Check the thank-you page console for tracking confirmation
• Verify your API key is correct in the plugin settings
• Contact support with the order ID and your brand ID if the issue persists

Widget not showing

• Ensure your domain has been verified in the app (Admin → Domains)
• Ensure the shortcode [advocate_loop_widget] is on the page
• Check for JavaScript errors in the browser console
• Verify the plugin is activated

Enable Debug Mode in the plugin settings to see detailed API call logging in the browser console for troubleshooting.