• 手引き
  • プラットフォーム
  • パートナー
  • English
  • TLC Tealium Learning Center Tealium Learning
    Community
  • Discussions & Ideas Dicussions & Ideas
  • Product Guides Product Guides
  • Knowledge Base Knowledge Base
  • Developer Docs Developer Docs
  • Education Education
  • TLC Blog TLC Blog
  • Support Desk Support Desk
  • CDH Customer Data Hub Customer Data Hub

目次

  • ユニバーサルデータオブジェクト(UDO)
    • 構文ガイドライン
  • 例
    • 標準ページ
    • ページ固有のデータ
    • 製品配列
    • 配列の整合性
JAVASCRIPT

ユニバーサルデータオブジェクト(utag_data)

ユニバーサルデータオブジェクト(utag_data)およびそれによって利用可能となるさまざまなタイプのウェブページデータについて説明します。

ユニバーサルデータオブジェクト(UDO)

データレイヤーはTealiumソリューションの基盤であり、すべてのデジタル資産と顧客インタラクション全体にわたって唯一の真実のデータを定義する機能を果たします。データレイヤーは、サイト全体で収集されるさまざまな変数と、トラッキングされる訪問者とのやり取りやイベントで構成されます。

データレイヤーはutag_dataと呼ばれるJavaScriptオブジェクトとしてウェブサイト上に実装されます。このオブジェクトでは、ページから取得したデータにTealiumタグが適用されます。このオブジェクトのプロパティには、ビジネスに合わせてベンダーに依存しないわかりやすい名前を使用します。

以下はutag_dataの宣言の例です。

<script type="text/javascript">
  var utag_data={
      "tealium_event"  : "search",
      "page_name"      : "Search Results",
      "search_results" : "42",
      "search_keyword" : "Tealium shirt"};
</script>

ユニバーサルタグ(utag.js)を読み込む前に、utag_dataオブジェクト変数を定義してこの変数に値を入力する必要があります。

utag.jsはページを読み込むと、utag_data変数を探し、そのデータを使用して、自動でutag.view()を介してページビューのトラッキングコールをトリガーします。単一ページのアプリケーションを使用しているか、またはutag.view()を手動でコールしている場合は、utag_dataが不要な場合があります。 

ページトラッキングオプションの詳細については、こちらを参照してください。

構文ガイドライン

UDOを実装する場合は、従うべき一定のガイドラインがあります。これらのガイドラインは、実装においてエラーや不統一を避けるためだけでなく、JavaScriptおよびTealiumの標準に準拠するためにも必要です。

  • 文字列値 ブーリアン値データや数値データを含むすべての変数に文字列値を使用します。
  • エスケープ引用符 すべての値を二重引用符または一重引用符で囲み、値そのものに出現する可能性のある引用符をエスケープします。たとえば、utag_data.page_name = 'It's All About the Data!';などです。
  • ブーリアン値 ブーリアン値には、trueとfalseを表す"1"と"0"を使用します。これは、文字列を使用してブーリアン値を表す最も簡単な方法です。
  • 金額値 すべての金額に文字列を使用し、すべての通貨記号とカンマを除外します。たとえば、"$1,234.00"ではなくutag_data.order_total = "1234.00";のようにします。 
  • 配列値 製品関連のすべての変数に配列値を使用します。Tealiumライブラリと各ベンダータグ統合は、製品関連のすべてのデータに対して配列を使用するよう設計されています。たとえば、ID、価格、数量などです。 
    utag_data.product_id = ["P1234", "P4567", "P7890"];
  • 余分なコードの回避 UDOスクリプトブロックに余分なコードを追加しないでください。同じスクリプトブロック内のコードが実行に失敗する場合は、UDOが正しく定義されていない可能性があり、予期しないデータがベンダータグに渡される可能性があります。

例

標準ページ

以下は、ページに表示されるとおりの_サンプル_のUDOです。この例では、カートに2つの製品が入っている状態で”ショッピングカート”のページに表示される可能性があるプロパティを示しています。

<script type="text/javascript">
  var utag_data = {
    "tealium_event"      : "cart_add",
    "country_code"       : "US",    
    "currency_code"      : "USD",    
    "page_name"          : "Cart: View Shopping Bag",   
    "page_type"          : "cart",    
    "product_id"         : ["PROD123", "PROD456"],    
    "product_name"       : ["Red Shoes", "Black Socks"],
    "product_category"   : ["Footwear", "Apparel"],    
    "product_quantity"   : ["1", "2"],    
    "product_unit_price" : ["65.00", "4.75"],    
    "cart_total_items"   : "3",    
    "cart_subtotal"      : "74.00"};
</script>

必要な場合は、宣言ブロックの外にある追加の値でUDOを更新します。ただし、utag.jsを読み込む前にそのデータを設定する必要があります。utag.jsの読み込み後に設定されたUDO変数は無視されます。 

<script type="text/javascript">
  utag_data["page_name"] = "View Cart";
</script>

ページ固有のデータ

UDOに入力する場合は、現在のページタイプに関係する変数のみを含めるようにしてください。これにより、ページのコードが乱雑になるのを避けることができ、求められるデータについて混乱することがなくなります。以下は、製品および発注データなどの不要な項目を省いた検索ページUDOの例です。

<script type="text/javascript">
  var utag_data={
      "page_name"      : "Search Results",
      "page_type"      : "search",
      "search_results" : "42",
      "search_keyword" : "tennis shoes"};
</script>

製品配列

設定する製品が1つだけの場合でも、製品変数は配列として入力する必要があります。以下は、製品ID変数に1つの製品IDを設定した例(製品詳細ページなどの場合)と、3つの製品IDを設定した例(ショッピングカートページなどの場合)です。

// Single product. For example, product detail page
utag_data["product_id"] = ["PROD123"];

// Multiple products. For example, cart page
utag_data["product_id"] = ["PROD123", "PROD456", "PROD789"];

配列の整合性

データの整合性を確保する観点から、すべての製品配列変数に含まれる要素の数を揃える必要があります。この例では、各配列の最初の要素が最初の製品に対応していることに注意してください。この製品と関連付けられているプロパティ(ID、価格、量など)は、すべて各配列の最初の要素で出現します。一方、2つ目の製品のプロパティは各配列の2つ目の要素で出現し、3つ目以降も同様です。

// Product 1:
//   ID    = PROD123
//   Price = 3.00
//   QTY   = 1
//
// Product 2:
//   ID    = PROD456
//   Price = 5.00
//   QTY   = 1
//
utag_data["product_id"]       = ["PROD123", "PROD456"];
utag_data["product_price"]    = ["3.00", "5.00"];
utag_data["product_quantity"] = ["1", "1"];
データレイヤー
ユニバーサルタグ(utag.js)

 
  • モバイル
  • 始める
    • 概要
    • モバイルの概念
    • クライアントサイド
    • サーバーサイド
    • データレイヤー
    • 同意管理
    • イベントバッチ処理
    • ユーザーの位置情報とジオフェンシング
    • 機能比較
    • トラブルシューティング
  • Remote Commands
    • 概要
    • 仕組み
    • リモートコマンド
      • リモートコマンド:AppsFlyer
      • リモートコマンド:Braze
      • リモートコマンド:Contentsquare
      • リモートコマンド:Facebook
      • Firebase
      • リモートコマンド:Usabilla
  • Android (Java)
    • 概要
    • インストール
    • トラッキング
    • データレイヤー
    • データ管理
    • 同意管理
    • モジュールのリスト
      • Ad Identifierモジュール
      • Crash Reporterモジュール
      • Install Referrerモジュール
      • Lifecycle Trackingモジュール
      • Locationモジュール
      • Optimizely X Trackingモジュール
    • Android TV
    • Android Wear
    • APIリファレンス
      • ConsentManager
      • DataSources
      • LifeCycle
      • Tealium
      • Tealium.Config
      • TealiumLocation
    • リリースノート
  • Cordova
    • 概要
    • インストール
    • トラッキング
    • データ管理
    • モジュールのリスト
      • Ad Identifierモジュール
      • Crash Reporterモジュール
      • Install Referrerモジュール
    • APIリファレンス
    • リリースノート
  • Flutter
    • 概要
    • インストール
    • トラッキング
    • 同意管理
    • データ管理
    • APIリファレンス
    • リリースノート
  • iOS (Objective-C)
    • 概要
    • インストール
    • トラッキング
    • データレイヤー
    • データ管理
    • 同意管理
    • Tag Management
    • モジュールのリスト
      • Lifecycle Trackingモジュール
      • Optimizely X Trackingモジュール
    • tvOS
    • watchOS
    • APIリファレンス
    • リリースノート
  • iOS (Swift)
    • 概要
    • インストール
    • トラッキング
    • データレイヤー
    • データ管理
    • アイデンティティの解決
    • アプリ拡張機能
    • 同意管理
    • モジュール
    • モジュールのリスト
      • AppDataモジュール
      • Attributionモジュール
      • AutoTrackingモジュール
      • Collectモジュール
      • Connectivityモジュール
      • CrashReporterモジュール
      • DataSourceモジュール
      • DefaultStorageモジュール
      • Delegateモジュール
      • DeviceDataモジュール
      • DispatchQueueモジュール
      • FileStorageモジュール
      • Lifecycleモジュール
      • Locationモジュール
      • Loggerモジュール
      • PersistentDataモジュール
      • RemoteCommandsモジュール
      • TagManagementモジュール
      • VisitorServiceモジュール
      • VolatileDataモジュール
    • Objective-Cとの連携
    • 機能比較
    • APIリファレンス
      • TealiumConfig
      • TealiumConsentCategories
      • TealiumConsentManagerDelegate
      • TealiumConsentManager
      • TealiumInstanceManager
      • TealiumPersistentData
      • TealiumVolatileData
      • Tealium
    • リリースノート
  • React Native
    • 概要
    • インストール
    • トラッキング
    • APIリファレンス
    • リリースノート
  • Xamarin
    • 概要
    • インストール
    • トラッキング
    • データ管理
    • 同意管理
    • APIリファレンス
    • リリースノート
  • ウェブ
  • AMP
    • 概要
    • インストール
    • トラッキング
    • データレイヤー
  • Angular
    • 概要
    • インストール
    • トラッキング
    • APIリファレンス
  • JavaScript (Web)
    • 概要
    • インストール
    • トラッキング
    • データレイヤー
    • ユニバーサルデータオブジェクト(utag_data)
    • ユニバーサルタグ(utag.js)
    • データレイヤーオブジェクト(b)
    • 単一ページアプリケーション
    • 設定
    • デバッグ
    • APIリファレンス
    • リリースノート
  • サーバーサイド
  • C#
    • 概要
    • インストール
    • トラッキング
    • データレイヤー
    • APIリファレンス
    • リリースノート
  • HTTP API
    • 概要
    • エンドポイント
    • データレイヤー
  • Java
    • 概要
    • インストール
    • トラッキング
    • APIリファレンス
    • リリースノート
  • Node
    • 概要
    • インストール
    • トラッキング
    • APIリファレンス
  • Python
    • 概要
    • インストール
    • トラッキング
    • APIリファレンス
  • Roku
    • 概要
    • インストール
    • トラッキング
    • APIリファレンス
  • Ruby
    • 概要
    • インストール
    • トラッキング
    • APIリファレンス
  • Unity
    • 概要
    • インストール
    • トラッキング
    • APIリファレンス

このページはお役にたちましたでしょうか?

最終更新日 :: 2022年March月2日       ご意見有難うございます。
  • 手引き
  • プラットフォーム
  • パートナー
  • モバイル
  • 始める
  • Remote Commands
  • Android (Java)
  • Cordova
  • Flutter
  • iOS (Objective-C)
  • iOS (Swift)
  • React Native
  • Xamarin
  • ウェブ
  • AMP
  • Angular
  • JavaScript (Web)
  • サーバーサイド
  • C#
  • HTTP API
  • Java
  • Node
  • Python
  • Roku
  • Ruby
  • Unity