傳送事件日誌¶

大綱¶

您可以將事件日誌傳送到 Analytics。配置發送的事件時，請檢查事件範本提供的事件結構以及是否自動收集Hive SDK。

需要進一步分析的事件日誌可以從客戶端或伺服器發送。

客戶端傳輸¶

Hive SDK v4, Hive 這是如何透過 Axyl 從客戶端傳送事件日誌。

透過 Hive SDK v4 傳送事件日誌¶

Hive SDK 如何使用v4的事件日誌傳輸功能從客戶端發送事件。

• 必填屬性中，只有eventName需要直接傳送。 SDK 自動收集 其餘部分。

引擎通用設定¶

SDK v4 供使用的引擎設定。

根據引擎的不同，使用SDK之前需要進行一些常見的設置，例如Unity、Unreal、Engine等。 Hive不適用於Axyl。

轉帳方式¶

傳送 Hive SDK v4 的事件日誌 Analytics 使用 API。

JSONObject logData = new JSONObject();
// 必填屬性（僅直接傳送eventName，其餘SDK自動收集）
logData.AddField("eventName", "asset_drop");
// 自訂屬性
logData.AddField("level", 10);
logData.AddField("exp", 1.5f);
logData.AddField("character_name", "AA");
logData.AddField("stage_id", "stage_101");
Analytics.sendAnalyticsLog(logData);

#include "HiveAnalytics.h"

TSharedPtr<FJsonObject> LogData = MakeShareable(new FJsonObject);
// 必填屬性（僅直接傳送eventName，其餘SDK自動收集）
LogData->SetStringField(TEXT("eventName"), TEXT("asset_drop"));
// 自訂屬性
LogData->SetNumberField(TEXT("level"), 10);
LogData->SetNumberField(TEXT("exp"), 1.5);
LogData->SetStringField(TEXT("character_name"), TEXT("AA"));
LogData->SetStringField(TEXT("stage_id"), TEXT("stage_101"));

FHiveAnalytics::SendAnalyticsLog(LogData);

picojson::object logData;
// 必填屬性（僅直接傳送eventName，其餘SDK自動收集）
logData["eventName"] = picojson::value("asset_drop");
// 自訂屬性
logData["level"] = picojson::value((double)10);
logData["exp"] = picojson::value(1.5);
logData["character_name"] = picojson::value("AA");
logData["stage_id"] = picojson::value("stage_101");
Analytics::sendAnalyticsLog(logData);

Map<String, Object> logData = new HashMap<String, Object>();
// 必填屬性（僅直接傳送eventName，其餘SDK自動收集）
logData.put("eventName", "asset_drop");
// 自訂屬性
logData.put("level", 10);
logData.put("exp", 1.5);
logData.put("character_name", "AA");
logData.put("stage_id", "stage_101");
Analytics.sendAnalyticsLog(logData);

NSMutableDictionary* logData = [[NSMutableDictionary alloc] init];
// 必填屬性（僅直接傳送eventName，其餘SDK自動收集）
[logData setObject:@"asset_drop" forKey:@"eventName"];
// 自訂屬性
[logData setObject:@10 forKey:@"level"];
[logData setObject:@1.5 forKey:@"exp"];
[logData setObject:@"AA" forKey:@"character_name"];
[logData setObject:@"stage_101" forKey:@"stage_id"];
[HIVEAnalytics sendAnalyticsLog:logData];

儲存結果¶

如果您發送上述範例，它將保存在 BigQuery 中，如下所示。

attributes 範例

{
  "hiveAttributes": {
    "dataSource": "custom_sdk",
    "geoIpCountry": "KR"
  },
  "eventAttributes": {
    "eventTime": "2026-07-20T14:01:01+09:00",
    "level": 10,
    "exp": 1.5,
    "character_name": "AA",
    "stage_id": "stage_101",
    "vid": 100001,
    "uid": 1,
    "vid_type": "v4",
    "guid": "ecbfbd7fcdc340e1b8a433999c5290c1",
    "server_id": "KR-1",
    "model": "iPhone17,3",
    "os": "I",
    "os_version": "26.5.2"
  }
}

Hive SDK v4 注意事項 & Tips¶

• 使用 SDK v4 事件日誌傳送功能時，vid、uid、did、model、os、market、server_id 等基本收集屬性會自動傳送。詳細清單請參閱傳送事件屬性 > Hive SDK v4 自動收集屬性。
• 請注意，如果您手動新增並傳輸與基本集合屬性相同的屬性名稱，則自動收集的SDK和v4的值可能會被您自己設定的值覆蓋。

透過 Hive Axyl 傳送事件日誌¶

伺服器傳輸¶

這是透過Fluentd、HTTP從遊戲伺服器發送事件日誌的方法。

透過 Fluentd 發送事件日誌¶

此方法涉及透過 Fluentd 直接從遊戲伺服器發送事件。

• 您必須手動設定和傳輸所有屬性，包括必要屬性。

Fluentd 伺服器訊息¶

Analytics Fluentd 伺服器位址為： 事件日誌必須參考下表傳輸。

Fluentd 轉帳方式¶

在遊戲伺服器上，配置 JSON 形式的事件日誌並透過 Fluentd 發送。

fluentd tag 規則：

event.{gameName}.{eventName}

傳輸 JSON 範例：

{
  "userId": "100001",
  "identifierProvider": "hive",
  "deviceId": "100000",
  "appId": "com.com2us.game.ios",
  "eventTime": "2026-07-20T14:01:01+09:00",
  "eventName": "asset_drop",
  "level": 10,
  "character_name": "AA",
  "stage_id": "stage_101"
}

Fluentd 儲存結果¶

如果您發送上述範例，它將保存在 BigQuery 中，如下所示。

attributes 範例

{
  "hiveAttributes": {
    "dataSource": "custom_server",
    "geoIpCountry": "KR"
  },
  "eventAttributes": {
    "eventTime": "2026-07-20T14:01:01+09:00",
    "level": 10,
    "character_name": "AA",
    "stage_id": "stage_101"
  }
}

Fluentd 使用者指南¶

可以使用 Fluentd 以多種方式傳送事件日誌。點擊下面的連結以了解更多資訊。

• Fluentd 使用者指南
• 使用應用程式庫傳送事件日誌
• 讀取特定日誌檔案並傳輸事件日誌

Fluentd 注意事項 & Tips¶

• 在伺服器傳輸（Fluentd）中，不包含自動收集的屬性SDK，因此您必須手動設定和傳輸所有必要的屬性。
• 必須包含所有必要屬性（userId、identifierProvider、deviceId、appId、appIdGroup、eventTime、eventName）。

透過 HTTP 發送事件日誌¶

如何透過 HTTP API 直接從遊戲伺服器或客戶端發送事件。

• Fluentd 適合在無法安裝的環境中傳輸伺服器事件日誌。
• 以REST和API的形式直接傳送JSON資料。
• 您必須手動設定和傳輸所有屬性，包括必要屬性。

接收伺服器訊息¶

Analytics Web 伺服器位址是：

Header 訊息：

HTTP 轉帳方式¶

向上述接收伺服器URL請求JSON資料POST。

HTTP 請求：

POST https://analytics-log.withhive.com/v1/server-recv
Content-Type: application/json; charset=utf8

請求 Body (JSON):

{
  "userId": "100001",
  "identifierProvider": "hive",
  "deviceId": "100000",
  "appId": "com.com2us.game.ios",
  "eventTime": "2026-07-20T14:01:01+09:00",
  "eventName": "asset_drop",
  "level": 10,
  "character_name": "AA"
}

HTTP 傳輸範例¶

cURL:

curl -X POST https://analytics-log.withhive.com/v1/server-recv \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "100001",
    "identifierProvider": "hive",
    "deviceId": "100000",
    "appId": "com.com2us.game.ios",
    "eventTime": "2026-07-20T14:01:01+09:00",
    "eventName": "asset_drop",
    "level": 10,
    "character_name": "AA"
  }'

Python:

import requests
import json

url = "{Analytics 接收伺服器 URL}"
data = {
    "userId": "100001",
    "identifierProvider": "hive",
    "deviceId": "100000",
    "appId": "com.com2us.game.ios",
    "eventTime": "2026-07-20T14:01:01+09:00",
    "eventName": "asset_drop",
    "level": 10,
    "character_name": "AA",
}

response = requests.post(url, json=data)
print(response.status_code)

HTTP 儲存結果¶

如果您發送上述範例，它將保存在 BigQuery 中，如下所示。

attributes 範例

{
  "hiveAttributes": {
    "dataSource": "custom_server",
    "geoIpCountry": "KR"
  },
  "eventAttributes": {
    "eventTime": "2026-07-20T14:01:01+09:00",
    "level": 10,
    "character_name": "AA"
  }
}

HTTP 注意事項 & Tips¶

• 必須包含所有必要屬性（userId、identifierProvider、deviceId、appId、appIdGroup、eventTime、eventName）。
• Content-Type 必須設定為 application/json。
• 如果您使用 JSON 物件 ({}) 或陣列 ([]) 作為屬性值，它將被隔離到 rescue 表中。
• 在伺服器傳輸（HTTP）中，不包含自動收集的屬性SDK，因此您必須手動設定和傳輸所有必要的屬性。

相關菜單¶

• 傳送事件屬性 — 必填/自動收集/自訂屬性的詳細規則
• 事件儲存結構>表格結構 — BigQuery儲存結構
• 事件儲存結構>資料隔離 — rescue 表格隔離原因及尋找方法