Tealium for iOS（Swift）リリースノート

2.12.3（2024年3月）

低影響の変更

• ディスクスペースカテゴリのプライバシーマニフェストNSPrivacyAccessedAPITypeReasonsを修正しました。

2.12.2（2024年2月）

低影響の変更

• CocoaPodsでインストールする際にプライバシーマニフェストとの競合が発生する可能性がある問題を修正しました。

2.12.1（2024年2月）

低影響の変更

• ライブラリのバージョンを最新の（2.12.1）に修正しました。

2.12.0（2024年2月）

中程度の影響の変更

• XCode 15を公式にサポートするようになりました。
• サポートされる最小のオペレーティングシステムバージョンを増やしました：iOS 12.0、TvOS 12.0、およびMacOS 10.14。
• プライバシーマニフェストをSDKに追加し、プライバシーAPIの使用理由を開示します。詳細を見る

2.11.1（2024年1月）

低影響の変更

• 機能に変更はありません。Swift Package Managerの最小サポートオペレーティングシステムバージョンの定義を修正しました。

2.11.0（2024年1月）

中程度の影響の変更

• サポートされる最小のオペレーティングシステムバージョンを増やしました：iOS 11.0、TvOS 11.0、WatchOS 4.0、およびMacOS 10.13。
• Application Supportはテレビでサポートされていないため、TvOSのディスク上のデフォルトディレクトリをApplication SupportからCachesに変更しました。
• iAdフレームワークをAttributionモジュールから削除しました。Appleによって無効化され、近日中に削除される予定です。

低影響の変更

• リモート設定からSDK全体を無効にするオプションを実装しました。
• Macデバイスと最新のiOSデバイスを含むデバイス名のリストを更新しました。
• TealiumVisitorProfileのパースを改善し、null文字列を優雅に受け入れるようにしました。
• エラーログの可読性を向上させました。
• iOSデバイスモデルのリストを更新しました。

既知の問題

• これはXCode 14を対象とした最終リリースです。XCode 15ではiOS 11のサポートが削除されたことに注意してください。XCode 15にインストールするには、インストール後にTealiumライブラリの最小デプロイメントターゲットをiOS 12に手動で増やす必要があります。そうしないと、アプリが起動時にクラッシュします。詳細については、TEALIUM SWIFT BUG: Runtime crash on launch with Xcode 15 Releaseを参照してください。

2.10.1（2023年8月）

低影響の変更

• Objective-Cライブラリからの以前の移行から残ったデータレイヤーのデータ（app_version、uuid、visitor_id、last_track_event、last_session_created）を削除しました。
• +loadメソッドがSwiftクラスのobj-cカテゴリで定義されているため、XCode 15ベータ版でクラッシュする可能性がある問題を修正しました。

2.10.0（2023年5月）

低影響の変更

• TealiumインスタンスでgetTagManagementWebViewメソッドを追加し、クライアントがisInspectableフラグを設定してXCode 14.3+でデバッグできるようにしました。
• 2つのTealiumConfigオブジェクトを比較する際に発生する可能性のあるクラッシュを修正しました。
• いくつかの内部ファイルが意図せずにバックアップされ、異なるデバイスで再利用される可能性のあるエッジケースを修正しました。

2.9.2（2023年4月）

低影響の変更

• 大容量のデータレイヤーの場合の起動パフォーマンスを改善しました。
• 一部の内部モジュールでパブリッシュ設定が正しく更新されないバグを修正しました。

2.9.1（2023年2月）

低影響の変更

• JSONリモートコマンドの複合キーのオーバーライドを導入し、デフォルトの区切り文字（,と:）を新しい構成キーkeys_separation_delimiterとkeys_equality_delimiterで置き換えるためのオーバーライドを追加しました。
• ライブラリを更新する際にデバイス上のTealium内部ファイルがリセットされる可能性のあるバグを修正しました。

2.9.0（2023年1月）

中程度の影響の変更

• iOS 14.5+向けに新しいApple Search Ads APIを実装しました（Attributionモジュール）。
• JSONリモートコマンドに新しい静的オブジェクトマッピングと複合キー機能を追加し、使用の柔軟性を向上させました。

低影響の変更

• デバイス名のルックアップファイルを更新しました。

2.8.2（2022年10月）

低影響の変更

• ビジターIDの切り替え後に古いビジター識別子に対するビジタープロファイルリクエストが実行されないようにしました。

2.8.1（2022年10月）

低影響の変更

• 機能に変更はありません。Carthageでのビルドエラーを解決するために、Carthageでのビルド時にCarthageのためのクラッシュを回避しました。

2.8.0（2022年10月）

低影響の変更

• タグ管理モジュールのコードとスレッドセキュリティを改善しました。
• VisitorServiceのrequestVisitorProfileは、visitorServiceRefresh構成キーで設定されたタイムアウトをスキップするようになりました。
• TealiumクラスのonVisitorIdの変更を通知するためのオブザーバブルを追加し、resetVisitorIdが呼び出された場合や自動的に新しいビジターに切り替わった場合に新しいIDを通知します。
• 新しいビジター切り替えAPIのためのvisitorIdentityKey構成キーを追加しました。
• app_uuidストレージをデータレイヤーに移行し、必要に応じてアプリケーションが削除できるようにしました。
• 現在のおよび以前のIDのすべてのストアドビジターIDを削除し、現在のvisitorIdをリセットするためのclearStoredVisitorIdsメソッドをTealiumクラスに追加しました。
• AdobeVisitorServiceモジュールのdecorateUrlメソッドを追加し、AdobeクエリパラメータをURLに追加します。

新機能

• Adobe ECIDのクエリパラメータプロバイダ機能をTag Managementモジュールに追加し、WebビューURLにAdobeクエリパラメータを追加します。
• リモートコマンドでall_eventsおよびall_viewsのコマンドマッピングをサポートし、それぞれイベントとビューでトリガーされます。
• ビジター切り替えのサポートを追加しました。

2.7.0（2022年9月）

低影響の変更

• SKAdNetworkの呼び出しを更新し、iOS 15の場合はupdatePostbackConversionValueを使用するようにしました。

高影響の変更

• trackUserConsentCategoriesへの初回呼び出しを削除しました。これにより、それが呼び出されることを期待している場合に影響を与える可能性があります。

新機能

• カスタムサーバーサイドの同意の強制をサポートするために、Tealium同意カテゴリ属性の名前を上書きするためのoverrideConsentCategoriesKey構成オプションを追加しました。

2.6.5（2022年5月）

低影響の変更

• 機能に変更はありません。プリビルドフレームワークでコンパイルエラーが発生する問題を修正しました。

2.6.4（2022年5月）

低影響の変更

• ビジタープロファイルのためのビジターIDの格納と更新ロジックを改善しました。
• アプリケーションの内部ファイルが意図せずにバックアップされ、異なるデバイスで再利用される可能性のあるエッジケースを修正しました。

2.6.3（2022年3月）

低影響の変更

• パブリッシュ設定が複数回取得される可能性のあるバグを修正しました。
• untilRestartの有効期限を持つdataLayer変数が削除されないバグを修正しました。
• 次のLocationモジュールは、それぞれのゲッターに置き換えられました：
  • createdGeofences -> getCreatedGeofences(completion:)
  • lastLocation -> getLastLocation(completion:)
  • monitoredGeofences -> getMonitoredGeofences(completion:)

2.6.2（2022年2月）

低影響の変更

• セッションの2番目のイベントでセッションヒットが送信されるようにセッションカウントロジックを修正しました。

2.6.1（2022年2月）

低影響の変更

• 列挙型ベースのエラーのログを改善しました。
• TealiumConfigのsessioncountingenabledフラグを追加し、セルフホスト型のJavaScriptファイルを使用するTealium iQアカウントでのセッションカウントを無効にすることができるようにしました。

2.6.0（2022年1月）

中程度の影響の変更

• 新しいTealiumInAppPurchaseモジュールを追加し、アプリ内購入を自動的にトラッキングします。

低影響の変更

• データレイヤーとCollectorの変数をすべてTealium.gatherTrackData()メソッドを使用して利用できるようにしました。
• TealiumKeysをTealiumDataKeysに名前変更し、gatherTrackData()で使用するために追加しました。
• リリースビルドでは非コーダブルな値を無視し、デバッグビルドではクラッシュするようにすることで、Codableのサポートを改善しました。
• ジオフェンスの読み込みに対するメインスレッドの使用を減らしました。

既知の問題

• CocoaPodsプラットフォームのiOSバージョンは、リンティングの問題により11に増加しています（ただし、必要に応じてポストインストールスクリプトで9に下げても安全です）。
• CarthageはXcode 13で警告を生成します（https://github.com/Carthage/Carthage/issues/3238）。

2.4.6（2021年10月）

低影響の変更

• HTTPリクエストを内部コマンドに送信する前にRemoteCommandを解放するとクラッシュする可能性のあるバグを修正しました。
• セッションが30分を超える場合にデータレイヤー変数が永続化されないバグを修正しました。
• batterySaver機能が無効化されている場合にisLowPowerModeEnabled通知の登録を回避し、iOS 15の内部デッドロックでクラッシュする可能性を回避しました。
• トラッキング設定が正しく更新されないバグを修正しました。

2.4.5（2021年9月）

高影響の変更

• Apple Watchでのトラッキングができないバグを修正しました。
• AppDelegateでのディープリンクトラッキングができないバグを修正しました。

中程度の影響の変更

• Objective-Cライブラリからの移行時にライフサイクルモジュールがクラッシュする問題を修正しました。

低影響の変更

• 構成内のvisitorServiceDelegateとwebViewDelegatesを弱参照に変更し、メモリリークの可能性を回避しました。
• 同じcommandIdを持つ2つのリモートコマンドの競合を回避するためのチェックを追加しました。
• ディープリンクが自動的に検出され、リファラが存在する場合、またはTealium.handleDeepLink(_:referrer:)に渡された場合に追加される新しいキーdeep_link_referrer_appとdeep_link_referrer_urlを追加しました。
• ディープリンクのクエリパラメータの処理を改善し、同じセッション中に複数のディープリンクを受け取る場合に古いクエリパラメータを削除するようにしました。
• 最新のiPhone、iPad、およびApple Watchモデルを含むデバイスモデル名のリストを更新しました。

2.4.4（2021年9月）

• パブリッシングの問題により、バージョンがスキップされました。

2.4.2（2021年8月）

低影響の変更

• IDFAとATTの承認ステータスが実行時に更新されない可能性のあるバグを修正しました。

2.4.1（2021年7月）

低影響の変更

• IDFAとATTの承認ステータスが実行時に更新されない可能性のあるバグを修正しました。
• Objective-Cライブラリからの移行がデフォルトで無効になっていたバグを修正しました。

2.4.0（2021年7月）

中程度の影響の変更

• 同意のステータスの有効期限を設定し、ステータスが期限切れになったときにトリガーされるコールバックを設定するオプションを追加しました。同意管理について詳しく見る。
• ユーザーのビジターIDをリセットするためのパブリックメソッドを追加しました。resetVisitorIdを参照してください。
• Tealiumのリリース時にLifecycleリスナーを削除しました。

低影響の変更

• TealiumCoreを埋め込みフレームワークから削除し、Carthageを使用して依存関係を設定している場合にAppStoreの提出エラーが発生する問題を解決しました。
• Carthageでビルドするためにtealium-swift.xcodeproj内のTealiumAttributionスキームを再追加しました。

2.2.2（2021年1月）

低影響の変更

• パーシステントデータがiOS 14.7+にアップグレードする際に削除されないように、パーシステントストレージモジュールを更新しました。

低影響の変更

• リモートコマンドのタグオプションを使用している場合、関連するTiQアカウント/プロファイルのmobile.htmlテンプレートも更新する必要があります。この操作を実行しないと、Tealiumで重複したセッションが記録されます。テンプレートの更新方法については、テンプレートについてを参照するか、アカウントマネージャーに連絡してサポートを受けてください。

2.2.1（2021年1月）

低影響の変更

• Carthageを使用して依存関係を設定している場合、AppStoreの提出エラーが発生する問題を解決するために、埋め込みフレームワークとしてのTealiumCoreを削除しました。

2.2.0（2020年11月）

新機能

• 同意管理モジュールにCCPA APIを追加しました。同意管理のドキュメントで詳細を確認してください。
• ネイティブホストされたデータレイヤーサポート
• ユーザーがアプリをディープリンク、ユニバーサルリンク、またはクエリ文字列パラメータから開いた場合に、ディープリンクURL、ユニバーサルリンクURL、およびクエリ文字列パラメータをデータレイヤーに追加する自動ディープリンクトラッキング
• Customer Data Hub UIからQRコードをスキャンしてトレースを開始する機能
• Appleが推奨するOSLogを使用する新しいTealiumLoggerを追加しました。TealiumConfigオブジェクトのlogTypeプロパティを設定することで、引き続きprintを使用するオプションもあります。ログ記録について詳しく読む。
• パフォーマンスの向上のために、複数の補助モジュールをCoreライブラリに統合し、インストールがより迅速かつ簡単になりました。詳細については、モジュールセクションを参照してください。
• より明確なスクリーンとイベントのトラッキングを提供するために、track()メソッドを更新しました。更新されたtrack()メソッドについて詳しく読む。
• データ変数の有効期限のオプションをサポートするようになりました。詳細については、データレイヤーを参照してください。
• セッションカウントのロジックを使用せずにネイティブのセッションカウントをサポートするようになりました。これにより、より正確なセッションカウントが可能になり、バックグラウンドのアクティビティが新しいセッションをトリガーし、予想よりも高いセッションカウントが発生するエッジケースが修正されます。

⚠️重要⚠️ タグ管理モジュールをディスパッチオプションとして使用している場合、関連するTiQアカウント/プロファイルの関連するmobile.htmlテンプレートも更新する必要があります。この操作を実行しないと、Tealiumで重複したセッションが記録されます。テンプレートの更新方法については、テンプレートについてを参照するか、アカウントマネージャーに連絡してサポートを受けてください。

高影響の変更

• Swiftのベストプラクティスに合わせてAPIを更新しました。
• パフォーマンスを向上させるためにモジュールシステムを最適化しました。
• パフォーマンスを向上させるために各モジュールを最適化しました。
• APIのシンプルさのために複数のデリゲートオプションを削除しました。
• 接続のチェックを改善しました - サポートされているデバイスではNWPathMonitorを使用します。
• プロジェクトからCrashReporterモジュールを削除し、使用する場合は別のリポジトリに追加しました。
• RemoteCommandsモジュールのNotificationCenterを削除し、デリゲートパターンに置き換えました。

低影響の変更

• テスト可能性のためにより多くのプロトコルと結果タイプを追加しました。
• 一貫性のあるクラス名を更新しました。
• インラインのコードドキュメントを追加しました。
• ユニットテストを更新し、パフォーマンステストを追加しました。

2.x以前のリリースノートについては、Tealium for Swift 1.xを参照してください。