Xユニバーサルウェブサイトタグ構成ガイド
この記事では、タグ管理アカウントでXユニバーサルウェブサイトタグ(UWT)を構成する方法について説明します。
このタグは現在非推奨です。現在のタグについては、Xピクセルタグを参照してください。
要件
- X広告アカウント
- X UWTピクセルID
- 完全に構成されたEコマース拡張機能
サポートされているバージョン
- v1.0.0
タグの構成
タグマーケットプレイスに移動して、新しいタグを追加します。詳細については、タグについてを参照してください。
タグを追加するときに、以下の構成を行います。
- タイトル:タグを識別するための一意の名前を入力します。このタグのインスタンスを複数追加する場合に重要です。
- XピクセルID:ユニバーサルウェブサイトタグのコードスニペットに含まれるピクセルID値を入力します。例:
twq('init','1a2b3');
タグ構成を動的に指定する場合は、データマッピング(以下を参照)を使用してください。
読み込みルール
すべてのページでタグを読み込むか、タグを読み込む条件を構成します。読み込みルールの詳細については、読み込みルールのドキュメントを参照してください。
データマッピング
データマッピングは、データレイヤー変数の値をベンダータグ内の対応する変数に送信します。詳細については、データマッピングについてを参照してください。
Xユニバーサルウェブサイトタグの宛先変数は、[データマッピング]タブに組み込まれています。使用可能なカテゴリは次のとおりです。
標準
| 宛先名 | 説明 |
|---|---|
| XピクセルID | X広告アカウントに関連付けられたユニバーサルウェブサイトタグのピクセルID。例:“1a2b3” |
| イベント値 | ユーザーがこのイベントを実行したことによって広告主にもたらされる価値。例:“19.99” |
| アイテム数 | このサイト内イベントに関連付けられたアイテムの数。例:“3” |
| コンテンツタイプ | 値は「product」または「product_group」のいずれかにする必要があります。
|
| イベントステータス | サイト内登録イベントのステータス。例:“submitted” |
Eコマース
XユニバーサルウェブサイトタグはEコマースに対応しているため、デフォルトのEコマース拡張機能のマッピングが自動的に使用されます。通常、次の場合を除き、このカテゴリで手動マッピングを行う必要はありません。
- 拡張機能のマッピングを上書きする場合。
- 使用するEコマース変数が拡張機能で提供されていない場合。
| 宛先名 | 説明 | Eコマース拡張機能の変数 |
|---|---|---|
| 注文ID | 購入、登録、またはダウンロードイベントに関連付けられた広告主の注文ID | corder |
| 注文合計 | 購入イベントの場合、このEコマース拡張機能パラメータがイベント値の宛先に渡されます | ctotal |
| 通貨 | イベント値属性の通貨(ISO 4217規格) | ccurrency |
| 商品IDのリスト | イベントに関連付けられた商品ID | cprod |
| 名前のリスト | イベントに関連付けられた商品名 | cprodname |
| カテゴリのリスト | 商品のカテゴリ | ccat |
| 数量のリスト | 購入イベントとダウンロードイベントの場合、この配列内の値(Eコマース拡張機能から取得)が合算され、アイテム数の宛先に渡されます | cquan |
イベントトリガー(および必須パラメータ)
ページビューイベントを含む、ページ上の特定のイベントをトリガーするには、これらの宛先にマッピングします。イベントトリガーをマッピングする手順は次のとおりです。
- トリガーリストからイベントを選択します。
- マッピング値フィールドに、この宛先へマッピングする変数の値を入力します。マッピングされた変数の値が、マッピング値フィールドに入力した値と一致すると、ページ上でイベントがトリガーされます。
- さらにイベントをマッピングするには、+追加をクリックし、手順1と2を繰り返します。
PageViewイベントは、各ページの読み込み時に自動的にトリガーされます。
一部のイベントには特定のパラメータが必要であり、それらのパラメータが存在しないか空白の場合、イベントはトリガーされません。以下の表でアスタリスクが付いているパラメータは、明示的にマッピングされていない限り、Eコマース拡張機能によって値が構成されます。
| Xイベント変数 | 説明 | 必須 | 任意 |
|---|---|---|---|
| PageView(デフォルト) | より具体的なイベントタイプがないページに使用する汎用イベントタイプ。 | なし |
|
| Purchase | 購入が行われたとき、またはチェックアウトフローが完了したとき。 |
|
|
| Signup | ユーザーの登録が完了したとき。 | なし |
|
| Download | ダウンロードリンクがクリックされたとき。例:ソフトウェアのダウンロード、ドキュメントのダウンロード | なし |
|
ベンダーのドキュメント
最終更新日 :: 2026年November月10日