DispatchQueueモジュール

使用方法

DispatchQueueモジュールは、ConnectivityモジュールおよびConsentManagerモジュールと連動して動作して、デバイスのオフライン時やユーザーがまだトラッキングに同意していない場合に保留中のディスパッチをディスクに格納します。接続が復旧した場合やユーザーがトラッキングに同意した場合は、ディスパッチのキューが送信されます。デフォルトでは、キュー内のディスパッチ数の上限は20です。この上限を超えると、最新のディスパッチを格納するためにディスパッチが古い方から消去されます。データはUserDefaultsに格納されます。

このモジュールの使用は、ConsentManagerモジュールまたはConnectivityモジュールを使用している場合は必須です。それ以外の場合も、初期化前のTealiumCoreモジュールによるキューへのイベント追加を支援することを強く推奨します。

以下のプラットフォームがサポートされています。

• iOS
• tvOS
• watchOS
• macOS

インストール

DispatchQueueモジュールをCocoaPodsまたはCarthageによってインストールします。

CocoaPods

DispatchQueueモジュールをCocoaPodsによってインストールするには、Podfileに以下のポッドを追加します。

pod 'tealium-swift/TealiumDispatchQueue'

フレームワークは自動でインスタンス化され、TealiumCoreポッドに依存しています。iOS向けCocoaPodsのインストールの詳細については、こちらを参照してください。

Carthage

DispatchQueueモジュールをCarthageによってインストールするには、以下の手順に従います。

1. Xcodeで対象アプリの[General]構成ページに移動します。

2. 以下のフレームワークを[Embedded Binaries]セクションに追加します。

   TealiumDispatchQueue.framework

フレームワークは自動でインスタンス化され、TealiumCoreに依存しています。追加のインポートステートメントは必要ありません。iOS向けCarthageのインストールの詳細については、こちらを参照してください。

データ層

モジュールが有効な場合に、トラッキングコールのたびに以下の変数が送信されます。

APIリファレンス

このモジュール用のパブリックAPIメソッドはありません。成功と失敗は、Delegateモジュールを通じて監視できます。

以下の追加のメソッドがTealiumConfigクラスによって提供されます。

setMaxQueueSize()

ディスパッチの保管のために永続的なキューの最大サイズを設定します。デフォルトは20イベントです。

tealConfig.setMaxQueueSize(size)

getMaxQueueSize()

キューの最大サイズを取得します。

tealConfig.getMaxQueueSize();