Skip to content

Track

BrickAdjust

TIP

说明:它可以进行事件跟踪上报,集合了 adjust 的事件跟踪,归因等;firebase 的事件跟踪。

获取归因信息

kotlin
/**
 * adjust获取归因信息
 */
fun getAttribution(): attribution?

方法举例:

kotlin
val attribution = BrickAdjust._getAttribution_()

获取设备标识符

kotlin
/**
 * adjust获取设备标识符
 * 当后端跟踪到一台设备时,就会为其生成一个Adjust Device ID (ADID)
 */
fun getAdid(): String

方法举例:

kotlin
BrickAdjust._getAdid_()

获取 Amazon 广告 ID

获取 Amazon 广告标识符( Amazon 广告 ID)

context 应用上下文

kotlin
/**
 * adjust获取Amazon 广告标识符( Amazon 广告 ID)
 * context 应用上下文
 */
fun getAmazonAdId(context: Context): String

方法举例:

kotlin
BrickAdjust._getAmazonAdId_(this)

获取 Google 广告 ID

adjust 获取 Google Play 服务广告标识符(即 Google 广告 ID),是一台设备的独特标识符

context 上下文

onDeviceIdsRead google 广告 ID 的回调

kotlin
/**
 * adjust获取Google Play 服务广告标识符(即 Google 广告 ID),是一台设备的独特标识符
 * context 上下文
 * onDeviceIdsRead google广告ID的回调
 */
fun getGoogleAdId(context: Context, onDeviceIdsRead: OnDeviceIdsRead)

方法举例:

kotlin
BrickAdjust._getGoogleAdId_(this, object : _OnDeviceIdsRead_ {
    override fun onGoogleAdIdRead(googleAdId: String) {
    }
})

普通跟踪

简单地进行事件跟踪,只需要传入事件识别码

event 事件识别码

kotlin
/**
 * adjust事件跟踪
 * event 事件识别码 事件对象
 */
fun track(event: String)

方法举例:

kotlin
BrickAdjust.track("event")

收入跟踪

跟踪应用中生成收入的操作,包括广告交互和应用内购买

event 事件识别码

money 收入的金额

unit 货币识别码,应当是包含 3 个字符的字符串

kotlin
/**
 * adjust事件跟踪------收入跟踪
 * event 事件识别码
 * money  收入的金额
 * unit 货币识别码 货币识别码应当是包含 3 个字符的字符串。Adjust 后端会将收入换算为您选定的报告币种
 */
fun trackForRevenue(event: String, money: Double, unit: String)

方法举例:

kotlin
BrickAdjust.trackForRevenue("event", 0.01, "EUR")

避免重复进行跟踪收入

利用交易 Id,避免重复进行收入跟踪

event 事件识别码

money 收入的金额

unit 货币识别码,应当是包含 3 个字符的字符串

orderId 订单交易 Id

kotlin
/**
 * adjust事件跟踪并不重复收入跟踪
 * event 事件识别码
 * money  收入的金额
 * unit 货币识别码 货币识别码应当是包含 3 个字符的字符串。Adjust 后端会将收入换算为您选定的报告币种
 * orderId  订单交易Id 设置唯一事件 ID
 */
fun trackForOrderId(event: String, money: Double, unit: String, orderId: String)

方法举例:

kotlin
BrickAdjust.trackForOrderId("event", 0.01, "EUR", "4r634734")

跟踪特定来源的广告收入

跟踪特定来源的广告收入,Adjust SDK 支持从特定渠道合作伙伴接收广告收入信息。此功能只能用于特定广告收入来源。请查看受支持的来源列表

adRevenue 特定来源的广告收入的对象

kotlin
/**
 * adjust事件跟踪------跟踪特定来源的广告收入
 * adRevenue 特定来源的广告收入的对象
 * Adjust SDK 支持从特定渠道合作伙伴接收广告收入信息。
 */
fun trackForRevenue(adRevenue: adRevenue)

方法举例:

kotlin
val adRevenue = adRevenue(AdjustConfig._AD_REVENUE_APPLOVIN_MAX_)
adRevenue.revenue = 1.00
adRevenue.currency = "EUR"
adRevenue.adImpressionsCount = 10
adRevenue.adRevenueNetwork = "network1"
adRevenue.adRevenueUnit = "unit1"
adRevenue.adRevenuePlacement = "banner"
adRevenue.addCallbackParameter("key1", "value1")
adRevenue.addPartnerParameter("key2", "value2")
BrickAdjust.trackForRevenue(adRevenue)

事件跟踪同时回传标识符

为想要跟踪的每个事件添加自定义字符串标识符。Adjust 后端将在事件回传中报告该标识符。这样就能了解哪些事件已经被成功跟踪

event 事件识别码

_callbackId 设置唯一回传 ID _

kotlin
/**
 * adjust事件跟踪同时回传标识符
 * event 事件识别码
 * callbackId 设置唯一回传 ID  您可以为想要跟踪的每个事件添加自定义字符串标识符。Adjust 后端将在事件回传中报告该标识符。这样就能了解哪些事件已经被成功跟踪
 */
fun trackForCallBackId(event: String, callbackId: String)

方法举例:

kotlin
BrickAdjust.trackForCallBackId("event", "callbackId")

事件跟踪同时将回传单个参数

事件跟踪同时将回传参数发送至 Adjust

event 事件识别码

key 回传参数的键

value 回传参数的值

kotlin
/**
 * adjust事件跟踪同时将回传参数发送至 Adjust
 * event 事件识别码
 * key 回传参数的Key
 * value 回传参数的value
 */
fun trackForCallBackParameter(event: String, key: String, value: String)

方法举例:

kotlin
BrickAdjust.trackForCallBackParameter("event", "key", "value")

事件跟踪同时将回传多个参数

adjust 事件跟踪同时将回传参数发送至 Adjust

event 事件识别码

params 回传参数,对应 map 对象

kotlin
/**
 * adjust事件跟踪同时将回传参数发送至 Adjust
 * event 事件识别码
 * params 回传参数,可以是多个
 */
fun trackForCallBackParameter(event: String, params: Map<String, String>)

方法举例:

kotlin
BrickAdjust.trackForCallBackParameter("event", _mapOf_("key" _to _"value"))

事件跟踪同时将回传单个参数发送至渠道合作伙伴

当用户在应用内触发事件时,您可以将参数发送至渠道合作伙伴

event 事件识别码

key 回传参数的键

value 回传参数的值

kotlin
/**
 * adjust事件跟踪同时将回传参数发送至渠道合作伙伴
 * event 事件识别码
 * key 回传参数的Key
 * value 回传参数的value
 */
fun trackForPartnerParameter(event: String, key: String, value: String)

方法举例:

kotlin
BrickAdjust.trackForPartnerParameter("event", "key", "value")

事件跟踪同时将回传多个参数发送至渠道合作伙伴

adjust 事件跟踪同时将回传参数发送至 Adjust

event 事件识别码

params 回传参数,对应 map 对象

kotlin
/**
 * adjust事件跟踪同时将回传参数发送至渠道合作伙伴
 * event 事件识别码
 * params 回传参数,可以是多个
 */
fun trackForPartnerParameter(event: String, params: Map<String, String>)

方法举例:

kotlin
BrickAdjust.trackForPartnerParameter("event", _mapOf_("key" _to _"value"))

设置会话回传单个参数

设置会话回传参数,你可以同时发送回传参数和 Adjust SDK 记录的会话

key 回传参数的键

value 回传参数的值

kotlin
/**
 * 针对每次会话发送回传参数
 * key 回传参数的Key
 * value 回传参数的value
 */
fun addSessionCallbackParameter(key: String, value: String)

方法举例:

kotlin
BrickAdjust.addSessionCallbackParameter("key", "value")

设置会话回传多个参数

设置会话回传参数,你可以同时发送回传参数和 Adjust SDK 记录的会话

params 回传参数,对应 map 对象

kotlin
/**
 * 针对每次会话发送回传参数
 * params 回传参数,可以是多个
 */
fun addSessionCallbackParameter(params: Map<String, String>)

方法举例:

kotlin
BrickAdjust.addSessionCallbackParameter( _mapOf_("key" _to _"value"))

移除会话回传单个参数

key 回传参数的键

kotlin
/**
 * 移除会话回传参数
 * key 需要移除回传参数的Key
 */
fun removeSessionCallbackParameter(key: String)

方法举例:

kotlin
BrickAdjust.removeSessionCallbackParameter("key")

移除会话回传多个参数

keyList 需要移除回传参数的 Key 的列表

kotlin
/**
 * 移除会话回传参数
 * keyList 需要移除回传参数的Key的列表
 */
fun removeSessionCallbackParameter(keyList: List<String>)

方法举例:

kotlin
BrickAdjust.removeSessionCallbackParameter(_listOf_("key1", "key2"))

重置会话回传参数

kotlin
/**
 * 重置所有会话回传参数
 */
fun resetSessionCallbackParameters()

方法举例:

kotlin
BrickAdjust.resetSessionCallbackParameters()

回传单个参数发送至渠道合作伙伴

key 回传参数的键

value 回传参数的值

kotlin
/**
 * 针对每次会话将回传参数发送至渠道合作伙伴
 * key 回传参数的Key
 * value 回传参数的value
 */
fun addSessionPartnerParameter(key: String, value: String)

方法举例:

kotlin
BrickAdjust.addSessionPartnerParameter( "key", "value")

回传多个参数发送至渠道合作伙伴

params 回传参数,对应 map 对象

kotlin
/**
 * 针对每次会话将回传参数发送至渠道合作伙伴
 * params 回传参数,可以是多个
 */
fun addSessionPartnerParameter(params: Map<String, String>)

方法举例:

kotlin
BrickAdjust.addSessionPartnerParameter( _mapOf_("key" _to _"value"))

AdjustCallBack

TIP

说明:它是 Adjust 相关信息(例如归因等)的回调接口

方法:

onFinishedEventTrackingSucceeded(adjustEventSuccess: AdjustEventSuccess?)

设置事件跟踪成功监听(非必需重写)

adjustEventSuccess:事件设置成功后返回的信息

kotlin
fun onFinishedEventTrackingSucceeded(adjustEventSuccess: AdjustEventSuccess?) {}

onFinishedEventTrackingFailed(adjustEventFailure: AdjustEventFailure)

设置事件跟踪失败监听(非必需重写)

adjustEventFailure:事件设置失败后返回的信息

kotlin
fun onFinishedEventTrackingFailed(adjustEventFailure: AdjustEventFailure?) {}

onFinishedSessionTrackingSucceeded(adjustSessionSuccess AdjustSessionSuccess?)

设置会话跟踪成功监听(非必需重写)

adjustEventSuccess:设置会话跟踪成功后返回的信息

kotlin
fun onFinishedSessionTrackingSucceeded(adjustSessionSuccess: AdjustSessionSuccess?)  {}

onFinishedSessionTrackingFailed(adjustSessionFailure: AdjustSessionFailure?)

设置会话跟踪失败监听(非必需重写)

adjustSessionFailure:设置会话跟踪失败后返回的信息

kotlin
fun onFinishedSessionTrackingFailed(adjustSessionFailure: AdjustSessionFailure?)

onAttributionChanged(attribution: attribution?)

监听归因信息变化(非必需重写)

attribution:归因信息对象

kotlin
fun onAttributionChanged(attribution: attribution?)

接口实现举例:

kotlin
val adjustCallback= object :
    AdjustCallBack {
    override fun onAttributionChanged(attribution: attribution?) {
        Log.e(
            "MyApplication",
            "onAttributionChanged ${attribution?.adid ?: ""} ${attribution?.trackerName ?: ""} ${attribution?.trackerToken ?: ""} ${attribution?.campaign ?: ""} ${attribution?.costCurrency ?: ""} ${attribution?.adgroup ?: ""} ${attribution?.clickLabel ?: ""} ${attribution?.costType ?: ""} ${attribution?.fbInstallReferrer ?: ""} ${attribution?.network ?: ""}  "
        )
    }

    override fun onFinishedEventTrackingFailed(adjustEventFailure: AdjustEventFailure?) {
        Log.e(
            "MyApplication",
            "onFinishedEventTrackingFailed  ${adjustEventFailure._toString_()}"
        )
    }

    override fun onFinishedEventTrackingSucceeded(adjustEventSuccess: AdjustEventSuccess?) {
        Log.e(
            "MyApplication",
            "onFinishedEventTrackingSucceeded  ${adjustEventSuccess._toString_()}"
        )

    }

    override fun onFinishedSessionTrackingFailed(adjustSessionFailure: AdjustSessionFailure?) {
        Log.e(
            "MyApplication",
            "onFinishedSessionTrackingFailed  ${adjustSessionFailure._toString_()}"
        )

    }

    override fun onFinishedSessionTrackingSucceeded(adjustSessionSuccess: AdjustSessionSuccess?) {
        Log.e(
            "MyApplication",
            "onFinishedSessionTrackingSucceeded  ${adjustSessionSuccess._toString_()}"
        )
    }
}