Miko AI · Merchant Guide

Miko AI Guide

Everything you need to turn your customer data into specific, ranked actions for your store, with zero technical setup.

1. What is Miko AI?

Miko AI is a native Shopify customer intelligence app. It reads your customers' purchase history, segments them with machine learning, predicts who is about to churn and who is about to become your top spender, and tells you in plain English what to do next.

Unlike Shopify Analytics, which shows aggregate dashboards, Miko AI works at the individual customer level and ranks your customers by action priority each week.

The core loop

Miko reads your orders → ML scores every customer → Claude explains each segment in plain English → Tags sync to Shopify Customers → Your email tool picks up the tags → You take the recommended actions. New scores every night.

What you get out of the box

  • Ten RFM segments: Champions, Loyal Customers, Potential Loyalists, Active Buyers, At Risk, Needs Attention, Lost, High Value, Average, Low Engagement
  • A churn-probability score from 0 to 100 for every customer
  • Lifecycle stage classification: New Customers, Active Buyers, VIP Customers, At Risk, Lapsed
  • Cohort retention analysis (1, 2, 3, 6 and 12 month retention rates)
  • Auto-tagging back to Shopify customer profiles with a miko- prefix
  • Weekly AI insight email every Monday (Growth and Scale plans)

2. Installation

Miko AI is available on the Shopify App Store. Search for "Miko AI" or click the install link below.

Step-by-step

  1. Click the install link or search the Shopify App Store for "Miko AI"
  2. Approve the requested scopes: read_customers, write_customers (for tagging), read_orders, read_products,
  3. Choose your plan (Free, Essentials, Growth, or Scale) and start your 14-day free trial if applicable
  4. Miko begins its initial ML run automatically — you do not need to click anything
  5. You get an email when the first scoring run is complete (usually within 5–15 minutes for stores up to 5,000 customers)
Tip: Miko reads your existing customer history when you install. The more order history you have, the better your first segmentation will be. Stores with at least 6 months of orders get the most accurate first-run results.

3. Your First ML Run

When you install Miko AI, Miko AI does five things in sequence on your customer data:

  1. Reads your orders via the Shopify Admin API (read-only)
  2. Computes RFM scores for every customer (recency, frequency, monetary)
  3. Runs customer behavioural grouping to surface behavioural groupings unique to your store
  4. Trains a churn model on your store's specific historical patterns
  5. Forecasts CLV for every customer based on their order pattern and product mix

You can watch progress in the Miko admin while it runs. Subsequent runs happen automatically every 24 hours.

4. RFM Segments Explained

Every customer in your store is automatically slotted into one of ten research-backed segments. Here is what each one means and what you should typically do about them:

SegmentWhat it meansRecommended action
ChampionsBought recently, frequently, and high valueReward, upsell, ask for referrals
Loyal CustomersSpend good money, often, and consistentlyCross-sell, surface new collections
Potential LoyalistsRecent customers with above-average spendNurture with welcome sequence
New CustomersJust made their first or second orderWelcome series, build the habit
Potential LoyalistsRecent shoppers, not yet repeatEducational content, soft upsell
Needs AttentionAbove-average recency, frequency droppingLimited-time offer
Needs AttentionBelow-average recency, decliningRe-engagement campaign
At RiskUsed to spend a lot, gone quietPersonalised win-back
High ValueHighest historical spenders, now silentVIP win-back, direct outreach
HibernatingLow recency, low frequency, low valueOne reactivation attempt, then archive
LostLong-gone, unlikely to returnExclude from active campaigns
Where to find segments: In the Miko admin, go to Segments. Click any segment to see the customers in it. Click any customer to see their individual scores and history.

5. Churn Risk Scores

Every customer gets a churn-probability score from 0 to 100, updated nightly. The score is your individual customer's likelihood of NOT ordering again in the next 90 days, based on their pattern compared to your historical customer base.

How to read the score

  • 0–30: Healthy. No action needed.
  • 31–60: Watch. Worth a nudge in your normal cadence.
  • 61–80: At risk. Prioritise a personalised offer.
  • 81–100: Critical. Direct outreach if the customer's lifetime value justifies it.

Using churn scores in your marketing

Miko writes the churn band as a customer tag (e.g. miko-churn-high) so your email tool can target it. Common patterns:

  • Send a 10% off win-back to anyone tagged miko-churn-high who hasn't ordered in 45+ days
  • Trigger an SMS to anyone tagged miko-churn-critical with predicted CLV over $500
  • Exclude miko-churn-critical from acquisition discounts to protect margin

6. Lifetime Value Forecasts

For every customer, Miko AI predicts how much they will spend in the next 12 months, based on their order pattern, recency, product mix, and similarity to other customers in your store.

How the forecast is calculated

Miko uses a gradient-boosted regression model trained on your store's specific data. Inputs include order count, average order value, days between orders, product categories, discount usage, and time since last order. Outputs are bracketed into tiers so they are actionable, not just numeric.

CLV tiers

TierPredicted 12-month spendTag
PlatinumTop 5% predicted spendersmiko-clv-platinum
GoldTop 6–20%miko-clv-gold
SilverTop 21–50%miko-clv-silver
BronzeBottom 50%miko-clv-bronze
Tip: Pair Miko AI with Miko Loyalty & Rewards: assign higher loyalty tiers to miko-clv-platinum and miko-clv-gold customers via Shopify Flow. The two apps share the same tag namespace.

7. Segment Discount Codes

On any segment detail page you can create a real Shopify discount code targeted to customers in that segment. Miko AI tracks every redemption and attributes the recovered revenue back to the campaign.

How it works

  1. Open a segment and click Create a discount for this segment
  2. Choose percentage off (e.g. 20%) or fixed amount and a validity window (1--365 days)
  3. Miko creates the code in your Shopify Discounts admin restricted to customers in that segment
  4. Copy the code and use it in your Shopify Messaging campaign or email
  5. When a customer redeems it, Miko tracks the redemption count and revenue recovered on the segment page
Tip: Discount codes work especially well for Lapsed and At Risk segments. Include the code in the AI-generated email copy from the same segment page.

8. Shopify Tag Sync

Miko AI writes intelligence directly to Shopify customer profiles as miko- prefixed tags. Every email tool, automation platform, or Shopify Flow can pick these up automatically.

Tags written by Miko AI

TagWhen it is applied
miko-vipCustomer has 5+ orders AND $500+ lifetime spend
miko-high-valueCustomer has $1,000+ lifetime spend
miko-at-riskCustomer has not ordered in 90--180 days
miko-lapsedCustomer has not ordered in 180+ days
miko-first-time-buyerCustomer has exactly 1 order
miko-one-time-buyerCustomer bought once and did not return within 60 days
miko-bulk-buyerCustomer has 10+ orders

When tags update

Tags are written in real time on every new order (via webhook) and refreshed for all customers during a manual sync. Go to Miko App → Settings and click Sync to update all tags now.

Important: Miko only writes miko- prefixed tags. It never removes or modifies your existing customer tags.

9. Sending Campaigns with Your Email Platform

Miko AI is the intelligence layer, not the email sender. It writes customer tags and creates native Shopify segments so any email platform picks them up automatically.

Shopify Messaging (recommended)

Miko AI auto-creates customer segments in your Shopify admin (e.g. Miko AI: At risk) during every sync. In Shopify Messaging, click Create campaign and select the Miko AI segment as your audience. Your campaign targets exactly the right customers instantly.

Miko AI Automations (set once, runs forever)

Go to Miko App → Automations to set up automated campaigns. Miko AI generates the email copy using Claude and guides you through creating a one-time automation in Shopify Messaging. Once live, the automation fires automatically whenever Miko AI tags a qualifying customer -- no ongoing effort required.

Shopify Flow

In Shopify Flow, use the built-in Customer tag is added trigger (found under Shopify's 82 triggers). Set the tag condition to the Miko AI tag for the segment you want (e.g. miko-at-risk). Add any action -- Shopify Messaging email, SMS, internal notification, or a third-party platform action.

Klaviyo, Omnisend, Mailchimp, Brevo

All these platforms support Shopify Flow actions. Use Miko AI as the trigger in Flow and choose your platform's action to fire a campaign. Alternatively, create a segment in your platform using the Shopify customer tag as the filter condition (e.g. tag contains miko-at-risk).

Key principle: Miko AI tags the right customer at the right time. Your email platform sends with your branding and templates. Zero integration work beyond a one-time setup.

10. Your Weekly Insight Email

Every Monday, Miko AI sends you a one-page email summarising your store's customer health and the top actions for the week.

What is in the email

  • Top segments by revenue: your highest-value customer groups with movement vs last week
  • Active predictions: at-risk revenue and VIP candidates identified this week
  • Three recommended actions: specific campaigns to run, written in plain English by Claude (Growth and Scale plans)
  • Segment movement: customers who changed segments this week (e.g. "8 customers became At Risk, 3 became VIP")

Email cadence and setup

Essentials and above: weekly on Mondays. Set your email address in Miko App → Settings → Reports. You can also request a CSV export of any segment delivered to your inbox from the segment detail page.

11. Privacy & Data Handling

Miko AI is privacy-first. Here is exactly how your customer data is handled:

Where your data is processed

  • Storage: PostgreSQL hosted by Railway in the EU/US region of your choice during onboarding.
  • ML processing: Inside our infrastructure. Customer data does not leave our servers for the segmentation, churn, or CLV models.
  • Claude API: Only anonymised aggregate descriptions are sent to the Claude API (e.g. "237 customers, average 3.2 orders, last order 45 days ago"). Never raw customer records, emails, names, or PII.
  • Email reports (Resend): Your store name and segment counts only. No customer-level data.

Data retention

If you uninstall Miko AI, your customer data is deleted from our database within 48 hours of uninstall via the automatic shop/redact webhook. The miko- tags on your Shopify customers stay in place (you own them) but can be removed via a Shopify Flow if you prefer.

Full details: Privacy Policy.

12. Plans & Features

FeatureFree
$0/mo
Essentials
$19/mo
Growth
$49/mo
Scale
$129/mo
Customers analysed505001,0003,000
Rule-based Shopify tagging
Shopify Flow templates
Full RFM scoring (10 segments)--
Churn risk + VIP predictions--
Cohort retention analysis--
Weekly email reports--
Discount code creation + tracking--
Native Shopify segments--
Claude AI explanations----
AI email copy per segment----
AI weekly report narrative----
Lifecycle journey mapping------
Industry benchmarks by category------

All paid plans include a 14-day free trial. View full pricing →

13. FAQ

How much customer history do I need for accurate scoring?

At least 50 customers and 100 orders to get useful segmentation. 6+ months of order history gives you the best churn predictions. Stores with less history still get RFM segments, but churn scoring will be conservative until more data accumulates.

Will Miko AI's tags conflict with my existing customer tags?

No. Every Miko-written tag is prefixed with miko- to avoid collisions. Miko never modifies or removes tags you set manually.

Can I disable the weekly email?

Yes. Miko App → Settings → Email Reports lets you change the cadence to weekly, monthly, or off entirely. You can also add multiple recipients (e.g. your retention manager).

Does Miko AI work with Shopify Markets / multi-currency?

Yes. All monetary values (CLV forecasts, order totals) are normalised to your store's primary currency for ranking, but Claude explanations display amounts in the customer's purchase currency for clarity.

What happens if the Miko AI scoring engine is down?

Miko AI degrades gracefully. If the ML service is unavailable, the app falls back to rule-based RFM scoring so you never see a blank dashboard. Churn and CLV predictions resume automatically once the service is restored.

Can I export Miko AI data?

Yes. Every segment and customer list can be exported as CSV from the Miko admin. The same data is also available via the standard Shopify customer export — just filter by miko- tags.

14. Support

Support is delivered by email at hello@tripsterdevelopers.com.

  • Email: hello@tripsterdevelopers.com
  • Response times: Free plan within 48 hours. Essentials and Growth within 24 hours. Scale within 4 hours during NZ business hours.
Feedback: Email hello@tripsterdevelopers.com with "Miko AI" in the subject and we will reply within one business day.