跟踪用户行为

POST

/api/v1/behavior-tracking/track

跟踪用户行为事件，支持批量事件和会话数据。

Request

Authorization

OAuth 2.0

Password

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: /api/v1/auth/login

Body Params application/jsonRequired

Example

{
    "events": [
        {
            "event_type": "page_view",
            "event_category": "content",
            "target_type": "string",
            "target_id": "d3bcdc92-4191-401b-ad0c-42056c6efab9",
            "target_data": {
                "property1": "string",
                "property2": "string"
            },
            "page_url": "string",
            "referrer_url": "string",
            "user_agent": "string",
            "ip_address": "string",
            "device_type": "mobile",
            "platform": "ios",
            "action_detail": {
                "property1": "string",
                "property2": "string"
            },
            "session_id": "1ffd059c-17ea-40a8-8aef-70fd0307db82",
            "sequence_number": 0,
            "duration_ms": 0,
            "performance_metrics": {
                "property1": "string",
                "property2": "string"
            },
            "country": "string",
            "region": "string",
            "city": "string",
            "latitude": 0,
            "longitude": 0
        }
    ],
    "session_data": {
        "session_id": "1ffd059c-17ea-40a8-8aef-70fd0307db82",
        "device_type": "mobile",
        "platform": "ios",
        "browser": "string",
        "screen_resolution": "string",
        "timezone": "string",
        "entry_page": "string",
        "exit_page": "string",
        "referrer": "string",
        "utm_source": "string",
        "utm_medium": "string",
        "utm_campaign": "string"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/behavior-tracking/track' \
--header 'Content-Type: application/json' \
--data '{
    "events": [
        {
            "event_type": "page_view",
            "event_category": "content",
            "target_type": "string",
            "target_id": "d3bcdc92-4191-401b-ad0c-42056c6efab9",
            "target_data": {
                "property1": "string",
                "property2": "string"
            },
            "page_url": "string",
            "referrer_url": "string",
            "user_agent": "string",
            "ip_address": "string",
            "device_type": "mobile",
            "platform": "ios",
            "action_detail": {
                "property1": "string",
                "property2": "string"
            },
            "session_id": "1ffd059c-17ea-40a8-8aef-70fd0307db82",
            "sequence_number": 0,
            "duration_ms": 0,
            "performance_metrics": {
                "property1": "string",
                "property2": "string"
            },
            "country": "string",
            "region": "string",
            "city": "string",
            "latitude": 0,
            "longitude": 0
        }
    ],
    "session_data": {
        "session_id": "1ffd059c-17ea-40a8-8aef-70fd0307db82",
        "device_type": "mobile",
        "platform": "ios",
        "browser": "string",
        "screen_resolution": "string",
        "timezone": "string",
        "entry_page": "string",
        "exit_page": "string",
        "referrer": "string",
        "utm_source": "string",
        "utm_medium": "string",
        "utm_campaign": "string"
    }
}'

Responses

🟢200成功

application/json

Successful Response

Bodyapplication/json

Example

{
    "code": 0,
    "message": "success",
    "data": {
        "success": true,
        "tracked_events": 0,
        "message": "string",
        "errors": [
            "string"
        ]
    }
}

🟠422无法处理的实体

Modified at 2025-09-26 15:37:19

获取广告系统统计

获取行为事件历史