获取设备信息(GetDeviceInfo)[仅限 Player Network SDK]
获取当前设备的信息。 [仅限 Player Network SDK]。
警告
如果通过 GetDeviceInfo
接口获取了 IDFA 或者 XWID 数据,需要高度关注以下事项。
IDFA: 仅可用于在应用程序内投放和跟踪/归属广告。禁止对 IDFA 进行任何其它使用 (例如安全分析),同样禁止使用任何其它标识符进行广告。
XWID:
- XWID 不能与 advertising ID 一起使用。
- 限定使用的低风险场景:可用于跟踪具有相同签名密钥的应用程序之间的已登出用户偏好,并用于反欺诈目的(使用 Android ID 将信息范围限定至相同的应用程序签名密钥)。
- 如果获取 XWID 做新增用途,需要明确的在业务的 ROP 表格中披露具体的使用场景,并通过业务侧合规评审。
- 如果使用 XWID 做新增用途,需在隐私协议中披露与更新。
我们在上报的时候新增了各个渠道的 xx_uaid
,但是在 GetDeviceInfo
接口中没有返回这些 ID,目前还不支持。
支持的平台
- Unity
- Unreal Engine
支持
Android, iOS, Windows
平台。支持
Android, iOS, Windows
平台。函数定义
- Unity
- Unreal Engine
public static string GetDeviceInfo(string extra_json);
static std::string GetDeviceInfo(const std::string &extra_json);
入参说明
- Unity
- Unreal Engine
参数 | 类型 | 说明 |
---|---|---|
extra_json | string | 额外参数 JSON 串 |
参数 | 类型 | 说明 |
---|---|---|
extra_json | std::string | 额外参数 JSON 串 |
代码示例
- Unity
- Unreal Engine
string deviceInfo=UnionAdapterAPI.GetReportService().GetDeviceInfo("");
string extraJson = "{\"idfa\":1, \"xwid\":1}";//最多包含两对 kv,分别对应 iOS IDFA 与 XWID (三端都有) 的敏感数据
string deviceInfo2=UnionAdapterAPI.GetReportService().GetDeviceInfo(extraJson);
FString deviceInfo = GUA_NAMESPACE::GUAReportService::GetDeviceInfo("");
FString extraJson = "{\"idfa\":1, \"xwid\":1}";//最多包含两对 kv,分别对应 IDFA(iOS 端) 与 XWID (三端都有) 的敏感数据
FString deviceInfo2 = GUA_NAMESPACE::GUAReportService::GetDeviceInfo(extraJson);
返回值
设备信息示例:
{"comm_c_xwid":"92be4a32a74afc497ba4653dfcb7df09ec4e5gW4762f","comm_c_os":2,"comm_c_os_version":"15.4","comm_c_app_version":"1.0(1)","comm_c_device_model":"iPhone13,2","comm_c_device_brand":"iPhone","comm_c_bundle_id":"com.intlgame.demo","comm_c_carrier_id":"46002","comm_c_ram_total":3662,"comm_c_rom_total":244017,"comm_c_screen_width":1170,"comm_c_screen_height":2532,"comm_c_network_type":2,"comm_c_cpu_name":"Apple","comm_c_cpu_core":6,"comm_c_cpu_freq":0,"comm_c_gpu_name":"Apple","comm_c_language":"zh"}