Перейти к содержанию

CSV интеграция

FraudScore дает возможность клиентам загружать данные для анализа в систему посредством файлов в формате .csv.

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

Существуют базовые требования для оформления файлов .csv, чтобы FraudScore мог корректно их обработать.

Внимание

Нарушение любого из ОБЯЗАТЕЛЬНЫХ требований повлечет за собой невозможность загрузки такого файла во FraudScore. Поэтому будьте, пожалуйста, внимательны при оформлении файла.

  1. Формат файла - ТОЛЬКО .csv

    Другие форматы не будут приняты.

  2. По возможности, каждый параметр в кавычках "".

  3. Разделитель - запятая , или точка с запятой ;.

  4. ОБЯЗАТЕЛЬНЫЕ ПАРАМЕТРЫ:

    Параметр Тип данных Описание Пример
    id string Unique conversion ID 1234567890abc
    advertiser_id string Advertiser ID 835
    affiliate_id string Affiliate ID 6251
    offer_id string Offer ID 34713
    session_time datetime Click time 2018-01-01 00:00:00
    onversion_time datetime Conversion time 2018-01-01 00:00:00
    session_ip string (16) Session (click) IP 217.12.13.43
    ua string Full device "User agent" Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/53.0.2785.116 Safari/537.36

  5. Для параметров conversion_time и session_time допустимы только два варианта форматов:

    • международный формат даты-времени (указание секунд обязательно),

      пример: 2025-03-07 02:35:47

    • количество секунд с даты 1 января 1970 г.,

      пример: 1234567890

  6. Для параметра ip допустимы только полные реальные IP-адреса (никаких дополнительных символов).

    Корректный пример: 31.181.185.107

    Следующие примеры не будут приняты:

    • 1.1.1.1
    • 8.8.8.
    • :ffff::

  7. Для параметра ua (user agent) допустима только полная строка "user-agent" (никаких сокращений):

    пример: Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, Like Gecko) Chrome/49.0.2623.87 Safari/537.36

  8. Требования для параметра id:

    • Каждая конверсия должна иметь свой уникальный идентификатор (id);

    • Если ваши конверсии не имеют уникальных id, то FraudScore не сможет корректно их обработать.

  9. Кодировка файла .csv должна быть только UTF-8.

Совет

Проверяйте, пожалуйста, кодировку файла .csv перед отправкой к нам. Это можно сделать, например, через программу NotePad++ (для Windows) или командой в терминале file -I {filename} (для MacOS).

Необходимые параметры

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

Параметр Тип данных Описание Пример
advertiser_name string Advertiser Name (in case of "empty" will be equal to "advertiser_id") BestMediaCPANetwork
advertiser_manager_id string Advertiser Manager IDAdvertiser Manager ID 4
advertiser_manager_name string Advertiser Manager Name (in case of "empty" will be equal to "advertiser_manager_id") John
affiliate_name string Affiliate Name (in case of "empty" will be equal to "affiliate_id") Partner 1
affiliate_manager_id string Affiliate Manager ID 12
affiliate_manager_name string Affiliate Manager Name (in case of "empty" will be equal to "affiliate_manager_id") Jane
offer_name string Offer Name (in case of "empty" will be equal to "offer_id") Mobile App (iOS)
aff_sub1 string Additional affiliate info (ID of your subsources)
aff_sub2 string Additional affiliate info (ID of your subsources)
aff_sub3 string Additional affiliate info (ID of your subsources)
aff_sub4 string Additional affiliate info (ID of your subsources)
aff_sub5 string Additional affiliate info (ID of your subsources)
conversion_ip string (16) Conversion IP (IP of postback server) 217.12.13.43
country_code string (2) Country Code (ISO 3166) US
device_os string Device OS "Android", "iOS", e.t.c
device_os_version string Device OS Version "6.0", "10.3.2", e.t.c.
device_model string Device model "iPhone", "N7100", e.t.c.
device_brand string Device brand "Apple", "Samsung", e.t.c."
browser string Browser name "Chrome mobile", "Firefox", e.t.c.
browser_version string Browser version "53.0.1.2", "39.2.1.3", e.t.c.
device_locale string Device language "En-US", "Ru-Ru", e.t.c.
conversion_status string Status of conversion "Pending", "Approved", "Hold", e.t.c
refer string (1024) Click URL http://e1.ru/ad_banner
user_mail string User's e-mail john_doe@gmail.com
idfa string iOS device ID 6D92078A-8246-4BA4-AE5B-76104861E7DC
android_id string Android device ID 1919FC51E20A1732
source string Traffic Source "MyTarget", "Facebook", "Network", e.t.c.
app_id string App ID 1234567890, com.company.appname
app_version string Application version 1.35.0
funnel_id string Funnel ID 5ea20b93a28bde0001f07382
attributed_touch_type string Attributed type of touch click, impression, pre-install
contrib1_touch_type string Contributor touch type 1 click, impression
contrib2_touch_type string Contributor touch type 2 click, impression
contrib3_touch_type string Contributor touch type 3 click, impression
contrib1_touch_time datetime Contributor touch time 1 2018-01-01 00:00:00
contrib2_touch_time datetime Contributor touch time 2 2018-01-01 00:00:00
contrib3_touch_time datetime Contributor touch time 3 2018-01-01 00:00:00
contrib1_partner string Contibutor partner 1 Partner 1
contrib2_partner string Contibutor partner 2 Partner 2
contrib3_partner string Contibutor partner 3 Partner 3
contrib1_media_source string Contributor media source 1 Media source 1
contrib2_media_source string Contributor media source 2 Media source 2
contrib3_media_source string Contributor media source 3 Media source 3
app_name string App name Application name
sdk_version string SDK version v5.1.1
cost float32 Costs 0
cost_currency string Currency of the costs USD, EUR

Рекомендации

Совет

Создайте файл в первый раз и сохраните в виде шаблона для последующих загрузок. Используйте шаблон каждый раз - это позволит сэкономить ваше время.

Пример

Пример .csv-файла, соответствующего требованиям: upload_example.csv

2 мар 2026 г.