Firano¶

Аутентификация¶

Для аутентификации вебмастера Firano использует уникальный токен. Он генерируется автоматически и использует ваш wm_id из системы. Данный токен надо обязательно передавать в запросе в параметре token.

Получение id и токена Firano API

Чтобы получить идентификационный номер и ключ, вам необходимо зайти в Firano | Конструктор запросов и нажать на кнопку Сгенерировать.

Запрос¶

В системе есть возможность работать с Firano в тестовом режиме. Для тестирования запроса вы можете включить тестовый режим, нажав на переключатель sandbox, или указать GET-параметр sandbox:

• sandbox = 1, тестовый режим. Тестовый режим позволяет отправить тестовые заявки и получить ответ от нашего сервера без реальной отправки заявок рекламодателям.
• sandbox = 0, рабочий режим сервиса.

Данные, которые содержаться в заявке, вебмастер передает по URL https://firano.cityads.com/api/rest/v2/applications.json

Обязательные поля

Firano, получив запрос с данными по заявке, осуществляет первичную проверку переданных значений. Перед тем, как отправить эту заявку рекламодателям, чтобы заявка прошла первичную проверку на стороне Firano, верно должны быть переданы обязательные поля.

Ответ¶

Ниже приведены коды ответов сервиса Firano. Если Firano передает сообщения об ошибках и вам не удалось их устранить, используя инструкции, обратитесь в техническую поддержку.

{
  "application": {
    "id": 4524772
  }
}

{
  "error": {
    "code": 401,
    "message": "Authorize Failed",
    "errors": {
      "token": "Вебмастер не найден"
    }
  }
}

{
  "error": {
    "code": 400,
    "message": "Validation Failed",
    "errors": {
      "surname": "Значение не должно быть пустым"
    }
  }
}

Конструктор запросов¶

Для работы с Конструктором запросов вебмастеру необходимо придерживаться следующего алгоритма действий:

1. Откройте Firano | Конструктор запросов.

2. Выберете типы продуктов, по которым заявки посетителей сайта будут направляться рекламодателям.

   

3. Создайте персональный набор полей, которые будут направляться рекламодателям. При выборе вебмастером тех или иных полей Конструктор запросов будет показывать список офферов, для которых данный набор полей подходит.

4. Создайте персональный список офферов, в соответствии которым заявки посетителей сайта будут направляться рекламодателям.

   

Пример кода¶

Когда вы выберете типы продуктов, создадите набор полей и персональный список офферов, Firano сгенерирует для вас пример тела запроса в формате JSON и пример кода для самостоятельной настройки API на своем сайте.

1. Для быстрого копирования примера тела запроса JSON вы можете нажать на кнопку Копировать JSON.
2. Для быстрого копирования примера кода вы можете нажать на кнопку Копировать весь код.

База заявок¶

В разделе Firano | База заявок отображаются все ваши заявки, направленные Firano различным рекламодателям. Здесь вы можете просматривать заявки «С группировкой по заявке» / «Без группировки».

При просмотре заявок «С группировкой по заявке» выводится следующая информация:

1. ID заявки — это уникальный номер заявки, которая пришла в Firano от вебмастера.
2. Оффер — название оффера, на который Firano отправил заявку.
3. Статус доставки — это статус доставки Firano заявки рекламодателям: доставлена во все офферы, доставлена не во все офферы.
4. Субаккаунт — переданный от вебмастера параметр.
5. Дата создания заявки — дата отправки заявки рекламодателю.

При просмотре заявок «Без группировки» выводится следующая информация:

1. ID подзаявки — это уникальный номер заявки, которая пришла в Firano от вебмастера.
2. Оффер — название оффера, на который Firano отправил заявку.
3. Статус от банка — это статус заявки от рекламодателя: получена, отказ в выдаче кредита, дублирующая заявка, ошибка и др.
4. Субаккаунт — переданный от вебмастера параметр.
5. Дата создания заявки — дата отправки заявки рекламодателю.