React Native向けTealiumのインストール方法について説明します。
Tealium for React Nativeを使用すると、React NativeアプリケーションでTealiumのネイティブモバイルライブラリ(iOS、Android)を利用できます。
これはTealium for React Nativeの現行バージョン(2.x)です。
以前のバージョンについては、Tealium for React Native 1.xを参照してください。
仕組み
Tealiumモバイルライブラリは、次のいずれかの方法でReact Nativeアプリケーションに統合します。
- NPMパッケージ(推奨)
- GitHubを使用して手動で統合
要件
- ネイティブビルド環境へのアクセス
- React Native 0.63以降および必要なツールがインストールされていること
- タグ管理モバイルプロファイル
- Android StudioまたはXcode
- Tealium for AndroidまたはTealium for iOS
サンプルアプリ
ライブラリ、トラッキングメソッド、およびベストプラクティスに沿った実装に慣れるため、React Nativeサンプルアプリをダウンロードすることをお勧めします。
インストール(NPM/YARN)
NPMを使用してReact Native向けTealiumライブラリをインストールするには、次の手順を実行します。
React Nativeプロジェクトのルートに移動します。
次のコマンドを使用して、
tealium-react-nativeパッケージをダウンロードしてインストールします。yarn install tealium-react-nativeNPMパッケージのバージョン1.0.7以降ではReact Native Autolinkingが有効になっているため、React Native 0.60以降を使用している場合は、
react-native linkを実行する必要はありません。
Android
Android Mavenのインストールドキュメントの説明に従って、Androidプロジェクトのルートにあるbuild.gradleファイルにTealiumのMavenリポジトリへの参照を追加します。プロジェクトの依存関係は、Autolinkingプロセスによって自動的に処理されます。
iOS
React Native 0.60以降のAutolinking機能により、必要なCocoaPods依存関係がiOSアプリケーションのワークスペースに自動的に追加されます。
Podをインストールするには、次のコマンドを実行します。
// From your React Native application folder:
cd ios && pod install
バージョン2.2.0から2.5.1では、Podfileに次の参照を追加してください:pod "tealium-react-native-swift", :path => '../node_modules/tealium-react-native/tealium-react-native-swift.podspec'。
バージョン2.6.0以降では、この追加の依存関係は不要になったため、削除する必要があります。
場合によっては、フレームワークモジュール内で非モジュール形式のインクルードを許可するために、clangパラメータを有効にする必要があります。clangパラメータを有効にするには、次の手順を実行します。
Xcodeでアプリの
.xcworkspaceファイルを開き、ナビゲーターからPodsを選択します。Targetsでtealium-react-nativeターゲットを選択し、Build Settingsタブをクリックします。
Apple Clang - Language - Modules > Allow Non-modular Includes In Framework Modulesにある次の構成を見つけて更新します。
CLANG_ALLOW_NON_MODULAR_INCLUDES_IN_FRAMEWORK_MODULES = YES;
ブリッジングヘッダー
TealiumReactNativeモジュールは、Tealium iOS (Swift)ライブラリを使用します。React NativeのObjective-CファイルをSwiftに公開するには、Xcodeを使用してiOSプロジェクトにブリッジングヘッダーファイルを作成します。
- Xcodeのメニューから**File > New > File…**を選択します。
- テンプレートとしてSwift Fileを選択し、Nextをクリックします。
- Groupドロップダウンで、アプリの最上位フォルダー(プロジェクトではありません)を選択します。
- 「Would you like to configure an Objective-D bridging header?」というプロンプトが表示されたら、Create Bridging Headerを選択してブリッジングヘッダーファイルを生成します。
ブリッジングヘッダーのファイル名はYourProject-Bridging-Header.hという形式です。Xcodeは生成されたファイル名を使用してプロジェクトを構成するため、ファイル名を変更しないでください。
ブリッジングヘッダーを追加するためのプロンプトは、プロジェクトごとに一度だけ表示されます。
JavaScript
モジュールをアプリにインポートする方法は、インストール方法によって異なります。
NPMを使用してインストールした場合は、コードに次の行を追加します。
import Tealium from 'tealium-react-native';
手動でインストールした場合は、GitHubリポジトリのnpm-packageフォルダーでindex.jsファイルを探し、ファイル名をTealiumModule.jsに変更して、React Native JavaScriptプロジェクトにコピーします。
インストール後、次のようにTealiumモジュールをアプリのJavaScriptコードにインポートします。
import Tealium from 'tealium-react-native';
import { TealiumConfig, TealiumView, TealiumEvent, ConsentCategories, Dispatchers, Collectors, ConsentPolicy, Expiry, ConsentExpiry, TimeUnit, ConsentStatus, TealiumEnvironment } from 'tealium-react-native/common';
初期化
アプリへのインストールが完了したら、次の例のようにinitialize()メソッドを使用してTealiumインスタンスを初期化します。
let config: TealiumConfig = {
// Replace 'ACCOUNT' with your Tealium account name
account: 'ACCOUNT',
// Replace 'PROFILE' with your Tealium profile name
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リファレンスを参照してください。
最終更新日 :: 2026年November月18日