Metadata-Version: 2.4
Name: clippable-sdk
Version: 0.2.1
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
# Run the CLI (log in with your Clippable account)
clippable

# If 'clippable' isn't found, use this instead:
python -m clippable_sdk

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

# Log out
clippable --logout
```

## 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. Install the SDK: `pip install clippable-sdk`
2. Run `clippable` and log in with your Clippable account
3. Add the JS tracker to your store (shown in the setup screen)
4. View your dashboard, campaigns, events, and correlation analysis
