traaaction 1.3.0

Python SDK for Traaaction affiliate tracking and management

traaaction

Python SDK for Traaaction — affiliate tracking for Python web apps.

Install

pip install traaaction

Quick start

from traaaction import Traaaction

trac = Traaaction()  # reads TRAAACTION_API_KEY env var
# or: trac = Traaaction(api_key="pk_live_xxx")

Track a lead (signup)

Call this immediately after creating a user in your database:

trac.track.lead(
    click_id=click_id,          # from cookie or URL param
    event_name="sign_up",
    customer_id=str(user.id),   # your app's user ID
    customer_email=user.email,
    customer_name=user.get_full_name(),
)

Stripe checkout metadata

Pass this to stripe.checkout.Session.create():

metadata = trac.stripe_metadata(request, str(user.id))
session = stripe.checkout.Session.create(
    line_items=[...],
    mode="subscription",
    metadata=metadata,
    success_url="...",
)

Django integration

1. Install with Django extras

pip install "traaaction[django]"

2. Add middleware

# settings.py
MIDDLEWARE = [
    ...
    "traaaction.django.TraacMiddleware",
    "django.contrib.sessions.middleware.SessionMiddleware",
    ...
]

# Optional: share cookie across subdomains
TRAC_COOKIE_DOMAIN = ".yourdomain.com"

3. Track events in views

# views.py
from traaaction import Traaaction
from traaaction.django import get_click_id

trac = Traaaction()

def signup_view(request):
    # ... create user ...

    click_id = get_click_id(request)  # reads middleware session or cookies
    trac.track.lead(
        click_id=click_id,
        event_name="sign_up",
        customer_id=str(user.id),
        customer_email=user.email,
    )
    return redirect("/dashboard")

def checkout_view(request):
    metadata = trac.stripe_metadata(request, str(user.id))
    session = stripe.checkout.Session.create(
        line_items=[...],
        mode="subscription",
        metadata=metadata,
        success_url=request.build_absolute_uri("/dashboard"),
    )
    return redirect(session.url)

Environment variables

Variable	Description
TRAAACTION_API_KEY	Your Traaaction publishable key (pk_live_...)
TRAC_API_KEY	Legacy alias (backwards compatible)

How it works

1. A seller shares their Traaaction affiliate link (e.g. traaaction.com/s/mission/abc123)
2. A customer clicks → lands on your site with ?trac_click_id=clk_xxx
3. TraacMiddleware captures and persists the click ID (session + cookie)
4. On signup: track.lead() links the customer to the seller
5. On purchase: Stripe webhook (configured in Traaaction dashboard) automatically creates the commission

Links

• Documentation
• Django quickstart
• Dashboard