Shopify
Connecting Shopify brings your customers, orders, products and checkouts into Contlo and keeps them current. Contlo also adds tracking to your storefront, so you can recover abandoned checkouts, follow up on every order, and bring first-time buyers back for a second purchase.
الأدلة متوفرة باللغة الإنجليزية.
Before you start
- You need permission to install apps on the Shopify store.
- Have your store's
myshopify.comaddress ready, for exampleyourstorename.myshopify.com. Your public domain won't work here.
Connect your store
You can start from Contlo or from the Shopify App Store. Both end in the same place. The platform choice during first-run setup is covered in Connect your store.
From Contlo
- On Home, click Connect your store on the Connect your store card, or click Connect Now on the Connect your Store step of the onboarding checklist.
- Choose Shopify.
- Enter your store URL in the form
yourstorename.myshopify.comand click Connect now. You see the note You will be redirected to Shopify to install Contlo. - In Shopify, review the permissions and install the app.
- You return to Contlo, signed in, with the store connected.
If you were already using Contlo with a custom store, that store is converted to a Shopify store on the same account. Your contacts, campaigns and settings stay.
From the Shopify App Store
- Find Contlo - Marketing & Help Desk in the Shopify App Store and install it.
- Approve the permissions in Shopify.
- If the store owner's email already has a Contlo login, you are signed in. Otherwise the Create your account page opens with the store owner's email filled in. Finish the sign-up.
You can also start from the App Market: open the Shopify app and click Install. The Shopify sign-in opens in a new tab, and the app shows as installed once the store is connected.
Permissions Contlo asks for
Shopify lists these permissions on the install screen. This is what each one is used for.
| Permission | Why Contlo needs it |
|---|---|
| Read and edit customers | Import customers with their contact details, tags, marketing consent and custom fields, and keep them up to date. |
| Read orders, including all past orders | Import order history beyond Shopify's default recent window, and record new orders as they happen. |
| Edit orders | Add tags to orders from automations, for example when a shopper confirms a cash-on-delivery order on WhatsApp. |
| Read fulfillments | Record shipping events such as Order In Transit and Delivered Order. |
| Read and edit products | Import your catalog for product blocks, feeds, recommendations, price-drop and back-in-stock flows. |
| Edit draft orders | Create order links your team can send to shoppers from Conversations, where that is enabled. |
| Edit price rules and discounts | Create the static and unique discount codes you use in campaigns, automations and forms. |
| Edit script tags, themes and online store content | Add Contlo's tracking script to your storefront and provide the app embed for your theme. |
| Edit pixels and read customer events | Add Contlo's web pixel, which records completed checkouts on the thank-you page. |
The first sync
The import starts on its own as soon as the store is connected. There is no button to press.
| Data | How far back |
|---|---|
| Products and variants | Your whole catalog |
| Customers | Up to the last 5 years |
| Orders | Up to the last 5 years |
While the import runs, Home, Audience and Reports show this banner: Data sync to Contlo is in progress. It can take up to 24 hours to sync all your contacts, orders and product data. It disappears once customers, products and orders have all arrived. Until then, contact counts, revenue and order-based segments are incomplete.
Contlo also sets up a few things for a new store: a starter Newsletter popup form, a default product feed sorted by popularity, and default SMS consent messages.
What stays in sync
After the first import, Shopify notifies Contlo within moments of each change. Contlo also re-checks recent orders and your product catalog on a schedule to catch anything that was missed.
| In Shopify | In Contlo |
|---|---|
| Customer created, updated, enabled or disabled | The contact is created or updated: name, email, phone, default address, order count, amount spent, average order value, first order date, Shopify customer tags and marketing consent. New customers also record Subscriber Created. |
| Checkout created or updated | The checkout and its items are saved with a recovery link, and Checkout Started is recorded once the shopper can be matched by email or phone. |
| Order created | The order is saved with totals, tax, shipping, discount code, items, addresses, order tags and UTM values. Placed Order is recorded, plus one Ordered Product per product. Revenue is attributed to the message that drove it. |
| Order updated | Cancellation state, fulfillment status and order tags are updated. |
| Order cancelled | Cancelled Order is recorded. |
| Order fulfilled | Fulfilled Order is recorded. |
| Fulfillment created or updated | Fulfillment Created, Order In Transit, Delivered Order and Fulfillment Complete are recorded as the shipment moves. |
| Product created or updated | Product, variants, prices, inventory and tags are updated. A lower price on an in-stock variant can start price-drop flows, and a variant coming back into stock can start back-in-stock flows. |
Customer custom fields
Once a day Contlo reads your Shopify customer metafield definitions and creates matching custom properties for text, number, date and true/false fields. The values arrive with each customer update. See Custom properties and tags.
Marketing consent
- A customer who has opted in to email marketing in Shopify is subscribed to email in Contlo.
- A customer who has opted in to SMS marketing in Shopify is subscribed to SMS in Contlo, and to WhatsApp when WhatsApp is set up.
- A contact who has unsubscribed in Contlo stays unsubscribed, even if Shopify still shows them as opted in.
- Consent is read from Shopify. Unsubscribes recorded in Contlo are not written back to the customer in Shopify.
On your storefront
Contlo adds its storefront pieces for you when the store is connected. You don't paste any code.
| Piece | What it does |
|---|---|
| Tracking script | Loads on your storefront pages. It recognizes returning shoppers, records Viewed Product on product pages, Viewed Page on other pages and Added To Cart when the cart changes, and keeps the cart contents for recovery messages. |
| Forms and popups | The same script shows the forms you publish in Contlo, including the Shopify-only timings (see below). See Forms overview. |
| Web push | Shows the notification permission prompt and delivers web push through your store's domain. See Push settings. |
| Live chat widget | Shows the chat widget when the live chat app is installed and enabled. |
| Web pixel | A pixel named Contlo Thank You Tracking is added under Settings → Customer events in Shopify. It records completed checkouts on the thank-you page and links the order to the shopper. |
| App embed | The Contlo app adds an app embed named Contlo tracking to your theme. It loads the same tracking script from inside the theme. |
Turn on the app embed
If events from your storefront are not arriving, switch the app embed on.
- In Shopify, go to Online Store → Themes and click Customize on your live theme.
- Open App embeds in the theme editor's left panel.
- Switch on Contlo tracking.
- Click Save.
Shopify events in segments and automations
In the segment builder, store events are grouped under Shopify. The same events are available as automation triggers unless noted.
| Event | Recorded when | Use in |
|---|---|---|
| Placed Order | An order is created | Segments, automations |
| Revenue | Order value, for filtering on amount spent | Segments |
| Ordered Product | Once per product in an order | Segments, automations |
| Checkout Started | A shopper reaches checkout and can be identified | Segments, automations |
| Cancelled Order | An order is cancelled | Segments, automations |
| Fulfilled Order | An order is fulfilled | Segments, automations |
| Fulfillment Created | A shipment is created | Segments, automations |
| Fulfillment Complete | A shipment is delivered | Automations |
| Order In Transit | The carrier reports the shipment in transit | Segments, automations |
| Delivered Order | The carrier reports delivery | Segments, automations |
| Added To Cart | A recognized shopper adds to cart | Segments, automations |
| Viewed Product | A recognized shopper opens a product page | Segments, automations |
| Viewed Page | A recognized shopper opens a page that is not a product page | Automations |
| Active On Site | A recognized shopper visits the storefront | Segments |
| Price Drop | The price of an in-stock product is lowered | Automations |
| Back In Stock | A product variant comes back into stock | Segments, automations |
| Subscriber Created | A new subscriber is created, including a new Shopify customer | Automations |
Value versions of several events, such as Checkout Started Value, Cancelled Order Value, Fulfilled Order Value and Ordered Product Value, let you segment on amounts.
Features you get only with Shopify
| Where | What |
|---|---|
| Coupons | Static Coupon (Shopify) and Unique Coupon (Shopify). Contlo creates the discount in your Shopify store. See Coupons. |
| Email editor | The discount code block, alongside the product, recommended items, abandoned cart and order summary blocks. See Email editor. |
| SMS campaigns and automations | The Add Discount option. |
| Forms | The Discount Code block with unique coupons, Automatically apply code to cart, and display timings after cart abandonment, after viewing a product, and on a back-in-stock button. See Form targeting and behavior. |
| Form analytics | Orders placed, revenue and product clicks. |
| Automations list | A Revenue column. |
| Conversations | An orders tab on the contact panel. See Conversations inbox. |
| App Market | All apps, including the third-party integration categories. See App Market. |
| Billing | Charges are approved through Shopify. See Billing and plans. |
Disconnect Shopify
There is no disconnect button in Contlo, and the Shopify app in the App Market has no Uninstall option. To disconnect, uninstall the Contlo app from Settings → Apps and sales channels in your Shopify admin.
When you uninstall the app:
- Syncing stops and Contlo's access to the store is removed.
- Storefront tracking, forms and web push stop working on the store.
- Your automations and forms are switched off.
- Your Contlo plan moves to the free plan.
- The SMS number assigned to your account is released.
- The Connect your Store step in onboarding goes back to pending.
- The store owner receives an email asking for feedback.
Your contacts, orders, campaigns and reports are kept in your Contlo account. You can still sign in.
Customer data requests
When Shopify sends a customer erasure request for your store, Contlo deletes the matching contact.
Troubleshooting
| What you see | What to do |
|---|---|
| Invalid Shop Domain or Please enter a valid store domain | Enter the store's Shopify address, like yourstorename.myshopify.com, not your public domain and without extra paths. |
| The sync banner is still showing | The first import can take up to 24 hours. If it is still there after that, write to hello@contlo.com. |
| Fewer contacts or orders than in Shopify | The first import covers up to the last 5 years. Wait for the sync banner to disappear before comparing numbers. |
| A Shopify customer is not subscribed in Contlo | Check the customer's email or SMS marketing status in Shopify. Contacts who unsubscribed in Contlo stay unsubscribed. |
| No Viewed Product or Added To Cart events | Turn on the Contlo tracking app embed (see On your storefront). These events are recorded only for shoppers Contlo can recognize, so an anonymous test visit does not show up. |
| Checkout Started arrives late or not at all | The event is recorded once the checkout has an email or phone number Contlo can match to a contact. This can take several minutes after the shopper enters their details. |
| Forms don't show on the store | Check that the form is published and that the Contlo tracking app embed is on. If you uninstalled and reinstalled the app, turn the form on again. |
| Discount codes are not created | Contlo needs the discount permissions granted at install. If Shopify asks you to approve updated permissions when you open the app, approve them. |
أدلة ذات صلة
- Connect your storeConnect Shopify, WooCommerce or a custom site to Contlo, see what gets synced, and fix a connection that fails.
- App MarketBrowse, install, set up and uninstall apps in Contlo: channels, analytics, ad audiences and the third-party tools your store already uses.
- CouponsCreate static or unique Shopify discount codes in Contlo and add them to SMS, WhatsApp and automation messages.
- Automation triggers and actions referenceEvery trigger, filter, condition, message block and flow action in the automation builder, with what each one does and its options.
- WooCommerceConnect a WooCommerce store to Contlo with the Contlo plugin: what is synced, how storefront tracking works, and how to fix a connection.