AgilOne Webtag構成ガイド | クライアントサイドタグ

前提条件

認証キー（AgilOneへのAPI呼び出しを認証するために必要）
Tealiumイベント拡張（オプションですが、強く推奨されます）

タグの構成

まず、タグマーケットプレイスに移動し、AgilOne Web Tag Tagをプロファイルに追加します（タグの追加を参照）。

タグを追加したら、以下の構成を行います：

テナントID（必須）：AgilOneから受け取ったテナントID。このフィールドにIDを指定するか、データマッピングを使用して動的に構成できます。

ロードルール

ロードルールは、サイト上でこのタグのインスタンスをいつ、どこでロードするかを決定します。

推奨されるロードルール：すべてのページでロード

データマッピング

マッピングは、データレイヤー変数からベンダータグの対応する宛先変数にデータを送信するプロセスです。変数をタグの宛先にマッピングする方法については、データマッピングを参照してください。

AgilOne Web Tag Tagの宛先変数は、そのデータマッピングタブに組み込まれています。利用可能なカテゴリーは次のとおりです：

スタンダード

宛先名	説明
テナントID	(必須) テナントID
認証キー	(必須) 認証キーの値
検索語	サイトの検索に使用されるキーワード
イベント名	トリガーしたいイベントの名前。Tealiumイベント拡張で既に提供されていないイベントをトリガーする場合に推奨されます。
イベントエンティティURL	イベントが発生しているページのURL
イベントエンティティ時間	(オプション) イベントがトリガーされたときのタイムスタンプ。この値は、タイムスタンプがイベントが送信されたときの時間と等しくない場合にのみ送信することをAgilOneは推奨しています。
イベントエンティティカスタムデータ*	イベントエンティティと一緒に送信する追加のデータ

イベントエンティティカスタムデータは、イベントカスタムデータカテゴリとは異なります。

E-コマース

AgilOne Web Tag Tagはe-commerce対応しているため、デフォルトのE-Commerce Extensionマッピングを自動的に使用します。通常、このカテゴリで手動でマッピングする必要はありませんが、以下の場合は必要となります：

拡張マッピングを上書きしたい場合
ご希望のe-commerce変数が拡張機能に提供されていない場合

宛先名	説明	E-コマース拡張変数
注文ID	ユニークな注文ID	`_corder`
注文合計	注文の合計金額	`_ctotal`
注文小計	注文の小計金額	`_csubtotal`
送料	送料	`_cship`
税金	税金の金額	`_ctax`
注文組織ID	注文組織ID	NA
注文請求日	注文の請求日	NA
注文カスタムデータ	注文のカスタムデータ	NA
顧客ID	ユニークな顧客ID	`_ccustid`
製品IDのリスト	製品IDの配列	`_cprod`
取引アイテムIDのリスト	取引アイテムIDのリスト	NA
名前のリスト	製品名の配列	`_cprodname`
SKUのリスト	SKUのリスト	`_csku`
ブランドのリスト	ブランドのリスト	`_cbrand`
カテゴリのリスト	製品カテゴリの配列	`_ccat`
数量のリスト	製品数量の配列	`_cquan`
価格のリスト	製品価格の配列	`_cprice`
割引のリスト	割引のリスト	`_cpdisc`
組織IDのリスト	組織IDのリスト	NA
製品タイプのリスト	製品タイプのリスト	NA
製品サブタイプのリスト	製品サブタイプのリスト	NA
製品出荷収益のリスト	製品出荷収益のリスト	NA
製品組織IDのリスト	製品組織IDのリスト	NA
製品出荷日のリスト	製品出荷日のリスト	NA
製品請求日のリスト	製品請求日のリスト	NA
製品カスタムデータ	製品カスタムデータ	NA

顧客

宛先名	説明
顧客メール	顧客のメールアドレス
顧客UUID	顧客のUUID
顧客プリファレンスDNE	メールのオプトアウト値
顧客プリファレンスDNM	郵便のオプトアウト値
顧客プリファレンスDNC	電話のオプトアウト値
顧客カスタム	顧客に関するカスタムデータ

現在のカート

現在のカートアイテムのデータを送信するために、これらの宛先にマッピングします。

宛先名	説明
現在のカートID	ユニークなカート識別子
現在のカート数量	カート内の各アイテムの数量
現在のカートカスタムデータ	カート内の各アイテムに関連するカスタムデータ

カートの更新（追加または削除）のデータを送信するには、_cprodのE-Commerceマッピングを使用します。詳細については、カート更新の送信セクションを参照してください。

イベントカスタムデータ

これらのマッピングを使用して、標準イベントのみに追加のデータを送信します。

宛先名	説明
製品ビューのイベントカスタムデータ	製品ビューのイベントカスタムデータ
検索のイベントカスタムデータ	検索のイベントカスタムデータ
カテゴリビューのイベントカスタムデータ	カテゴリビューのイベントカスタムデータ
ブランドビューのイベントカスタムデータ	ブランドビューのイベントカスタムデータ
カート更新のイベントカスタムデータ	カート更新のイベントカスタムデータ
チェックアウトのイベントカスタムデータ	チェックアウトのイベントカスタムデータ

標準イベントのトリガー

AgilOneがサポートする標準イベントは、Tealiumイベント拡張を通じてトリガーされます。つまり、拡張機能を通じてサポートされるイベントのイベント名やトリガー値をマッピングする必要はありません。拡張機能は、標準化されたイベント名をソリューションに導入し、新しいデータレイヤー変数であるtealium_eventを導入します。各イベントには、データレイヤーの実装に一致するカスタム条件が割り当てられます。イベント条件がtrueに評価されると、tealium_eventは事前に定義されたイベント値に構成されます。TealiumのAgilOne Webtagテンプレートは、事前に定義された値を読み取り、それに応じてイベントを発火します。例えば、“カートに追加"の条件がtrueに評価されると、tealium_eventはcart_addに構成され、カートイベントがカートページで発火します。

Tealiumイベント拡張を通じてAgilOneがサポートするイベントの完全なリスト：

イベント名	tealium_event変数値	サポート拡張
ユーザーログイン	`user_login`	Tealiumイベント
ユーザーログアウト	`user_logout`	Tealiumイベント
検索ページビュー	`search`	Tealiumイベント
製品詳細ページビュー	`product_view`	Tealiumイベント
カテゴリページビュー	`category_view`	Tealiumイベント
ブランドビュー	`brand_view`	–
カートに追加	`cart_add`	Tealiumイベント
カートから削除	`cart_remove`	Tealiumイベント
カートを空にする	`cart_empty`	Tealiumイベント
チェックアウト	`checkout`	Tealiumイベント

標準イベントに追加のカスタムデータを送信するには、標準カテゴリのイベントカスタムデータマッピングでマッピングします。

非標準イベントのトリガー

トリガーしたいイベントがTealiumイベント拡張に含まれていない場合、代替手段があります。代わりに、Set Data Value Extensionを使用してイベントトリガーとイベント条件を構成することができます。その後、トリガー変数をイベント名宛先（スタンダードカテゴリ）にマッピングします。

ブランドビューイベントは非標準イベントの一例です。イベントをトリガーするには、以下の手順を実行します：

拡張マーケットプレイスから新しいSet Data Values Extensionを追加して構成します。
それをAgilOne Webtagにスコープします。
event_nameデータ変数をテキストbrand_viewに構成します。注意：brand_viewの値はテンプレートで事前に定義されており、変更することはできません。
顧客のブランド閲覧者クションを評価するイベント条件を追加します。例えば、event_typeがbrand_viewに等しい場合。

探している変数が見つからない場合は、その場で追加することができます。

タグのデータマッピングタブに移動し、event_name変数をイベント名宛先（スタンダードカテゴリ）にマッピングします。

カート更新の送信

カートへのアイテムの追加と削除は標準イベントとして扱われ、したがってTealiumイベント拡張を通じて簡単にトリガーすることができます。最終的なカート（追加または削除されたアイテムを含む）のデータを送信するには、以下の3つのステップを実行します：

Tealiumイベント拡張を構成して、カートの追加/削除イベントをトリガーします。
タグの現在のカートマッピングに移動し、選択した宛先にマッピングします。
E-Commerce Extensionに移動し、新しく追加または削除されたカートアイテムを_cprodにマッピングします。これにより、更新されたカートアイテムが個別にキャプチャされます。

ページ上でカートの追加/削除イベントが発火すると、当社のタグテンプレートは自動的に追加/削除されたアイテムを現在のカートデータと組み合わせ、完全なカートリストを送信します。

削除されたカートアイテムを正しく識別するには、E-Commerceのcprodと現在のカートの両方にマッピングする必要があります。

ベンダードキュメンテーション

AgilOneリソース