Market your product with one connection

ROAS attribution 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.

pip install clippable-sdk

How it works

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://helpers.clippable.io/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:

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:

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

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.

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

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