跳到主要内容

获取设备信息（GetDeviceInfo）

AndroidiOSWindows
如果您使用的是 Unreal Engine，请参见 Unreal Engine SDK 的 GetDeviceInfo。

获取当前设备的信息。

警告

如果通过 GetDeviceInfo 接口获取了 IDFA、XWID 或者 UAID 数据，需要高度关注以下事项。

IDFA：仅可用于在应用程序内投放和跟踪/归属广告。禁止对 IDFA 进行任何其它使用 (例如安全分析)，同样禁止使用任何其它标识符进行广告。

XWID：

  • XWID 不能与 advertising ID 一起使用。
  • 限定使用的低风险场景：可用于跟踪具有相同签名密钥的应用程序之间的已登出用户偏好，并用于反欺诈目的(使用 Android ID 将信息范围限定至相同的应用程序签名密钥)。
  • 如果获取 XWID 做新增用途，需要明确的在业务的 ROP 表格中披露具体的使用场景，并通过业务侧合规评审。
  • 如果使用 XWID 做新增用途，需在隐私协议中披露与更新。

UAID：是三方 UA 平台生成的用于识别设备的标识符，需要合规团队评审通过后才能使用。

函数定义​

public static string GetDeviceInfo(string extra_json);

入参说明​

名称类型说明
extra_jsonstring额外参数 JSON 串

代码示例​

string deviceInfo=INTLAPI.GetDeviceInfo("");
string extraJson = "{\"idfa\":1, \"xwid\":1, \"adjust_uaid\": 1, \"appsflyer_uaid\": 1, \"firebase_uaid\": 1, \"facebook_uaid\": 1}"; // IDFA（iOS 端）、XWID（三端都有）和 UAID 均为敏感数据
string deviceInfo2=INTLAPI.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_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", "comm_c_adjust_uaid":"xxxxx", "comm_c_appsflyer_uaid":"xxxxx", "comm_c_firebase_uaid":"xxxxx", "comm_c_facebook_uaid":"xxxxx"}

返回参数的说明，请参见 Player Network SDK 数据上报公共字段。

最后于 更新