BehaviorScoresDocumentation

Customer arrives at checkout
    ↓
Retrieve customer score
    ↓
Apply discount rules
    ↓
Show appropriate offer (or none)

High Score Threshold: 70
  → Scores 70-100 get NO discount

Medium Score Threshold: 40
  → Scores 40-69 get SMALL discount
  → Scores 0-39 get FULL discount

0 -------- 40 -------- 70 -------- 100
   LOW        MEDIUM        HIGH
  (needs     (might       (will buy
  discount)   need nudge)   anyway)

SCORE BREAKDOWN

Recency:     +25 (purchased 5 days ago)
Frequency:   +20 (8 orders total)
Monetary:    +15 (avg order $85)
Coupon Use:  -10 (uses coupons 60% of time)
Return Rate: +5  (low return rate)
─────────────────
TOTAL:       55/100 (Medium)

┌─────────────────────────────────────┐
│  Cart Summary                       │
├─────────────────────────────────────┤
│  Subtotal              $120.00      │
│  Discount (SAVE5OFF)    -$6.00      │
│  Shipping               $5.00       │
│  ─────────────────────────────      │
│  Total                 $119.00      │
└─────────────────────────────────────┘

RESULTS

                Control     Variant
─────────────────────────────────────
Sample Size       524         518
Conversions       89          85
Conv. Rate       16.9%       16.4%
Avg Savings      $12.50      $8.30

Statistical Significance: 94%
Winner: Variant (saves more with similar conversion)

SUGGESTION

Your high-score threshold is 70%, but similar stores
in your segment perform better with 65%.

Current:   70% → No discount
Suggested: 65% → No discount

Potential Impact: +12% savings
Confidence: High (based on 47 similar stores)

[Start A/B Test]  [Apply Directly]  [Dismiss]

{
  "event": "decision.made",
  "timestamp": "2024-12-15T10:30:00Z",
  "data": {
    "shop_id": "shop_123",
    "customer_id": "cust_456",
    "score": 72,
    "decision": "no_coupon",
    "cart_value": 125.00
  }
}

Authorization: Bearer your_api_key_here

GET /api/v1/score/{customer_id}

{
  "customer_id": "cust_123",
  "score": 72,
  "confidence": "high",
  "segment": "loyal",
  "factors": {
    "recency": 85,
    "frequency": 70,
    "monetary": 65,
    "coupon_resistance": 45,
    "return_rate": 90
  },
  "updated_at": "2024-12-29T10:30:00Z"
}

POST /api/v1/decide

{
  "customer_id": "cust_123",
  "cart_value": 150.00,
  "product_ids": ["prod_1", "prod_2"]
}

{
  "decision": "small_coupon",
  "discount": {
    "type": "percentage",
    "value": 5,
    "code": "SAVE5XYZ123"
  },
  "reasoning": [
    "Customer score: 55 (medium)",
    "No excluded products",
    "Cart value above minimum"
  ]
}

{
  "event": "decision.made",
  "timestamp": "2024-12-29T14:30:00Z",
  "data": {
    "shop_id": "shop_123",
    "customer_id": "cust_456",
    "score": 72,
    "decision": "small_coupon",
    "cart_value": 150.00
  }
}

const crypto = require('crypto');

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

// Usage in your endpoint:
app.post('/webhook', (req, res) => {
  const signature = req.headers['x-behaviorscore-signature'];
  if (!verifyWebhook(JSON.stringify(req.body), signature, process.env.WEBHOOK_SECRET)) {
    return res.status(401).send('Invalid signature');
  }
  // Process the webhook...
});