WooCommerce

How the WordPress plugin connects your WooCommerce store, keeps products in sync and adds to the cart.

ShopperQuiz connects to WooCommerce using REST API keys — a Consumer Key and Consumer Secret you generate in your WordPress admin. There is no OAuth redirect. Once connected, ShopperQuiz syncs your products, categories, and tags and keeps them up to date via webhooks.

One store per account

Each ShopperQuiz account connects to one store only — either Shopify or WooCommerce, never both simultaneously. If you run multiple WooCommerce stores, create a separate ShopperQuiz account for each one.

Generating API keys

ShopperQuiz needs Read/Write access to your WooCommerce store. To generate the keys:

1. In your WordPress admin, go to WooCommerce → Settings → Advanced → REST API
2. Click Add key
3. Set a description (e.g. "ShopperQuiz"), set permissions to Read/Write, and click Generate API key
4. Copy the Consumer Key (ck_…) and Consumer Secret (cs_…) — you'll need both in the next step

The Consumer Secret is only shown once. If you lose it, delete the key and generate a new one.

Connecting your store

In your ShopperQuiz dashboard, go to Integrations in the sidebar. In the WooCommerce card, enter:

• Your WordPress site URL (e.g. https://yourstore.com)
• Your Consumer Key (ck_…)
• Your Consumer Secret (cs_…)

Click Connect WooCommerce. ShopperQuiz will verify the credentials and connect. Your products, categories, and tags will start syncing in the background — this usually takes under a minute.

Product sync

Once connected, ShopperQuiz syncs your full product catalog — products, categories, and tags — into its own database. This cached copy powers the right panel in the Quiz Builder and the voting engine at runtime.

The initial sync runs automatically after connecting. After that, your catalog stays up to date via WooCommerce webhooks: when you add, update or remove products, the changes reach ShopperQuiz automatically, including each product's categories and tags. If you rename or delete categories or tags themselves, click Sync now to refresh them.

If you need to force a full re-sync, click Sync now on the WooCommerce card in Integrations. The sync counts are shown on the card so you can verify everything came through.

Order tracking and revenue attribution

ShopperQuiz measures which sales came from your quiz. This needs the ShopperQuiz plugin installed and active on your WordPress site (the same plugin that provides the quiz shortcode and block).

1. When a shopper goes to the cart or checkout from the quiz results, the plugin remembers their quiz response for one hour in their browser.
2. An order placed in that window is tagged with the quiz response. This works with classic checkout, block checkout and the Store API.
3. When the order reaches Processing, Completed or On hold, WooCommerce notifies ShopperQuiz, which records the revenue, currency and purchased items on that quiz response.

This powers revenue in Analytics and Responses, and the purchase events sent to Google Analytics 4, Meta, TikTok, Zapier and webhooks.

• Each quiz attempt is attributed to its first paid order.
• ShopperQuiz registers the WooCommerce webhooks it needs automatically when you connect (products and orders), and re-checks them when you open the Integrations page.

Managing your connection

Click Manage on the WooCommerce card to open a side drawer with:

• Store details — store name, URL, and last synced time
• Synced data counts — products, categories, and tags
• Open WordPress Admin — a quick link to your WP admin
• Disconnect store — removes the API key connection. Your quizzes and all quiz data are kept intact. You can reconnect at any time by entering new API keys.
• Disconnect & delete all quiz data — permanently removes the connection and deletes all your quizzes, questions, answers, and synced product data. This cannot be undone. You'll be asked to type DELETE to confirm.