リモートコマンド：FullStory

要件

• 以下のいずれかのモバイルライブラリ：
  • Tealium for Android-Kotlin（1.0.0以降）
  • Tealium for Android-Java（FullStory 1.0.0以降の場合は5.9.0以降、以前のバージョンの場合は5.9.0未満）
  • Tealium for iOS-Swift（2.18.0以降）
• 以下のいずれかのリモートコマンド統合：
  • FullStoryリモートコマンドJSONファイル（Android-Kotlin 1.0.0以降またはiOS-Swift 2.18.0以降が必要）
  • タグ管理のFullStoryリモートコマンドタグ

仕組み

FullStory統合では、次の3つのコンポーネントを使用します。

1. FullStoryネイティブSDK。
2. FullStoryのメソッドをラップするリモートコマンドモジュール。
3. イベントトラッキングをネイティブのFullStory呼び出しに変換する、JSON構成ファイルまたはリモートコマンドタグ。

FullStoryリモートコマンドモジュールをアプリに追加すると、必要なFullStoryライブラリが自動的にインストールおよびビルドされます。依存関係マネージャーを使用してインストールする場合、FullStory SDKを個別にインストールする必要はありません。

依存関係マネージャーとしてCocoaPodsまたはCarthageを使用している場合は、FullStoryコマンドラインツールを手動でダウンロードし、ビルドスクリプトとして追加する必要があります。

リモートコマンドには、次の2つのオプションがあります。

• リモートでホストするか、アプリ内にローカルで配置したJSON構成ファイルを使用する（推奨）。
• タグ管理を使用してマッピングを構成し、ベンダー統合用のリモートコマンドタグを追加する。

詳細については、ベンダー統合を参照してください。

インストール

依存関係マネージャー

次のいずれかの依存関係マネージャーを使用してモジュールをインストールすることをお勧めします。

手動インストール（iOS）

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

1. まだインストールしていない場合は、FullStory SDKをインストールします。
2. Tealium iOS FullStoryリモートコマンドリポジトリをクローンし、Sourcesフォルダー内のファイルをプロジェクトにドラッグします。
3. Dispatchers.RemoteCommandsをディスパッチャーとして追加します。
4. remoteAPIEnabled構成フラグをtrueに構成します。

初期化

すべてのTealiumライブラリで、初期化時にFullStoryリモートコマンドを登録します。

Android（Kotlin）

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

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

var tealium = Tealium.create(TEALIUM_MAIN, config) {
    // Initialize FullStory Remote Command
    val fullstoryCommand = FullStoryRemoteCommand()
    // register the command
    remoteCommands?.add(fullstoryCommand, filename = "tealium-fullstory.json")
}

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

var tealium = Tealium.create(TEALIUM_MAIN, config) {
    // Initialize FullStory Remote Command
    val fullstoryCommand = FullStoryRemoteCommand()
    // register the command
    remoteCommands?.add(fullstoryCommand)
}

Android（Java）

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

FullStoryRemoteCommand fullstory = new FullStoryRemoteCommand();

// register the command
teal.addRemoteCommand(fullstory);

iOS（Swift）

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

var tealium : Tealium?
let config = TealiumConfig(account: "ACCOUNT",
    profile: "PROFILE",
    environment: "ENVIRONMENT",
    dataSource: "DATASOURCE",
    options: nil)
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 fullstory = FullstoryRemoteCommand(type: .local(file: "fullstory"))
    remoteCommands.add(fullstory)
}

var tealium : Tealium?
let config = TealiumConfig(account: "ACCOUNT",
    profile: "PROFILE",
    environment: "ENVIRONMENT",
    dataSource: "DATASOURCE",
    options: nil)
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 fullstory = FullstoryRemoteCommand()
    remoteCommands.add(fullstory)
}

JSON テンプレート

JSON 構成ファイルを使用してリモートコマンドを構成する場合は、次のテンプレートを参照して開始してください。このテンプレートには、標準的な E コマース実装で使用される一般的なマッピングが含まれています。必要に応じてマッピングを編集してください。

{
  "config": {},
  "mappings": {
    "tealium_event": "event_name",
    "uid": "uid_str",
    "email": "user_variables.email_str",
    "phone": "user_variables.phone_str",
    "cart_id": "event.cart_id_str",
    "product_id": "event.product_id_str",
    "price": "event.price_real",
    "name": "event.name_str",
    "category": "event.categoryProperties"
  },
  "commands": {
    "launch": "logevent",
    "identify_user": "identify",
    "tealiumSampleEvent": "logevent",
    "tealiumSampleEventWithData": "logevent"
  }
}

サポートされるメソッド

各 FullStory メソッドにコマンドをマッピングします。FullStory メソッドをトリガーするには、対応するコマンドを指定された形式で渡します。

FullStory SDK は Tealium SDK とともにインストールされるため、Tealium FullStory リモートコマンドタグで提供されていない機能であっても、SDK を直接呼び出すことで、FullStory の任意のネイティブ機能をトリガーできます。

SDK のセットアップ

初期化

FullStory SDK は起動時に自動的に初期化されます。

FullStory 開発者ガイド：SDK の初期セットアップ

• モバイルのスタートガイド

イベントの記録

FullStory 開発者ガイド：イベントの記録

• Android
• iOS

識別

FullStory 開発者ガイド：識別

• Android
• iOS

ユーザー変数の構成

user_variables パラメータはキーと値のペアで構成されるオブジェクトを受け取ります。キーは strings であり、値にはデータ型を表すサフィックス（例：_str、_int、_bool）がエンリッチメントされます。詳細については、カスタム API プロパティの構成を参照してください。

FullStory 開発者ガイド：ユーザー変数の構成

• Android
• iOS

シャットダウン

FullStory の記録を停止します。シャットダウン後に記録を再開するには、restart を使用します。

FullStory 開発者ガイド：シャットダウン

• Android
• iOS

再起動

shutdown によって停止された FullStory の記録を再開します。

FullStory 開発者ガイド：再起動

• Android
• iOS

同意

FullStory のセッション記録に対するユーザーの同意を許可または取り消します。

FullStory 開発者ガイド：同意

• Android
• iOS

匿名化

現在のユーザーセッションを匿名化し、以前に構成されたユーザー識別情報をすべて削除します。

FullStory 開発者ガイド：匿名化

• Android
• iOS

アイドルタイマーのリセット

FullStory のアイドルタイムアウトタイマーをリセットし、現在のセッションを延長します。

FullStory 開発者ガイド：アイドルタイマーのリセット

• Android
• iOS

ログ

指定されたレベルでメッセージをログに記録します。使用できる log_level の値はプラットフォームによって異なります。

FullStory 開発者ガイド：ログ

• Android
• iOS