iOS(Objective-C)向けTealium SDKのインストール方法について説明します。
このセクションでは、以前のiOSライブラリであるObjective-C版について説明します。macOS、iOS、watchOS、tvOSなどでは、Swiftが推奨されるプログラミング言語です。Swiftコードは、同じプロジェクト内の既存のObjective-Cファイルと共存でき、Objective-C APIにも完全にアクセスできるため、簡単に導入できます。
要件
- Xcode 7.0以降
- iOS 8.1以降
- タグ管理モバイルプロファイル
- Tealium Customer Data Hubアカウント
サンプルアプリ
Tealiumライブラリ、トラッキングメソッド、および実装のベストプラクティスを理解するために、Tealium for iOSのサンプルアプリを参照してください。
Tealiumの実装をアプリの他の部分から分離するため、TealiumHelperクラスの使用をお勧めします。これにより、初期化やトラッキング呼び出しを行うための単一のエントリポイントを作成できます。また、個々のViewControllerやヘッダー/メソッドファイルを変更することなく、ヘルパーファイル内のコードだけを更新できます。
iOS向けのTealiumクラスとメソッドの完全な一覧については、TealiumIOS APIを参照してください。
インストール
CocoaPods、Carthage、または手動でiOS(Objective-C)向けTealium SDKをインストールします。
CocoaPods
CocoaPodsを使用して、アプリにiOS(Objective-C)向けTealiumをインストールするには(推奨):
Podfileに次の依存関係を追加します。
pod "TealiumIOS"ファイルを保存し、プロジェクトディレクトリで次のコマンドを実行します。
pod install --repo-update作成された
.xcworkspaceファイルを使用して、アプリのビルドを続行します。.xcworkspaceファイルを使用しない場合、アプリを正しくビルドできません。
Carthage
Carthageを使用して、アプリにiOS(Objective-C)向けTealiumをインストールするには:
Cartfileに次の内容を追加します。
github "tealium/tealium-ios"フレームワークをダウンロードして展開するには、次のコマンドを実行します。
carthage update --platform ios --use-xcframeworks必ず
--use-xcframeworksフラグを使用してください。使用しない場合、ビルドが失敗します。これにはCarthage 0.38.0が必要です。ビルド時に必要なフレームワークが自動的にコピーされるように、CarthageがXcodeプロジェクトに正しく統合されていることを確認します。
手動
アプリにiOS(Objective-C)向けTealiumを手動でインストールするには:
TealiumIOS.xcframeworkをプロジェクトに追加します。表示されたダイアログボックスで、フレームワークをプロジェクトにコピーします。
ターゲットで、General > Frameworks, Libraries & Embedded Contentに移動し、「Embed & Sign」オプションを選択して
TealiumIOS.xcframeworkを追加します。
Swiftプロジェクトの場合は、Build Settings > Swift Compiler > Objective-C Bridging Headerオプションに移動し、TealiumIOSBridgingHeader.hファイルを指定します。
初期化
Application Delegate、またはヘルパークラスのセットアップメソッド内で、次の初期化コードを使用します。
// set your account, profile, and environment
let tealConfig = TEALConfiguration.init(account: "ACCOUNT",
profile: "PROFILE",
environment: "ENVIRONMENT",
datasource: "DATASOURCE")
// Initialize with a unique key for this instance
guard let tealium = Tealium.newInstanceForKey("INSTANCE", configuration: tealConfig) else {
// Any additional failure response here
return
}
// import area
@import TealiumIOS;
// Set your account, profile, and environment
TEALConfiguration *tealConfig = [TEALConfiguration configurationWithAccount:@"ACCOUNT"
profile:@"PROFILE"
environment:@"ENVIRONMENT"
datasource:@"DATASOURCE"];
// Initialize with a unique key for this instance
Tealium *tealium = [Tealium newInstanceForKey:@"INSTANCE" configuration:tealConfig];
ログレベルは、デフォルトではiQアカウントのパブリッシュ構成に基づいて構成されます。この構成を上書きするには、TEALConfigurationインスタンスのlogLevelプロパティを構成します。
// Set the log verbosity to errors only
tealConfig.logLevel = .prod
// Set the log verbosity to maximum
[tealConfig setLogLevel: TEALLogLevelDev];
トラッキングを開始する前に、Tealiumインスタンスを次のパラメータで構成する必要があります。
| パラメータ | 型 | 説明 | 例 |
|---|---|---|---|
account | String | Tealiumアカウント名 | "companyXYZ" |
profile | String | Tealiumプロファイル名 | "main" |
environment | String | Tealium環境名 | ["dev", "qa", "prod"] |
datasource | String | (任意)データソースキー | "abc123" |
instance | String | インスタンスの一意の名前(複数のインスタンスをサポート) | "tealium_main" |
最終更新日 :: 2026年November月18日