Appearance
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_()}"
)
}
}