Skip to main content

Offer ranking

Changelly provides an opportunity to display offers with the highest conversion to a specific user. This helps your user complete their transactions and enhances your success rates.

warning

Currently, offer ranking is available only for On-Ramp offers.

Offer ranking flow​

In real time, Fiat API determines which segment each user belongs to. The user segment depends on user data, such as country, currency pair, browser family, exchange account, previous transaction history, etc. Based on this historical data, Fiat API provides offers with the highest conversion score for a specific user segment.

  1. API — calculates the share of completed and initiated transactions. This share is an offer conversion score configured as a score parameter. The score value can be between 0.0 and 1.0. The more transactions were completed for the offer, the higher the conversion rate.
  2. API — ranks offers in descending order. The first offer has the highest score.
  3. API - marks ranked offers with the label parameter.
  4. API — returns ranked offers in the /v1/offers response.
  5. System - sets offer display according to the score and label values.
  6. GUI - displays set ranked offers.

Offer ranking labels​

The labels parameter can contain only the following values from the list.

LabelDescription
optimalThe label for the offer with the highest score value.
verifiedThe label for the offer used for the previous finished transaction.

Offer ranking common issues​

Sometimes, Fiat API does not return an offer conversion score. This occurs due to the following reasons:

  • A provider is new.
  • A provider does not have enough traffic.
  • A payment method is rare.
  • User transaction history is short.