このページでは

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

自動キャプチャ

Amplitude アカデミー

自動キャプチャとビジュアルラベル付けを使用してウェブサイトのクリックを追跡

自動キャプチャとビジュアルラベル付けを使用してウェブサイトのクリックイベントを定義する方法を学び、Amplitudeの実装を簡素化して、プロダクトの使用状況に関するインサイトを迅速に引き出しましょう。

今すぐ始める

Autocaptureは、事前定義済みの一連のユーザーインタラクションを、1つのSDKスニペットを使用してウェブサイトやアプリから収集します。イベントごとの計測は行いません。ウェブでは、ブラウザ SDK を使用してセッション、ページビュー、クリック数、フォームのインタラクション、ファイルのダウンロード、マーケティング アトリビューション、ページ URL の拡張をキャプチャします。iOS および Android では、iOS Swift SDK および Android-Kotlin SDK を使用してインストール、アップグレード、セッション、画面表示をキャプチャします。 カスタムイベントトラッキングの範囲を特定する前に、プロダクト分析のベースラインを迅速に取得したい場合は、この機能を有効にしてください。

計装作業なしで幅広いベースラインをすぐにカバーしたい場合は、自動キャプチャを使用してください。 購入や機能固有のアクションなど、特定のビジネスロジックに関連付けられたカスタムイベントやプロパティが必要な場合は、正確なトラッキングを使用してください。 この 2 つは連携して機能するため、ほとんどのチームは両方を実行しています。

ウェブ上では、ビジュアルラベルを使用してサイトをナビゲートしたり、クリック情報から新しいイベントを作成したりすることもできます。

自動キャプチャと正確な追跡

Amplitudeはイベントをキャプチャするための2つの主な方法を提供します。

  • 自動キャプチャは、Amplitude SDKを使用して、標準化されたタクソノミーで事前定義された一連のイベントとプロパティを自動的に収集します。
  • お客様のビジネスニーズと分析に特有の機器イベントとプロパティを正確に追跡できます。

SDKをインストールした瞬間から、Amplitudeは自動的にデータを収集し、機能の使用状況、ファネルコンバージョン率、ウェブ上のクリック分析に関するインサイトを提供します。 また、ブラウザSDKは、過去のページの追跡やページタイプの分類など、ページURL情報を使用してすべてのイベントを強化します。自動キャプチャ機能はセットアップ時間を最小限に抑えるため、すぐに分析に移行できます。

アプリケーション内で追加のメタデータを必要とする特定のアクションを調査したり、ビジネスにとって中核となる可能性のある購入イベントなどのイベントを追跡したりするには、精密トラッキングを使用します。コード内の精密トラッキングは、これらのイベントを堅牢なプロパティセットとともに送信し、より詳細な分析を行います。

たとえば、新しい機能をリリースしようとしているが、正確なトラッキングを実装する時間がないとします。 自動キャプチャは、ベースライン指標を収集したり、エンゲージメントに関する質問に回答したりするためのセーフティネットとして機能できます。 これらのインサイトを得てより深く掘り下げたいと思ったら、チームと協力して正確に追跡されたイベントを実装し、両方のアプローチを最大限に活用してください。

イベントの量を最適化

Autocaptureには、お客様のニーズに合わせて実装を調整するのに役立ついくつかの設定オプションがあります。必要に応じて個々のAutocaptureイベントをオン/オフにしたり、これらのイベントをさらに調整してイベントのボリュームを最適化できます。

デフォルトの設定では、重要なイベントを自動的にキャプチャし、それ以外のイベントを除外するという適切なバランスがとれています。 このバランスはクリックをキャプチャする際に重要です。 デフォルトでは、Amplitudeはインタラクティブ要素（リンク、テキストフィールド、ドロップダウン、その他のフォーム要素など）のクリックをキャプチャします。 また、Amplitudeはページ上の変更（新しいビジュアル要素など）や新しいページへのナビゲーションをもたらす要素へのクリックをキャプチャします。 この設定では、空白領域へのクリックやテキストの強調表示などを除外することで、価値の低いユーザーの行動に対して料金が発生しないようにします。

Amplitudeは、変更を加える際にイベントボリュームを監視することをお勧めします（設定 > プランと請求に移動してください）。イベントボリュームが期待どおりであることを確認してください。 設定を変更して、特定の要素（または特定のクラスを持つ要素）でのみクリックをキャプチャしたり、特定のページでのみトラッキングしたり、ページビューやセッションなどの他の自動キャプチャデータを使用しながらクリックトラッキングをオフにしたりできます。

Autocaptureによるお客様のタクソノミー

タクソノミーをきれいに整理しておくことで、ユーザーが必要とするものを見つけることができます。自動キャプチャを有効にすると、事前定義されたイベントとプロパティタイプのセットを取得して取り込みます。たとえば、SDKはクリック操作を、騒々しいユーザー操作のストリームではなく、事前に定義されたプロパティセットを持つ2つのイベント(「要素がクリックされました」と「要素が変更されました」)としてキャプチャします。

ビジュアルラベル付けを使用すると、組織内のユーザーはUIから直接イベントを作成できます。 タクソノミーを計画する際には、次の点を考慮してください。

  • 各ユーザーに適切な権限を設定してください。 メンバー以上のロールを持つユーザーは、ラベル付きイベントを作成できます。
  • 命名規則を、ラベル付きイベントの既存のタクソノミーと一致させてください。
  • ラベル付けされたイベントに説明を追加することで、他のユーザーがイベントの目的を理解できるようにします。

ラベル付きイベントに関するその他の詳細情報：

  • ラベル付きイベントには、「*データ」>「イベント」*という別のタブがあります。これにより、未処理の取り込みイベントとは異なる方法でイベントを管理できます。 このタブには、ラベル付きイベントを作成したユーザーと各イベントの作成日が表示されます。
  • ラベル付きイベントはイベントドロップダウンに異なるアイコンが表示されるため、あなたとユーザーはこれらのイベントを他のイベントと区別できます。

プライバシーとセキュリティ

多くの組織にとって、データのプライバシー、セキュリティ、および個人を特定できる情報（PII）はデータ収集を設定する際の重要な要素です。 ビジネスニーズ、デジタル製品の目的、コンプライアンス要件は管轄区域によって異なる場合があります。 あらゆる状況に適した1つのソリューションは存在しません。

Autocaptureは柔軟な設定オプションを提供しており、お客様の会社のプライバシーとセキュリティに関するポリシーと要件を順守するのに役立ちます。Amplitudeの使用がお客様のデータプライバシーポリシーと要件に準拠していることを確認することはお客様の責任ですが、これらの設定はコンプライアンスを達成するのに役立ちます。

デフォルトのAutocapture保護

Autocaptureが収集してAmplitudeプラットフォームに送信する情報を制御できます。 AutocaptureがAmplitudeに送信するイベントを更新するには、ブラウザSDK | Autocaptureを無効にするを参照してください。

次のリストは、ページ要素のクリックと変更をキャプチャするためのAutocaptureのデフォルト設定（「Element Clicked」イベントと「Element Changed」イベント）について説明しています。このリストには、以下のプライバシーとセキュリティに関する考慮事項も含まれています。 これらの保護を有効にするために何かをする必要はありません。 これらは常にアクティブです。

  • エンドユーザーによるテキスト入力、選択項目、テキスト領域要素、属性として指定されているすべての HTML 要素などの機密要素については、SDK はcontenteditable="true"クラス名と type 属性のみを収集します。 自動キャプチャでは、エンドユーザーが入力したテキストはすべて除外されます。
  • 自動キャプチャのデフォルト設定では、パスワードや隠し属性を持つフォームフィールドなどの機密入力フィールドの収集をさらに制限し、クラス属性値とタイプ属性値のみをキャプチャします。自動キャプチャでは、エンドユーザーが入力フィールドに入力したコンテンツなど、これらの要素に関するその他の詳細情報はキャプチャされません。
  • 自動キャプチャは、ウェブサイトやアプリに表示されるテキストをキャプチャします。 たとえば、クリックされた要素のコンテンツ (textContent) とその子です。 Amplitudeは、機密情報を含む可能性があるページで自動キャプチャの要素インタラクショントラッキングを使用することを推奨していません。Amplitudeはパターンマッチングを使用して、クレジットカード番号、社会保障番号、または電子メールアドレスのようなテキストコンテンツを自動的にマスクします。
  • これらの属性収集規則の例外は、要素に接頭辞 data-amp-track- が付加された明示的な属性がある場合です。 この例外により、これらの属性のデータは意図的にAmplitudeに渡されます。
  • 自動キャプチャは自動的に値、イベントハンドラ、スタイル、およびreact属性を削除します。
  • <title>要素にdata-amp-mask属性を追加することで、ページビューイベントでページタイトルをマスクできます。これにより、実際のタイトルがマスクされた値に置き換えられ、機密情報を保護できます。 実装の詳細については、ブラウザSDKのページタイトルマスキングを参照してください。

手動による自動キャプチャ保護

Amplitudeは、実装を選択した場合に以下の自動キャプチャ保護を提供します。デフォルトでは、Amplitudeはこれらを有効にしません。 以下に示す保護機能のすべてまたは一部を有効にできます。

これらの保護の一部については、要素に属性を追加する必要があります。 これらの保護の一部は、*[データ設定]>[自動キャプチャ]*ページで有効にできます。 各保護の有効化方法については、各保護のドキュメントを参照してください。

正確なテキストマスキング

正確なテキストマスキングは、ページ上の特定の要素から取得されたテキストを墨消しします。この属性は、それらの要素に表示されているテキストをマスクしながら、クリックを追跡します。

要素のテキストをマスクするには、その要素に属性data-amp-maskを追加します。たとえば、ボタンに次のような文字があるとします。

html
<div data-amp-mask>John Doe</div>

自動キャプチャは引き続き div 要素へのクリックを追跡します。 ただし、テキストコンテンツ「John Doe」は、自動キャプチャデータ内では*****そのように表示されます。この除外は SDK レベルで機能します。

正確なテキストマスキングは再帰的に機能するため、オートキャプチャは要素に含まれるすべてのテキストをマスキングします。 例えば：

html
<div data-amp-mask>
  John Doe
  <div>Jane Doe</div>
</div>

この例では、自動キャプチャは両方の名前を ***** でマスクします。

正確な属性マスキング

正確な属性マスキングは、キャプチャから特定の HTML 属性を削除します。 どの属性をマスクするかを定義すると、自動キャプチャは HTML 内のそれらの属性を編集しながらクリックを追跡します。 ある要素に属性を指定すると、その属性がすべての子要素にもマスクされます。

たとえば、次の属性を含めるとします。

html
<div data-amp-mask-attributes="name">
     <span name="John D">Account</span>
</div>

ボタンまたはリンク上では、自動キャプチャは 「John D」という名前を ***** でマスクします。

リストを使用して、マスクする複数の属性を指定することもできます。 リストを使用する場合、マスキング属性を「 data-amp-mask-attributes="name,ssn"」としてフォーマットします。

ID 属性と Class 属性は視覚的なラベル付けにとって重要であるため、情報をマスクすることはできません。

パターン（正規表現）マスキング

指定したパターン（正規表現またはRegEx）に基づいて情報をマスクできます。RegExについてよく知らない場合は、正規表現に関するこちらのページを確認してください。

Autocaptureがマスクする情報のパターンを指定します。この設定は SDK 内で行われ、Amplitude が電子メール、クレジットカード、社会保障番号を隠すために使用するデフォルトのパターンに追加の保護レイヤーを提供します。 RegExフィルターは、このデータが表示される可能性があるすべてのフィールド（ページ上の表示フィールドと非表示属性の両方を含む）の値をマスクします。

たとえば、RegEx パターンを設定して、****-**** **** 1234 などのクレジットカード番号をフィルタリングできます。 この例では、最後の 4 桁を含むクレジット カード情報を完全にマスクしたいと考えています。 RegEx フィルタを追加します/(?i)ends\s*in\s*[0-9]{4}/。Amplitudeがパターンに一致するクレジットカード情報を検出した場合、自動キャプチャはその番号を「*****」としてマスクします。

この機能は、「*データ設定」>「自動キャプチャ」>「要素の相互作用」*ページで有効にします。

ページURLの除外リストと許可リスト

ページ URL の除外リストと許可リストを使用して、自動キャプチャから除外または自動キャプチャに含める固有の URL パターンを指定できます。これらの機能は、組織がより厳しい制限や保護措置を必要としている場合や、ウェブサイトやアプリに金融サービス、ヘルスケア、医療技術などの極めて機密性の高いデータを含むページが含まれている可能性がある場合に使用してください。

たとえば、ユーザーのアカウント設定やテストデータのみを含むURLなど、URL上の特定のサブドメインからユーザーアクティビティを除外できます。

.comや .co.uk などの複数のドメインでサイトをホストしている場合は、その.co.ukドメインからのデータのみを含めることを指定してください。

例

上記の.com および .co.ukの例を使用して、除外リストと許可リストの例を次に示します。

除外リスト

  • 除外リストに glob パターンとしてhttps://example.co.uk/account/*追加します。 このパターンは、アカウントセクションを除く.co.ukドメイン上のすべてのものをキャプチャします。

許可リスト

  • 許可リストに glob パターンとしてhttps://example.co.uk/*追加します。 Amplitudeは.co.ukドメインからのデータのみをキャプチャします。 Amplitudeは.comドメインからデータを取得しません。

除外リストは常に許可リストよりも優先されます。 この優先順位により、不要なデータをキャプチャすることができなくなります。 除外リストと許可リストの両方に同じパターンを含めると、オートキャプチャはそのパターンを除外します。

この機能は、「*データ設定」>「自動キャプチャ」>「要素の相互作用」*ページで有効にします。

クリック追跡を制限する

視覚的なラベル付けをサポートするために、オートキャプチャはクリックまたは変更された要素に関するインタラクション情報と、HTML構造内の要素の親に関する情報をキャプチャします。 サイトの構造に応じて、次のことが可能です。

  • クリックと変更の追跡が可能な要素を改良します。 cssSelectorAllowlist オプションと actionClickAllowlist オプションを設定して、オートキャプチャが追跡できる要素のリストを変更します。 すべての一般的な HTML 要素を削除し、特定のクラスを持つ要素に制限することができます。

この機能は、「*データ設定」>「自動キャプチャ」>「要素の相互作用」*ページで有効にします。

自動キャプチャイベントをオフにする

自動キャプチャを完全にオフにし、データ収集に精密なトラッキングを使用できます。 Amplitudeには、カスタムタクソノミーの計画と実装をサポートする堅牢なデータ管理ツールとワークフローが含まれています。

SDK設定を通じて、一部またはすべての自動キャプチャイベントをオフにします。

これは役に立ちましたか？