React Native 向け Tealium のインストール方法について説明します。
これは React Native 向け Tealium の旧バージョン(1.x)です。
現行バージョンについては、React Native 向け Tealium 2.xを参照してください。
React Native 向け Tealium を使用すると、React Native アプリケーションで Tealium のネイティブモバイルライブラリ(iOS、Android)を利用できます。
仕組み
Tealium モバイルライブラリは、次のいずれかの方法で React Native アプリケーションに統合します。
- NPM パッケージ(推奨)
- GitHub を使用した手動インストール
要件
- ネイティブビルド環境へのアクセス
- React Native および関連ツールがインストールされていること
- タグ管理モバイルプロファイル
- Android Studio または Xcode
- Android 向け Tealium または iOS 向け Tealium
サンプルアプリ
Tealium ライブラリ、トラッキングメソッド、および実装のベストプラクティスについて理解を深めるため、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
場合によっては、フレームワークモジュール内で非モジュール形式のインクルードを許可するために、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;
インストール(手動)
Android
Android アプリでは、次の手順に従って手動でインストールします。
Tealium を Android アプリケーションに統合するため、Tealium Maven リポジトリに次の内容を追加します。
プロジェクトルートの
build.gradleに Tealium Maven URL を追加します。allprojects { repositories { mavenCentral() maven { url "http://maven.tealiumiq.com/android/releases/" } } }プロジェクトモジュールの
build.gradleファイルに、Tealium コアライブラリの依存関係を追加します。また、必要に応じて Tealium ライフサイクルの依存関係も追加します。dependencies { compile 'com.tealium:library:5.5.2' compile 'com.tealium:lifecycle:1.1' }
ブリッジロジックをコピーするには、次の手順を実行します。
Android フォルダーから、
TealiumModule.javaとTealiumPackage.javaをプロジェクトファイルに追加します。MainApplication.javaファイルのgetPackages()メソッドにTealiumPackageを追加します。@Override protected List getPackages() { return Arrays.asList( new MainReactPackage(), new TealiumPackage() // <--- Add TealiumPackage ); }
iOS
React Native プロジェクトに iOS 向け Tealium を追加する手順は、ブリッジファイルを除き、React Native 以外のアプリケーションの場合と同じです。詳細については、iOS アプリへの Tealium の追加を参照してください。
コアライブラリは必須であり、オプションモジュールは必要に応じて追加します。これらは、Tealium の iOS 向け GitHub リポジトリから入手できます。
サンプルアプリは開発者によるテストを目的としており、App Store での公開を目的としていません。そのため、TealiumIOS.framework および TealiumIOSLifecycle.framework モジュールを使用しています(シミュレーターには適していますが、公開用には適していません)。App Store での公開を目的として独自のアプリを開発する場合は、必ずデバイス専用フォルダー内のフレームワークを使用してください。
インストール(CocoaPods)
CocoaPods を使用してインストールすることもできます。Tealium の Pod 名は「TealiumIOS」です。詳細については、iOS 向け Tealium ガイドを参照してください。create-react-native-app コマンドでは Podfile が作成されないため、サンプルアプリは手動インストールを使用して構築されています。多数の依存関係を持つ複雑な本番アプリでは、CocoaPods の使用を推奨します。
ブリッジロジックのコピー
GitHub リポジトリには、Tealium のネイティブ iOS SDK と React Native アプリ内の JavaScript をブリッジするための TealiumModule.m と TealiumModule.h という 2 つのファイルがあります。
これら 2 つのファイルをアプリのメインプロジェクトにコピーします。
JavaScript
モジュールをアプリにインポートする方法は、使用したインストール方法によって異なります。
NPM を使用してインストールした場合は、コードに次の行を追加します。
import Tealium from 'tealium-react-native';
手動でインストールした場合は、GitHub リポジトリの npm-package フォルダーにある index.js ファイルを探し、ファイル名を TealiumModule.js に変更して、React Native JavaScript プロジェクトにコピーします。
次に、Tealium JavaScript モジュールをインポートするため、コードに次の行を追加します。
import Tealium from './TealiumModule';
初期化
アプリをインストールしたら、次の例に示すように、initialize() メソッドを使用して Tealium インスタンスを初期化します。
Tealium.initialize("ACCOUNT",
"PROFILE",
"ENVIRONMENT",
"IOS_DATA_SOURCE_KEY",
"ANDROID_DATA_SOURCE_KEY")
同意管理
同意管理を使用するには、同じパラメータを指定して initializeWithConsentManager() メソッドで初期化します。
詳細:
カスタム初期化
すべての初期化オプションは、initializeCustom() メソッドで利用できます。
Tealium.initializeCustom('ACCOUNT',
'PROFILE',
'ENVIRONMENT',
'IOS_DATA_SOURCE_KEY',
'ANDROID_DATA_SOURCE_KEY',
'INSTANCE',
ENABLE_LIFECYCLE, // enable lifecycle tracking
'PUBLISH_SETTINGS_URL', // custom publish settings URL
'TAG_MANAGEMENT_URL', // custom tag management URL
USE_COLLECT_ENDPOINT, // toggle between data endpoints, true: Tealium Collect, false: Visitor Data
ENABLE_CONSENT_MANAGER); // enable consent management
詳細については、APIリファレンスを参照してください。
最終更新日 :: 2026年November月18日