リモートコマンド：Usabilla

1. Xcodeプロジェクトで、File > Add Packages… > Add Package Dependencyを選択します。
2. リポジトリURLを入力します：https://github.com/tealium/tealium-ios-usabilla-remote-command。
3. バージョンルールを構成します。通常はUp to next majorが推奨されます。現在のTealiumUsabillaバージョンがリストに表示されない場合は、Swiftパッケージキャッシュをリセットしてください。
4. インストールするTealiumUsabillaモジュールを選択し、そのモジュールをインストールするアプリターゲットを選択します。

プロジェクトに複数のアプリターゲットがあり、TealiumUsabillaモジュールを複数のアプリターゲットに追加する必要がある場合は、Frameworks, Libraries, and Embedded Contentセクションで手動で追加する必要があります。

TealiumUsabillaを追加のアプリターゲットにインストールするには：

1. Project NavigatorでXcodeプロジェクトを選択します。
2. Xcodeプロジェクトで、TARGETSセクションの下にあるアプリターゲットを選択します。
3. General > Frameworks, Libraries & Embedded Contentに移動し、TealiumUsabillaモジュールをアプリターゲットに追加します。

Tealium Swiftライブラリから追加のモジュールを追加するには、Swift Package Managerの指示に従ってください。

1. Podfileからtealium-swiftとpod "Usabilla"を削除します。tealium-swiftの依存関係はすでにTealiumUsabillaフレームワークに含まれています。

2. Podfileに次の依存関係を追加します：

   pod "TealiumUsabilla"
   

   TealiumUsabillaポッドには次のTealiumSwift依存関係が含まれています：

   'tealium-swift/Core'
   'tealium-swift/TealiumDelegate'
   'tealium-swift/RemoteCommands'
   'tealium-swift/TagManagement'
   

3. TealiumHelperファイルおよびTealiumクラスまたはUsabillaリモートコマンドにアクセスする他のファイルでTealiumSwiftおよびTealiumUsabillaモジュールをインポートします。

1. Cartfileからtealium-swiftを削除します。tealium-swiftの依存関係はすでにTealiumUsabillaフレームワークに含まれています。

2. Cartfileに存在する場合は次の行を削除します：

   github "usabilla/usabilla-u4a-ios-swift-sdk"
   

3. Cartfileに次の依存関係を追加します：

   github "tealium/tealium-ios-usabilla-remote-command"
   

Tealium for Swift SDK (バージョン1.6.5+)は、インストール時にTealiumDelegateモジュールが含まれている必要があります。

1. まだ行っていない場合は、Tealium for Android (Kotlin)またはTealium for Android (Java)をインストールし、プロジェクトのトップレベルのbuild.gradleファイルにTealium Maven URLを追加します。

   allprojects {
     repositories {
       mavenCentral()
       maven {
         url "https://maven.tealiumiq.com/android/releases/"
       }
     }
   }
   

2. アプリプロジェクトのbuild.gradleファイルに次の依存関係を追加して、Tealium-Usabillaリモートコマンドをインポートします：

   dependencies {
         implementation 'com.tealium.remotecommands:usabilla:1.0.0'
   }
   

Usabillaリモートコマンドの手動インストールには、Tealium for Swiftライブラリがインストールされている必要があります。iOSプロジェクトのUsabillaリモートコマンドをインストールするには：

1. まだ行っていない場合は、Usabilla SDKをインストールします。

2. Tealium iOS Usabillaリモートコマンドリポジトリをクローンし、Sourcesフォルダ内のファイルをプロジェクトにドラッグします。

3. remoteAPIEnabled構成フラグをtrueに構成します。

Usabillaリモートコマンドの手動インストールには、Tealium for Android (Kotlin)またはTealium for Android (Java)がインストールされている必要があります。

AndroidプロジェクトのBranchリモートコマンドをインストールするには：

1. プロジェクトルートのbuild.gradleファイルにflatDirを追加します：

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

2. <PROJECT_ROOT>/<MODULE>/libsにtealium-usabilla.aarを追加します。

3. build.gradleファイルにTealiumライブラリの依存関係を追加します：

   dependencies {
         implementation(name:'tealium-usabilla', ext:'aar')
   }
   

TealiumのiOS（Swift）ライブラリ用にJSON構成ファイルまたはリモートコマンドタグでリモートコマンドを初期化します：

var tealium : Tealium?
let config = TealiumConfig(account: "ACCOUNT",
                           profile: "PROFILE",
                           environment: "ENVIRONMENT",
                           dataSource: "DATASOURCE")
config.dispatchers = [Dispatchers.TagManagement, Dispatchers.RemoteCommands]
config.remoteAPIEnabled = true // リモートコマンドを使用するために必要

tealium = Tealium(config: config) { _ in
    guard let remoteCommands = self.tealium?.remoteCommands else {
        return
    }

    // Webviewタグ
    let usabilla = UsabillaRemoteCommand() 

    // ローカルJSON
    //let usabilla = UsabillaRemoteCommand(type: .local(file: "usabilla"))

    // リモートJSON
    //let usabilla = UsabillaRemoteCommand(type: .remote(url: "https://some.domain.com/usabilla.json"))
    remoteCommands.add(usabilla)
}

TealiumのAndroid（Kotlin）ライブラリ用にJSON構成ファイルまたはリモートコマンドタグでリモートコマンドを初期化します：

val config = TealiumConfig(application,
        "ACCOUNT",
        "PROFILE",
        Environment.DEV,
        dispatchers = mutableSetOf(Dispatchers.RemoteCommands, Dispatchers.TagManagement));
val usabilla = UsabillaRemoteCommand(TEALIUM_MAIN, config);

var tealium = Tealium.create(TEALIUM_MAIN, config) {

    // Webviewタグ
    remoteCommands?.add(usabilla);

    // ローカルJSON
    //remoteCommands?.add(usabilla, filename = "usabilla.json");

    // リモートJSON
    //remoteCommands?.add(usabilla, remoteUrl = "https://some.domain.com/usabilla.json");
}

Usabilla SDKのための追加（オプショナル）初期化パラメータが利用可能です：

• usabillaHttpClient = null
HttpClientオブジェクトをオーバーライドし、SDKによって実行されるすべての接続を処理するカスタムクライアントを注入する可能性を提供します。カスタムHTTPクライアントについてもっと学びましょう。
• usabillaReadyCallback = null
UsabillaReadyCallbackオブジェクトをオーバーライドし、初期化プロセスが終了したときに通信するコールバックです。
• autoFragmentManager = false
  パッシブフィードバックを無効にします（デフォルトでは有効）。パッシブフィードバックは、AndroidのFragmentManagerを最新の状態に保ち、android.app.Application.ActivityLifecycleCallbacksを使用して監視する必要があります。
• autoFeedbackHandler = false
  パッシブおよびキャンペーンフィードバックフォームのイベントトラッキングの処理を無効にし、送信または却下されたフォームを自動的に削除する機能を無効にします（デフォルトでは有効）。二つのandroid.content.BroadcastReceiverが登録され、パッシブおよびキャンペーンフィードバックフォームのクロージャを処理するUsabillaイベントをリッスンします。

オプショナルパラメータの使用例を以下に示します：

val usabilla = UsabillaRemoteCommand(TEALIUM_MAIN, config,
        usabillaHttpClient = null,
        usabillaReadyCallback = null,
        autoFragmentManager = false,
        autoFeedbackHandler = false);

AndroidのJSONリモートコマンドファイル機能はKotlin SDKでのみ利用可能です。TealiumのAndroid（Java）ライブラリ用にリモートコマンドタグを初期化します：

Tealium.Config config = Tealium.Config.create(application, "ACCOUNT", "PROFILE", "ENVIRONMENT");
Tealium teal = Tealium.createInstance(TEALIUM_MAIN, config);

RemoteCommand usabilla = new UsabillaRemoteCommand(TEALIUM_MAIN, config);
teal.addRemoteCommand(usabilla);

Usabilla SDKのための追加（オプショナル）初期化パラメータが利用可能です：

• usabillaHttpClient = null
HttpClientオブジェクトをオーバーライドし、SDKによって実行されるすべての接続を処理するカスタムクライアントを注入する可能性を提供します。カスタムHTTPクライアントについてもっと学びましょう。
• usabillaReadyCallback = null
UsabillaReadyCallbackオブジェクトをオーバーライドし、初期化プロセスが終了したときに通信するコールバックです。
• autoFragmentManager = false
  パッシブフィードバックを無効にします（デフォルトでは有効）。パッシブフィードバックは、AndroidのFragmentManagerを最新の状態に保ち、android.app.Application.ActivityLifecycleCallbacksを使用して監視する必要があります。
• autoFeedbackHandler = false
  パッシブおよびキャンペーンフィードバックフォームのイベントトラッキングの処理を無効にし、送信または却下されたフォームを自動的に削除する機能を無効にします（デフォルトでは有効）。二つのandroid.content.BroadcastReceiverが登録され、パッシブおよびキャンペーンフィードバックフォームのクロージャを処理するUsabillaイベントをリッスンします。

オプショナルパラメータの使用例を以下に示します：

RemoteCommand usabilla = new UsabillaRemoteCommand(TEALIUM_MAIN, config,
        usabillaHttpClient = null,
        usabillaReadyCallback = null,
        autoFragmentManager = false,
        autoFeedbackHandler = false);