TealiumによるEコマース統合

このガイドでは、Tealiumを使用してRoktと統合するプロセスを説明します。データレイヤーに基づいてTealiumで変数を作成する方法、mParticle by Roktタグを使用してRokt SDKを初期化し、配置を挿入する方法を学びます。

始める前に

以下を確認してください：

• サイトに既に実装されているデータレイヤー（通常は開発者によって行われます）
• Rokt APIキー（Roktアカウントマネージャーから提供されます）

データレイヤーの理解

データレイヤーは、開発者によってウェブページに実装されているはずです。

データレイヤーは、Tealiumと共有したいすべての情報を含むオブジェクトです。変数はデータレイヤーを介して、またはその後のビュー変更宣言でTealiumと共有できます。

データレイヤーの動作についての詳細は、Tealium開発者ガイドを参照してください。

データレイヤーの例：

window.utag_data = window.utag_data || {}

utag_data['email_address'] = 'test@test.com'
utag_data['first_name'] = 'john'
utag_data['last_name'] = 'doe'

ビュートリガーの設定

適切なイベントをトリガーするには、購入イベントが発生したときにアプリで次のコードを使用してください：

utag.view({tealium_event : 'purchase', email_address : 'john.doe@example.com', amount:'20.00', currency:'USD', confirmationref:'123456789'})

タグ設定：Rokt SDKの初期化

1. Tealiumアカウントにログインします。
2. 左側のナビゲーションでTagsをクリックします。
3. 右側のNew Tagボタンをクリックし、mParticle by Roktタグを検索します。
4. タグの説明名を入力します（例：「Rokt SDK」）。
5. mParticle API Keyの下に、Roktアカウントマネージャーから提供されたRokt APIキーを貼り付けます。
6. Log Page Viewsを有効にします。
7. Saveをクリックします。

ルールとイベント

Rules and Eventsの下で、新しいタグをすべてのページで発火するように設定します。

変数マッピング：ウェブページコードの必要な変更

1. Tealiumイベント

ウェブサイト上で、Roktが配置をレンダリングするすべてのページにtealium_event値を含める必要があります。 tealium_event値は、utag_dataオブジェクト内の他のすべての属性と一緒に、Roktに送信されるように直接設定する必要があります。

例えば、次のように設定します：

var utag_data = {
  tealium_event : "purchase"
}

2. ページ名

pageNameがデータレイヤーに存在する変数であることを確認してください。RoktはpageNameを使用してページビューを記録し、区別するのに役立ちます。（オプションで、ページURLも渡すことができます。）

3. 識別子

(オプション) ページを一意に識別する必要がある場合は、ページ識別子を設定します（同じURLを再利用するマルチステップのチェックアウトフローに便利です）。ページ識別子を統合することを決定した場合は、Roktアカウントマネージャーに開示してください。例:

• stg.rokt.conf - ステージング（テスト）環境での確認ページ
• prod.rokt.conf - 本番環境での確認ページ
• stg.rokt.payments - ステージング（テスト）環境での支払いページ
• prod.rokt.payments - 本番環境での支払いページ

識別子を使用する場合は、データレイヤーにも識別子を設定する必要があります:

var utag_data = {
  tealium_event: "purchase",
  identifier: "mp-layout"
};

変数マッピング: Tealiumでの必要な変更

Roktにマッピングする前に、特定のデータレイヤーに従ってTealium内でUDO変数を設定する必要があります。変数の詳細については、Tealiumデータレイヤー変数を参照してください。

1. コンテナ内でUDO変数を作成する

Tealiumでは、Roktにマッピングして渡したいすべてのフィールドは、以下を含むUDO変数として存在する必要があります:

• Roktがオファー選択に使用したい任意の属性
• tealium_event
• 識別子（Roktアカウントマネージャーと設定している場合）
• ページビューのログをサポートするためのpageName（およびオプションでページURL）

タグテンプレートにリストされていない追加の属性を送信したい場合は、それらをデータレイヤーに追加し、TealiumでUDO変数として作成します。

2. UDO変数を正しい宛先にマッピングする

マッピングされた変数の下で、UDO変数をRoktの宛先にマッピングします。Roktに送信したい各変数はマッピングされる必要があります。ほとんどの宛先はタグ内で利用可能であるべきです。 マッピングしたいUDO変数に対するRoktの宛先が存在しない場合は、"+ Add Custom Destination"機能を使用してください。

注記

識別子を使用している場合は、カスタム宛先として"identifier"を使用してマッピングする必要があります。

• 提供されたタグカテゴリと宛先を使用して開始します:
  1. 一意の識別子（例: メール）→ ユーザーIDカテゴリを使用
  2. ユーザープロフィールフィールド（例: 名前）→ ユーザー属性カテゴリを使用
  3. ページレベルの属性（例: ページ名）→ ページビュー属性カテゴリを使用
  4. tealium_eventに基づく配置トリガー → 配置を選択カテゴリを使用
     • ウェブサイトで設定した各tealium_event値（例: "purchase"）に対して、その条件が真であるときに配置選択イベントをトリガーするマッピングを追加します。
     • これにより、サイトが送信する際に: utag.view({ tealium_event: "purchase" })、tealiumがselectPlacementsをトリガーします
• 既存のカテゴリにリストされていない任意の属性をカスタム宛先（例: 識別子）を使用してマッピングします

共通のRokt定義済み属性

属性キー	例示値	カテゴリ	備考
Email	john.doe@example.com	ユーザーID	顧客のメールアドレス。
Hashed Email	a8b1a93c...7890abcdef	ユーザーID	顧客のメールアドレスのSHA-256ハッシュ。
First Name	John	ユーザー	顧客の名。
Last Name	Doe	ユーザー	顧客の姓。
Mobile	3125551515	ユーザー	電話番号は1112345678または+1 (222) 345-6789の形式でフォーマット可能。
Age	33	ユーザー	顧客の年齢。
Gender	M	ユーザー	顧客の性別。例: M, Male, F, または Female。
City	Brooklyn	ユーザー	顧客の市。
State	NY	ユーザー	顧客の州または省。
ZIP Code	11201	ユーザー	顧客のZIPまたは郵便番号。
Date of Birth	19900717	ユーザー	生年月日。yyyymmddの形式。
Title	Mr	ユーザー	顧客の敬称。例: Mr, Mrs, Ms, Dr。
Language	en	ユーザー	顧客または購入に関連する言語。
Amount	20.00	Eコマース	総取引額。
Confirmation Number	123456789	Eコマース	注文確認または取引参照番号。
Page Name	Confirmation	ページビュー	現在のページの名前。
URL	https://www.example.com/confirmation	ページビュー	現在のページのURL。

カスタムイベントのトラッキング

カスタムUDO変数を既存のRoktカスタムイベントタイプにマッピングすることで、カスタムイベントを定義しトラッキングできます。 サポートされているカスタムイベントタイプは以下の通りです:

• Navigation
• Location
• Search
• Transaction
• UserContent
• UserPreference
• Social
• Other

カスタムイベントをトラッキングするには:

1. カスタムイベントをトリガーする必要があるすべてのページに、カスタムイベント変数をウェブページコードに追加します
2. Tealiumでカスタムイベント変数をUDO変数として追加します
3. トリガーしたいイベントにそのUDO変数の値をマッピングします:

• Eventsをカテゴリとして選択
• When mapped variable equalsの横に、ウェブページコードに設定した正確な値を入力
• 任意のイベント名を選択
• このページでトリガーしたいイベントを選択

マッピングされた変数のセットアップの例