Skip to main content

Quality Scoring

Quality scores determine how ads rank in the auction. Higher quality ads win auctions at lower bids, creating an incentive for advertisers to provide genuinely useful content.

How it's calculated​

Quality scores factor in:

  • Click-through rate — How often users click the ad
  • Business ratings — 1-5 star ratings from developers (you!)
  • Feedback sentiment — Positive vs negative user reactions
  • Conversion rate — How often clicks lead to meaningful outcomes

Rating businesses​

After a user clicks an ad and interacts with the business, you can submit a quality rating:

await client.rateBusiness({
  tracking_token: ad.tracking_token,
  ad_unit_id: ad._meta!.unit_id,
  rating: 4,
  context: 'Accurate information, good landing page',
});

Rating requirements​

  • A verified click must exist before you can rate
  • Rating must be submitted within 72 hours of the click
  • One rating per interaction

Rating scale​

RatingMeaning
5Excellent — highly relevant, great experience
4Good — relevant and useful
3Average — somewhat relevant
2Poor — not very relevant or useful
1Bad — misleading, broken, or irrelevant

Why it matters​

  • Higher quality = better ranking — Good advertisers win more auctions
  • Better user experience — Your users see more relevant, higher-quality content
  • More clicks = more revenue — Quality drives engagement which drives earnings
  • Ecosystem health — Ratings help the platform surface the best businesses