Install Referrerモジュールのインストール

インストール

Install ReferrerモジュールをMavenまたは手動でインストールします。

Maven

MavenでInstall Referrerモジュールをインストールするには：

1. プロジェクトのトップレベルの build.gradle ファイルに、次のMavenリポジトリを追加します：

   maven {
         url "https://maven.tealiumiq.com/android/releases/"
   }
   

2. プロジェクトモジュールの build.gradle ファイルに、次のMaven依存関係を追加します：

   dependencies{
         // この参照がない場合のみ必要
         implementation 'com.tealium:kotlin-core:1.5.5'
         implementation 'com.tealium:kotlin-install-referrer:1.1.1'
         // この参照がすでに存在しない場合、またはライフサイクルの追跡が必要な場合のみ必要
         implementation 'com.tealium:kotlin-lifecycle:1.2.0'
         // GoogleのInstall Referrer API
         implementation 'com.android.installreferrer:installreferrer:1.0'
   }
   

このモジュールの依存関係であるGoogle Install Referrer APIは自動的に追加されません。ビルドにモジュールを追加してください。

手動

Install Referrerモジュールを手動でインストールするには：

1. TealiumのInstall Referrerモジュールをダウンロードします。

2. トップレベルの build.gradle ファイルで、以下を確認します：

   allprojects {
         repositories {
         mavenCentral()
         flatDir {
               dirs 'libs'
         }
         }
   }
   

3. ファイル tealium-kotlin.installreferrer-1.1.1.aar をプロジェクトの <PROJECT_ROOT>/<MODULE>/libs ディレクトリにコピーします。

4. プロジェクトモジュールの build.gradle ファイルにTealiumライブラリの依存関係を追加します：

   dependencies {
         // この参照がすでに存在しない場合のみ必要
         implementation(name:'tealium-kotlin-1.5.5', ext:'aar')
         implementation(name:'tealium-kotlin.installreferrer-1.1.1', ext:'aar')
         // この参照がすでに存在しない場合、またはライフサイクルの追跡が必要な場合のみ必要
         implementation(name:'tealium-kotlin.lifecycle-1.2.0', ext:'aar')
         // GoogleのInstall Referrer API
         implementation 'com.android.installreferrer:installreferrer:1.0'
   }
   

データレイヤー

Google Playから取得した以下のリファラーデータを期待します

"install_referrer" - インストールパッケージのリファラーURL
"install_referrer_begin_timestamp" - リファラルクリックが発生したタイムスタンプ（秒）
"install_referrer_click_timestamp" - インストールが開始されたタイムスタンプ（秒）

追加の考慮事項

保存されたリファラーの削除
保存されたインストールリファラー文字列を削除するには、Tealiumデータレイヤーの remove() メソッドを呼び出します。

// データレイヤーから以下のキーの一つまたはすべてを削除します
tealium.dataLayer.remove(InstallReferrerConstants.KEY_INSTALL_REFERRER)
tealium.dataLayer.remove(InstallReferrerConstants.KEY_INSTALL_REFERRER_BEGIN_TIMESTAMP)
tealium.dataLayer.remove(InstallReferrerConstants.KEY_INSTALL_REFERRER_CLICK_TIMESTAMP)