Technical Note

Sizebay Assistant for Shopify

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). ✅ 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 [e-mail].

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

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

---

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: 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 [e-mail].