Shopify

8 production-ready jobs — customer cohort personas, product review analysis, collection content generation, abandoned cart focus groups, seasonal campaign planning, product bundling validation, inventory-aware content prioritization, and customer metafield persona enrichment

Shopify holds your commerce truth — who buys, what they buy, how often they return, and where they drop off. These eight jobs pull that data through Mavera’s surfaces (Custom Personas, Mave Agent, Focus Groups, Generate, Brand Voices) so your personas reflect real purchasing behavior, your content matches actual inventory priorities, and your campaigns are informed by synthetic audience reactions grounded in real customer data.

---

API Reference Card

Detail	Value
Base URL	https://{store}.myshopify.com/admin/api/2024-10/graphql.json
Auth	OAuth 2.0 — X-Shopify-Access-Token header
Rate limits	GraphQL: 50 pts/sec (Standard), 500 pts/sec (Shopify Plus)
REST fallback	https://{store}.myshopify.com/admin/api/2024-10/{resource}.json
Mavera base	https://app.mavera.io/api/v1
Mavera auth	Authorization: Bearer mvra_live_...

All examples use three environment variables: SHOPIFY_STORE (your myshopify.com subdomain, e.g. acme-store), SHOPIFY_ACCESS_TOKEN (private app access token starting with shpat_), and MAVERA_API_KEY. Python examples use requests; JavaScript examples use fetch. GraphQL queries target the 2024-10 API version.

---

Prerequisites

1. Shopify private app with required scopes

   Create a custom app in Shopify Admin → Settings → Apps and sales channels → Develop apps. Grant scopes: read_customers, read_orders, read_products, read_inventory, read_checkouts. Copy the Admin API access token (starts with shpat_).

2. Mavera API key

   Get your key from Mavera dashboard. The key starts with mvra_live_.

3. Install dependencies

   pip install requests openai
   
4. Environment variables

   export SHOPIFY_STORE="acme-store"
   export SHOPIFY_ACCESS_TOKEN="shpat_xxxxx"
   export MAVERA_API_KEY="mvra_live_xxxxx"
   

---

Jobs

#	Job	Shopify Data	Mavera Surface	Output
1	Customer Cohort → Persona Pipeline	Customers with order history	Custom Personas	Cohort-segmented persona library
2	Product Review Analysis	Product metafields / Judge.me reviews	Responses	Sentiment + theme breakdown per product
3	Product Collection → Content Generation	Collection products	Brand Voices + Generate	Marketing copy with brand-consistent voice
4	Abandoned Cart → Focus Group	Abandoned checkouts	Focus Groups	Abandonment reason insights by segment
5	Seasonal Sales → Campaign Planning	Historical orders by month	Mave Agent	Data-driven seasonal campaign calendar
6	Product Bundling Validation	Orders with line items	Focus Groups	Bundle concept validation scores
7	Inventory-Aware Content Prioritization	Inventory levels by location	Generate	Prioritized content for high-stock items
8	Customer Metafield → Persona Enrichment	Customer metafields	Custom Personas	Enriched personas with loyalty + preference data

---

---

Rate Limits & Production Notes

Concern	Shopify Limit	Recommendation
GraphQL cost	50 pts/sec (Standard), 500 pts/sec (Plus)	Check extensions.cost.throttleStatus in every response
REST API	2 req/sec (Standard), 20 req/sec (Plus)	Add 500ms sleep between REST calls
Bulk operations	1 concurrent bulk op per app	Use for > 10k records instead of pagination
Webhook delivery	Push-based	Consider webhooks for real-time triggers
Mavera rate limit	Varies by plan	Exponential backoff on 429 responses

Before going to production: store tokens in a secrets manager (never commit them), implement exponential backoff with jitter (start 1s, double, cap 30s), use Shopify Bulk Operations for 10k+ records, log all API responses for auditing, test on a development store first, and pin your API version to 2024-10.

Production Checklist

• Secrets in env vars or secrets manager
• Exponential backoff with jitter on all API calls
• Bulk operations for datasets > 10k records
• Structured logging and error alerting
• Tested on Shopify development store
• API version pinned to 2024-10; rate limit headers monitored
• Pagination cursors handled for all list endpoints

---

Shopify GraphQL Admin API

Official GraphQL reference with schema explorer.

Mavera API Reference

Personas, focus groups, brand voices, and generations.

Shopify Bulk Operations

Async queries for large datasets.

Integration Quick Reference

Cross-platform patterns for all Mavera integrations.