Shopify

How ShopperQuiz connects to your Shopify store, keeps products in sync and adds to the cart.

ShopperQuiz connects to Shopify via OAuth. When you connect your store, ShopperQuiz is authorised to read your products, collections, and tags, and to interact with your cart via the Storefront API. It does not require embedded app access or changes to your theme files — it operates entirely from app.shopper-quiz.com.

One store per account

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

Connecting your store

There are two ways to install and connect ShopperQuiz to your Shopify store:

From the Shopify App Store — install ShopperQuiz directly from apps.shopify.com/shopperquiz. Click Install, approve the permissions in your Shopify admin, and you'll be redirected to app.shopper-quiz.com to complete setup.

From the dashboard — go to Integrations in the sidebar, enter your store's .myshopify.com domain (e.g. your-store.myshopify.com) in the Shopify card, and click Connect Shopify. You'll be redirected to your Shopify admin to approve the installation and then brought back to your dashboard.

Either way, once approved you'll land on the Integrations page with a connected status and your products syncing in the background.

Product sync

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

The initial sync runs automatically and usually completes within a minute. After that, your catalog stays up to date via Shopify webhooks — when you add, update, or remove products, collections, or tags in Shopify, the changes propagate to ShopperQuiz automatically.

If you ever need to force a full re-sync — for example after a bulk product import — click Sync now on the Shopify card in Integrations. The sync count (products, collections, tags) is shown on the card so you can verify everything came through.

Permissions

ShopperQuiz asks Shopify for read-only access to your products and inventory (for the catalog and in-stock filtering) and your orders (to attribute quiz revenue). It never changes your products or orders.

Order tracking and revenue attribution

ShopperQuiz measures which sales came from your quiz:

1. When a shopper adds a product with the quiz's Add to cart button, that cart line gets a hidden marker linking it to their quiz response.
2. When the order is paid, Shopify notifies ShopperQuiz.
3. If the order contains a product from the quiz, ShopperQuiz 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.

• Only orders containing at least one product added from the quiz results are attributed. Products added from normal store pages aren't linked to the quiz.
• Each quiz attempt is attributed to its first paid order.
• ShopperQuiz doesn't store customer details from Shopify orders.

Managing your connection

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

• Store details — store name, domain, and last synced time
• Synced data counts — how many products, collections, and tags are cached
• Open Shopify Admin — a quick link to your Shopify admin
• Disconnect store — removes the OAuth connection. Your quizzes and all quiz data are kept intact. You can reconnect at any time.
• 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.

Disconnecting only removes the store connection from ShopperQuiz — it does not uninstall the ShopperQuiz app from your Shopify admin. To fully remove the app, uninstall it from Shopify Admin → Apps.