Quick Tracking:SDK のインポートと構成

SDK の基本情報

1 クイック統合

Quick Tracking は、各アプリケーションに一意の統合コードを生成します。プロダクト内のガイドに従って統合を完了してください。注：すでに Umeng+ SDK を使用している場合は、SDK のファイルパスを変更する必要があります。詳細については、本ドキュメントのセクション 1.2 をご参照ください。

1.1 プロダクトパス

Quick Tracking のホームページにアクセスし、管理コンソールを開きます。組織リストに移動し、ご利用のアプリケーションが含まれる組織を見つけて、[アプリケーションの管理] をクリックします。アプリケーション管理ページで、ご利用のアプリケーションの横にある [統合] をクリックします。

[統合] をクリックすると、一意の統合コードを取得できる新しいページが表示されます。[次へ] をクリックして統合検証に進みます。その後、QR コードをスキャンしてアプリを起動し、統合が成功したことを確認できます。

1.2 Umeng+ SDK との競合の確認

注：すでに Umeng+ SDK を使用している場合は、SDK のファイルパスを変更する必要があります。

2. 詳細な統合コード

何らかの理由で前のセクションで説明したページにアクセスできず、このドキュメントを使用して統合を行う必要がある場合は、次のセクションで詳細な統合コードを提供します。

2.1 パラメーターの準備

appKey：アプリケーションリストから取得します。

データ収集ドメイン名：管理コンソールの情報収集モジュールから取得します。

SDK 情報：管理コンソールの情報収集モジュールから取得します。Web リンクを追加

2.2 SDK のインポート

2.2.1 自動統合

maven { url 'https://repo1.maven.org/maven2/' }

buildscript {
    repositories {
        google()
        jcenter()
        maven { url 'https://repo1.maven.org/maven2/' }
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:3.4.0'
    }
}

allprojects {
    repositories {
        google()
        jcenter()
        maven { url 'https://repo1.maven.org/maven2/' }
    }
}

dependencies {
    implementation fileTree(include: ['*.jar'], dir: 'libs')

    //QuickTracking 分析 SDK
    implementation 'com.lydaas.qtsdk:qt-px-common:1.8.9.PX'
  
}

pluginManagement {
    repositories {
        google {
            content {
                includeGroupByRegex("com\\.android.*")
                includeGroupByRegex("com\\.google.*")
                includeGroupByRegex("androidx.*")
            }
        }
        mavenCentral()
        gradlePluginPortal()
        maven { url 'https://repo1.maven.org/maven2/' }
    }

}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven { url 'https://repo1.maven.org/maven2/' }
    }
}

dependencies {
    //QuickTracking 分析 SDK
    implementation 'com.lydaas.qtsdk:qt-px-common:1.8.9.PX'
}

2.2.2 手動統合

SDK コンポーネントを選択してダウンロードします。.zip ファイルを解凍して、コンポーネントパッケージを取得します。

• qt-px-common-1.x.x.PX.aar // 分析 SDK。このコンポーネントは必須です。

• Android Studio で、関連するコンポーネントの JAR パッケージをプロジェクトの libs ディレクトリにコピーします。次に、プロジェクトを右クリックして [Open Module Settings] を選択します。[Project Structure] ダイアログボックスで、[Dependencies] タブを選択します。左下隅のプラス記号 (+) をクリックし、コンポーネントパッケージタイプを選択して、対応するパッケージをインポートします。

• Eclipse で、プロジェクトのルートディレクトリを右クリックし、[Properties] > [Java Build Path] > [Libraries] を選択します。次に、[Add External JARs...] をクリックし、JAR ファイルへのパスを選択して、[OK] をクリックしてインポートを完了します。(ADT 17 以降では手動でのインポートは不要です)。

repositories{
    flatDir{
        dirs 'libs'
    }
}

dependencies {
    implementation fileTree(include: ['*.jar'], dir: 'libs')
    implementation files('libs/qt-px-common-1.x.x.PX.aar') // 必須
}

dependencies {
    implementation fileTree(include: ['*.jar'], dir: 'libs')
    implementation files('libs/qt-px-common-1.x.x.PX.aar') // 必須
}

2.3 権限の構成

分析 SDK では、ホストアプリが次の権限を付与する必要があります。

次のコードは、AndroidManifest.xml マニフェストファイルの例です。

<manifest>
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
    <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
    <uses-permission android:name="android.permission.INTERNET"/>
</manifest>

2.4 難読化の構成

ご利用のアプリケーションでコードの難読化を使用している場合は、次の構成を追加する必要があります。これにより、Quick Tracking SDK が不正に難読化されて使用できなくなるのを防ぎます。

-keep class com.umeng.** {*;}
-keep class org.repackage.** {*;}

-keep class com.quick.qt.** {*;}
-keep class rpk.quick.qt.** {*;}

-keepclassmembers class * {
   public <init> (org.json.JSONObject);
}
-keepclassmembers enum * {
    public static **[] values();
    public static ** valueOf(java.lang.String);
}

SDK は、プロジェクトにインポートされたリソースファイルを参照する必要があります。リフレクションメカニズムを使用して、リソース参照ファイル R.java を取得します。ただし、ProGuard などの難読化ツールや最適化ツールで APK を処理すると、R.java ファイルが削除される可能性があります。この問題が発生した場合は、次の構成を追加してください。

-keep public class [your_app_package_name].R$*{
public static final int *;
} 

2.5 トラッキング検証の構成

AndroidManifest.xml ファイルで、android.intent.action.MAIN に応答するアクティビティを見つけます。これは、アプリケーションの外部から起動できる最初のアクティビティです。次のコードを追加して、特定のスキームリンクでアプリケーションを起動できるようにします。

<intent-filter>
    <action android:name="android.intent.action.VIEW"/>
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="atm.your_appKey" />
</intent-filter>

注：

1. 独立した intent-filter を使用してください。他の intent-filter と同じレベルに配置する必要があります。前述のコードを別の intent-filter 内に追加しないでください。

2. "your_appKey" をご利用のアプリケーションの appKey に置き換えてください。