インストール
TealiumをNativeScriptにインストールする方法を学びます。
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つのディスパッチャーが必要です。ディスパッチャーが指定されていない場合、トラッキングは行われません。
最終更新日 :: 2024年May月15日