菜单

Ltv报表（1-90天数据）

注意：接入Api前请先熟悉api签名机制（参考接口鉴权说明）, 即Api请求样例中的一些http请求头的来源

1.请求URL

https://openapi.hyperbid.com/v1/report/ltv

2.请求方式

POST

3.请求参数

字段	类型	是否必传	备注	样例
time_zone	String	Y	时区，枚举值：UTC-8、UTC+8、UTC+0	"UTC-8"
start_date	Int	Y	开始日期，格式：YYYYmmdd	20250101
end_date	Int	Y	结束日期，格式：YYYYmmdd	20250101
app_id_list	Array[String]	Y	开发者后台的多聚合应用ID列表, 至少需要一个appId	["ja547b671dc3ef29"]
geo_short_list	Array[String]	N	国家短码列表，不传默认所有国家	["US","CN"]
start	Int	N	偏移数，代表从第几条数据开始，默认为0	0
limit	Int	N	每次拉取数据的最大条数，默认是1000，可选[1,1000]	不传默认1000，最大1000
group_by	Array[String]	N	group by 维度，不传时默认date_time，支持的维度说明 date_time（日期）， app_id（应用）， geo_short（地区短码）， channel（渠道）注意：当传入其他维度时，date_time必传	["date_time"]

4.返回参数

字段	类型	是否必传	备注
records	Array[Object]	N	记录，对象数组每个record结构见下面records元素结构，无数据时为空
count	Int	N	总条数，无数据时为空
time_zone	String	N	时区，枚举值：UTC-8、UTC+8、UTC+0
currency	String	N	开发者账号币种

records元素结构如下：

字段	类型	是否必传	备注
date_time	Int	N	日期，格式：YYYYmmdd。group_by有选date_time才有返回
app_id	String	N	开发者后台的应用ID，group_by有选app_id维度时才返回
geo_short	String	N	国家短码，group_by有选geo_short维度时才有返回
channel	String	N	渠道，group_by有选channel维度时且不为空时才有返回
new_user	Int	Y	新增用户数
ltv_1	String	Y	第1天LTV
...	String	Y	第2到第89天LTV
ltv_90	String	Y	第90天LTV

5.样例

请求样例：

curl --location --request POST 'https://openapi.hyperbid.com/v1/report/ltv' \
--header 'X-Up-Key: a5c20012d6964913dcea19dbb09243282518505c' \
--header 'X-Up-Signature: CE12B506DBCD868C2C6F09E08C139CBC' \
--header 'X-Up-Timestamp: 1735716753000' \
--header 'Content-Type: application/json' \
--data-raw '{
    "start_date": 20250101,
    "end_date": 20250101,
    "group_by":["date_time"],
    "start": 0,
    "limit": 30,
    "time_zone": "UTC+8",
    "app_id_list":["jafc84034d4a8922"]
}'

返回样例：

{
    "count": 1,
    "time_zone": "UTC+8",
    "currency": "USD"
    "records": [
        {
            "date_time": 20250101,
            "new_user": 70,
            "ltv_1": "",
            "ltv_2": "",
            "ltv_3": "",
            "ltv_4": "",
            "ltv_5": "",
            "ltv_6": "",
            "ltv_7": "",
            "ltv_8": "",
            "ltv_9": "",
            "ltv_10": "",
            "ltv_11": "",
            "ltv_12": "",
            "ltv_13": "",
            "ltv_14": "",
            "ltv_15": "",
            "ltv_16": "",
            "ltv_17": "",
            "ltv_18": "",
            "ltv_19": "",
            "ltv_20": "",
            "ltv_21": "",
            "ltv_22": "",
            "ltv_23": "",
            "ltv_24": "",
            "ltv_25": "",
            "ltv_26": "",
            "ltv_27": "",
            "ltv_28": "",
            "ltv_29": "",
            "ltv_30": "",
            "ltv_31": "",
            "ltv_32": "",
            "ltv_33": "",
            "ltv_34": "",
            "ltv_35": "",
            "ltv_36": "",
            "ltv_37": "",
            "ltv_38": "",
            "ltv_39": "",
            "ltv_40": "",
            "ltv_41": "",
            "ltv_42": "",
            "ltv_43": "",
            "ltv_44": "",
            "ltv_45": "",
            "ltv_46": "",
            "ltv_47": "",
            "ltv_48": "",
            "ltv_49": "",
            "ltv_50": "",
            "ltv_51": "",
            "ltv_52": "",
            "ltv_53": "",
            "ltv_54": "",
            "ltv_55": "",
            "ltv_56": "",
            "ltv_57": "",
            "ltv_58": "",
            "ltv_59": "",
            "ltv_60": "",
            "ltv_61": "",
            "ltv_62": "",
            "ltv_63": "",
            "ltv_64": "",
            "ltv_65": "",
            "ltv_66": "",
            "ltv_67": "",
            "ltv_68": "",
            "ltv_69": "",
            "ltv_70": "",
            "ltv_71": "",
            "ltv_72": "",
            "ltv_73": "",
            "ltv_74": "",
            "ltv_75": "",
            "ltv_76": "",
            "ltv_77": "",
            "ltv_78": "",
            "ltv_79": "",
            "ltv_80": "",
            "ltv_81": "",
            "ltv_82": "",
            "ltv_83": "",
            "ltv_84": "",
            "ltv_85": "",
            "ltv_86": "",
            "ltv_87": "",
            "ltv_88": "",
            "ltv_89": "",
            "ltv_90": ""
        }
    ]
}

上一个

高级报表

下一个

QA问答

最近修改: 2025-08-19Powered by

大纲