AgilOne Webtag構成ガイド
この記事では、タグ管理アカウントでAgilOneタグを構成する方法について説明します。
前提条件
- 認証キー(AgilOneへのAPI呼び出しの認証に必要)
- Tealium Event拡張機能(任意ですが、使用を強く推奨)
タグの構成
最初に、タグマーケットプレイスへ移動し、AgilOne Web Tagタグをプロファイルに追加します(タグの追加を参照)。
タグを追加したら、以下の構成を構成します。
- テナントID:(必須)AgilOneから提供されたテナントID。このフィールドにIDを指定するか、データマッピングを使用して動的に構成できます。
ロードルール
ロードルールでは、このタグのインスタンスをサイト上のいつ、どこで読み込むかを決定します。
推奨ロードルール:すべてのページで読み込む
データマッピング
データマッピングは、データレイヤー変数の値をベンダータグ内の対応する変数に送信します。詳細については、データマッピングについてを参照してください。
AgilOne Web Tagタグの宛先変数は、その「データマッピング」タブに組み込まれています。使用可能なカテゴリは次のとおりです。
標準
| 宛先名 | 説明 |
|---|---|
| テナントID | (必須)テナントID |
| 認証キー | (必須)認証キーの値 |
| 検索語句 | サイトの検索に使用されたキーワード |
| イベント名 | トリガーするイベントの名前。Tealium Event拡張機能で提供されていないイベントをトリガーする場合に推奨されます。 |
| イベントエンティティURL | イベントが発生しているページのURL |
| イベントエンティティ時刻 | (任意)イベントがトリガーされた時刻のタイムスタンプ。タイムスタンプがイベントの送信時刻と異なる場合にのみ、この値を送信することをAgilOneは推奨しています。 |
| イベントエンティティのカスタムデータ* | イベントエンティティとともに送信する追加データ |
イベントエンティティのカスタムデータは、「イベントカスタムデータ」カテゴリとは異なります。
Eコマース
AgilOne Web TagタグはEコマース対応であるため、デフォルトのEコマース拡張機能のマッピングを自動的に使用します。通常、次の場合を除き、このカテゴリで手動マッピングを行う必要はありません。
- 拡張機能のマッピングを上書きする場合
- 必要なEコマース変数が拡張機能で提供されていない場合
| 宛先名 | 説明 | 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コマースマッピングを使用します。詳細については、カート更新の送信セクションを参照してください。
イベントカスタムデータ
これらのマッピングは、標準イベントに追加データを送信する場合にのみ使用します。
| 宛先名 | 説明 |
|---|---|
| 商品表示のイベントカスタムデータ | 商品表示のイベントカスタムデータ |
| 検索のイベントカスタムデータ | 検索のイベントカスタムデータ |
| カテゴリ表示のイベントカスタムデータ | カテゴリ表示のイベントカスタムデータ |
| ブランド表示のイベントカスタムデータ | ブランド表示のイベントカスタムデータ |
| カート更新のイベントカスタムデータ | カート更新のイベントカスタムデータ |
| チェックアウトのイベントカスタムデータ | チェックアウトのイベントカスタムデータ |
標準イベントのトリガー
AgilOneでサポートされている標準イベントは、Tealium Events拡張機能を通じてトリガーされます。つまり、この拡張機能でサポートされているイベントについては、イベント名やトリガー値をマッピングする必要はありません。この拡張機能により、標準化されたイベント名と、tealium_eventという新しいデータレイヤー変数がソリューションに導入されます。各イベントには、データレイヤーの実装に一致するカスタム条件が割り当てられます。イベント条件がtrueと評価されると、tealium_eventには事前定義されたイベント値が構成されます。TealiumのAgilOne Webtagテンプレートは、この事前定義値を読み取り、それに応じてイベントを発生させます。たとえば、「カートに追加」の条件がtrueと評価されると、tealium_eventはcart_addに構成され、カートページでカートイベントが発生します。
Tealium Events拡張機能を通じてAgilOneでサポートされるイベントの完全なリストは次のとおりです。
| イベント名 | tealium_event変数の値 | 対応する拡張機能 |
|---|---|---|
| ユーザーログイン | user_login | Tealium Events |
| ユーザーログアウト | user_logout | Tealium Events |
| 検索ページ表示 | search | Tealium Events |
| 商品詳細ページ表示 | product_view | Tealium Events |
| カテゴリページ表示 | category_view | Tealium Events |
| ブランド表示 | brand_view | – |
| カートに追加 | cart_add | Tealium Events |
| カートから削除 | cart_remove | Tealium Events |
| カートを空にする | cart_empty | Tealium Events |
| チェックアウト | checkout | Tealium Events |
標準イベントとともに追加のカスタムデータを送信するには、標準カテゴリにあるイベントカスタムデータのマッピングを構成します。
非標準イベントのトリガー
トリガーするイベントがTealium Events拡張機能で提供されていない場合は、別の方法を使用できます。代わりにSet Data Value拡張機能を使用して、イベントトリガーとイベント条件を構成できます。その後、トリガー変数をイベント名の宛先(標準カテゴリ内)にマッピングします。
ブランド表示イベントは、非標準イベントの一例です。イベントをトリガーするには、次の手順に従います。
拡張機能マーケットプレイスから、新しいSet Data Values拡張機能を追加して構成します。
スコープをAgilOne Webtagに構成します。
event_nameデータ変数をテキストbrand_viewに構成します。注意:brand_viewの値はテンプレートで事前定義されているため、変更できません。顧客のブランド表示アクションを評価するイベント条件を追加します。たとえば、
event_typeがbrand_viewに等しい、という条件です。
目的の変数が見つからない場合は、その場で追加できます。
- タグの「データマッピング」タブに移動し、
event_name変数をイベント名の宛先(標準カテゴリ)にマッピングします。
カート更新の送信
カートへの商品の追加およびカートからの商品の削除は標準イベントとして扱われるため、Tealium Events Extension から簡単にトリガーできます。最終的なカートのデータ(追加または削除された商品を含む)を送信する手順は、次の3つです。
- カートへの追加/カートからの削除イベントをトリガーするように、Tealium Events Extension を構成します。
- タグの Current Cart マッピングに移動し、任意の送信先にマッピングします。
- E-Commerce Extension に移動し、新しく追加または削除されたカート商品を
_cprodにマッピングします。これにより、更新されたカート商品が個別に取得されます。
ページ上でカートへの追加/カートからの削除イベントが発生すると、タグテンプレートによって追加または削除された商品と現在のカートデータが自動的にまとめられ、完全なカートリストが送信されます。
削除されたカート商品を正しく識別するには、その商品を E-Commerce の cprod と Current Cart の両方にマッピングする必要があります。
ベンダーのドキュメント
最終更新日 :: 2026年November月10日