Connecting Shopify lets Raya see your store data, such as orders, products, customers, discounts and returns, so she can use it when answering your questions.
What it does
Shopify is a Raya connector. Raya can use your store data in her answers, but it doesn't appear in Analytics dashboards, Radar or custom reports. Those use Meta and TikTok data. Connecting Shopify doesn't add blended MER or ROAS to your dashboards.
Once connected, you can ask Raya things like:
What did we sell last week, and how does that compare with what Meta reported?
Which products are selling?
How much of last month's revenue came from new customers versus returning ones?
How much did discounts and returns cost us?
What she can answer depends on the permissions you grant. The connection is read-only. Atria never changes your products, orders, customers or settings.
One store per brand
A workspace can have several brands, and each brand connects to its own Shopify store. If you manage six clients, set up six brands, each with its own store. Raya then knows which store to use for each brand. Set up the brand before connecting the store.
Before you start
You need admin access to the Shopify store, so you can create an app and generate an Admin API access token. If someone else manages the store, ask them to do the Shopify steps below. Do them in one go, because Shopify only shows the token once.
Get a token in Shopify
In your Shopify admin, go to Settings → Apps and sales channels → Develop apps.
If asked, turn on Allow custom app development. You only need to do this once per store.
Click Create an app and name it, for example Atria. Open Configure Admin API scopes and tick the scopes listed below.
Click Install. Open API credentials and click Reveal token once under Admin API access token. Copy it straight away. If you lose it, you'll need to create a new one.
Use Develop apps in your store admin, not Shopify's separate Dev Dashboard. The Dev Dashboard doesn't give you a shpat_ token. If you can't find Develop apps, contact us and we'll help you connect another way.
Scopes to grant (all read-only):
read_orders · read_all_orders · read_products · read_inventory · read_locations · read_discounts · read_returns · read_customers · read_markets · read_draft_orders · read_marketing_events · read_shopify_payments_payouts · read_shopify_payments_disputes · read_reports
Only grant what you need. read_all_orders lets Raya see orders older than 60 days, which you'll need for year-on-year questions. The customer, payments and reports scopes are only needed for those analyses.
Connect in Atria
Open the Raya tab and go to Connectors, or go to
app.tryatria.com/workspace/raya/connectors.
Find Shopify and click Connect. To add a store for another brand, click Add Account in the top right.
On the Atria AI wants to connect to your Shopify screen, enter:
Store Subdomain: your
myshopify.comname, for exampleacmefromacme.myshopify.com. Find it in Shopify under Settings → Domains. Don't use your custom domain.Admin API access token: the token from Shopify, starting with
shpat_.
Click Connect Account.
You can also ask Raya: "I would like to connect to a new Shopify account". She'll take you to the same place.
If it won't connect
Try reconnecting from the Connectors page.
The token isn't accepted: check you created the app under Develop apps, not the Dev Dashboard, and that you entered the store subdomain, not your custom domain.
The install button is greyed out, or you see "This app is under review": send us the store URL.
In each case, send us the store URL and a screenshot of what you see. See also Raya connectors.