Moments APIモジュール

Moments APIモジュールを使用すると、Tealium AudienceStreamから訪問プロファイルの詳細情報を取得できます。この情報は、オーディエンス、バッジ、文字列、ブール値、日付、数値などのさまざまな属性にアクセスして、アプリ内の顧客体験を向上させるために使用できます。

サポートされているプラットフォーム

以下のプラットフォームがMoments APIモジュールをサポートしています：

• iOS
• macOS
• tvOS
• watchOS

インストール

Swift Package Manager、CocoaPods、またはCarthageを使用してMoments APIモジュールをインストールします。

Swift Package Manager（推奨）

1. Xcodeプロジェクトで、File > Swift Packages > Add Package Dependencyを選択します。
2. リポジトリURLを入力します：https://github.com/tealium/tealium-swift
3. バージョンルールを構成します。通常、"Up to next major"が推奨されます。現在のTealium Swiftライブラリバージョンがリストに表示されない場合は、Swiftパッケージキャッシュをリセットします。
4. インストールするモジュールのリストからTealiumMomentsAPI、TealiumCore、およびTealiumCollectまたはTealiumTagManagementモジュールを選択し、それらをXcodeプロジェクトの各アプリターゲットに追加します。これはFrameworks and Librariesの下にあります。

CocoaPods

Podfileに以下のpodsを追加します：

pod 'tealium-swift/Core'
pod 'tealium-swift/Collect' // or 'tealium-swift/TagManagement'
pod 'tealium-swift/MomentsAPI'

Carthage

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

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

   TealiumMomentsAPI.xcframework
   

3. 必要なインポート文をプロジェクトに追加します：

   import TealiumCore
   import TealiumCollect // or import TealiumTagManagement
   import TealiumMomentsAPI
   

使用法

初期化

モジュールを初期化するには、TealiumConfigのcollectorsプロパティで指定されていることを確認します。

config.collectors = [Collectors.MomentsAPI]
config.momentsAPIRegion = .us_east // 下記の可能なリージョンオプションを参照

リージョンの構成は必須です。これが欠けていると、Moments APIモジュールは初期化されません。

訪問データの取得

fetchEngineResponseメソッドを呼び出して、パーソナライズされた訪問データを取得します。これは、アプリ内のパーソナライゼーションのユースケースを実現するために、更新された訪問情報が必要なときに呼び出すべきです。

func fetchMoments(engineId: String, completion: @escaping (Result<EngineResponse, Error>) -> Void) {
    tealium?.momentsAPI?.fetchEngineResponse(engineID: engineId) { engineResponse in
        switch engineResponse {
        case .success(let response):
            print("String attributes:", response.strings ?? [])
            print("Boolean attributes:", response.booleans ?? [])
            print("Audiences:", response.audiences ?? [])
            print("Date attributes:", response.dates ?? [:])
            print("Badges:", response.badges ?? [])
            print("Numbers:", response.numbers ?? [:])
        case .failure(let error):
            print("Error fetching moments:", error.localizedDescription)
            if let suggestion = (error as? LocalizedError)?.recoverySuggestion {
                print("Recovery suggestion:", suggestion)
            }
        }
        completion(engineResponse)
    }
}

訪問プロファイルデータ

EngineResponseオブジェクトには、Moments APIが返すさまざまなタイプの属性が含まれています。以下の表は、利用可能なプロパティとそのデータタイプを示しています：

構成オプション

リージョン

AudienceStreamプロファイルが存在する場所に応じて、Moments APIのリージョンを構成します。不確かな場合は、アカウントマネージャーに相談してください。

config.momentsAPIRegion = .us_east

カスタムオプションは将来の拡張のためのものであり、指示がない限り使用しないでください。

リファラー

追加のセキュリティのために、リファラーURLを指定できます。このURLはTealium UIの"Domain Allow List"と一致する必要があります。そうでない場合、Moments APIはデータを返しません。デフォルトのリファラーURLは次のとおりです：

https://tags.tiqcdn.com/utag/{account}/{profile}/{environment}/mobile.html

以下のようにカスタムリファラーURLを指定します：

let config = TealiumConfig(
    account: "tealiummobile",
    profile: "demo",
    environment: "prod"
)
config.momentsAPIReferrer = "https://example.com/"
tealium = Tealium(config: config) { _ in
    // Initialization complete
}

トラブルシューティング

一般的なエラー

Moments APIからデータをリクエストするときにエラーが発生することがあります。以下の表は、発生可能なエラーを示しています：