Tealium for iOS (Objective C) リリースノート
iOS (Objective C) ライブラリの各リリースの変更点の完全なリスト。
5.8.3 (2022年2月)
低影響の変更
TEALConfiguration
にsessionCountingEnabled
フラグを追加し、自己ホスト型のJavaScriptファイルを使用するTealium iQアカウントのセッションカウントを無効にすることができるようになりました。- 優先言語が設定されていないデバイスでクラッシュが発生する可能性がある問題を修正しました。
5.8.2 (2021年8月)
低影響の変更
- アプリの.ipaファイルのアーカイブが成功しない問題を引き起こすLifecycle XCFrameworkファイルの問題を修正しました。
- Carthageは、中間のJSONファイルを必要とせずに、Githubリポジトリから直接XCFrameworksを使用できるようになりました(インストールを参照)。既存のCartfileの参照は更新する必要があります。
- CocoaPodsは現在、XCFrameworkファイルを使用しています。
5.8.1 (2021年6月)
高影響の変更
- Tealium Tag Managementのwebviewがクッキー同期の問題を回避するために使用する
WKProcessPool
インスタンスをTealiumConfig
オブジェクトに設定するオプションを追加しました。
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はUIWebView
APIを使用するアプリの提出を停止します。UIWebView
についてはこちらをご覧ください。ユーザーID/訪問者クッキーが新しい実装にシームレスに移行するように、WKHTTPCookieStoreを用意しています。
中影響の変更
- 最新のAppleデバイス(X, XR, XS, 11, etc)を含むデバイスリストを更新しました。また、デバイス名をハードコーディングするのではなく、JSONファイルからロードするように実装を更新しました。最後に、追加のデバイス詳細を提供する2つの変数を追加しました:
model_name
(例:iPhone 8, iPhone XR Max, iPhone 11 Pro, etc)と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はデフォルトで
UIWebView
の代わりに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の例
// version 4.x & prior
[Tealium trackCallType:TealiumEventCall
customData:@{@"testKey":@"testValue"}
object:nil];
// version 5.x
[Tealium instanceForKey:@"testInstanceID"] trackEventWithTitle:@"buttonClick"
dataSources:@{@"testKey":@"testValue"}];
[Tealium instanceForKey:@"testInstanceID"] trackViewWithTitle:@"mainView"
dataSources:@{@"testKey":@"testValue"}];
// Note: An event or view title is required, but dataSources are still optional
さらに、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で追加できます。
最終更新日 :: 2024年May月15日