如果无法与 SDK 集成,可以使用 API 归属。在这种情况下,应执行以下操作:
设置
安装非有机指标的最小回传
curl --request POST
--data '[
{
"uuid":"1a7adcca-f786-4c62-a770-5b3e687d0ee3",
"created_time":1668605535000,
"affise_app_id":"3",
"affise_pkg_app_name":"com.test.app"、
"affise_app_token":"ee8ebe706e0359e3ac5c45666a681f4c228d97f20012dac186ae3902eb479955",
"affise_device_id":"bf62b34b-5750-4e95-a132-4185cedbee00",
"随机用户 ID"92f254db-d70d-47ce-8597-baccab852300",
"first_open_time"(首次打开时间): 16854527242641685452724264,
"referrer": "gclid=CjwKCAjwvdajBhBEEiwAeMh1UwCsBajGUaMGwuqg6-nhQQe54jA4hR3l5wUQK5OB_GH_OxlAizBIQRoCRGAQAvD_BwE" }
}
]'
如果referrer参数为空或无效,在未使用其他定义的情况下,安装将自动进行。
回传会话和/或检查活动用户
curl --request POST
--data '[
{
"uuid":"1a7adcca-f786-4c62-a770-5b3e687d0ee3",
"created_time":1668605535000,
"affise_app_id":"3",
"affise_pkg_app_name":"com.test.app"、
"affise_app_token":"ee8ebe706e0359e3ac5c45666a681f4c228d97f20012dac186ae3902eb479955",
"affise_device_id":"bf62b34b-5750-4e95-a132-4185cedbee00",
"随机用户 ID"92f254db-d70d-47ce-8597-baccab852300",
"first_open_time"(首次打开时间): 16854527242641685452724264,
"last_session_time": 16854527560001685452756000,
"last_time_session": 16854527560001685452756000,
"time_session":56783,
"affise_session_count":5,
"lifetime_session_count":4556891
}
]'
其中:
名称 | 类型 | 必须填写 | 信息 |
uuid | uuidv4(字符串) | 每个 | 回传标识符,每个回传的唯一值。 |
创建时间 | 时间戳(int) | 每个 | 以毫秒为单位的回传发送时间。 |
affise_app_id | 字符串 | 每次 | Affise 上的应用程序 ID。 |
affise_pkg_app_name | 字符串 | 每个 | 商店中的软件包名称。 |
affise_app_token | 字符串 | 每个 | 回传签名。 |
affise_device_id | uuidv1(字符串) | 每个 | 用户的唯一设备标识符。 |
随机用户 ID | uuidv4(字符串) | 每个 | 用户的唯一设备标识符。 |
首次打开时间 | 时间戳(int) | 首次回传 | 首次启动应用程序的时间(毫秒)。
设备唯一。
必须至少提交一次。
在随后的回传中可能不会出现。 |
推荐人 | 字符串 | 非或第一次回传,用于非有机检查 | 来自商店的推荐人信息。
如果使用其他机制进行非有机检查,则该字段为可选字段。 |
最后会话时间 | 时间戳(int) | 对于会话 | 会话处于活动状态时的当前时间(以毫秒为单位),否则为 0。 |
last_time_session | 时间戳(int) | 用于会话、
如果 last_session_time = 0 | 会话处于活动状态时的当前时间(毫秒),否则
会话处于活动状态时的最后时间(毫秒),否则
first_open_time。 |
会话时间 | int | 用于计算会话持续时间 | 最后会话持续时间(毫秒)。 |
affise_session_count | int | 用于会话 | 设备上的非欺诈会话数。
Affise 建议在会话开始 30 秒后增加此计数器。
该值不应减少。 |
会话生命周期计数 | 无 | 用于计算会话持续时间 | 以毫秒为单位的应用程序活动持续时间总和。 |
请参阅完整的回传示例:
[
{
"affise_app_id":"3",
"affise_pkg_app_name":"com.test.app"、
"app_version":"1.0",
"app_version_raw":"2",
"store":"Apk"、
"installed_time":1685445035570,
"first_open_time":1685445103532,
"installed_hour":1685444400000,
"first_open_hour":1685444400000,
"install_first_event": true、
"install_begin_time":0,
"install_finish_time":1685445103532,
"referrer_install_version":"",
"referral_time":0,
"referrer_click_time":0,
"referrer_click_time_server":0,
"referrer_google_play_instant": false、
"created_time":1685445103000,
"created_time_milli":1685445103908,
"创建时间": 16854451030001685444400000,
"last_session_time": 16854451039081685445103908,
"connection_type":"WIFI"、
"cpu_type":"arm64-v8a, armeabi-v8a"arm64-v8a, armeabi-v7a, armeabi"、
"hardware_name":"coral"、
"网络类型"WIFI"、
"设备制造商"谷歌"、
"proxy_ip_address":"",
"deeplink_click": false、
"device_atlas_id":"",
"affise_device_id":"6c5b4fbb-0188-1000-a2a8-a425dfc3a5d1",
"affise_alt_device_id":"6c5b4fd6-0188-1000-8d42-38592460a3c0",
"adid":"",
"android_id":"50da7b69cab425a1"、
"android_id_md5":"f2e24f12834014cf69623fd9a7c77f12",
"mac_sha1":"",
"mac_md5":"",
"gaid_adid":"",
"gaid_adid_md5":"",
"oaid":"",
"oaid_md5":"",
"altstr_adid":"",
"fireos_adid":"",
"coloros_adid":"",
"reftoken":"6c5b51...ac5631"、
"reftokens": "6c5b5...59c94f0a":"6c5b5...59c94f0a"、
"referrer":"referrer=018…a43e29&clickid=6475e…e37f55&pid=9",
"user_agent":"Dalvik/2.1.0 (Linux; U; Android 13; Pixel 4 XL Build/TP1A.221005.002.B2)"、
"mccode"(代码):"272",
"mncode":"2"2",
"isp":"3",
"区域":"IE"、
"国家":"IE"、
语言"en-IE"、
"设备名称"Pixel 4 XL"、
"设备类型"智能手机"、
"os_name":"",
平台":"android"android"、
"sdk_platform":"android"、
"api_level_os":"33",
"affise_sdk_version":"-",
"os_version": "13":"13",
"random_user_id":"6c5b4fea-0188-1000-90fb-29759c0aadba",
"affise_sdk_pos":"生产"、
"timezone_dev":"UTC+0100":"UTC+0100"、
"affise_event_token":"",
"affise_event_name":"",
"last_time_session":1685445104000,
"time_session":295,
"affise_session_count":1,
"lifetime_session_count":295,
"affise_deeplink":"",
"affise_part_param_name":"",
"affise_part_param_name_token":"",
"affise_app_token":"9d1af455f1…66611d7e72e9",
"标签":"",
"uuid":"6c5b5181-0188-1000-ab71-0cbd7e8a63e2",
"pushtoken":"",
"affise_events_count":2,
"事件": [[
{
"affise_event_id":"4fc7d613-af35-4298-92a8-04838e03a40c",
"affise_event_name":"CustomId01"、
"affise_event_category":"本机"、
"affise_event_timestamp":1685449930539,
"affise_event_first_for_user": false、
"affise_event_user_data":"",
"affise_event_data":{
"affise_event_custom_id_01":"AiChatClickEvent"、
"affise_event_custom_id_{01}_timestamp":1685449930539
},
"affise_parameters":{}
},
{
"affise_event_id":"b1e1aa62-652e-48d5-a9b0-4f9a0b9448e0",
"affise_event_name":"CustomId10"、
"affise_event_category":"本机"、
"affise_event_timestamp":1685449935544,
"affise_event_first_for_user": false、
"affise_event_user_data":"about:blank"、
"affise_event_data":{
"affise_event_custom_id_10":"PageFinishedLoading"、
"affise_event_custom_id_{10}_timestamp":1685449935544
},
"affise_parameters":{}
}
],
"affise_internal_events_count":0,
"internal_events":[],
"affise_sdk_events_count":0,
"sdk_events":[],
"affise_metrics_events_count":0,
"metrics_events":[]
}
]
提供程序 affise_app_token
affise_app_token = SHA256(affiseAppId + createdTime + secretId)
其中:
affiseAppId - Affise 应用程序标识。
createdTime - 请求时间。
secretId - SDK 密钥。
fun sha256(value: String) :字符串 {
return MessageDigest.getInstance("SHA-256")
.digest(value.toByteArray())
.joinToString("") {
"%02x".format(it)
}
}
示例:
affiseAppId | AffiseDemoApp |
创建时间 | 1685463568000 |
秘密 ID | be07d122-3f3c-11ec-9bbc-0242ac130002 |
密码 | 00c1c31859fcfecc7be3a4505d27bc189e6deebd544025ddd1017b770407974e |
谷歌游戏推荐库集成
要正确获得推荐,必须与 Google 库集成。请阅读此处的操作方法。
如有任何问题,请发送电子邮件至[email protected] 联系 Affise 客户支持团队。