Influencer Attribution
go.chatcal.ai kampanya linkleri, Worker implementasyonu, admin raporları ve domain doğrulama.
Repo referansı: chatcalgo/ · Tam dokümantasyon: docs/chatcalgo.md (monorepo internal)
Campaign links should be served from https://go.chatcal.ai.
Link Shapes
https://go.chatcal.ai/c/{campaignSlug}https://go.chatcal.ai/i/{creator}/{platform}
Supported query parameters:
creatororutm_sourceplatformorutm_mediumcampaignorutm_campaigncontentorutm_content
The Worker generates a fresh click_id on every click (query click_id is not used on redirect).
Redirect Behavior
For each click, the Worker:
- Parses campaign metadata from path + query
- Creates a unique
click_id(clk_prefix) - Inserts a row into D1
clicks - Optionally sends Mixpanel
Campaign Link Clicked - Returns 302 by User-Agent:
| Client | Destination |
|---|---|
| Android | Play Store with referrer (UTM + click_id) |
| iOS | App Store URL |
| Desktop / other | https://chatcal.ai/ with UTM + click_id |
App-installed Universal/App Link opens are handled by the mobile app from the original go.chatcal.ai URL (AttributionService).
Example Android referrer payload:
utm_source=creatorx&utm_medium=instagram&utm_campaign=summer_launch&utm_content=reel_1&click_id=clk_123&source_url=...Admin Reports
Protected by Authorization: Bearer <ADMIN_TOKEN>.
| Endpoint | Description |
|---|---|
GET /admin/reports/summary?days=7 | Total clicks, unique creators/campaigns |
GET /admin/reports/creators?days=7 | Clicks by creator + platform |
GET /admin/reports/campaigns?days=30 | Clicks by campaign |
GET /admin/reports/daily?days=30 | Daily click series |
Domain Verification Files
chatcalgo/public/.well-known/apple-app-site-association — iOS Universal Links, team Q722G994W5.com.chatcal.app.
Android App Links:
https://go.chatcal.ai/.well-known/assetlinks.jsonPackage: com.chatcal.app. Use production signing SHA-256 from Play Console (no placeholder in production).
Related
- Deploy runbook:
docs/deploy.md - Env reference:
docs/env.md - Growth roadmap:
docs/chatcalgo-roadmap.md