Metadata-Version: 2.4
Name: clippable-sdk
Version: 0.2.0
Summary: Clippable SDK - Campaign ROAS analytics via temporal correlation
Project-URL: Homepage, https://clippable.com
Project-URL: Repository, https://github.com/clippable/sdk
Author-email: Clippable <hello@clippable.com>
License-Expression: MIT
License-File: LICENSE
Keywords: analytics,attribution,campaign,roas,sdk
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: rich>=13.7.0
Description-Content-Type: text/markdown

# Clippable SDK

Campaign ROAS analytics via temporal correlation. No click-through links required.

## Install

```bash
pip install clippable-sdk
```

## Usage

```bash
# Interactive setup wizard
clippable

# Skip setup if .env is configured
clippable --skip-setup

# Point to a specific env file
clippable --env /path/to/.env.local

# Filter to a specific store
clippable --store-id <your-store-id>
```

## What it does

1. **Tracks all store interactions** - page views, product views, add-to-cart, purchases
2. **Correlates with campaign spikes** - uses Pearson correlation across hourly time windows
3. **Measures real ROAS** - attributes revenue to campaigns even without UTM click-through links

## Setup

1. Add the JS tracker to your store
2. Run the SQL migration (`sdk/migrations/001_sdk_events.sql`)
3. Deploy edge functions (`sdk-ingest`, `sdk-correlate`)
4. Run `clippable` to view your dashboard
