Currencies and rates

Rates are configured on the Settings → Currencies («Настройки → Валюты») tab, in the Exchange rates («Курсы валют») block. The tracker uses them to convert to USD the payouts from postbacks, the amounts from conversion import and the spend from the extension. Owners and admins can see the tab.

Report currency

The report currency is USD and cannot be changed. The Default currency («Валюта по умолчанию») field on the Settings → General («Настройки → Основные») tab shows USD and cannot be edited.

Amounts in USD need no rate. Any other currency needs a rate, either automatic or manual. If there is no rate, the tracker does not count the amount 1:1 but rejects it, see If there is no rate.

Prices in campaign cost models and the click cost from a source parameter are set directly in USD and are not converted by rates, see Campaign cost models.

Which rate the tracker uses

A rate is the number of USD per 1 unit of currency. For each amount, the tracker chooses the rate like this:

1. The currency is USD — the rate is 1.
2. There is a manual rate for this currency dated no later than the required date — the latest of them is used.
3. There is no such manual rate and the Automatic rates («Автоматические курсы») checkbox is on — the latest automatic rate dated no later than the required date and no more than 7 days older than it is used.
4. Otherwise there is no rate.

The required date depends on what is being converted:

Automatic rates

The tracker fetches daily reference rates from Frankfurter automatically and checks for new ones every hour.

• Automatic rates — a checkbox, on by default. When the checkbox is off, only manual rates work. The change applies immediately; there is no save button.
• Check for updates («Проверить обновления») — the button requests rates from the source right now, without waiting for the next check.

The status is shown under the line about the source:

A rate saved for a date does not change. A rate for a new date is added as a separate row.

Manual rate

You need a manual rate when the source does not have the currency, automatic rates are turned off, or you want to use your own rate.

1. Open Settings → Currencies.
2. Expand the Add a manual rate («Добавить ручной курс») block.
3. Fill in the Currency («Валюта»), Effective from · UTC («Действует с · UTC») and USD per 1 unit of currency («USD за 1 единицу валюты») fields.
4. Click Add rate («Добавить курс»).

The Add rate button is inactive while the fields are filled in incorrectly. After saving, the rate appears in the Rate history («История курсов») table with the source “Manual” («Вручную»).

A manual rate takes priority over an automatic one. It applies from the specified date until the next manual rate for this currency and has no age limit. New automatic rates do not replace it.

To change a rate, add a new manual rate with a later date in the Effective from · UTC field. It takes effect from that date.

Rate history

The Rate history table shows manual and automatic rates: up to the 1000 most recent rows, newest dates first.

The Find currency («Найти валюту») field above the table leaves only the rows with the code you need. An empty table shows “No rates found. No rate is needed for payouts in USD.” («Курсы не найдены. Для выплат в USD курс не требуется.»)

Conversion currency and rate

The tracker takes the currency of a postback amount from the currency parameter of the incoming postback. If the parameter is missing, the offer currency is used: for offers created in the panel, this is USD. For a click without an offer, it is also USD. The payout sent by the network and the cost parameter are both in this currency.

If the network does not pay in USD, pass the currency code in the postback URL, for example currency=EUR. The template in Settings → Postback («Настройки → Postback») already contains this parameter with the value USD — replace it. Where to get the postback URL is covered on the Incoming postback page.

A fixed payout from the offer's Payout $ («Выплата $») field is recorded in the offer currency and does not depend on the currency parameter. For offers created in the panel this is USD, so enter the amount in dollars. How the tracker chooses the amount is covered in the Payout section.

The rate is locked to the conversion when it is received:

• The payout is converted to USD at the rate for the day the postback was received.
• A repeat postback with the same transaction ID and in the same currency is calculated at the rate recorded in the conversion, not the current one. More in Currency rate on repeats.
• New automatic and manual rates do not recalculate conversions that have already been received.

The postback cost parameter sets the conversion cost in the postback currency. If the payout is recorded in the same currency, cost is converted to USD at the same rate as the payout. With a fixed offer payout in a different currency, cost is converted at the postback currency rate for the day the conversion is recorded, and you need a rate for that currency even if the payout is in USD, see The cost parameter in a postback.

Conversion import from CSV locks the rate the same way. The currency is set for the whole file in the Currency field, USD by default. It does not affect a fixed offer payout.

Rate for extension spend

The spend extension sends daily spend in the ad account currency. The tracker converts it to USD at the rate for the spend date. An account in USD needs no rate.

The rate is locked to the account and day on the first accepted collection. Repeat uploads of that day are calculated at the same rate, even if the rates in the tracker have changed since then.

If there is no rate

An amount in a currency without a rate is not recorded. Causes and what to do:

• The Automatic rates checkbox is off and there is no manual rate for the currency. Turn the checkbox on or add a manual rate.
• The source does not have this currency, or its latest rate is more than 7 days older than the event date. Add a manual rate dated no later than the event date.

Then repeat the action:

Messages on the Currencies tab:

• “A manual rate for this date already exists. Choose another date.” («Ручной курс на эту дату уже есть. Укажите другую дату.») — the currency already has a manual rate for the selected date. Choose another date.
• “Could not get rates. Saved rates remain available within 7 days.” («Не удалось получить курсы. Сохранённые курсы остаются доступны в пределах 7 дней.») — the source did not respond to the Check for updates request. Try again later or add a manual rate.

Limitations

• Automatic rates are daily reference rates. They do not account for bank and payment system fees or the rate at the moment of the actual payout. To calculate at your own rate, add a manual one.
• A currency the source does not have is converted only at a manual rate.
• A manual rate cannot be edited or deleted.
• Conversions and spend that are already recorded are not recalculated at new rates.

Rate of an explicit conversion cost

If an offer has a fixed payout in one currency and the cost in the postback arrived in another, the cost rate is stored separately. With the same transaction ID and cost currency, a status change, an amount change or an exact repeat of the postback does not change the stored rate. A change of the cost currency locks the rate for the new currency; if it matches the payout currency, the payout rate of this transaction is used.

An empty or missing cost keeps the previous cost and rate. cost=auto resets the explicit cost; the next numeric cost sets it again. If a record had no separate cost rate before the tracker update, then on the next numeric cost the tracker uses the rate for the date of the last recorded version once and stores it. Amounts that are already recorded are not recalculated automatically.