Tracking sales back to a sales assistant and store

Cloudshelf tags every order with the store, device and sales assistant. How staff check in, and where to find the data in Shopify or the API.

Last updated
May 29, 2024

Cloudshelf automatically tracks all sales back to the originating store, and even lets you reward a sales assistant for a sale.

Register your sales team

Register your sales team (screenshot 1 of 5)
Register your sales team (screenshot 2 of 5)
Register your sales team (screenshot 3 of 5)
Register your sales team (screenshot 4 of 5)
Register your sales team (screenshot 5 of 5)

During a sale

Sales assistants check in when they are helping on a Cloudshelf:

  1. Swipe down anywhere on the screen 3 times rapidly for the team selection pop-up to appear.
  2. Select your name or reference.
  3. Click the (x) to close the window.
Team selection pop-up on the kiosk

If a sales assistant is selected, their first name appears on the checkout page with a message such as "Today you were helped by John".

If sales assistants don't see their name, they can do the 3-swipe gesture anywhere on the screen and select themselves.

Tracking a completed sale in Shopify

After a sale is complete, the Shopify order shows these references:

  • CS_Cloudshelf: the Cloudshelf experience the order was placed from
  • CS_Device: the device name (you can configure this in the Devices section)
  • CS_OriginatingStore: the store where the sale was made
  • CS_SalesAssistant: the employee's full name and employee reference (if available)

Example in a Shopify order:

Shopify order showing Cloudshelf attribution fields

Tracking a completed sale via the API

To integrate this into an ERP, recover the data with a GraphQL query:

{
  orders(first: 10) {
    edges {
      node {
        id
        updatedAt
        lineItems(first: 10) { nodes { id title } }
        customAttributes { key value }
      }
    }
  }
}

The keys are CS_Cloudshelf, CS_Device, CS_OriginatingStore and CS_SalesAssistant.

To get a single order's data, query it by ID:

{
  order(id: "gid://shopify/Order/...") {
    id
    customAttributes { key value }
  }
}

Frequently asked questions

How does a sales assistant check in on a Cloudshelf?|Where can I see which assistant made a sale?
Swipe down anywhere on the screen 3 times quickly, choose your name from the pop-up, then close it with the (x).|On the Shopify order, in the CS_SalesAssistant field. CS_Cloudshelf, CS_Device and CS_OriginatingStore show where the order came from.
Was this helpful?
Thanks for the feedback.
Still stuck?
Tell us the device and what you see on screen. We usually reply within one working day.