Shopify App
The SegOps Shopify app is the fastest way to connect a Shopify store. Install it once and SegOps provisions your workspace, backfills your store history, captures storefront behavior, and keeps your product catalog in sync — no API keys, no webhook wiring, no SDK code.
Looking for the manual, per-tenant webhook receiver instead? See Shopify Integration (manual webhooks). The app below is the recommended path for almost everyone.
Install#
- Open the SegOps app from the Shopify App Store and click Add app.
- Approve the requested scopes (see Scopes).
- That's it. SegOps:
- creates your workspace (tenant) — slug = your shop subdomain,
- mints a public storefront key and a server key,
- registers webhooks (delivered to Pub/Sub),
- installs the Web Pixel,
- creates the
segops.*product metafield definitions, - starts a 90-day historical backfill.
The embedded admin shows setup progress and your first auto-suggested segment within a few minutes.
Reconnecting an existing workspace#
Already have a SegOps workspace? Generate a signed connect link from Settings → Integrations → Shopify in the main app, then install the Shopify app from that link. The install attaches to your existing workspace instead of creating a new one.
Scopes#
| Scope | Why |
|---|---|
read_products, write_products | Sync the product catalog (write is opt-in, for pushing SegOps products back) |
read_orders | Purchase / order behavioral events |
read_customers | Customer profiles + tagging for segment push-back |
read_inventory | Inventory context on products |
read_checkouts | Checkout funnel events |
read_fulfillments | Fulfillment events |
read_locations, read_themes | Theme app block + store metadata |
What gets captured#
Webhooks (server-side events)#
Order, customer, checkout, cart, refund, and fulfillment webhooks are delivered directly to SegOps' ingestion pipeline and mapped to canonical events. Examples:
| Shopify topic | Canonical event |
|---|---|
orders/paid | purchase |
orders/create | order_created |
orders/edited | order_modified |
checkouts/create | checkout_start |
carts/update | cart_update |
customers/create | customer_created |
customers/marketing_consent/update | consent_change |
refunds/create | refund |
Web Pixel (storefront behavior)#
The pixel captures on-site behavior and ships it through the public-key
handshake (the buyer can't be spoofed — user_id is set server-side). It
respects the storefront analytics consent purpose.
| Storefront event | Canonical event |
|---|---|
page_viewed | page_view |
product_viewed | product_view |
product_added_to_cart | add_to_cart |
checkout_started | checkout_start |
checkout_completed | purchase |
search_submitted | search |
Configure tracked events + sampling in the embedded admin under Pixel.
Product catalog sync#
Shopify products sync into SegOps PIM automatically (products/create|update| delete). Each product maps to a SegOps Product with variants, images, tags,
price, and inventory under data.
- Inbound (Shopify → SegOps) is on by default.
- Outbound (SegOps → Shopify) is opt-in under Settings → Product sync —
SegOps products created from CSV/API are pushed to Shopify via
productCreate.
AI readability in Shopify admin#
SegOps writes product intelligence back as segops.* metafields so you can sort
and filter on it inside Shopify:
| Metafield | Source |
|---|---|
segops.ai_readability_score | AI readability score (0–100) |
segops.ai_recommendations | Ranked improvement actions |
segops.mention_count_30d | AI visibility mentions |
segops.segment_memberships | Product segment slugs |
Pushed nightly; trigger on demand from Settings → Product sync.
Segments in Shopify#
Push a SegOps segment into Shopify two ways (per segment):
- Customer tag (default) — membership is written as a
segops:<slug>tag. Works for any segment; usable in Shopify Email, Audiences, and Flow. - Native Shopify segment (advanced) — available only when the segment's rules fully translate to Shopify's segment query language (e.g. country, customer tags, total spend). The embedded admin tells you whether a segment is translatable.
Automations#
Flow#
The app ships Flow triggers (customer entered/left a SegOps segment, product AI score dropped) and actions (recompute a segment, tag a customer, score a product). Build workflows in Shopify Flow using the SegOps connector.
Discounts (Shopify Function)#
Configure segment-driven discounts under Settings → Discounts. A checkout
Function applies a discount based on the buyer's segops:<slug> membership tag —
no API call at checkout. Up to 25 active rules.
Checkout & account surfaces#
- Theme block — embed a SegOps landing page by slug into any theme section.
- Checkout upsell — segment-targeted product card at checkout.
- Order-status recommendations — personalized products on the order-status page.
Billing#
Shopify-installed workspaces are billed through Shopify (not Stripe). Pick a plan in the embedded admin under Billing; you confirm the charge on Shopify. Growth and Scale include a 30-day free trial; Starter has none.
Privacy & data deletion#
The app implements Shopify's three mandatory privacy webhooks (data request, customer redact, shop redact) with a 30-day SLA. See Shopify GDPR & Privacy Compliance.
Uninstalling keeps your data until Shopify's shop/redact arrives (~48h later),
so an accidental uninstall is recoverable.
Troubleshooting#
| Symptom | Check |
|---|---|
| No events after install | Backfill still running? See setup progress on the dashboard. Storefront events need the pixel enabled. |
| Pixel events missing | Storefront analytics consent must be granted; check the consent banner + Pixel settings. |
| Segment won't push as a native Shopify segment | The DSL isn't translatable — use customer-tag mode, or simplify the rules to country/tags/spend. |
| Discount not applying | The customer must carry the segops:<slug> tag (segment must be pushed in tag mode); rule must be active. |
| Scope change banner | Reapprove scopes from the embedded admin after an app update. |