Валюты и курсы
Все суммы в отчётах считаются в USD: выплаты и расходы в других валютах трекер переводит по курсу на дату события.
Курсы настраиваются во вкладке Настройки → Валюты, блок Курсы валют. По ним трекер переводит в USD выплаты из постбеков, суммы из импорта конверсий и расходы из расширения. Вкладку видят владелец и администратор.
Отчётная валюта
Отчётная валюта — USD, изменить её нельзя. Поле Валюта по умолчанию во вкладке Настройки → Основные показывает USD и недоступно для правки.
Для сумм в USD курс не нужен. Для любой другой валюты нужен курс — автоматический или ручной. Если курса нет, трекер не считает сумму 1:1, а отклоняет её, см. Если курса нет.
Цены в моделях расхода кампании и стоимость клика из параметра источника задаются сразу в USD и по курсам не пересчитываются, см. Модели расхода кампании.
Какой курс берёт трекер
Курс — это количество USD за 1 единицу валюты. Для каждой суммы трекер выбирает курс так:
- Валюта
USD— курс 1. - Есть ручной курс этой валюты с датой не позже нужной — берётся самый поздний из них.
- Такого ручного курса нет, а флажок Автоматические курсы включён — берётся самый поздний автоматический курс с датой не позже нужной и не старше 7 дней от неё.
- Иначе курса нет.
Нужная дата зависит от того, что пересчитывается:
| Что пересчитывается | Дата курса |
|---|---|
Выплата и cost из постбека | День приёма постбека, UTC |
| Выплата из импорта CSV | День импорта, UTC |
| Расход из расширения | День расхода |
Автоматические курсы
Трекер сам получает ежедневные справочные курсы из источника Frankfurter. Проверка идёт каждый час.
- Автоматические курсы — флажок, по умолчанию включён. При выключенном флажке работают только ручные курсы. Изменение применяется сразу, кнопки сохранения нет.
- Проверить обновления — кнопка запрашивает курсы у источника сейчас, не дожидаясь очередной проверки.
Под строкой об источнике показано состояние:
| Строка | Что значит |
|---|---|
| «Получены … · доступно валют: N» | Дата и время последнего успешного обновления и число валют, у которых курс не старше 7 дней |
| «Первое обновление ещё не завершено.» | Курсы от источника ещё ни разу не получены |
| «· устарели: N» | Число валют, у которых последний курс старше 7 дней. Такие курсы не используются |
| «Последнее обновление не удалось. Следующая проверка произойдёт автоматически. Можно задать курс вручную. Автокурсы старше 7 дней не используются.» | Последняя попытка получить курсы завершилась ошибкой. Сохранённые курсы действуют, пока им не больше 7 дней |
| «Свежих автоматических курсов пока нет. Можно задать курс вручную. Автокурсы старше 7 дней не используются.» | Флажок включён, но ни у одной валюты нет курса не старше 7 дней |
Курс, сохранённый на дату, не изменяется. Курс за новую дату добавляется отдельной строкой.
Ручной курс
Ручной курс нужен, когда валюты нет у источника, автоматические курсы выключены или вы считаете по своему курсу.
- Откройте Настройки → Валюты.
- Раскройте блок Добавить ручной курс.
- Заполните поля Валюта, Действует с · UTC и USD за 1 единицу валюты.
- Нажмите Добавить курс.
| Поле | Что указать | Правила |
|---|---|---|
| Валюта | Код валюты. По умолчанию EUR | Три латинские буквы, ввод переводится в верхний регистр. USD не принимается |
| Действует с · UTC | Дата, с которой применяется курс. По умолчанию сегодняшняя по UTC | На одну валюту и одну дату — один ручной курс |
| USD за 1 единицу валюты | Курс, например 1.10 | Больше 0 и меньше 1 000 000 000 |
Кнопка Добавить курс неактивна, пока поля заполнены неверно. После сохранения курс появляется в таблице История курсов с источником «Вручную».
Ручной курс имеет приоритет над автоматическим. Он действует с указанной даты до следующего ручного курса этой валюты, срока давности у него нет. Новые автоматические курсы его не заменяют.
Ручной курс нельзя изменить или удалить. Он применяется ко всем суммам в этой валюте начиная с указанной даты. Автоматические курсы для неё с этой даты не используются, дальше курс нужно обновлять вручную. Проверьте значение до сохранения.
Чтобы изменить курс, добавьте новый ручной курс с более поздней датой в поле Действует с · UTC. Он начнёт действовать с этой даты.
История курсов
Таблица История курсов показывает ручные и автоматические курсы: до 1000 последних строк, новые даты сверху.
| Колонка | Что в ней |
|---|---|
| Валюта | Код валюты |
| Дата · UTC | Дата курса у источника или дата начала действия ручного курса |
| Курс в USD | Сколько USD за 1 единицу валюты |
| Источник | «Вручную» или «Frankfurter» |
Поле Найти валюту над таблицей оставляет в ней строки с нужным кодом. Пустая таблица показывает «Курсы не найдены. Для выплат в USD курс не требуется.»
Валюта и курс конверсии
Валюту выплаты трекер берёт из параметра currency входящего постбека. Если параметра нет, берётся валюта оффера: у офферов, созданных в панели, это USD. Для клика без оффера — тоже USD.
Если сеть платит не в USD, передайте код валюты в адресе постбека, например currency=EUR. В шаблоне из Настройки → Postback параметр уже есть со значением USD — замените его. Где взять адрес постбека — на странице Входящий постбек.
Курс закрепляется за конверсией при приёме:
- Выплата переводится в USD по курсу на день приёма постбека.
- Повторный постбек с тем же ID транзакции и в той же валюте считается по курсу, записанному в конверсии, а не по текущему. Подробнее — Курс валюты при повторах.
- Новые автоматические и ручные курсы уже принятые конверсии не пересчитывают.
Параметр cost постбека задаёт расход конверсии в валюте постбека и переводится в USD по тому же курсу, что и выплата, см. Параметр cost в постбеке.
Импорт конверсий из CSV закрепляет курс так же. Валюта задаётся полем Валюта на весь файл, по умолчанию USD.
Курс для расходов из расширения
Расширение для расходов передаёт дневной расход в валюте рекламного аккаунта. Трекер переводит его в USD по курсу на дату расхода. Для аккаунта в USD курс не нужен.
Курс закрепляется за аккаунтом и днём при первом принятом сборе. Повторные загрузки этого дня считаются по тому же курсу, даже если курсы в трекере с тех пор изменились.
Если курса нет
Сумма в валюте без курса не записывается. Причины и что сделать:
- Флажок Автоматические курсы выключен, а ручного курса для валюты нет. Включите флажок или добавьте ручной курс.
- У источника нет этой валюты или её последний курс старше 7 дней от даты события. Добавьте ручной курс с датой не позже даты события.
После этого повторите действие:
| Где | Что происходит | Что сделать |
|---|---|---|
| Входящий постбек | Трекер отвечает сети кодом 422 и текстом «курс валюты на дату события не найден; добавьте курс в настройках и повторите». Конверсия не записана | Отправьте постбек повторно или загрузите конверсию через импорт из CSV |
| Импорт конверсий | В колонке Результат у строки: «Нет курса валюты или сумма слишком велика». Ничего не импортировано | Нажмите Проверить CSV снова |
| Расширение для расходов | В окне расширения: «Проверьте timezone и курс валюты в трекере». День не принят | Повторите сбор. Другие причины этого сообщения — в разделе Курс валюты и отказ в приёме дня |
Сообщения вкладки Валюты:
- «Ручной курс на эту дату уже есть. Укажите другую дату.» — у валюты уже есть ручной курс на выбранную дату. Выберите другую дату.
- «Не удалось получить курсы. Сохранённые курсы остаются доступны в пределах 7 дней.» — источник не ответил на запрос кнопки Проверить обновления. Повторите позже или добавьте ручной курс.
Ограничения
- Автоматические курсы — ежедневные справочные. Комиссии банка и платёжной системы и курс на момент фактической выплаты в них не учитываются. Чтобы считать по своему курсу, добавьте ручной.
- Валюта, которой нет у источника, пересчитывается только по ручному курсу.
- Ручной курс нельзя изменить или удалить.
- Уже записанные конверсии и расходы по новым курсам не пересчитываются.