# 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 <support@sizebay.com>.

#### 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):\
> \&#xNAN;*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 <support@sizebay.com>.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sizebay.com/size-and-fit-order-tracking/platforms/shopify/technical-note.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
