英語からAIを使用して翻訳されました
この記事はAI技術を使用して翻訳されています。正確性を維持するよう努めていますが、一部の詳細が元のテキストと完全に一致しない場合があります。情報に不明点がある場合は、英語版をご参照ください。
ゾーニングは、サイトのHTML内の要素を特定することで、各インタラクションをページ要素にリンクします。もしサイトのリリースでそのHTML構造が変更されると、既存のゾーンが同じ要素と一致しなくなり、ゼロまたは予期しないデータを表示することがあります。
この記事では、重要なページ要素に安定した識別子を付与し、サイトの変更時にもゾーニングデータが一貫している状態を保つ方法を説明します。
この記事のいずれのオプションも遡及的には適用されません。各オプションは有効になった日から機能し始めます。
始める前に
保護したい要素を決めます。長期間にわたりチームが分析する要素から始めましょう。例えば:
- 固定されたトップページのブロック
- メニュー項目
- 在庫やコンテンツによって位置が変わる可能性のある商品ページのボタン
- 商品タイルなどの繰り返しコンポーネント
重要な各ブロックについては、そのブロックと主要なボタンの両方を保護することを検討してください。ブロックを保護すると、その外側の変更が内部の要素に影響を与えるのを防げます。ボタンを個別に保護すると、ブロック内の変更がボタンに影響を与えるのを防げます。
識別子の値は以下の条件を満たすものを選んでください:
- 文字、数字、ハイフン、アンダースコアのみを使用する
- ページ内で一意である
- リリース間で変わらない
- スペース、アクセント、ドットを含まない
- キャンペーン名や日付を含まない
無効または重複した値は無視されます。この場合、要素の既存のHTML IDも無視されます。
利用可能なオプション
以下のオプションを確認し、ご利用のプラン、サイト設定、実装要件に合ったものを使用してください。
オプションA:属性またはCSSクラスを使用する
ProおよびEnterpriseプランで利用可能
サイトにすでにリリース間で安定している属性やCSSクラス(商品IDやコンポーネント名など)がある場合にこのオプションを使用します。
1. 識別子が安定して一意であることを確認する
以下を確認してください:
- 属性またはクラスが変わらないこと
- 値がページ内に一度だけ現れること
- モバイル版とデスクトップ版が同時にレンダリングされるなど、一時的な重複がないこと
同じ値が複数回現れる場合、Contentsquareはそれらの要素に対して使用できません。次に一意のCSSクラスを試み、その後要素のHTML IDを試し、最後の手段として要素の位置を使用する場合があります。
2. データ収集の設定を開く
- コンソールで、ゾーニング、CS Live、およびヒートマップのデータ収集設定を開きます。
- ユニーク属性に属性名を追加します。値ではなく名前のみを入力してください。例として、data-product-idを入力します。
- ユニークCSSクラスに、ページごとに一度だけ表示されるクラスを追加します。ドットなしでクラス名を入力してください。例として、store-locatorを入力します。
実装中は、実装マネージャーがこの設定の構成を支援できます。実装後に問題が判明した場合は、サポートまたはテクニカルアカウントマネージャーに連絡してください。
この設定は保存された日からサイト全体に適用されます。ページ上で属性値またはクラスがユニークなすべての要素は、その時点で新しい名前が付けられます。ただし、すでにオーバーライドIDがある場合は除きます。
一致する要素内の要素も、それぞれが独自のオーバーライドID、ユニーク属性、または安定したHTML IDを持っていない限り、新しい名前が付けられます。
オプションB: ContentsquareタグコンフィギュレータでIDを追加する
ProおよびEnterpriseプランで利用可能
このオプションを使用すると、サイトコードを変更せずに安定したIDを追加できます。
タグコンフィギュレータのスニペットは、シャドウDOMを使用するウェブコンポーネント内の要素にはアクセスできません。保護したい要素がシャドウDOM内にある場合は、オプションC:サイトコードにIDを追加するを使用してください。
スニペットを作成する
- コンソールで、Contentsquareタグコンフィギュレータを開きます。
- 新しいスニペットを作成します。
- 保護する要素の名前を付けてスニペットに名前を付けます。例:Override ID – HP Enchanting Gift。
- Element ID Overrideテンプレートを選択します。
要素を選択する
CSSセレクタで、変更されにくいセレクタを使って正確に1つの要素をターゲットにします。
以下の方法で要素をターゲットにできます:
- リンク先、例:a[href*="store-locator"]
- aria-label
- リリース間で安定しているdata属性
以下のセレクタは避けてください:
- :nth-childなどの位置指定
- 生成されたクラス名
- リリース間で変わる値
セレクタが複数の要素に一致する場合、スニペットはDOM順で最初の要素にのみ属性を適用します。Contentsquareは警告を表示しません。
オーバーライドIDを入力する
属性値に、選択した安定したID値を入力します。
このフィールドを空欄にしないでください。空欄にするとContentsquareは要素のHTML IDを無視し、要素およびその内部すべての名前が変更される可能性があります。
文字、数字、ハイフン、アンダースコアのみを使用してください。ページ内で値がユニークであることを確認してください。
トリガーを選択する
トリガーとして「Before Pageview」を選択します。
- 以下の両方を有効化します:
自然なページビュー
artificialなページビュー
artificialなページビューは、ページをリロードしないページ変更をカバーします。
オプションC:サイトコードにIDを追加する
グロース、プロ、エンタープライズ・プランで利用可能
識別子をコンポーネントに組み込み、将来のリリースでもそのまま維持したい場合にこのオプションを使用してください。
サイトコードにオーバーライドIDを実装する
1. コンポーネントにオーバーライドIDを追加する
コンポーネントのテンプレートに data-cs-override-id 属性を追加します。
例:
<section data-cs-override-id="hp-enchanting-gift">
ページ上で安定して一意の値を選択してください。
2. 繰り返し表示されるコンポーネントには一意の値を付与する
繰り返し表示されるコンポーネントの場合は、製品またはコンポーネントの参照から値を構築します。
例:
<div data-cs-override-id="plp-tile-VCARA12345">
これは、各製品がページに一度だけ表示される場合にのみ機能します。同じ製品が複数回表示される場合、結果の値は一意ではなくなり、信頼して使用できません。
3. 可能な場合は既存のオーバーライドIDを再利用する
要素にすでにTag ConfiguratorスニペットによってIDが割り当てられている場合は、同じ値を使用し、同じ要素タイプを維持してください。
これにより、コード変更がライブになる際に追加の途切れなく既存のゾーンのマッチングを継続できます。リリースがライブになった後、Tag Configuratorスニペットを削除してください。
データの途切れは1回を見込む
ほとんどの変更は、変更がライブになった日からContentsquare内で要素に新しい名前を付けます。その変更前に作成されたゾーンはマッチングしなくなる可能性があります。
影響を最小限にするために:
- 関連する識別子の変更を同じリリースにまとめる。
- リリース後に新しいスクリーンショットを撮る。
- 新しいスクリーンショット上でゾーンを再描画する。
- 識別子変更後に分析期間を開始する。
実装をテストする
- ライブページを開く。
- 要素を右クリックして「検証」を選択する。
- 要素に期待されるID、属性、またはCSSクラスがあることを確認する。
- ElementsパネルでHTML内の値を検索する。
- 値が正確に一度だけ表示されていることを確認する。
複製が一時的に現れる可能性のある状態で要素をテストしてください。例:
- クローンされたカルーセルスライド
- モバイルとデスクトップのメニューが同時に表示される場合
- モーダル
- その他の一時的なページ状態
Contentsquareで新しいスクリーンショットを撮り、ゾーンがデータを表示していることを確認してください。
各リリース後に識別子を安定させる
サイトの各リリース後:
- 識別子がまだ存在していることを確認してください。
- ページ上にまだ一度だけ表示されていることを確認してください。
- 要素タイプを同じに保ってください。例えば、divをsectionに変更するとゾーンが一致しなくなることがあります。
- Tag Configuratorのスニペットを再確認してください。サイトの変更により警告が表示されずにCSSセレクタが無効になることがあります。
- リリーステストに識別子のチェックを含めてください。