ウェブアプリケーションで訪問者が使用するデバイスの画面サイズを記録できます。たとえば、サポートする画面解像度を決定する場合などに使用します。画面サイズはPendoがデフォルトで収集するフィールドではないため、アプリケーションから訪問者のメタデータまたはトラックイベントプロパティとして送信する必要があります。サブスクリプションにセッションリプレイが含まれている場合、各リプレイには記録時のブラウザウィンドウのサイズも表示されます。
表示したい内容に応じて、方法を選択してください。
- 訪問者メタデータ。 訪問者ごとに1つの値を保持し、アプリを読み込むたびに更新されます。画面サイズ別に訪問者数を集計したり、セグメントを作成したり、データエクスプローラのレポートをグループ化したりする場合に使用します。フィールドの履歴メタデータを有効にしない限り、Pendoは最新の値のみを保持します。
- トラックイベントプロパティ。 イベントが送信されるたびに1つの値が記録されます。トラックイベントの詳細ページやデータエクスプローラで、訪問者が使用したすべてのサイズと、各サイズが出現した頻度を確認する場合に使用します。
- セッションリプレイ。 録画された1つのセッションのブラウザウィンドウサイズが、リプレイプレーヤーに表示されます。1人の訪問者のセッションを確認し、そのウィンドウサイズを知りたい場合に使用します。
開始する前に
画面サイズをメタデータまたはトラックイベントとして送信するには、アプリケーションのコードを変更する必要があるため、開発者の協力が必要です。この記事の例では、訪問者の画面の解像度を示すブラウザの値であるwindow.screen.widthとwindow.screen.heightを使用します。代わりにブラウザウィンドウのサイズを記録するには、window.innerWidthとwindow.innerHeightを使用してください。
幅と高さを1つのテキスト値(1920x1080など)に組み合わせます。Pendoはテキスト値でレポートをグループ化できるため、1つに組み合わせた値を使用することで、画面サイズごとに1行が表示されます。
画面サイズを訪問者メタデータとして送信する
インストールスクリプトのvisitorオブジェクトに画面サイズを追加します。Pendoは最初に値を受信したときにメタデータフィールドを作成し、訪問者がアプリを読み込むたびに更新するため、各訪問者のレコードには最後に使用したサイズが保持されます。
- インストールスクリプトの
visitorオブジェクトにフィールドを追加します。例:visitor: { id: "VISITOR-UNIQUE-ID", screen_size: window.screen.width + "x" + window.screen.height } - 訪問者がアプリを読み込んだ後、[設定(Settings)] > [メタデータ(Metadata)]に移動し、フィールドが[訪問者レベルデータ(Visitor-level data)]タブに[テキスト(Text)]データ型で表示されていることを確認します。サブスクリプションで未定義のウェブSDKメタデータフィールドがブロックされている場合は、先にそこでフィールドを追加してください。詳細については、「未定義のウェブSDKメタデータフィールドをブロックする」を参照してください。
- 最新の値だけでなく訪問者が送信するすべての値を保持するには、フィールドの履歴メタデータを有効にします。詳細については、「履歴メタデータ」を参照してください。
このフィールドは、各訪問者の詳細ページおよびセグメントビルダーに表示されます。画面サイズ別に訪問者数を集計するには、データエクスプローラのレポートを作成し、[すべてのアクティビティ(Any activity)]を選択して、測定値を[ユニーク訪問者数(Number of unique visitors)]に設定し、[訪問者メタデータ(Visitor metadata)]の下にあるフィールドでグループ化します。詳細については、「訪問者とアカウントのメタデータを設定する」および「データエクスプローラのレポートを作成する」を参照してください。
トラックイベントで画面サイズを送信する
アプリの読み込み時、または任意に選択した他のタイミングで、画面サイズをイベントプロパティとして含むトラックイベントを送信します。Pendoはすべてのイベントで値を記録するため、各訪問者が使用したすべてのサイズと、各サイズが出現した頻度を確認できます。
- アプリケーションで、画面サイズをプロパティとして含むトラックイベントを送信します。例:
ガイド内のコードブロックからトラックイベントを送信して、ガイドが表示されたときにサイズを記録することもできます。詳細については、「トラックイベントを設定する」を参照してください。pendo.track("Screen size", { screen_size: window.screen.width + "x" + window.screen.height }); - [設定] > [イベントプロパティ(Event properties)]に移動し、プロパティの[タイプ(Type)]が文字列であることを確認します。このページを開くには、サブスクリプション管理者であるか、[イベントプロパティの管理(Manage event properties)]権限が必要です。トラックイベントプロパティはデフォルトで文字列として収集され、文字列値はデータエクスプローラでグループ化できます。
- [プロダクト(Product)] > [トラックイベント(Track Events)]に移動し、イベントを選択します。詳細ページ下部の[イベント内訳(Event breakdown)]テーブルには、訪問者が送信した各画面サイズが一覧表示されます。[訪問者(Visitor)]列を削除すると、画面サイズごとの[合計イベント数(Total Events)]が表示されます。
経時的にサイズを分析するには、トラックイベントを使用してデータエクスプローラのレポートを作成し、[イベントプロパティ]の下にあるプロパティでグループ化します。詳細については、「データエクスプローラのレポートを作成する」を参照してください。
リプレイでウィンドウサイズを表示する
セッションリプレイは、Pendoの有料アドオンです。サブスクリプションに含まれている場合、ウェブアプリケーション用のリプレイプレーヤーには、動画の下に訪問者のブラウザウィンドウの幅と高さがピクセル単位で表示されます。これは録画開始時点のサイズであり、そのリプレイにのみ適用されます。詳細については、「リプレイを視聴する」を参照してください。