Shopify Integration
Set up Colter Lens on your Shopify store with one-click install.
TL;DR: Shopify installs Colter through the embedded app flow, provisions a Lens site, and injects the storefront beacon through a theme extension. The beacon is a low-friction fallback; full agent traffic coverage requires request-level collection in front of the storefront or server-log ingestion.
Install Flow
- Merchant starts the Shopify app install.
- Colter completes OAuth and stores the offline token.
- A Lens site is provisioned for the shop.
- The theme extension injects the storefront beacon.
Browser-like agent visits can appear in Lens within seconds. Direct crawler traffic will not appear from the beacon alone because most crawlers do not execute JavaScript.
Required Scopes
| Scope | Purpose |
|---|---|
read_products | Catalog inspection and readiness checks |
read_orders | Revenue attribution in Lens |
write_metafields | Store the Lens site ID on the shop |
What Gets Added
- a storefront beacon for browser-like agent telemetry
- a
colter.lens_site_idmetafield for site resolution - Shopify webhooks for revenue attribution and analytics
Revenue Webhook Example
Non-Shopify stores can send the same shape manually:
curl -X POST https://agenticcom.ai/api/v1/lens/revenue-webhook \
-H "Authorization: Bearer $COLTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"site_id": "site_abc123",
"order_id": "order_123",
"currency": "USD",
"amount_cents": 31900,
"items_count": 3,
"session_id": "sess_abc123"
}'
Troubleshooting
| Issue | Fix |
|---|---|
| OAuth scope error | Reinstall the app and approve the requested scopes |
| Beacon not firing | Enable the Colter App Embed in Shopify theme settings |
| No Lens traffic yet | Confirm the beacon is installed for browser-like agents; use edge or log collection for direct crawlers |
| Revenue not attributed | Make sure the order flow includes the session_id correlation path |