インストール

このセクションでは、以前のiOSライブラリ、Objective-Cについて説明します。SwiftはmacOS、iOS、watchOS、tvOSなどで推奨されるプログラミング言語です。Swiftのコードは既存のObjective-Cファイルと同じプロジェクト内で共存し、Objective-C APIに完全にアクセスできるため、採用が容易です。

要件

• Xcode 7.0+
• iOS 8.1+
• Tealium iQ Mobile Profile
• Tealium Customer Data Hub account

サンプルアプリ

Tealiumライブラリ、トラッキング方法、ベストプラクティスの実装に慣れるために、iOS用Tealiumのsample appsを探索してみてください。

アプリの残りの部分からTealiumの実装を抽象化するために、TealiumHelperクラスの使用をお勧めします。これにより、初期化およびトラッキング呼び出しを行う単一のエントリポイントが提供されます。また、ヘルパーファイルのコードを更新し、すべてのViewControllerまたはヘッダー/メソッドファイルで更新する必要がなくなります。

• Objective-C用TealiumHelper
• Swift用TealiumHelper

iOS用のTealiumクラスとメソッドの完全なリストについては、TealiumIOS APIを参照してください。

インストール

CocoaPods、Carthage、または手動でiOS（Objective-C）用のTealium SDKをインストールします。

CocoaPods

アプリにiOS（Objective-C）用のTealiumをCocoaPods（推奨）でインストールするには：

1. Podfileに以下の依存関係を追加します：

   pod "TealiumIOS"
   

2. ファイルを保存し、プロジェクトディレクトリで以下を実行します：

   pod install --repo-update
   

3. 作成された.xcworkspaceファイルを使用してアプリのビルドを続けます。.xcworkspaceファイルを使用しないと、アプリを正しくビルドできません。

Carthage

アプリにiOS（Objective-C）用のTealiumをCarthageでインストールするには：

1. Cartfileに以下を追加します：

   github "tealium/tealium-ios"
   

2. フレームワークをダウンロードして抽出するには、以下のコマンドを実行します：

   carthage update --platform ios --use-xcframeworks
   

   ビルドが失敗しないように、--use-xcframeworksフラグを使用してください。これにはCarthage 0.38.0が必要です。

3. ビルド時に必要なフレームワークが自動的にコピーされるように、CarthageがXcodeプロジェクトに適切に統合されていることを確認します。

手動

アプリにiOS（Objective-C）用のTealiumを手動でインストールするには：

1. TealiumIOS.xcframeworkをプロジェクトに追加します。

2. 結果のダイアログボックスでフレームワークをプロジェクトにコピーします。

3. ターゲットでGeneral > Frameworks, Libraries & Embedded Contentに移動し、“Embed & Sign"オプションを選択してTealiumIOS.xcframeworkを追加します。

Swiftプロジェクトの場合は、Build Settings > Swift Compiler > Objective-C Bridging Headerオプションに移動し、TealiumIOSBridgingHeader.hファイルを含めます。

初期化

Application Delegateまたはヘルパークラスのセットアップメソッド内で、以下の初期化コードを使用します：

// アカウント、プロファイル、環境を構成します
let tealConfig = TEALConfiguration.init(account: "ACCOUNT",
                                        profile: "PROFILE",
                                    environment: "ENVIRONMENT",
                                     datasource: "DATASOURCE")

// このインスタンスの一意のキーで初期化します
guard let tealium = Tealium.newInstanceForKey("INSTANCE", configuration: tealConfig) else {
     // ここで追加の失敗応答           
     return
}

// インポートエリア
@import TealiumIOS;

// アカウント、プロファイル、環境を構成します
TEALConfiguration *tealConfig = [TEALConfiguration configurationWithAccount:@"ACCOUNT"
                          profile:@"PROFILE"
                          environment:@"ENVIRONMENT"
                          datasource:@"DATASOURCE"];

// このインスタンスの一意のキーで初期化します
Tealium *tealium = [Tealium newInstanceForKey:@"INSTANCE" configuration:tealConfig]; 

ログレベルはデフォルトでiQアカウントからの公開構成から構成されます。この構成を上書きするには、TEALConfigurationインスタンスのlogLevelプロパティを構成します：

// ログの詳細度をエラーのみに構成します
tealConfig.logLevel = .prod

// ログの詳細度を最大に構成します
[tealConfig setLogLevel: TEALLogLevelDev];

Tealiumインスタンスは、トラッキングを開始する前に以下のパラメータで構成する必要があります：