Aller au contenu
Contlo by QuestionPro
Parcourir la documentation

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.

Home → Connect your store → ShopifyCustomers, orders, products, checkoutsStorefront tracking added for youDiscount codes created in Shopify

Les guides sont en anglais.

Before you start

  • You need permission to install apps on the Shopify store.
  • Have your store's myshopify.com address ready, for example yourstorename.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

  1. 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.
  2. Choose Shopify.
  3. Enter your store URL in the form yourstorename.myshopify.com and click Connect now. You see the note You will be redirected to Shopify to install Contlo.
  4. In Shopify, review the permissions and install the app.
  5. 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

  1. Find Contlo - Marketing & Help Desk in the Shopify App Store and install it.
  2. Approve the permissions in Shopify.
  3. 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.

PermissionWhy Contlo needs it
Read and edit customersImport customers with their contact details, tags, marketing consent and custom fields, and keep them up to date.
Read orders, including all past ordersImport order history beyond Shopify's default recent window, and record new orders as they happen.
Edit ordersAdd tags to orders from automations, for example when a shopper confirms a cash-on-delivery order on WhatsApp.
Read fulfillmentsRecord shipping events such as Order In Transit and Delivered Order.
Read and edit productsImport your catalog for product blocks, feeds, recommendations, price-drop and back-in-stock flows.
Edit draft ordersCreate order links your team can send to shoppers from Conversations, where that is enabled.
Edit price rules and discountsCreate the static and unique discount codes you use in campaigns, automations and forms.
Edit script tags, themes and online store contentAdd Contlo's tracking script to your storefront and provide the app embed for your theme.
Edit pixels and read customer eventsAdd 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.

DataHow far back
Products and variantsYour whole catalog
CustomersUp to the last 5 years
OrdersUp 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 ShopifyIn Contlo
Customer created, updated, enabled or disabledThe 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 updatedThe 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 createdThe 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 updatedCancellation state, fulfillment status and order tags are updated.
Order cancelledCancelled Order is recorded.
Order fulfilledFulfilled Order is recorded.
Fulfillment created or updatedFulfillment Created, Order In Transit, Delivered Order and Fulfillment Complete are recorded as the shipment moves.
Product created or updatedProduct, 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.

On your storefront

Contlo adds its storefront pieces for you when the store is connected. You don't paste any code.

PieceWhat it does
Tracking scriptLoads 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 popupsThe same script shows the forms you publish in Contlo, including the Shopify-only timings (see below). See Forms overview.
Web pushShows the notification permission prompt and delivers web push through your store's domain. See Push settings.
Live chat widgetShows the chat widget when the live chat app is installed and enabled.
Web pixelA 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 embedThe 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.

  1. In Shopify, go to Online Store → Themes and click Customize on your live theme.
  2. Open App embeds in the theme editor's left panel.
  3. Switch on Contlo tracking.
  4. 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.

EventRecorded whenUse in
Placed OrderAn order is createdSegments, automations
RevenueOrder value, for filtering on amount spentSegments
Ordered ProductOnce per product in an orderSegments, automations
Checkout StartedA shopper reaches checkout and can be identifiedSegments, automations
Cancelled OrderAn order is cancelledSegments, automations
Fulfilled OrderAn order is fulfilledSegments, automations
Fulfillment CreatedA shipment is createdSegments, automations
Fulfillment CompleteA shipment is deliveredAutomations
Order In TransitThe carrier reports the shipment in transitSegments, automations
Delivered OrderThe carrier reports deliverySegments, automations
Added To CartA recognized shopper adds to cartSegments, automations
Viewed ProductA recognized shopper opens a product pageSegments, automations
Viewed PageA recognized shopper opens a page that is not a product pageAutomations
Active On SiteA recognized shopper visits the storefrontSegments
Price DropThe price of an in-stock product is loweredAutomations
Back In StockA product variant comes back into stockSegments, automations
Subscriber CreatedA new subscriber is created, including a new Shopify customerAutomations

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

WhereWhat
CouponsStatic Coupon (Shopify) and Unique Coupon (Shopify). Contlo creates the discount in your Shopify store. See Coupons.
Email editorThe discount code block, alongside the product, recommended items, abandoned cart and order summary blocks. See Email editor.
SMS campaigns and automationsThe Add Discount option.
FormsThe 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 analyticsOrders placed, revenue and product clicks.
Automations listA Revenue column.
ConversationsAn orders tab on the contact panel. See Conversations inbox.
App MarketAll apps, including the third-party integration categories. See App Market.
BillingCharges 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 seeWhat to do
Invalid Shop Domain or Please enter a valid store domainEnter the store's Shopify address, like yourstorename.myshopify.com, not your public domain and without extra paths.
The sync banner is still showingThe 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 ShopifyThe 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 ContloCheck the customer's email or SMS marketing status in Shopify. Contacts who unsubscribed in Contlo stay unsubscribed.
No Viewed Product or Added To Cart eventsTurn 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 allThe 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 storeCheck 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 createdContlo needs the discount permissions granted at install. If Shopify asks you to approve updated permissions when you open the app, approve them.

Guides associés

Vous ne trouvez pas quelque chose ? Nous écrire