GIVT Fraud Reports API
API предоставляет доступ к детальным отчетам по GIVT-фроду. Позволяет анализировать трафик на предмет подозрительной активности, роботов, дата-центров и других видов.
Endpoint
URL, по которому отправляются запросы к API
POST /v1/reports/fraud_reports?project_id={project_id}
Параметры запроса
Query-параметры
__________________________________________________________________________________

`project_id` (обязательный) - ID проекта
Тело запроса
{
  "ResponseType": "JSON",
  "Fields": ["EventDateTime", "SysName", "DeviceId", "Givt"],
  "InteractionFilter": {
    "DateFrom": "2024-01-01",
    "DateTo": "2024-01-31",
    "SysName": ["Impression", "Click"]
  },
  "Offset": 0,
  "Limit": 1000
}
Параметры
__________________________________________________________________________________
InteractionFilter
__________________________________________________________________________________
Доступные поля
Основные поля
__________________________________________________________________________________
Информация о пользователе и устройстве
__________________________________________________________________________________
Геолокация
__________________________________________________________________________________
Данные о фроде
__________________________________________________________________________________
Прочие поля
__________________________________________________________________________________
Примеры запросов
Получение отчета по GIVT за период
curl -X POST "https://api.targetads.io/v1/reports/fraud_reports?project_id=12486" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "ResponseType": "JSON",
    "Fields": [
      "EventDateTime",
      "SysName",
      "DeviceId",
      "Givt",
      "GivtReasonDataCentre",
      "GivtReasonCrawler"
    ],
    "InteractionFilter": {
      "DateFrom": "2024-01-01",
      "DateTo": "2024-01-31",
      "SysName": ["Impression"]
    },
    "Limit": 1000
  }'
Детальный анализ фрода по кампаниям
curl -X POST "https://api.targetads.io/v1/reports/fraud_reports?project_id=12486" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "ResponseType": "JSON",
    "Fields": [
      "EventDateTime",
      "MediaCampaignId",
      "Domain",
      "IP",
      "UserAgent",
      "Givt"
    ],
    "InteractionFilter": {
      "DateFrom": "2024-01-01",
      "DateTo": "2024-01-07",
      "MediaCampaignId": [12345]
    }
  }'
Формат ответа
Успешный ответ
{
  "Columns": [
    "EventDateTime",
    "SysName",
    "Givt"
  ],
  "Rows": [
    [
      "2024-01-15 10:30:45",
      "Impression",
      "0"
    ],
    [
      "2024-01-15 10:31:20",
      "Click",
      "1"
    ]
  ],
  "CountRows": 2
}
Ошибка валидации
{
  "ErrorCode": 400,
  "ErrorMassage": "validate error",
  "Errors": [
    {
      "Error": true,
      "FailedField": "Fields",
      "Value": null
    }
  ]
}

Лимиты и ограничения


API имеет технические ограничения, которые следует

учитывать при построении интеграции:


Максимум записей: 100 000
Минимум полей: 3
Максимум значений в фильтре:
- MediaCampaignId/MediaPlacementId: 20
Rate limit: 40 запросов в минуту на project_id

Таймаут: 300 секунд