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.
offers is an empty array — fall back to your default offer list.
After you show them
Logoffer_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 returns503, show the default. Never block gameplay on a recommendation call.
