自定义用户属性日志
段落是從 Hive SDK 收集的信息，除了預定義的屬性外，還可以通過自由定義屬性值來傳輸和選擇。
發送屬性¶
您可以使用Hive SDK 客戶端日誌傳輸來發送用戶自定義的屬性值。
可以通过日志定义功能中的客户端源代码生成特性查看日志传输的示例代码。
屬性傳輸規範¶
字段采用驼峰命名法（例如，dateTime），并区分大小写。以下情况下，值将不会被保存。
- 如果字段名称未按规定定义（例如，“time”）
- 如果字段名称与字段名称不完全匹配（例如，“app_id”）
- 如果值不是为每个字段定义的类型（例如，“playerid”字段的“474392047”）
注意事項
- 字符串：字符串数据最大为 1 MB
- 整数：有符号 64 位（-9,223,372,036,854,775,808 到 9,223,372,036,854,775,807）数据
- 如果发送的数据与每个字段的类型不匹配，则相应字段可能无法正确保存，因此您必须发送与类型匹配的值。
| 欄位名稱 | 描述 | 類型 | 必填 |
|---|---|---|---|
| playerId | 用於識別 Hive 認證中用戶的唯一鍵 使用 [Hive SDK 客戶端日誌傳輸功能] 時，自動發送 | 整數 | 是 |
| uid | Hive 會員中的用戶鍵。UID 大於 90000000000 代表訪客用戶鍵 使用 Hive SDK 客戶端日誌傳輸功能 時，自動發送 | 整數 | |
| appId | 由應用中心發出的 appId 使用 Hive SDK 客戶端日誌傳輸功能 時，會自動發送 | STRING | Y |
| guid | 屬性行的唯一鍵值 建議使用類似 uuid 的隨機字符串格式 使用 Hive SDK 客戶端日誌傳輸功能 時，會自動發送 | STRING | Y |
| datatime | 屬性發生時間，格式為 “YYYY-MM-DD hh:mm:ss” (例如，“2022-11-15 10:20:10”) 使用 Hive SDK 客戶端日誌傳輸功能 時，會自動發送 | STRING | Y |
| timezone | “dateTime”的時區 可以通過 時區驗證 使用客戶端 IP 獲得 如果為空或沒有值，則根據 KST 確定 (例如，“GMT+09:00”) 使用 Hive SDK 客戶端日誌傳輸功能 時，會自動發送 | STRING | Y |
| category | 固定為“pub_user_property_log” | STRING | Y |
| propertyDataType | 可以設置為遊戲內用戶屬性值數據類型的值是以下四種之一（例如，“string”）。 * “string“：當屬性值需要被區分為字符串時 * “integer“：當屬性值需要被區分為整數時。如果屬性需要聚合，則聚合結果應為整數 * “float“：當屬性值需要被區分為浮點數時。如果屬性需要聚合，則聚合結果應為浮點數 * “timestamp“：當屬性值需要被區分為時間值時。格式應為yyyy-mm-dd hh:mm:ss 用於在創建段時提供選擇屬性值的能力 | STRING | Y |
| propertyName | 用戶在遊戲中擁有的屬性值的名稱（例如，“成功狀態”） 如果屬性值為英文則不區分大小寫 當傳輸的屬性在段頁面上顯示時，如果屬性值超過28個字節（包括空格），可能會發生換行。 用於在創建段時選擇屬性 | STRING | Y |
| propertyValue | 遊戲內用戶的屬性值（例如，“失敗”） 用於在創建段時選擇與屬性名稱相對應的值 | STRING | Y |
檢查已發送的屬性¶
- 您可以在發送用戶屬性後，在 日誌定義功能 中檢查。
- 如果用戶屬性定義中的所有必填字段都已成功輸入值，則在創建段時可以選擇用戶。