自定义事件上报(ReportEvent)
上报自定义事件。其中 Adjust 渠道需要提前在 Adjust 控制面板注册 event,获取 event token,方能成功上报。
支持渠道:
- INTL
- Adjust
- AppsFlyer
- Firebase
- Garena
警告
Windows 平台只支持 INTL 渠道。
函数定义
UFUNCTION(BlueprintCallable, Category = "INTLSDKAPI")
static bool ReportEvent(const FString EventName, TMap<FString, FString> ParamsMap, const FString SpecificChannel = "", const FString ExtraJson = "{}");
入参说明
参数名称 | 参数类型 | 说明 |
---|---|---|
EventName | FString | 事件名 1. Adjust 渠道,要求填写 event token 来追踪事件 2. AppsFlyer 渠道,建议仅将小写字母数字字符(a-z 和 0-9)用于应用内事件名称 3. Facebook 渠道,事件和参数必须由 2至 40个字母数字字符组成,且每个参数值的长度不能超过 100个字符 4. Firebase 渠道,要求含 1至 40个字母数字字符或下划线。名称必须以字母字符开头。请注意,事件名称区分大小写,并且记录两个名称仅大小写不同的事件将导致两个不同的事件。 5. INTL 渠道,event_name 不要超过12个字符,允许的字符包括大小写字母、数字、下划线,不可以有空格 |
ParamsMap | TMap<FString, FString> | 需要上报的参数 key-value 的形式 |
SpecificChannel | FString | 指定渠道 1. 若无指定渠道,可填空字符串。空字符串默认上报已初始化的渠道,即 INTLConfig.ini 配置中 ANALYTICS_REPORT_CHANNEL 配置的上报渠道。更多信息,请参见 接入向导。2. 指定上报到某个渠道,例如 "Facebook"。 3. 指定上报到多个渠道,渠道之间用英文逗号“,”分隔,例如 "Facebook,Firebase"。 |
ExtraJson | FString | 扩展参数,Player Network SDK 客户端的额外判断条件,该参数将不会上报到指定的渠道 |
代码示例
TMap<FString, FString> ParamsMap;
ParamsMap.Add("k1", "v1");
UINTLSDKAPI::ReportEvent("INTL_EVENT_TEST", ParamsMap);