Running totals

A daily streak asks "did you show up today?". A running total asks "how many have you done?". Every completed action adds one: 12 lessons, 30 posts, 5 orders. Running totals never expire, so members keep what they earn.

Both kinds count the same way. Your platform or server tells Streakfox a member finished the action, and the widget shows the new total.

Two names you'll see everywhere:

• Project key identifies your project. It's public and safe to put in a web page.
• Action is the thing you count, such as lesson_complete or post_created.

1) Count each action

Actions are counted after they happen, from a source the member can't fake. The browser never counts. Pick the path that fits your platform:

Give every completion an ID

A running total counts every action, so a retried request must not count twice. Send an ID for each completion:

• Incoming URL. Map the lesson, post or order ID to completion_id.
• Webhook. Send it as idempotencyKey, such as lesson_42:member_123.
• WordPress. The plugin does this for you. Custom hooks pass completion:YOUR_ID.

Each member and ID counts once. Without an ID, a retried webhook request can count again, and the incoming URL treats two actions from one member in the same minute as one.

curl -X POST https://api.streakfox.com/v1/webhook/YOUR_PROJECT_KEY/e \
  -H "Content-Type: application/json" \
  -H "X-Streak-Webhook-Secret: YOUR_WEBHOOK_SECRET" \
  -d '{"event":"lesson_complete","userHash":"member_123","idempotencyKey":"lesson_42:member_123"}'

2) Show the total

Add the widget to pages where members are signed in. It displays progress and doesn't count anything. Tell it whose total to show with the same member you count:

<script
  src="https://cdn.streakfox.com/widget.js"
  data-project="YOUR_PROJECT_KEY"
  data-event="YOUR_ACTION"
  data-member="MEMBER_EMAIL"
  defer
></script>

• Incoming URL. Use data-member with your platform's member email variable. The course platform guide lists them.
• Webhook. Use data-user-hash with the member ID you send as userHash.
• WordPress. The plugin adds the widget and the member for you.

data-member is for display only. It never reveals coupon codes or reward links. Those need a signed identity token.

3) Test, then go live

Until your program goes live, every action counts as a test. Complete the action once as a test member and watch Streakfox setup confirm their new total. Then go live.

Troubleshooting

Next steps

• Course platforms, Zapier and Make
• Events API
• Connecting users for protected rewards