リリースノート | iOS（Objective-C）用Tealium | Tealium開発者ドキュメントプレビュー

以下は、iOSライブラリの各リリースの変更点のリストです。

5.8.3 (2022年2月)

低影響の変更

TEALConfigurationにsessionCountingEnabledフラグを追加し、自己ホスト型のJavaScriptファイルを使用するTealium iQアカウントのセッションカウントを無効にすることができるようにしました。
優先言語がないデバイスで発生する可能性があるクラッシュを修正しました。

5.8.2 (2021年8月)

低影響の変更

Lifecycle XCFrameworkファイルの問題を修正し、アプリの.ipaファイルのアーカイブが成功するようにしました。
Carthageは、中間のJSONファイルを必要とせずに、Githubリポジトリから直接XCFrameworksを使用できるようになりました（インストールを参照）。既存のCartfile参照は更新する必要があります。
CocoaPodsは現在、XCFrameworkファイルを使用しています。

5.8.1 (2021年6月)

高影響の変更

Tealium Tag Managementのwebviewがクッキー同期の問題を避けるために使用するTealiumConfigオブジェクトにWKProcessPoolインスタンスを構成するオプションを追加しました。

5.8.0 (2021年2月)

中影響の変更

モバイルセッションタイマーを正しくするために、platform変数の値を小文字にしました。以前は、セッションはウェブと同様に（一貫した活動の30分）測定されていました。platform変数を小文字にすることで、Customer Data Hubは受信データをモバイルセッションと認識し、セッションの長さが2分に短縮されます。

大文字小文字を区別するplatform値（iOS vs iosなど）をチェックするLoadまたはAttribute Rulesが構成されている場合は、ロードルールを更新してください。

低影響の変更

ビルド警告を解決し、非推奨のAPIを更新しました。

5.7.0 (2020年8月)

高影響の変更

utag.js内のセッションカウントロジックの代わりにネイティブセッションカウントをサポートしました。これにより、セッションカウントがより正確になり、バックグラウンド活動が新しいセッションをトリガーするというエッジケースが修正され、予想以上にセッションカウントが増える問題が解決しました。

⚠️ 重要 ⚠️ モバイルパブリッシュ構成でTag Managementが有効になっている場合、関連するアカウント内のmobile.htmlテンプレートも更新する必要があります。このアクションが実行されない場合、Tealiumに重複したセッションが記録されます。テンプレートの更新方法については、こちらをご覧ください。

5.6.6 (2020年1月)

低影響の変更

バグ修正。removeRemoteCommandIDのログフォーマットを更新しました。

5.6.5 (2019年11月)

低影響の変更

tealium_session_idを揮発性データ変数に追加し、簡単に取得して使用できるようにしました。

5.6.4 (2019年10月)

低影響の変更

モデルのApple内部識別子（例："iPhone10,4"）を含む追加のdevice_type変数を追加しました。

5.6.3 (2019年10月)

低影響の変更

バグ修正。destroyInstanceForKeyメソッドを更新し、TEALDispatchService配列を反復処理しながら安全にディスパッチサービスを削除できるようにしました。

5.6.2 (2019年10月)

低影響の変更

デバイスとモデルのリストを更新し、デバイス、model_name、model_variant変数を作成するために使用する最新のiPad 7世代モデルを含めるようにしました。
デバイスリストに一致が見つからない場合に、基本的なモデル名（iPhone 10、4など）を使用するようにする追加のロジックを追加しました。

5.6.1 (2019年10月)

低影響の変更

Carthageのインストールが成功しない原因となっていたDevicesOnlyフレームワークフォルダを削除しました。#99

5.6.0 (2019年10月)

高影響の変更

UIWebViewを完全に削除し、AppleがiOS 8.0以降でUIWebViewを非推奨としているため、WKWebViewのみをサポートするようにしました。訪問のセッションと分析履歴が維持されるように、便宜上UIWebViewのサポートを続けていました。しかし、ITMS-90809: Deprecated API Usage - AppleはUIWebViewAPIを使用するアプリの提出を停止します。UIWebViewについては、こちらをご覧ください。UIWebViewで使用されていたクッキーをWKWebViewに移行するWKHTTPCookieStoreを用意しています。これにより、ユーザーID/訪問クッキーは新しい実装にシームレスに移行します。

中影響の変更

最新のAppleデバイス（X、XR、XS、11など）を含むデバイスリストを更新しました。また、デバイス名をハードコーディングするのではなく、JSONファイルからロードするように実装を更新しました。最後に、追加のデバイス詳細を提供する2つの変数を追加しました：model_name（iPhone 8、iPhone XR Max、iPhone 11 Proなど）とmodel_variant。例えば、"GSM"、"WiFi"、"model A1457, A1518, A1528"などです。追加のモデル情報が利用できない場合、標準のdevice変数は次のように表示されます："iPhone 10,0"。

5.5.4 - 5.5.5 (2019年8月)

低影響の変更

トラックコールごとにビューに再接続する機能を追加しました。これにより、ビュー階層が変更された場合でもTealiumを再初期化する必要がなくなりました。あなた自身のアプリでの検証が必要です。プッシュ通知から起動されるビューを含む、アプリのさまざまな画面でトラッキングコールがアプリから出ていることを確認してください。

5.5.3 (2019年7月)

高影響の変更

WKWebViewのUIView自動検出ロジックが改善され、複雑なビュー階層を持つほとんどのケースをカバーできるようになりました。これにより、webview構成で手動でUIViewインスタンスを渡す必要がなくなりました。あなた自身のアプリでの検証が必要です。プッシュ通知から起動されるビューを含む、アプリのさまざまな画面でトラッキングコールがアプリから出ていることを確認してください。

5.5.2 (2019年7月)

低影響の変更

これがクラッシュを引き起こしているようだったので、webviewへの各コールでのトレースIDクッキーチェックを削除しました。これはUIWebViewとはうまく機能しましたが、WKWebViewでは問題を引き起こすようでした。Tealiumのインストール検証とデバッグ方法については、Tealium Mobile Appsのデバッグを参照してください。

5.5.1 (2019年12月)

低影響の変更

captureTimeDataSourcesForTypeメソッドを修正し、clientVolatileDataSourcesを直接使用するのではなく、volatileDatasourcesCopyを使用するようにしました。これにより、addToVolatileDataSourcesメソッドは別のスレッドから安全に呼び出すことができるようになりました。

5.5.0 (2019年4月)

高影響の変更

Tag ManagementはデフォルトでWKWebViewを使用するようになりました。アップグレード前にTag Managementのドキュメンテーションを注意深く読んでください。

低影響の変更

WKWebViewの更新/変更を示す新しいサンプルアプリを追加しました。

4.xから5.xへの移行

5.xで追加された機能

Collect、Compact、Fullライブラリが1つのライブラリに統合されました
リモートで構成可能なディスパッチサービス
マルチインスタンスサポート
ディスパッチを監視または編集するためのデリゲート

4.xで削除された機能

ライフサイクルトラッキング
UIイベント自動トラッキング
モバイルコンパニオン

別のモジュールとして追加できます。

データレイヤーの違い

バージョン5.xは現在、4.xライブラリから利用可能なデータレイヤー変数の一部を使用しています。ただし、以前のすべての変数は、データレイヤーに存在し、将来の5.xオプションクラスと更新がそれらを使用するようになります。

APIの違い

バージョン5.xは、バージョン4.xとは全く異なる一連のAPIを使用しています。主な違いは2つあります：

インスタンスキー（任意の文字列）を必要とするマルチトンインスタンスが、シングルトンインスタンスコールを置き換えます。SDKはこれを使用してライブラリのそのインスタンスを参照します。
シングルトラックコールを置き換えるイベントとビューの変更コール

Objective-Cの例

// バージョン4.x以前
[Tealium trackCallType:TealiumEventCall
    customData:@{@"testKey":@"testValue"}
    object:nil];

// バージョン5.x
[Tealium instanceForKey:@"testInstanceID"] trackEventWithTitle:@"buttonClick"
    dataSources:@{@"testKey":@"testValue"}];
[Tealium instanceForKey:@"testInstanceID"] trackViewWithTitle:@"mainView"
    dataSources:@{@"testKey":@"testValue"}];
// 注意：イベントまたはビューのタイトルは必須ですが、dataSourcesは引き続きオプションです

さらに、useHttpsオプションはiOS 9（2015年9月）以降では不要となりました。Appleは、すべてのURL通信に対してHTTPSとTLS 1.2+のサポートを必須としています（アプリ開発者が明示的に上書きしない限り）。

Appleの公式ドキュメンテーション（App Transport Securityセクション）を参照してください。

Tealium iQ Tag Management構成の違い

バージョン5.xでは、新しいリモート構成オプションが利用可能です。アカウントが以前に4.xを使用していた場合は、以下の手順を実行します：

Tealium iQでSave/Publishをクリックし、次に**Configure Publish Settings…**をクリックします。
Mobile Library Publishingをクリックします。
+ Add Versionをクリックし、Mobile SDK 5.0を選択します。
Addをクリックし、次にSaveをクリックします。
任意の公開詳細を入力し、更新された構成を公開します。

Tag Managementはデフォルトで_無効_になっています。ネイティブモバイルアプリケーションからタグを実行するために有効にします。Tag Managementが有効になっている場合、重複したリクエストを送信しないようにCollectをオフにします。CollectタグはTealium iQで追加できます。