> For the complete documentation index, see [llms.txt](https://docs.sizebay.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sizebay.com/size-and-fit-order-tracking/platforms/shopify/technical-note.md). # Technical Note ## Introduction > ℹ️ **About Sizebay Assistant**\ > The **Sizebay Assistant** is a Shopify application designed to capture events from your store and generate valuable analytics and insights about your e-commerce performance on our platform, **My Sizebay**. By integrating this module, store owners can track essential data related to product sizes and customer interactions. For example, when the fitting room is used and a product is purchased, it’s possible to check which size was recommended and which size was bought. For more information on **Shopping Tracking and reports**, please refer to our documentation. *** ## Configuration ### Settings Page On the settings page, you will find a form containing three mandatory fields: ✅ **Tenant ID**: A unique code that identifies each store in the Sizebay platform.\ ✅ **Store Domain**: Your production store domain (e.g., [www.mystore.com).\\](http://www.mystore.com\).\\) ✅ **Size Variant**: Specifies the position of the product size in the product variants section. This must remain consistent across all products. > 💡 **Need Help?**\ > If you have any questions regarding the required information, please contact our **Support Team** at . #### Why These Settings Are Necessary > ⚠️ Shopify allows store owners to define how product variant fields are allocated, but it does not inherently identify which field represents the size. The **Size Variant** field enables Sizebay to correctly interpret the product size, ensuring accurate reporting based on the recommended size versus the ordered size. *** ## Integration Considerations ### Webhooks Requirement The module operates using Shopify’s **webhook system**, specifically the `orders/create` event. ✅ Orders must pass through this status at some point for proper integration. ### Third-Party Cookie Consent The store must enable the **Third-Party Cookie Message**, and customers must accept it to allow proper order integration. 📌 **Instructions**: [Enable Third-Party Cookie Message](https://community.shopify.com/c/shopify-discussions/enable-third-party-cookie-message/m-p/1908293) ### Webhook Delivery Issues > ⚠️ **Potential Data Loss**\ > Shopify, for unspecified reasons, may not fire certain webhook events due to service downtime or internal platform issues. This may result in some orders not being integrated correctly, leading to **data loss** on the Sizebay side. 📌 **More Details**: [Shopify Webhook Event Not Fired](https://community.shopify.com/c/webhooks-and-events/webhook-event-quot-orders-create-quot-not-fired/m-p/1333905) *** ## Third-Party Checkout / Payment Currently, the **Sizebay O.T** does not ensure proper support for order integrations when customers use **external checkouts** on Shopify. Most external checkout solutions do not transmit the **Shopify cart ID** that originated the order. As a result, it is impossible to determine whether a customer used the **Sizebay virtual try-on** feature for that specific order. > ⚠️ **Shopify Restriction**\ > Shopify states in their [**DEV Community**](https://community.shopify.dev/t/clarification-on-shopifys-external-payment-restrictions/788):\ > *Applications that process payments outside of Shopify’s checkout: Shopify cannot guarantee the security or safety of an order placed through an off-site or third-party payment. Apps that circumvent checkout or payment processing, or record transactions via the Shopify API as part of such activity, are prohibited.* #### Scenarios: 1️⃣ **Scenario 1**: If the external checkout sends the **Shopify cart ID** that originated the order, we can integrate the order with Sizebay and accurately indicate whether the virtual fitting room was used.\ 2️⃣ **Scenario 2**: If the external checkout does **not** send the **Shopify cart ID**, the order is integrated, but all orders will be marked as **not having used the virtual fitting room**.\ 3️⃣ **Scenario 3**: If the external checkout modifies all parameters in the order registration by sending custom fields for price, discount, and cart ID, we cannot guarantee proper integration of the order within Sizebay. > ❗ **External Payments Warning**\ > In cases of **external payments**, Sizebay may **not** be able to receive the tracking information corresponding to these purchases, resulting in **data loss** on our side. *** ## Conclusion > 🛠️ **Final Considerations**\ > The **Sizebay Assistant** provides powerful **tracking and reporting** capabilities for Shopify stores. However, proper **configuration**, including webhook setup and third-party cookie consent, is essential for **accurate data collection** and integration. Store owners should be aware of potential **Shopify limitations** in webhook delivery and monitor their system accordingly. > 💡 **Ongoing Support**\ > The **Sizebay Tech Team** remains committed to monitoring new changes on the **Shopify platform** and assisting store owners in any situation. **Order tracking** is a crucial part of our analytical reports, being essential for evaluating our service performance. However, as explained above, some limitations exist that Sizebay cannot fully control. > 📩 **Need Assistance?**\ > For further assistance, please reach out to our **Support Team** at .