トラッキング

track()メソッドを使用して、イベントとビューをTealiumおよび構成済みのディスパッチャーに送信します。

イベントのトラッキング

イベントをトラッキングするには、イベント名と、任意のタイプおよびデータをtrack()メソッドに渡します。イベント名は、データレイヤーにtealium_eventとして表示されます。

イベントをトラッキングするには、イベント名とDataObjectを指定してtrack()を呼び出します。

tealium.track("user_login", DataObject.create {
    put("customer_id", "1234567890")
})

追加データなしでイベントをトラッキングするには、次のようにします。

tealium.track("homepage", DataObject.EMPTY_OBJECT)

複数のデータ値を含むイベントをトラッキングするには、次のようにします。

tealium.track("purchase", DataObject.create {
    put("customer_id", "abc123")
    put("order_total", 149.99)
    put("order_id", "0123456789")
})

イベントをトラッキングするには、イベント名と、任意のタイプおよびデータパラメータを指定してtrack()を呼び出します。

// Basic track with default event type and no data
tealium.track("homepage")

// Track with event type and data
tealium.track("user_login", type: .event, data: ["customer_id": "1234567890"])

// Track with view type
tealium.track("homepage", type: .view)

イベントをトラッキングするには、track()を呼び出します。

// Track an event without data
await tealium.track("homepage");

// Track an event with data
await tealium.track("user_login", "event", { customer_id: "1234567890" });

// Track an event with multiple values
await tealium.track("purchase", "event", {
  customer_id: "abc123",
  order_total: 149.99,
  order_id: "0123456789",
});

ビューのトラッキング

画面ビューをトラッキングするには、.viewタイプパラメータを使用します。

tealium.track("product_detail", DispatchType.View, DataObject.create {
    put("product_id", "SKU123")
    put("product_name", "Running Shoes")
    put("product_price", 89.99)
})

tealium.track("product_detail",
    type: .view,
    data: [
        "product_id": "SKU123",
        "product_name": "Running Shoes",
        "product_price": 89.99
    ]
)

await tealium.track("product_detail", "view", {
  product_id: "SKU123",
  product_name: "Running Shoes",
  product_price: 89.99,
});

データオブジェクト

DataObject.createを使用して、トラッキング呼び出し用の構造化データを作成します。DataObject.createは、ネストされたオブジェクトと型付きの値をサポートします。

tealium.track("purchase", DataObject.create {
    put("customer_id", "abc123")
    put("order_total", 249.95)
    put("product_id", DataList.create {
        add("PROD123")
        add("PROD456")
    })
    put("product_price", DataList.create {
        add(4.00)
        add(6.00)
    })
})

イベントデータを辞書リテラルとして渡します。Swiftは、解析処理を行わず、型付きの値からDataObjectを直接作成します。

tealium.track("purchase", data: [
    "order_id": "0123456789",
    "order_total": 149.99,
    "product": ["id": "SKU123", "price": 89.99] as DataObject,
    "tags": ["new", "sale"]
])

ネストされたオブジェクトにはas DataObjectを、オブジェクトの配列にはas [DataObject]を指定します。一部の値がオプショナルの場合は、DataObject(compacting:)を使用します。

データがすでに[String: Any]辞書である場合（解析済みのJSONやクロスプラットフォームブリッジから取得した値など）は、try DataObject(jsonObject:)を使用します。このメソッドはJSONへのラウンドトリップによって辞書を検証するため、リテラルよりも呼び出しごとのコストが高くなります。動的データにのみ使用してください。

プレーンなJavaScriptオブジェクトを3番目の引数として渡します。配列とネストされた値がサポートされています。

await tealium.track("purchase", "event", {
  customer_id: "abc123",
  order_total: 249.95,
  product_id: ["PROD123", "PROD456"],
  product_price: [4.00, 6.00],
});