简介

Tenjin 的原生安卓 SDK。

目录

基础设置

Android Studio

  1. 点击这里 下载最新版的安卓 SDK。
  2. 在 Android Studio 里的 Project Navigator, 选择 Project,你将在 Android Studio project 里的 app 模块下看到 libs 文件夹 。
  3. 你需要将 tenjin.jartenjin.aar 文件添加到 libs 文件夹中。

    AndroidStudio

  4. 在你的 Android Studio 项目的 app 模块,选择 build.gradle 文件,确保将以下添加到 dependencies block 中:
dependencies {
  implementation fileTree(dir: 'libs', include: ['*.jar', '*.aar'])
  implementation files('libs/tenjin.aar')
}

============================================================================

Google Play 或 Amazon 应用商店

如果你在 Google Play 或者 Amazon 应用商店分发你的产品,请参考以下进行设置:

权限

Tenjin SDK 需要以下权限:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <!-- Required to get network connectivity (i.e. wifi vs. mobile) -->

同时从2022年4月1日起,在目标 API 级别设置为31(Android 12)的应用程序上,获得谷歌广告ID需要添加以下权限才可以获取 。请尽快添加此权限,另外请注意你需要将安卓 SDK 更新到 1.12.8及以上版本才可适配新的安卓权限。

<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

安卓广告 ID (AAID) 和 Install Referrer

在你的 build.gradle 文件中添加 安卓广告 ID (AAID)Install Referrer 库。

dependencies {
  implementation 'com.google.android.gms:play-services-ads-identifier:{version}'
  implementation 'com.android.installreferrer:installreferrer:{version}'
}

商店类型 App Store

默认商店类型 App Store 是 unspecified 。请根据你上架的应用商店,将 AppStore 值更改为 googleplayamazon

  1. AndroidManifest.xml:
<meta-data
    android:name="TENJIN_APP_STORE"
    android:value="googleplay" />
  1. setAppStore():
TenjinSDK instance = TenjinSDK.getInstance(this, "<API_KEY>");

instance.setAppStore(TenjinSDK.AppStoreType.googleplay);

============================================================================

其他安卓应用商店(包括安卓中国及华为海外)

如果你在其他安卓应用商店分发产品,请参照以下设置:

权限

Tenjin SDK 需要以下权限:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <!-- Required to get network connectivity (i.e. wifi vs. mobile) -->

同时从2022年4月1日起,在目标 API 级别设置为31(Android 12)的应用程序上,获得谷歌广告ID需要添加以下权限才可以获取 。请尽快添加此权限,另外请注意你需要将安卓 SDK 更新到 1.12.8及以上版本才可适配新的安卓权限。

<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

安卓广告ID (AAID) 和 Install Referrer

在你的 build.gradle 文件中添加 安卓广告 ID (AAID)Install Referrer 库。

dependencies {
  implementation 'com.google.android.gms:play-services-ads-identifier:{version}'
  implementation 'com.android.installreferrer:installreferrer:{version}'
}

如果你使用的广告网络需要 IMEI 进行设备定位,你需要添加以下权限的启用:

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

OAID

Tenjin 支持使用 OAID 在其他非 Google Play 商店渠道进行推广。我们有以下用于集成 OAID 库的选项。

MSA OAID (仅限中国)

集成 MSA 库,你需要下载 oaid_sdk_1.0.25.aarsupplierconfig.json.

在项目 gradle 文件中添加以下内容:

implementation files('libs/oaid_sdk_1.0.25.aar')

并确保在项目中复制了 supplierconfig.json 文件到 assets 文件夹内。

华为 OAID (华为海外)

对于在华为海外应用商店的推广,你可以集成华为 OAID 库来获取 OAID。可将华为的 OAID 库,在项目中添加以下内容:

build.gradle 文件中,为华为 SDK 添加 Maven address:


allprojects {
    repositories {
        google()
        jcenter()
        maven { url 'https://developer.huawei.com/repo/' }
    }
}
dependencies {
    implementation 'com.huawei.hms:ads-identifier:{version}'
}

华为的 Install Referrer

如果你在 华为应用商店(Huawei App Gallery)进行推广,请将上面的 Huawei OAID SDK 和 Install Referrer 库都进行添加。

dependencies {

    implementation 'com.huawei.hms:ads-identifier:{version}'
    implementation 'com.huawei.hms:ads-installreferrer:{version}'

}

商店类型 App Store

默认商店类型 App Store 是 unspecified 。请将 AppStore 值更改为 other

  1. AndroidManifest.xml:
<meta-data
    android:name="TENJIN_APP_STORE"
    android:value="other" />
  1. setAppStore():
TenjinSDK instance = TenjinSDK.getInstance(this, "<API_KEY>");

instance.setAppStore(TenjinSDK.AppStoreType.other);

============================================================================

Proguard 设置

-keep class com.tenjin.** { *; }
-keep public class com.google.android.gms.ads.identifier.** { *; }
-keep public class com.google.android.gms.common.** { *; }
-keep public class com.android.installreferrer.** { *; }
-keep class * extends java.util.ListResourceBundle {
    protected Object[][] getContents();
}
-keepattributes *Annotation*

如果你使用华为的库,你可以使用以下设置:

-keep class com.huawei.hms.ads.** { *; }
-keep interface com.huawei.hms.ads.** { *; }

集成

App 初始化

  1. Tenjin Organization 标签页 拿到你的 API_KEY
  2. 在 Activity 中导入 Tenjin import com.tenjin.android.TenjinSDK;
  3. onResume 方法中,你的 main Activity class 需要添加如下代码:
TenjinSDK instance = TenjinSDK.getInstance(this, "<API_KEY>");

instance.connect();

GDPR

作为 GDPR 合规的一部分,使用 Tenjin 的 SDK,你可以为设备和用户选择加入或者推出(opt-in/opt-out),或依据特定于设备的相关参数选择要加入或退出。OptOut() 不会向 Tenjin 发送任何 API 请求,我们也不会处理任何事件。

选择 opt-in/opt-out:

import com.tenjin.android.TenjinSDK;

public class TenjinDemo extends ActionBarActivity {

    @Override
    public void onResume() {
        //standard code
        super.onResume()

        //Integrate TenjinSDK connect call
        String apiKey = "<API_KEY>";
        TenjinSDK instance = TenjinSDK.getInstance(this, apiKey);

        boolean userOptIn = checkOptInValue();

        if (userOptIn) {
            instance.optIn();
        }
        else {
            instance.optOut();
        }

        instance.connect();

        //Your other code...
        //...

    }

    protected boolean checkOptInValue(){
        // check opt-in value
        // return true; // if user opted-in
        return false;
    }
}

要选择加入/退出特定的设备相关参数,可以使用 OptInParams()OptOutParams()

  • OptInParams() 将仅发送指定的设备相关参数. OptOutParams() 将发送除指定参数外的所有与设备相关的参数。

  • 请注意,我们至少需要以下参数来正确地对设备进行追踪监测:

    • ip_address
    • advertising_id
    • limit_ad_tracking
    • referrer
  • 如果你使用依赖 IMEI 和/或 OAID 的广告网络,以下参数为必须:

    • imei
    • oaid
  • 如果你计划使用 Google AdWords, 以下参数为必需项:

    • platform
    • os_version
    • locale
    • device_model
    • build_id

如果只想获取设备相关的特定参数,使用 OptInParams(),以下样例中,仅使用了设备相关的参数 ip_address, advertising_id, limit_ad_tracking, 和 referrer

String apiKey = "<API_KEY>";
TenjinSDK instance = TenjinSDK.getInstance(this, apiKey);

String[] optInParams = {"ip_address", "advertising_id", "limit_ad_tracking", "referrer"};
instance.optInParams(optInParams);

instance.connect();

如果你想要发送除特定设备相关参数以外的所有参数,使用 OptOutParams(),如下样例中,我们会发送除了 locale, timezone, 和 build_id 之外的所有相关的参数。

String apiKey = "<API_KEY>";
TenjinSDK instance = TenjinSDK.getInstance(this, apiKey);

String[] optOutParams = {"locale", "timezone", "build_id"};
instance.optOutParams(optOutParams);

instance.connect();

设备相关参数

Param Description Reference
ip_address IP Address
advertising_id Device Advertising ID Android)
limit_ad_tracking limit ad tracking enabled Android
oaid Open Advertising ID Android
imei Device IMEI Android
platform Platform Android
referrer Google Play Install Referrer Android
os_version operating system version Android
device device name Android
device_manufacturer device manufactuer Android
device_model device model Android
device_brand device brand Android
device_product device product Android
carrier phone carrier Android
connection_type cellular or wifi Android
screen_width device screen width Android
screen_height device screen height Android
os_version_release operating system version Android
build_id build ID Android
locale device locale Android
country locale country Android
timezone timezone Android


内购事件

理解用户收入和购买行为,你可以发送 transaction 事件到 Tenjin,Tenjin 将为你的 transaction 收据进行验证。

请注意: 你需要添加你的产品的 public key 到 Tenjin dashboard > Your Android App > Edit。你可以从 Google Play Developer Console > 获取你的 Base64-encoded RSA public key,路径为: Select your app > Development Tools > Services & APIs.




在 Tenjin 面板上添加好 Public Key 后,你可以使用以下方法:

public void transaction(String productId, String currencyCode, int quantity, double unitPrice, String purchaseData, String dataSignature)

样例:


public void sendPurchaseEvent(Purchase purchase, Double price, String currencyCode) {
        String sku = purchase.getSku();
        String purchaseData = purchase.getOriginalJson();
        String dataSignature = purchase.getSignature();

        TenjinSDK instance = getTenjinInstance();
        instance.transaction(sku, currencyCode, 1, price, purchaseData, dataSignature);
}

你可以通过我们的 Live Test Device Data Tool 来验证内购收据,你将会看到类似以下内容:




自定义事件

注意: connect() 事件的初始化必须在自定义事件之前进行上报。

你可以使用 Tenjin SDK 上报自定义事件: eventWithName(String name)

通过 Tenjin服务,你可以通过自定义事件,将买量的渠道和成本和应用内的交互进行关联绑定,示例如下:

String apiKey = <API_KEY>;
TenjinSDK instance = TenjinSDK.getInstance(this, apiKey);

//Integrate a custom event with a distinct name - ie. swiping right on the screen
instance.eventWithName("swipe_right");

自定义事件的值

你可以使用 Tenjin SDK 上报值为整数的自定义事件: eventWithNameAndValue(String name, String value) 或者 eventWithNameAndValue(String name, int value).

上报一个有 name (名称)的自定义事件, value (值)需为整数,你可以直接在面板上查看汇总和跟踪的平均值。如果你计划使用 Datavault,这些数值可以被用在更多有用的的指标上。

String apiKey = <API_KEY>;
TenjinSDK.instance = TenjinSDK.getInstance(this, apiKey);

//Integrate a custom event with a distinct name and value - ie. paying 100 virtual coins for an item
instance.eventWithNameAndValue("item", 100);

通过以上的样例, Tenjin 面板可以在对应的自定义事件名称下,汇总并平均对应的值。请注意,如果这个值不是整数,目前面板是不会显示的。

用于 A/B 测试的 App Subversion 参数(需要 DataVault 权限)

如果你想进行 A/B 测试并查看差异报告,我们可以使用 appendAppSubversion 方法将数字值附加到你的应用程序版本中。例如,如果你的应用程序版本 1.0.1 设置了 appendAppSubversion: @8888,就可以上报 App version 为 1.0.1.8888 的数据。

这些数据将在 DataVault 中,你可以通对应的过 subversion 值来查看报告。

TenjinSDK instance = TenjinSDK.getInstance(this, "<API_KEY>");
instance.appendAppSubversion(8888);
instance.connect();

Tenjin 与 ILRD 展示层级收益数据的集成

展示层级收益数据为付费功能,如有需要请联系你的客户经理讨论合约事宜。

Tenjin 目前支持与以下聚合平台展示数据进行集成:

  • AppLovin
  • IronSource
  • HyperBid
  • AdMob
  • TopOn

集成测试

你可以通过我们的 Live Test Device Data Tool 来验证内购查看 SDK 集成是否正常。添加你测试设备的 advertising_idIDFA/GAID 到测试设备名单中。你可以在面板上 DIAGNOSE -> Test Devices 查看。 点击到 SDK Live Data 页,并从 App 端发送事件,如果集成没有问题,你可以很快在面板上看到事件记录。




results matching ""

    No results matching ""