Community Affiliation Campaigns

Integration Guide

For Product Builders

Step 1: API Key Setup

  • Register on ProductClank Arena
  • Generate API credentials
  • Set webhook endpoints

Step 2: Campaign Creation

// Example API call
POST /api/v1/campaigns
{
  "product_name": "MyAwesomeApp",
  "description": "AI-powered productivity tool",
  "kpis": [
    {
      "type": "signups",
      "target": 10000,
      "timeframe_days": 180
    }
  ],
  "reward_structure": {
    "type": "revenue_share",
    "percentage": 50,
    "duration_months": 6
  }
}

Step 3: Event Tracking

  • Send events when users sign up
  • Report revenue milestones
  • Update metrics in real-time
// Track signup event
POST /api/v1/campaigns/{campaign_id}/events
{
  "event_type": "signup",
  "user_id": "user_123",
  "timestamp": "2025-01-01T00:00:00Z"
}

Step 4: Webhook Handling

Receive notifications on:

  • Party completion
  • Milestone achievements
  • Reward distributions
// Webhook payload example
{
  "event": "milestone_achieved",
  "campaign_id": "camp_abc123",
  "kpi": "signups",
  "achieved_value": 10500,
  "target_value": 10000,
  "timestamp": "2025-06-01T00:00:00Z"
}

For Community Developers

Querying Campaign Data

// Get active campaigns
GET /api/v1/campaigns?status=active

// Get specific campaign details
GET /api/v1/campaigns/{campaign_id}

// Get token price data
GET /api/v1/campaigns/{campaign_id}/token/price

Treasury Integration

  • Connect community wallet
  • Set distribution preferences
  • Automate reward claims