英語からAIを使用して翻訳されました
この文書はAI技術を使用して翻訳されたことにご注意ください。正確性を維持するよう努めていますが、一部の詳細は元のテキストを完全に反映していない場合があります。情報に不明な点がある場合は、英語版を参照してください。
デフォルトでは、Contentsquareはセッションデータに含まれるiframe要素をブロックし、コンテンツのレンダリングを防ぎます。セッションリプレイを視聴したりヒートマップを表示したりしている間、iframeのコンテンツの代わりに、ページに埋め込まれたiframeを追跡できませんというメッセージが表示されます。
この記事では、Contentsquareを使用してiframeコンテンツを追跡する方法についてのガイダンスを提供し、Contentsquareタグがインストールされている場所に応じてインタラクションをキャプチャするためのさまざまなオプションを概説します。また、iframeを有効にするために必要な手順とHTML属性、iframeの行動やサードパーティコンテンツに関連する考慮事項や制限についても詳述します。
iframeとは何ですか？
iframeは、別のウェブページに埋め込まれたウェブページです。一般的には、チャットボット、ビデオ、フォームなどのサードパーティサイトからのコンテンツを表示するために使用されますが、同じドメインからのコンテンツを表示することもできます。
iframeのコンテンツがどこから来ているかを判断するには、iframeのソースURL（src=""）を確認します。この例では、iframeのソースURLはYouTubeから来ています：
<iframe src="https://www.youtube.com/embed/dQw4w9WgXcQ"></iframe> iframeについての詳細は、Mozilla Developer Networkのドキュメントを参照してください。
この記事を完全に理解するために、以下の用語に慣れておいてください：
- iframe '親' ページ - これは<iframe> コードが追加されたページです。このページには通常独自のコンテンツがありますが、埋め込まれたiframeコンテンツも含まれています。これは、ユーザーがブラウザで訪れるページです。
- iframe 'ソース' ページ - これはiframe コンテンツが来ているページです。ソースページのURLは通常、ユーザーが直接アクセスするページではありません。
Contentsquareでiframeコンテンツを追跡するためのオプションは何ですか？
Contentsquareは、Contentsquareタグがインストールされているページのセッションのみを追跡できます。iframe内のインタラクションを追跡するには、iframeのソースコードを編集できる必要があります。これはサードパーティのiframeでは不可能な場合があります。サードパーティがContentsquareタグを追加することを許可する場合、彼らはプライバシーおよびクッキーポリシーにおいてContentsquareの追跡も考慮する必要があります。
Contentsquareは、以下の方法でiframeコンテンツを追跡できます：
- iframe 親ページにのみContentsquareタグをインストールする：Contentsquareは親ページのページコンテンツを追跡しますが、iframe内のインタラクションは追跡されません。
- iframe ソースページにのみContentsquareタグをインストールする：Contentsquareはiframeのソースページコンテンツを追跡しますが、親ページのインタラクションは追跡されません。セッションリプレイやヒートマップでは、訪問した親ページが表示されますが、iframe内のインタラクションからのデータのみがキャプチャされます。iframe外の親ページとのユーザーインタラクションはキャプチャされません。
- iframe 親およびソースページの両方に同じContentsquareタグをインストールする：Contentsquareは親ページとiframeソースページの両方からデータを検出できます。iframeコンテンツはセッションリプレイで別のページとして扱われます。iframeとのインタラクションは、ユーザーのセッション内の別のタブとして表示され、ユーザーが親ページとiframeソースページの間を切り替えているように見えます。
Contentsquare内でiframeを許可する方法
iframeを表示できるようにすることは、Contentsquareがiframeページを読み込むことができることを意味しますが、iframeにContentsquareタグをソースページとiframeの両方に追加する能力がない限り、iframe内のユーザーインタラクションを追跡することはできません。iframeコンテンツを読み込むためにJavaScriptが必要な場合、iframeを許可すると、セッションリプレイやヒートマップでiframeが空のスペースとして表示される可能性があります。
始める前に
iframeを許可する前に、iframeを許可した後も持続する制限を考慮してください：
- iframeにはsrc属性が必要です。
- Contentsquareは、src属性が相対ページパス（例：src=“/page”）を使用している場合、iframeを許可できません。完全なURL（例：src=“https://contentsquare.com/page”）を使用する必要があります。
- 親ページを録画している場合、iframe内のJavaScriptはブロックされます。
- 親ページをキャプチャしている場合、iframe内のインタラクション（クリックやスクロールイベント、入力、CSSアニメーション、DOMの変更など）は追跡されません。
- iframeが指すURLは私たちのサーバーに保存され、セッションリプレイが再生されるたびに再読み込みされます。これは、iframeソースページの読み込みが追加の動作を引き起こす場合、予期しない悪影響を引き起こす可能性があることを意味します。
- iframeを許可することは、<iframe>要素自体に属性を追加することを意味します。iframeの親要素に配置することはできません。多くのサードパーティツールは、<iframe>要素を編集することを許可していないため、許可することはできません。
これらの制限により、ほとんどのサードパーティのiframeはJavaScriptに依存しているため、iframeを許可した後でも表示されない可能性があります。許可されたiframeで機能しないコンテンツタイプのいくつかの例は次のとおりです：
- チャットボット
- サードパーティのビデオプレーヤー（YouTubeやVimeoを含む）
- サードパーティのフォーム（Typeformフォームを含む）
- iframeを介して読み込まれるほとんどのサードパーティのウェブアプリ
- ほとんどのサードパーティの決済システム
これは、Contentsquareが許可されたiframeの以下の側面のみを表示できることを意味します：
- iframeを介して読み込まれる静的ページコンテンツ（JavaScriptなし）。
- カーソルの動作は親ページに対して相対的に追跡されます。
Contentsquare内でiframeを許可する
1. iframeにdata-hj-allow-iframeをHTML属性として追加します。
表示したいiframeにHTML属性data-hj-allow-iframeを追加することでこれを行うことができます。
<iframe src="https://example.com/page.html" data-hj-allow-iframe=""></iframe> これはdata-hj-allow-iframe=""、data-hj-allow-iframe="true"、または単にdata-hj-allow-iframeとして書くことができます。いずれにせよ、値はバックエンドで「true」と表示されます。
2. サイトと組織のページにアクセスします。
3. サイト設定ページにアクセスするために、サイト設定の歯車アイコンをクリックします。
4. セッションターゲティングと追跡メニューを展開します。
5. Allowed iframe domainsの下に許可したいトップレベルドメイン名を入力します。
Allowed iframe domainsフィールドにドメイン名を入力する際は、トップレベルドメインのみを入力してください。トップレベルドメインは、www、http://、またはhttps://が接続されていないドメインです。例えば、https://www.contentsquare.com/をこのフィールドに許可したい場合、トップレベルドメインはcontentsquare.comになります。
6. Save Changesをクリックします。