インストール | NativeScript用のTealium

TealiumのNativeScript統合は、ネイティブのTealium iOSおよびAndroid SDKとインターフェースを持つクロスプラットフォームインターフェースと構成クラスのセットを提供します。

要件

ネイティブビルド環境へのアクセス
NativeScriptプラグインとツールがインストールされていること
Android StudioまたはXcode

サンプルアプリ

私たちのライブラリ、トラッキング方法、およびベストプラクティスの実装に慣れるために、NativeScriptサンプルアプリをダウンロードしてください。

サンプルアプリを実行するには、npm iコマンドを実行してすべての依存関係をインストールし、その後、ルートディレクトリ(tealium-nativescript-plugin)でnpm startを実行します。プラットフォームに応じて、apps.demo.androidまたはapps.demo.iosを選択します。

現在、NativeScript on iOSでは初期アプリビルドが失敗するという既知の問題があります。成功するためには、.xcworkspaceファイルを開き、Project > Build Settings > Validate Workspaceに移動し、プロパティをYesに構成します。

インストール (NPM)

NPMを使用してNativeScript用のTealiumライブラリをインストールするには：

NativeScriptプロジェクトのルートに移動します。
次のコマンドで@tealium/nativescript-pluginパッケージをダウンロードしてインストールします：
```
npm i @tealium/nativescript-plugin
```

TypeScript

インストール後、TealiumモジュールをアプリのTypeScriptコードにインポートします：

import { Tealium } from '@tealium-nativescript/tealium';
import {
   TealiumConfig, TealiumView, TealiumEvent, ConsentCategories, Dispatchers, Collectors,ConsentPolicy,
   Expiry, ConsentStatus, TealiumEnvironment } from '@tealium-nativescript/tealium/common';

初期化

アプリがインストールされた後、TealiumConfig初期化オプションを使用してinitialize()メソッドでTealiumインスタンスを初期化します：

let config: TealiumConfig = {
    account: 'ACCOUNT',
    profile: 'PROFILE',
    environment: TealiumEnvironment.dev,
    dispatchers: [
        Dispatchers.Collect,
        Dispatchers.RemoteCommands,
        Dispatchers.TagManagement
    ],
    collectors: [
        Collectors.AppData,
        Collectors.DeviceData,
        Collectors.Lifecycle,
        Collectors.Connectivity
    ],
    consentPolicy: ConsentPolicy.gdpr,
    visitorServiceEnabled: true
};

Tealium.initialize(config);

詳細な情報と追加の構成オプションについては、APIリファレンスを参照してください。

サポートされているモジュール

コレクター

コレクターは、デバイスから補足情報を収集し、それをデータレイヤーに追加してからTealium Customer Data Hubに送信するモジュールです。一部のコレクターはコアライブラリに含まれていますが、他のコレクターはオプションであり、別のモジュールとしてインストールされます。

以下の表は、利用可能なコレクターを一覧表示しています。デフォルトのコレクターはコレクター名の隣に*が付いています。

コレクター名	TealiumConfig参照
`AppData`*	`Collectors.AppData`
`Connectivity`*	`Collectors.Connectivity`
`Device`	`Collectors.Device`
`Lifecycle`	`Collectors.Lifecycle`

これらのモジュールは、TealiumConfigのcollectorsプロパティを使用して有効または無効にします。

ディスパッチャー

ディスパッチャーは、データレイヤーからのデータをTealiumエンドポイントに送信するモジュールです。現在利用可能なディスパッチャーは次のとおりです：

ディスパッチャー名	TealiumConfig参照
`Collect`	`Dispatchers.Collect`
`RemoteCommands`	`Dispatchers.RemoteCommands`
`TagManagement`	`Dispatchers.TagManagement`

少なくとも1つのディスパッチャーが必要です。ディスパッチャーが指定されていない場合、トラッキングは行われません。