跳到主要内容

自定义事件上报(ReportEvent)

AndroidiOSWindows
如果您使用的是 Unity 引擎,请参见 Unity SDK 的 ReportEvent

上报自定义事件。其中 Adjust 渠道需要提前在 Adjust 控制面板注册 event,获取 event token,方能成功上报。

支持渠道:

  • INTL
  • Adjust
  • AppsFlyer
  • Facebook
  • Firebase
  • Garena
警告

Windows 平台只支持 INTL 渠道。

函数定义

UFUNCTION(BlueprintCallable, Category = "INTLSDKAPI")
static bool ReportEvent(const FString EventName, TMap<FString, FString> ParamsMap, const FString SpecificChannel = "", const FString ExtraJson = "{}");

入参说明

参数名称参数类型说明
EventNameFString事件名
1. Adjust 渠道,要求填写 event token 来追踪事件
2. AppsFlyer 渠道,建议仅将小写字母数字字符(a-z 和 0-9)用于应用内事件名称
3. Facebook 渠道,事件和参数必须由 2至 40个字母数字字符组成,且每个参数值的长度不能超过 100个字符
4. Firebase 渠道,要求含 1至 40个字母数字字符或下划线。名称必须以字母字符开头。请注意,事件名称区分大小写,并且记录两个名称仅大小写不同的事件将导致两个不同的事件。
5. INTL 渠道,event_name 不要超过12个字符,允许的字符包括大小写字母、数字、下划线,不可以有空格
ParamsMapTMap<FString, FString>需要上报的参数
key-value 的形式
SpecificChannelFString指定渠道
1. 若无指定渠道,可填空字符串。空字符串默认上报已初始化的渠道,即 INTLConfig.ini 配置中 ANALYTICS_REPORT_CHANNEL 配置的上报渠道。更多信息,请参见 接入向导
2. 指定上报到某个渠道,例如 "Facebook"。
3. 指定上报到多个渠道,渠道之间用英文逗号“,”分隔,例如 "Facebook,Firebase"。
ExtraJsonFString扩展参数,Player Network SDK 客户端的额外判断条件,该参数将不会上报到指定的渠道

代码示例

TMap<FString, FString> ParamsMap;
ParamsMap.Add("k1", "v1");
UINTLSDKAPI::ReportEvent("INTL_EVENT_TEST", ParamsMap);