Build leading creator campaigns on Clippable's platform

Contact salesStart building

pip install clippable-sdk

Powered by our attribution stack

Our industry-leading SDK and attribution engine are designed for real storefronts, delivering deterministic ROAS and temporal correlation.

ROAS Tracking SDK

  • Install: pip install clippable-sdk
  • Payload: page views, clicks, commerce
  • Attribution: deterministic + temporal
Learn more

Commerce Events API

  • Methods: productView, addToCart, purchase
  • Custom: clippable.track(type, data)
  • Session: anonymous UUID, no cookies
Learn more

Attribution Engine

  • Direct: ?clp= tracked link sessions
  • Organic: temporal correlation engine
  • Output: clipper-level ROAS in dashboard
Learn more

Start building with the SDK

Start building

SDK documentation

Install the tracker, wire commerce events, and read the JavaScript API reference.

View documentation

AI integration prompt

Drop our markdown prompt into Cursor, Codex, or Claude Code for one-shot setup.

Download prompt

Enterprise & security

Privacy-first tracking, SSO, seats, and security reviews for larger orgs.

Learn more

The all-in-one platform for campaign attribution

Install once, attribute every session, and optimize payouts from a single ROAS dashboard.

Learn moreStart building

Install

Install with pip install clippable-sdk or drop the web tracker on your store, page views, scroll depth, and session timing captured automatically.

Attribute

Creators share tracked links. Every click and purchase in that session maps back to the clipper who drove it.

Optimize

See ROAS by creator in your dashboard. Pair direct attribution with temporal correlation for organic lift.

Use cases driven by our platform

Contact salesStart building

E-commerce & DTC

Measure creator-driven revenue without redirect links.

Mobile apps

Track installs and in-app purchases from creator campaigns.

SaaS signups

Attribute trials and paid conversions to the clips that drove them.

Performance campaigns

Run thousands of clips with payout data tied to real outcomes.

Research & analytics

Turn campaign spikes and store traffic into clear ROAS insights.

Agency workflows

Give clients clipper-level proof with a lightweight SDK.

Enterprise-grade features for operating at scale

Learn more

Security and data privacy

  • No cookies, localStorage and sessionStorage only
  • Anonymous visitor IDs, no PII by default
  • Cross-domain scoped to your store

Performance

  • Async ~8KB script with zero layout shift
  • Tracked link params removed after detection
  • Zero impact on Core Web Vitals

Enterprise controls

  • SSO, seats, and security reviews
  • Dedicated rollout guidance
  • Campaign workflows at scale

Get started

Partner with us on attribution

  • Work with our team on SDK rollout
  • Get hands-on deployment guidance
  • Enterprise campaign workflows
Contact sales

Build on your own

  • Access the SDK and integration prompt
  • Simple install on your storefront
  • See ROAS in your dashboard within minutes
View documentation

Home / API & SDK

ROAS Tracking SDK

Measure the real impact of creator campaigns on your store. The Clippable SDK tracks every visitor interaction and uses tracked links from post descriptions to provide deterministic click-through attribution alongside our temporal correlation engine.

Quick start

pip install clippable-sdk

Or use the web tracker below if you prefer a script tag on your storefront.

How it works

1

Install the SDK

Run pip install clippable-sdk for server-side integrations, or add the web tracker script to your store. Captures page views, product interactions, cart events, and purchases from every visitor.

2

Creators get tracked links

Each clipper gets a unique link to your store with a ?clp=CODE parameter. They put it in their post description.

3

Viewers click, SDK tracks

When a viewer clicks the link, they land on your real store. The SDK detects the tracking param, records the click, and attributes every action in that session (including purchases) to the creator.

4

See ROAS in your dashboard

Deterministic click attribution combines with our temporal correlation engine for a complete ROAS picture, even for visitors who didn't click a tracked link.

Installation

Python

Install the package from PyPI, then configure your store credentials in your app or notebook.

pip install clippable-sdk

Web tracker

Add the tracking script to every page of your store. Place it before the closing </body> tag or in your layout component.

<script
  src="https://clippablehelpers-production.up.railway.app/sdk/tracker.js"
  data-store-id="YOUR_STORE_ID"
  data-api-key="YOUR_API_KEY"
></script>

Get your Store ID and API Key from the brand dashboard after creating a campaign with a tracking URL. The script is ~8KB and loads asynchronously, it won't affect your page speed.

Automatic tracking

The SDK automatically captures these events for every visitor, no additional code required:

EventDescription
page_viewEvery page load, URL, title, referrer
link_clickFired when a visitor arrives via a tracked link (?clp=CODE)
scroll_depthAt 25%, 50%, 75%, and 90% scroll thresholds
time_on_pageAt 30s, 60s, 2min, and 5min marks

Tracked links

When you set a "Store Link" on your campaign, each clipper gets a unique tracked URL:

https://yourstore.com/products/summer-sale?clp=k7xm2n4p

This is your real store URL, not a redirect. When a viewer clicks it:

  • 1.They land on your store normally
  • 2.The SDK detects ?clp=k7xm2n4p and fires a link_click event
  • 3.The ?clp= param is silently removed from the URL bar
  • 4.Every subsequent event in that session (product views, add to cart, purchases) is attributed to the clipper

Manual event tracking

For store-specific interactions that aren't auto-detected, use the JavaScript API:

Product view

clippable.productView({
  id: 'SKU-123',
  name: 'Summer T-Shirt',
  price: 29.99,
  category: 'Apparel'
});

Add to cart

clippable.addToCart({
  id: 'SKU-123',
  name: 'Summer T-Shirt',
  price: 29.99,
  quantity: 1
});

Purchase

This is the most important event for ROAS calculation. Call it on your order confirmation page.

clippable.purchase({
  order_id: 'ORD-456',
  revenue: 59.98,
  currency: 'USD',
  items: [
    { id: 'SKU-123', name: 'Summer T-Shirt', price: 29.99, quantity: 2 }
  ]
});

Custom events

clippable.track('signup', { plan: 'pro' });
clippable.track('video_play', { video_id: 'abc' });

Attribution model

Clippable uses two complementary attribution methods:

Direct attribution

When a visitor arrives via a tracked link (?clp=CODE), every action in that session is deterministically attributed to the clipper. This gives you exact click-to-purchase tracking.

Temporal correlation

For visitors who find your store organically after seeing a campaign (no tracked link), our engine correlates campaign view spikes with store traffic spikes using Pearson correlation analysis. This captures viral and organic reach that direct links miss.

Privacy

  • •No personal data collected, visitor IDs are anonymous UUIDs stored in localStorage
  • •No cookies, uses localStorage and sessionStorage only
  • •No cross-site tracking, data is scoped to your store domain
  • •The ?clp= parameter is automatically removed from the URL bar after detection
  • •~8KB script, loads asynchronously, zero impact on Core Web Vitals

JavaScript API reference

MethodDescription
clippable.track(type, data)Track a custom event
clippable.productView(product)Track a product page view
clippable.addToCart(product)Track an add-to-cart action
clippable.purchase(order)Track a completed purchase with revenue
clippable.identify(userId, traits)Associate the visitor with a known user
clippable.flush()Force-send all queued events immediately
clippable.getVisitorId()Returns the anonymous visitor UUID
clippable.getSessionId()Returns the current session UUID

Instant setup with AI

Download our integration prompt and paste it into your AI coding assistant. It will automatically find the right files in your codebase and add the SDK script, product view tracking, add-to-cart tracking, and purchase tracking.

clippable-sdk-integration.md

Works with Claude Code, Codex, Cursor, Windsurf, and any AI coding tool

Download Prompt
# Claude Code
claude "$(cat clippable-sdk-integration.md)"

# Or just drag the file into Cursor / Codex / Windsurf

Ready to start tracking?

Create a campaign with a store tracking URL, install the SDK script, and you'll see click and ROAS data in your brand dashboard within minutes.

Get StartedSupport