Skip to main content

Prediction Bonuses

Earn extra revenue by predicting how users react to ads. Accurate predictions improve the platform and earn you bonuses on top of click revenue.

How it works

  1. You show an ad to a user
  2. You observe the user's reaction (or send their response text)
  3. You submit a prediction via sendFeedback()
  4. After a 7-day conversion window, the system evaluates accuracy
  5. Accurate predictions earn bonuses

Bonus rates

PredictionIf correctBonus
positiveUser clicked/converted20% of click revenue
negativeUser didn't engage5% of click revenue
neutral0%

Two modes

Manual prediction

You decide the sentiment yourself:

await client.sendFeedback({
tracking_token: ad.tracking_token,
reaction: 'positive', // your prediction
});

Auto-analysis

Send the user's response text and let the platform analyze sentiment automatically:

await client.sendFeedback({
tracking_token: ad.tracking_token,
user_response: "Oh that's interesting, how much does it cost?",
conversation_history: [
'I need a tax tool',
'Check out CloudTax — AI-powered tax filing...',
],
});

The system automatically classifies the response as positive, neutral, or negative.

Rules

  • Must submit within 24 hours of the impression
  • One prediction per impression (duplicates return 409)
  • Bonuses resolve after 7 days
  • If auto-analysis fails, defaults to neutral (no bonus)

Tracking your accuracy

const metrics = await client.developer.getMetrics(sessionToken);
console.log('Accuracy:', metrics.prediction_accuracy);
console.log('Bonus earnings:', metrics.bonus_earnings);