接続性モジュール

仕組み

接続性モジュールは、AppleのReachability APIを使用してネットワーク接続を監視し、デバイスがネットワーク接続を報告しない場合、自動的にディスパッチをキューに入れます。

トラッキングコールが送信されるたびに、モジュールは現在の接続状態を確認し、インターネットが到達不可能な場合はリクエストのキューを開始します。新しいトラッキングコールが受信されるたびに、再度接続状態を確認し、接続状態が再び到達可能に変わった場合は、以前にキューに入れられたリクエストがすべて送信され、キューがクリアされます。

さらに、1.6.5以降、接続状態はデフォルトで30秒ごとに自動的に確認されます（TealiumConfigで上書き可能）。状態が「到達不可能」から「到達可能」に変わった場合、キューは自動的にフラッシュされます（つまり、キュー内のすべてのトラッキングコールがディスパッチされます）。

自動接続チェックは、接続状態が「到達可能」に変わったときにキャンセルされ、状態が「到達不可能」に検出されたときに再開します。これにより、必要なときだけ接続の変更を監視することでリソースを節約します。

使用法

このモジュールの使用は強く推奨されます。これがないと、デバイスがオフラインの場合、ディスパッチが失敗し、ドロップされます。

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

• iOS
• tvOS
• macOS
• watchOS

要件

• SystemConfiguration
• TealiumDispatchQueue. コンパイル時の依存関係ではないですが、このモジュールが含まれていない場合、ディスパッチは正常に保存されません。

インストール

CocoaPodsまたはCarthageで接続性モジュールをインストールします。

CocoaPods

CocoaPodsで接続性モジュールをインストールするには：

1. Podfileに以下のpodを追加します：

   pod 'tealium-swift/TealiumConnectivity'
   

2. ディスパッチを永続化するための接続性モジュールを使用する際に必要なpodを追加します：

   pod 'tealium-swift/TealiumDispatchQueue'
   

フレームワークは自動的にインスタンス化されます。TealiumCore podに依存しています。iOSのCocoaPodsインストールについてはこちらをご覧ください。

Carthage

Carthageで接続性モジュールをインストールするには、以下の手順を実行します：

1. Xcodeのアプリターゲットの一般構成ページに移動します。

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

   TealiumConnectivity.framework
   TealiumDispatchQueue.framework
   

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

データレイヤー

モジュールが有効な間、以下の変数が各トラッキングコールとともに送信されます：