Skip to main content
Ask Qyren which offers to show a specific player.

Endpoint

Request

Response

  • offers — ordered. Display top to bottom.
  • offers[].rank — AI-assigned ordering, starting at 1.
  • offers[].score — internal confidence value used for ordering. Useful for diagnostics; don’t surface to players.
  • offers[].name — display name as imported in the catalog.
  • segment — the behavioral segment Qyren placed this player in for this call.
If no offers are eligible after filtering and pacing, offers is an empty array — fall back to your default offer list.

After you show them

Log offer_impression events for each offer actually rendered. This is what closes the learning loop.

Response codes

Fallback

Always have a default offer list hard-coded in your game. If the call times out (>500ms) or returns 503, show the default. Never block gameplay on a recommendation call.