kochava.logEvent()

类型 函数
返回值 无
修订版 发行版 2024.3703
关键字 分析、归因、Kochava、logEvent
另请参阅 kochava.logDeeplinkEvent()
kochava.*

概述

向 Kochava 发送自定义事件或预定义类型与参数的事件。

语法

kochava.logEvent( eventType, params )
eventType (必需)

字符串. 事件类型。对于标准事件，可使用以下字符串之一

  • “成就”
  • “广告视图”
  • “添加到购物车”
  • “添加到愿望单”
  • “结账开始”
  • “关卡完成”
  • “购买”
  • “评分”
  • “完成注册”
  • “搜索”
  • “教程完成”
  • “视图”

对于自定义事件，你可以指定任何有效字符串，只要不以空格开头。

params (必需)

表. 包含键值参数的表。有效键和关联数据类型如下所列。你可以随意组合和使用这些键和参数。

您还可以指定您自己的自定义键-值参数。值可能为 String、Number 或 Boolean 类型。

注意

Kochava 支持记录和验证应用商店收据，但前提是 eventType 为 "purchase"。在这种情况下，可以将以下参数添加到 params 表中，以达到此目的

  • "receiptData" (字符串) — 该参数预期从应用内购买交易回调中找到的 event.transaction.receipt 获取数据。支持的市场包括 Apple IAP 和 Google IAP

  • "receiptDataSignature" (字符串) — 记录 Google IAP 收据时，此参数必填。它预期从应用内购买交易回调中找到的 event.transaction.signature 获取数据。

示例

应用内购买
local kochava = require( "plugin.kochava" )

local function kochavaListener( event )
    -- Handle events here
end

-- Initialize plugin
kochava.init( kochavaListener,
    {
        appGUID = "YOUR_APP_GUID"
    }
)
kochava.logEvent( "purchase",
    {
        userId = "USER_ID",
        name = "ITEM_NAME",
        currency = "usd",
        quantity = 2,
        price = 2.50,
        date = "2016-12-30"
    }
)
游戏关卡完成
local kochava = require( "plugin.kochava" )

local function kochavaListener( event )
    -- Handle events here
end

-- Initialize plugin
kochava.init( kochavaListener,
    {
        appGUID = "YOUR_APP_GUID"
    }
)

kochava.logEvent( "levelComplete",
    {
        userId = "USER_ID",
        level = "2",
        score = "22000"
    }
)