FacebookEvent

概述

宝船 SDK 已经引入 Facebook 的分析跟踪模块，并做了相应封装。通过接入宝船 SDK,你可以轻松实现 Facebook 的功能，在你的应用中跟踪事件及更多数据。

应用接入

1. 如果你的应用没有继承 Applicaton 的类，请创建该类，如若已有实现类，则在应用的 Applicaton 继承类中添加如下方法：

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        val config = BrickConfig()
        //是否开启打印日志(可选)
        config.logEnable = true
        //app的业务Id，可以为空，可以为包名或者其他
        config.bindUid ="cc.xxxx.demo"
        BrickSDK.initBrick(
            this,
            "cdshf8dfbshdf8sdfc",//宝船出海SDK应用创建后，平台生成的key
            "sdjncvs8893d47xr983274cvhsd" //宝船出海SDK应用创建后，平台生成的秘钥
            config
        )
    }
}

• initBrick(context: Context, mKey: String, mSecret: String, config: BrickConfig = BrickConfig()) 方法说明：宝船平台 SDK 的初始化，该方法推荐放在 Application 类的 onCreate 方法中调用。是 BrickSDK 类中的方法 context：应用的上下文 mKey：为你在宝船出海 SDK 平台应用创建后，平台生成的 key mSecret：为你在宝船出海 SDK 平台应用创建后，平台生成的秘钥 config：对应 BrickConfig 类，是 sdk 的配置对象，可在该对象中设置是否开启日志打印，adjust 沙盒模式是否开启，与 adjust 回调等。

1. 打开 /app/manifest/AndroidManifest.xml 文件，在里面同步引用上一步创建的 MyApplication

<application
    android:name="你的包名和路径.MyApplication"
    android:allowBackup="true"
    android:dataExtractionRules="@xml/data_extraction_rules"
    android:fullBackupContent="@xml/backup_rules"
    android:icon="@mipmap/logo"
    android:label="@string/app_name"
    android:roundIcon="@mipmap/logo"
    android:supportsRtl="true">
    ......
    </application>

Facebook 事件上报分析

• logActivatedApp(extraData: String? = null)

方法说明：facebook标准事件(fb_mobile_activate_app)，上报app激活

extraData 额外数据(json字符串)

举例：

BrickFacebookTrack.logActivatedApp("{\"code\":200,\"message\":\"success\",\"data\":\"guestLogin\"}")

• logCompletedRegistration(registrationMethod: String? = null, extraData: String? = null)

方法说明：facebook标准事件(fb_mobile_complete_registration)，注册事件

registrationMethod 注册渠道 如"Facebook", "email", "Twitter"等

extraData 额外数据(json字符串)

举例：

BrickFacebookTrack.logCompletedRegistration(
                "Facebook",
                "{\"code\":200,\"message\":\"success\",\"data\":\"guestLogin\"}"
            )

• logCompletedTutorial(success: Boolean? = null, extraData: String? = null)

方法说明：facebook标准事件(fb_mobile_tutorial_completion)，完成新手指导

extraData 额外数据(json字符串)

举例：

BrickFacebookTrack.logCompletedTutorial(
                true,
                "{\"code\":200,\"message\":\"success\",\"data\":\"guestLogin\"}"
            )

• logAchievedLevel(level: String? = null, extraData: String? = null)

方法说明：facebook标准事件(fb_mobile_level_achieved)，达成成就等级

level 等级

extraData 额外数据(json字符串)

举例：

BrickFacebookTrack.logAchievedLevel(
                "100",
                "{\"code\":200,\"message\":\"success\",\"data\":\"guestLogin\"}"
            )

• logAchievementUnlocked(

    description: String? = null,
    contentType: String? = null, extraData: String? = null
  

  )

方法说明：facebook标准事件(fb_mobile_achievement_unlocked)，解锁成就

description 成就描述

contentType 成就类型

extraData 额外数据(json字符串)

举例：

BrickFacebookTrack.logAchievementUnlocked(
                "des",
                "prince",
                "{\"code\":200,\"message\":\"success\",\"data\":\"guestLogin\"}"
            )

• logInitiatedCheckout(

    productId: String? = null,
    productType: String? = null,
    productDes: String? = null,
    currency: String? = null,
    paymentInfoAvailable: Boolean? = null,
    numItems: Int? = null,
    totalPrice: Double? = null, extraData: String? = null
  

  )

方法说明：facebook标准事件(fb_mobile_initiated_checkout)，发起结账

productId 商品id

productType 商品类型

productDes 商品描述

currency 货币单位，如"USD", "EUR", "GBP"

paymentInfoAvailable 支付信息是否可用

numItems 购买商品数量

totalPrice 总金额

extraData 额外数据(json字符串)

举例：

BrickFacebookTrack.logInitiatedCheckout(
                "100",
                "coin",
                "des",
                "USD",
                true,
                3,
                100.0,
                "{\"code\":200,\"message\":\"success\",\"data\":\"guestLogin\"}"
            )

• logPurchase(

    purchaseAmount: Double? = null,
    currency: String? = null,
    parameters: Bundle? = null
  

  )

方法说明：facebook标准事件(fb_mobile_purchase)，购买

purchaseAmount 购买金额

currency 货币单位，如"USD"

parameters 额外参数

举例：

val bundle = Bundle()
bundle.putString("param", "value")
BrickFacebookTrack.logPurchase(300.0, "USD", bundle)

• logEvent(eventName: String)

方法说明：根据自己需要，自定义的事件

eventName 自定义事件名称

举例：

BrickFacebookTrack.logEvent("demo_event_name_example1")

• logEvent(eventName: String, parameters: Bundle?=null)

方法说明：根据自己需要，自定义的事件

eventName 自定义事件名称

parameters 参数

举例：

val bundle = Bundle()
bundle.putString("param", "value")
BrickFacebookTrack.logEvent("demo_event_name_example1", bundle)

• logEvent(eventName: String, valueToSum: Double)

方法说明：根据自己需要，自定义的事件

eventName 自定义事件名称

valueToSum 例如(价格或数量)参数

举例：

BrickFacebookTrack.logEvent("demo_event_name_example1", 100.0)

• logEvent(eventName: String, valueToSum: Double, parameters: Bundle?=null)

方法说明：根据自己需要，自定义的事件

eventName 自定义事件名称

valueToSum 例如(价格或数量)参数

parameters 参数

举例：

val bundle = Bundle()
bundle.putString("param", "value")
BrickFacebookTrack.logEvent("demo_event_name_example1", 100.0, bundle)