インストール

これは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およびツールがインストールされていること
Tealium iQ Mobile Profile
Android StudioまたはXcode
Tealium for AndroidまたはTealium for iOS

サンプルアプリ

ライブラリ、トラッキング方法、およびベストプラクティスの実装に慣れるために、React Nativeサンプルアプリをダウンロードすることをお勧めします。

インストール（NPM/YARN）

React Native用TealiumライブラリをNPMでインストールするには：

React Nativeプロジェクトのルートに移動します。
次のコマンドでtealium-react-nativeパッケージをダウンロードしてインストールします：
```
yarn install tealium-react-native
```
NPMパッケージのバージョン1.0.7ではReact Native Autolinkingが有効になっており、React Nativeのバージョン0.60+を使用している場合、react-native linkを実行する必要はありません。

Android

Androidプロジェクトのルートbuild.gradleファイルにTealiumのMavenリポジトリへの参照を追加します。これはAndroid Mavenインストールのドキュメントで説明されています。プロジェクトの依存関係はAutolinkingプロセスによって自動的に処理されます。

iOS

React Native 0.60+のAutolinking機能は、必要なCocoaPods依存関係を自動的にiOSアプリケーションワークスペースに追加します。

ポッドをインストールするには、次のコマンドを実行します：

// React Nativeアプリケーションフォルダーから：
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アプリの場合、以下の手動インストール手順に従います：

AndroidアプリケーションにTealiumを統合するには、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()    // <--- TealiumPackageを追加
      );
}

iOS

React NativeプロジェクトにiOS用Tealiumを追加するには、ブリッジングファイルを除いて、非React Nativeアプリケーションに追加するのと同じ手順が必要です。したがって、完全な詳細についてはiOSアプリにTealiumを追加するを参照してください。

コアライブラリが必要で、必要に応じてオプショナルモジュールが追加されます。これらはiOS用のGitHubリポジトリから入手できます。

サンプルアプリは開発者の実験用であり、App Storeに公開するためのものではないため、TealiumIOS.frameworkとTealiumIOSLifecycle.frameworkのモジュールを使用しています（シミュレーターに適していますが、公開には適していません）。App Storeに公開するための自分のアプリを作業する際には、デバイス専用フォルダのフレームワークを使用してください。

インストール（CocoaPods）

CocoaPodsはインストールを行う別の方法です。私たちのポッドは「TealiumIOS」という名前です。完全な詳細についてはiOS用Tealiumガイドを参照してください。コマンドcreate-react-native-appはPodfileを作成しないため、サンプルアプリは手動インストールを使用して構築されました。多くの依存関係を持つ複雑な本番アプリの場合、CocoaPodsが推奨される方法です。

ブリッジングロジックのコピー

GitHubリポジトリには、TealiumネイティブiOS SDKとReact NativeアプリのJavascript間のブリッジングを提供する2つのファイル、TealiumModule.mとTealiumModule.hがあります。

これらの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,        // ライフサイクル追跡を有効にする
                         'PUBLISH_SETTINGS_URL',  // カスタム公開構成URL
                         'TAG_MANAGEMENT_URL',    // カスタムタグ管理URL
                         USE_COLLECT_ENDPOINT,    // データエンドポイント間で切り替える、true: Tealium Collect, false: Visitor Data
                         ENABLE_CONSENT_MANAGER); // コンセント管理を有効にする

詳細はAPIリファレンスをご覧ください。