ebosAi AMP β Affiliate Marketing Platform Documentation¶
Welcome to the official documentation for ebosAi AMP (mh2603), the intelligent Affiliate Marketing Platform engineered for growing businesses, modern SaaS applications, and digital commerce enterprises.
π Overview¶
ebosAi AMP is a plug-and-extend growth engine that enables businesses to launch, manage, track, and scale partner, influencer, and affiliate marketing programmes with zero system disruption.
Whether managing high-profile private influencers or tapping into a global network via the Central Partner Pool, ebosAi AMP provides end-to-end automationβfrom 1-line zero-secret client tracking tags and cryptographically signed attribution tokens to automated commission calculation, AI-powered creative studios, and batch bank payouts.
graph TD
A[Partner Pool / Invited Creator] -->|Registers / Accepts Invite| B[Unified Partner Portal /partners]
B -->|Generates Attributed Links| C[Audience Clicks Tracking Link /ref/slug]
C -->|30-Day Signed JWT Cookie + ?ref= Pass-Through| D[Conversion Event: Signup / Order]
D -->|1-Line Client-Side Tag / Webhook| E[Commission Calculation Waterfall]
E -->|Product Override / Tier Rate| F[Pending Commission & Holding Period]
F -->|Admin Approval| G[Approved Payout Batch]
G -->|Batch Settlement & CSV Export| H[Affiliate Bank Transfer / Wire]
π Key Architectural Innovations¶
1. Central Partner Discovery Pool & Exclusivity Lifecycle¶
Eliminating the friction of siloed affiliate signups, ebosAi AMP provides a network-wide Partner Discovery Pool:
- Zero-Friction Signup (/partners/signup): Creators register centrally without needing merchant-specific codes.
- Role & Persona Specialization: Promoters declare their profile type (Affiliate/Publisher vs. Content Creator/Influencer) and provide a concise 500-character elevator pitch.
- Multi-Brand Freedom vs. Exclusive Partnerships: Creators choose between promoting multiple merchants across the network (/partners/merchants) or securing dedicated exclusive relationships with locked terms.
- Contract Exclusivity Lifecycle: Exclusive partners can transparently petition for contract release through their portal, while merchants review and manage releases with full audit logging.
2. Zero-Secret Client Conversion Tracking Tag (Option C)¶
Product vendors and SaaS platforms integrate conversion tracking in seconds with a single line of client-side code on their signup confirmation or thank-you page:
<script
src="https://marketing.ebosai.com/ref/track.js"
data-tenant="<TENANT_UUID>"
data-customer-id="<USER_ID>"
data-amount="49.00"
data-currency="USD"
data-plan="pro"
async>
</script>
amp_ref).
- Cross-Domain Persistence: Dual-channel handoff passes ?ref= to destination pages where track.js caches the token in first-party localStorage, providing 100% attribution reliability across third-party domains.
- Strict Privacy Compliance: Payloads strictly transmit pseudonymous customer IDs and transaction amounts with zero personally identifiable information (PII).
3. Built-In AI Creative Studio (Bring-Your-Own-Key / BYOK)¶
Equip your marketing team and promoters with a high-velocity AI Creative Studio accessible directly within the tenant admin portal (/admin/ai-studio):
- BYOK Encryption: Secure tenant-level API key storage encrypted with AES-256-GCM supporting OpenAI, DeepSeek, Anthropic, Gemini, OpenRouter, and custom endpoints.
- Multi-Channel Collateral: Generate tailored copy and formats for LinkedIn thought-leadership posts, Twitter/X viral threads, Instagram captions, high-resolution promotional graphics, 15β60s reels/video scripts & scene storyboards, and interactive SVG/CSS motion banners.
- Cloudflare R2 Integration: 1-click persistence to Cloudflare R2 object storage and PostgreSQL marketing asset catalogue for instant partner access.
π¦ Core Capabilities¶
| Module | Name | Key Functionality |
|---|---|---|
| M1 | Influencer & Partner Management | Unified partner registry, private custom links, VIP terms, manual payouts. |
| M2 | Partner Self-Service Portal & Pool | Central partner pool, OTP onboarding, multi-brand discovery, contract release management, link generator, media assets. |
| M3 | Product Catalogue | Plan/product listing, granular commission overrides (percentage/flat fee), SKU targeting. |
| M4 | Tracking & Attribution | 30-day cryptographically signed cookie, 1-line client script, UTM fallback, anti-fraud checks. |
| M5 | Commission Engine | Instant reward calculation waterfall, configurable holding periods, tier escalation, approval gates. |
| M6 | Payout Management | Affiliate bank detail capture, batch grouping, payment lifecycle tracking, banking CSV export. |
| M7 | Analytics & Reporting | Real-time conversion funnels, partner leaderboards, ROI analysis, traffic source breakdown. |
| M8 | REST API Gateway | Public beacon ingestion, HMAC webhook verification, rate limiting, strict tenant isolation. |
| M9 | Marketplace Integration | Universal SSO, auto-provisioning, unified billing, cross-app product connectors. |
π§ Navigation Guide¶
- Partner Portal User Manual β Step-by-step user guide for partner registration, pool onboarding, multi-brand product promotion, link creation, and payouts.
- Influencer & Partner Attribution Guide β Comprehensive end-to-end operational guide for custom domains, tracking links, and 1-line conversion tags.
- Commission Booking User Manual β In-depth guide to the commission calculation waterfall, holding periods, and settlement flows.
- Admin & Merchant Control Panel Manual β Central administration manual covering Partner Discovery Pool (
/admin/affiliates), RBAC, user permissions, and platform settings. - Partner Discovery Pool Admin Manual β Admin guide for searching pool creators, issuing invitations, and reviewing contract releases.
- AI Creative Studio & Marketing Assets Manual β Admin guide for Bring-Your-Own-Key (BYOK) multi-model AI setup, multi-channel collateral generation, Cloudflare R2 persistence, and partner asset publishing.