リモートコマンド：Usabilla

Swift Package Manager を使用して iOS の Facebook リモート コマンドをインストールするには:

1. Xcode プロジェクトで、次のように選択します: [File] > [Add Package…]> [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. プロジェクト ナビゲーターで Xcode プロジェクトを選択します。
2. Xcode プロジェクトにおいて、 [TARGETS] (ターゲット) セクションでアプリ ターゲットを選択します。
3. [General] > [Frameworks, Libraries & Embedded Content] に進み、 TealiumUsabilla モジュールを選択して、アプリ ターゲットに追加します。

Tealium Swift ライブラリからの追加のモジュールを追加するは、 Swift Package Manager の手順に従います。

CocoaPodsを使用してiOSのUsabillaリモートコマンドをインストールするには：

1. tealium-swiftとpod "Usabilla"がPodfileに既に存在する場合は削除します。tealium-swiftの依存関係はTealiumUsabillaフレームワークに既に含まれています。

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

pod "TealiumUsabilla"

TealiumUsabillaポッドには以下のTealiumSwift依存関係が含まれています。

'tealium-swift/Core'
'tealium-swift/TealiumDelegate'
'tealium-swift/TealiumRemoteCommands'
'tealium-swift/TealiumTagManagement'

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

Carthageを使用してiOSのUsabillaリモートコマンドをインストールするには：

1. tealium-swiftをCartfileから削除します。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モジュールがインストールに含まれている必要があります。

Mavenを使用してAndroidのUsabillaリモートコマンドをインストールするには：

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

   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'
}

以下のコードは、ローカル ファイル オプションを使用して、JSON Remote Commands 機能とともに用いるために設計されています。

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

var tealium = Tealium.create(TEALIUM_MAIN, config) {
  remoteCommands?.add(usabilla, filename = "usabilla.json");
}

Usabilla SDKで使用可能な追加（オプション）の初期化パラメータは次のとおりです。

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

次の例は、オプションのパラメータの使用方法を示しています。

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

以下のコードは、Remote Command タグ機能とともに用いるために設計されています。

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

var tealium = Tealium.create(TEALIUM_MAIN, config) {
  remoteCommands?.add(usabilla);
}

Usabilla SDKで使用可能な追加（オプション）の初期化パラメータは次のとおりです。

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

次の例は、オプションのパラメータの使用方法を示しています。

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

Android 向けの JSON Remote Command ファイル機能は、Kotlin SDK でのみ利用できます。

以下のコードは、Remote Command タグ機能とともに用いるために設計されています。

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 パッシブおよびキャンペーンフィードバックフォームと、送信または却下された自動削除フォームのイベントトラッキングの処理を無効にします（デフォルトで有効）。2つのandroid.content.BroadcastReceiverが登録され、パッシブおよびキャンペーンの両方のフィードバックフォームクロージャを処理するUsabillaイベントを待ち受けます。

次の例は、オプションのパラメータの使用方法を示しています。

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

以下のコードは、ローカル ファイル オプションを使用して、JSON Remote Commands 機能とともに用いるために設計されています。

var tealium : Tealium?
let config = TealiumConfig(account: "ACCOUNT",
                           profile: "PROFILE",
                           environment: "ENVIRONMENT",
                           dataSource: "DATASOURCE")
config.dispatchers = [Dispatchers.TagManagement, Dispatchers.RemoteCommands]
config.remoteAPIEnabled = true // Required to use Remote Commands

tealium = Tealium(config: config) { _ in
    guard let remoteCommands = self.tealium?.remoteCommands else {
        return
    }
  	let usabilla = UsabillaRemoteCommand(type: .local(file: "usabilla"))
	remoteCommands.add(usabilla)
}

以下のコードは、Remote Command タグ機能とともに用いるために設計されています。

var tealium : Tealium?
let config = TealiumConfig(account: "ACCOUNT",
                           profile: "PROFILE",
                           environment: "ENVIRONMENT",˜˜
                           dataSource: "DATASOURCE")
config.dispatchers = [Dispatchers.TagManagement, Dispatchers.RemoteCommands]
config.remoteAPIEnabled = true // Required to use Remote Commands

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