データレイヤー

データレイヤーには、追跡されているページに関する基本情報を収集するための組み込み変数が含まれています。これらの変数には、クッキー、ページの標準DOM変数、およびロードされた構成に関するTealium固有の変数が含まれます。

利用可能なデータレイヤー変数の種類については、詳細を見ることができます。

標準ページデータ

次の変数は、Webページの利用可能な標準JavaScriptプロパティから生成されます。

以下の例の値は、次のページURLに基づいています。

http://www.example.com/path/file.html?param1=value1#hash=fragment

クッキー

次の変数は、単一のTEALという名前のクッキーに格納され、維持されます。各変数はTEALオブジェクト内の変数です。

以下は、TEALクッキーのdocument.cookie形式の例であり、変数の値が$文字で区切られていることを示しています。

TEAL=v:927b2ebc092a70110329356772472215264145f9fa1$t:1628543914615$s:1628542077230%3Bexp-sess$sn:1$en:3

Tealiumデータ

例のデータ

以下は、自動的に利用可能な組み込みデータレイヤーの例です。

{
        "cp._ga": "GA1.2.1370368844.1628542067",
        "cp._gid": "GA1.2.73283117.1628542067",
        "tealium_session_number": 1,
        "tealium_session_event_number": 3,
        "tealium_session_id": "1628542077230",
        "tealium_visitor_id": "927b2ebc092a70110329356772472215264145f9fa1",
        "dom.referrer": "",
        "dom.title": "Example dot com",
        "dom.domain": "example.com",
        "dom.query_string": "",
        "dom.hash": "",
        "dom.url": "https://example.com/",
        "dom.pathname": "/",
        "dom.viewport_height": 936,
        "dom.viewport_width": 1517,
        "meta.description": "View",
        "meta.viewport": "width=device-width, initial-scale=1",
        "meta.theme-color": "#13B0E9",
        "tealium_cookie_domain": "example.com",
        "tealium_domain": "example.com",
        "tealium_event": "test event",
        "tealium_account": "xxxxxxxxxxxx",
        "tealium_profile": "main",
        "tealium_environment": "prod",
        "tealium_datasource": "test1234",
        "tealium_random": "9870188345895229",
        "tealium_library_name": "tealium.js",
        "tealium_library_version": "5.0.3",
        "tealium_timestamp_epoch": 1628542114,
        "tealium_timestamp_utc": "2021-08-09T20:48:34.616Z",
        "tealium_timestamp_local": "2021-08-09T13:48:34.616",
        "timing.domain": "example.com",
        "timing.pathname": "/",
        "timing.query_string": "",
        "timing.timestamp": 1628542085435,
        "timing.dns": 1,
        "timing.connect": 99,
        "timing.response": 0,
        "timing.dom_loading_to_interactive": 7,
        "timing.dom_interactive_to_complete": 129,
        "timing.load": 0,
        "timing.time_to_first_byte": 95,
        "timing.front_end": 163,
        "timing.fetch_to_response": 210,
        "timing.fetch_to_complete": 373,
        "timing.fetch_to_interactive": 244
}

データレイヤー変数のフラット化方法

Google Tag Managerのイベントは、Tealium Customer Data Hubの仕様に準拠するために、Tealium属性名にフラット化されます。イベントデータはTealium EventStreamで受け取られます。

tealium_eventの値は、dataLayer.push呼び出しのeventの値です。Google Tag Managerは、デフォルトのページビュー値をgtm.jsとしてイベントの名前に構成します。デフォルトを上書きするには、Tealiumイベントの構成を、イベント名を含む変数に構成します。

属性は自動的に追加されません。これらの属性をTealium EventStreamに追加する必要があります。

Eコマース

以下の購入イベントの例は、クライアントサイドのEコマースイベントがフラット化される方法を示しています。

dataLayer.push({
  'ecommerce': {
    'purchase': {
      'actionField': {
        'id': 'T12345',    // トランザクションID。購入と返金に必要です。
        'affiliation': 'オンラインストア',
        'revenue': '35.43',
        'tax':'4.90',
        'shipping': '5.99',
        'coupon': 'SUMMER_SALE'
      },
      'products': [{
        'name': 'Triblend Android T-Shirt',     // 名前またはIDが必要です。
        'id': '12345',
        'price': '15.25',
        'brand': 'Google',
        'category': 'アパレル',
        'variant': 'グレー',
        'quantity': 1,
        'coupon': ''
       },
       {
        'name': 'Donut Friday Scented T-Shirt',
        'id': '67890',
        'price': '33.75',
        'brand': 'Google',
        'category': 'アパレル',
        'variant': 'ブラック',
        'quantity': 1
       }]
    }
  }
});

フラット化後、購入イベントは次のようになります。

"ecommerce.purchase.actionField.affiliation": "オンラインストア"
"ecommerce.purchase.actionField.coupon": "SUMMER_SALE"
"ecommerce.purchase.actionField.id": "T12345"
"ecommerce.purchase.actionField.revenue": "35.43"
"ecommerce.purchase.actionField.shipping": "5.99"
"ecommerce.purchase.actionField.tax": "4.90"
"ecommerce.purchase.products.brand": [ "Google", "Google" ]
"ecommerce.purchase.products.category": [ "アパレル", "アパレル" ]
"ecommerce.purchase.products.coupon": [ "", "" ]
"ecommerce.purchase.products.id": [ "12345", "67890" ]
"ecommerce.purchase.products.name": [ "Triblend Android T-Shirt", "Donut Friday Scented T-Shirt" ]
"ecommerce.purchase.products.price": [ "15.25", "33.75" ]
"ecommerce.purchase.products.variant": [ "グレー", "ブラック" ]
"ecommerce.purchase.products.quantity": [ "1", "1" ]

フラット化プログラムは、キーを作成するためにドット表記を使用し、値は購入イベントのすべての値の配列に構成されます。

イベント

次のdataLayer.pushコマンドは、データレイヤーに「event」が含まれている場合に発火します。

window.dataLayer.push({
  event: "test_number",
  type_number: 5,
  type_string: 'hello',
  type_object: { someKey: 'someValue' },
  type_array: [1,2,3,4],
  type_function: function() { return 'hello'; },
  type_boolean: true
});

Tealium EventStreamに到着するデータレイヤーは、次のようになります。type_objectのみがフラット化され、関数は削除されます。

{
    "event": "test_number",
    "type_number": 5,
    "type_string": "hello",
    "type_object.someKey": "someValue",
    "type_array": [1, 2, 3, 4],
    "type_boolean": true
}