ウェブアプリケーションの設定

最終更新日:

アプリケーション設定には、サブスクリプション設定からアクセスします。Pendoの右上から[設定(Settings)]>[サブスクリプション設定(Subscription settings)]に移動し、[Applications(アプリケーション)]タブを開きます。[アプリケーション(Applications)]リストからアプリケーションを見つけて開きます。

サブスクリプションに応じて、アプリケーションの設定は次のタブで構成されます。

アプリの詳細:基本設定

表示名(Display name) Pendo全体でアプリケーションに表示される名前。サブスクリプションの管理者は、いつでもこれを変更できます。
プラットフォーム(Platform) Pendoが展開されるアプリケーションの種類:ウェブ、モバイル(iOSなど)、拡張機能。
訪問者タイプ アプリケーションの主な訪問者タイプ:B2B(企業間)、B2C(企業対消費者)、またはB2E(企業対従業員)。このフィールドは情報提供のみを目的としており、請求には影響しません。
パブリックアプリID

アプリケーションをPendoに接続するために使用される32桁のコード。これは、インストールスクリプト、モバイルSDK、Googleタグマネージャー、またはTwilio Segmentを使用するすべての実装に関連します。

パブリックアプリIDは、サブスクリプション内の特定のアプリケーションに関連付けられるために、Pendoに送信されるデータを識別します。

これは秘密鍵ではなく、セキュリティやプライバシーとは無関係です。Pendoアプリケーションにデータを送信するためだけに使用され、データの読み取りアクセスはできません。

トラックイベントの共有秘密(Track Event shared secret) トラックイベントを特定のアプリに接続するためのキー。これは、サーバー側またはモバイルのトラックイベントにのみ関係します。詳細については、トラックイベントの設定を参照してください。
CNAME CNAME設定中に確立されたコンテンツドメインとデータドメインを表示します。この情報は、CNAMEが設定されている場合のみ表示されます。詳細については、PendoのCNAMEを参照してください。
匿名の訪問者にガイドを表示する 匿名の訪問者をガイドセグメントに含めるかどうかを制御します。デフォルトでは、この設定はオフになっています。この設定を変更する場合は、この変更の影響を受ける既存の各ガイドのセグメントもリセットする必要があります。詳細については、匿名の訪問者を参照してください。
トラックイベントをアプリ滞在時間としてカウント トラックイベントをユーザーのアプリケーション滞在時間としてカウントできるようにします。この設定は、デフォルトではオフになっています。
グローバルCSSをオフにする

グローバルCSS内で行われた設定をバイパスし、プロダクトの標準CSSと、Pendoガイド要素に含まれるスタイルとテーマのみに依存します。

この設定は、デフォルトではオフになっています。

推奨ページ イベントデータのURLに基づいて推奨されるページルールを生成します。この機能を使用して推奨タグを承認または削除すると、訪問者が過去5日間に見たURLを表すページをPendoですばやく作成することができます。任意のアプリケーションでオンにすると、[推奨ページ(Suggested Pages)]テーブルがサブスクリプション全体に表示されます。
ページのイベントプロパティ

URLが変更されていないときにページタグを作成できるようにします。この設定により、個人データを収集してPendoに送信できます。お客様の会社の個人データの収集と処理に関するポリシーに留意してください。Pendoにおける個人データの取り扱いについては、データ収集とコンプライアンスを参照してください。ご質問がある場合は、Pendoサポートにお問い合わせください。

この設定をオンにすると、[ページタイトルの収集]設定が表示されます。

ページタイトルの収集

この設定は、ページのイベントプロパティがオンになっている場合にのみ表示されます。

Web SDKが収集したURLに、各ウェブページの<title>値を追加します。タイトルは「pendo_document_title」というクエリパラメータとして追加されます。たとえば、www.example.com/homeのタイトルが「Welcome Page」の場合、URLはhttps://www.example.com/home?_pendo_document_title=Welcome+Pageとして取得されます。

兄弟セレクター この設定は、Pendoサポートでこれを有効にした場合のみ表示されます。これにより、フィーチャールールとアプリケーション内の別のUI要素とを1対1でつなぐことができます。
コンソールログのキャプチャ 訪問者セッション中にコンソールメッセージ(console.log()console.warn()console.error())の収集を有効にします。これらのログはセッションリプレイの開発者ツール内に表示され、ウェブアプリでのみ利用可能です。ログは、サブスクリプションのデータ保持ポリシーに従って保持されます。
ネットワークログのキャプチャ 訪問者セッション中にブラウザのネットワークリクエストとレスポンスの収集を有効にします。これらのログはセッションリプレイの開発者ツール内に表示され、ウェブアプリでのみ利用可能です。ログは、サブスクリプションのデータ保持ポリシーに従って保持されます。
ブランディングを追加

Pendoでこのアプリケーションを表すファビコン(小さな画像)を割り当てます。デフォルトでは、ファビコンはアプリの種類(ウェブアプリの場合はデスクトップパソコン、拡張アプリの場合はパズルのピース、モバイルアプリの場合はAndroidまたはAppleのロゴ)に基づいて割り当てられます(カスタム画像はモバイルではサポートされていません)。

ファビコンを割り当てるには、[置き換え(Replace)]を選択し、アプリケーションのURLを入力するか、画像をアップロードします。画像は24 x 24ピクセルで、1MB以下である必要があります。割り当てられると、ファビコンはPendo全体のフィルター、テーブル、レポートの視覚化でアプリケーションの横に表示されます。

タグ命名規則 Pendo AIが命名規則に基づいて、より適切なタグ名を提案できるようにします。この機能を使用するには、サブスクリプション設定で「AIタグ名提案機能」をオンにします。ページとフィーチャーの命名規則を入力して、提案を生成してください。必要に応じて命名規則を更新できます。

アプリの詳細:Cookieとデータプライバシー

Pendoがデータを処理する方法とプライバシーを保護するために必要な手順の詳細については、データ収集とコンプライアンスを参照してください。

Cookieの有効期間 ユーザーにセッションCookieが付与されると、通常、サーバー側で有効期限(TTL)が設定され、設定された期間後に有効期限が切れます。この設定により、Pendo Web SDKが設定したウェブブラウザのCookieが失効するまでの最大有効日数を設定することができます。
Cookieの更新を防止する Cookieの有効期限のタイムスタンプが更新されないようにします。つまり、Cookieの値が変更されない場合、最終的には期限切れになります。この操作は推奨しません。
Cookieドメイン(Cookie domain)

アプリの特定のドメインまたはサブドメインでWeb SDKのCookieを有効にすることができます。これは、インストールスクリプトで直接定義することもできます。

ドメインを共有するアプリ間でクッキーを共有したい場合は、[クロスアプリのCookieとローカルストレージ]設定をオンにします。詳細については、匿名訪問者のサブドメイン間の追跡を参照してください。

クロスアプリのCookieとローカルストレージ

クライアント側ストレージを持つアプリでは、同じウェブドメイン内のアプリ間での訪問者IDの共有をサポートします。Web SDK Cookieは、サブドメイン間で訪問者を識別するために必要です。この設定は、拡張アプリでは使用できません。

この設定は、デフォルトではオフになっています。

POSTリクエストのみを使用してPendoにデータを送信 GETリクエストではなくPOSTリクエストでのみ、Pendoにデータを送り返します。この設定は、デフォルトではオフになっています。
ローカルストレージが利用できない場合にCookieを使用しない(Don't use cookies when local storage is unavailable)

ローカルストレージが利用できない場合に、Pendo Web SDKがCookieを使用しないようにします。この設定はデフォルトではオンになっています。

デフォルトでは、Web SDKはローカルストレージに読み込まれます。ローカルストレージが利用できない場合(例:ストレージがいっぱいである、訪問者のブラウザタイプでは利用できない)、PendoはファーストパーティCookieに依存して読み込みを行います。詳細については、Cookieとローカルストレージを参照してください。

Web SDKのユーザーIDの永続化をオフにする

Web SDKの読み込み時に既存のクライアント側の訪問者データを削除します。これはデータ収集に影響を与えますが、通常はごくわずかです。

デフォルトではこの設定はオフになっており、ユーザーの訪問者IDが利用可能になる前にPendo Web SDKが初期化された場合、Pendoはブラウザストレージを検索してイベントを正しい訪問者IDに関連付けます。この設定により、ブラウザのストレージがクリアされ、今後このような動作が発生しないようになります。

クライアント側ストレージをオフにする

Cookieとローカルストレージをオフにします。これは、[アプリの詳細][Cookieとデータプライバシー]セクションにある他のすべての設定をオフにするなど、広範囲にわたるさまざまな影響を及ぼします。

この設定は、デフォルトではオフになっています。

アプリの詳細:エンジニア設定

アプリケーションID アプリケーションの一意の識別子。
Feedbackの自動初期化をオフにする Pendoがインストールされ初期化された後、Pendo.feedback.initを使ってアプリケーションが明示的にクラシックFeedbackを起動するのを待ちます。この設定は、明示的に起動するまで、Pendo Web SDKがクラシックFeedbackをオンにしないようにするものです。
MutationObserverを500msタイマーに優先する MutationObserver APIを使用してDOMの変更を検出し、ガイドのタイミングに影響を与えます。この設定がオフの場合、500ミリ秒の設定間隔でDOMの変更をチェックし、どのガイドをいつ表示すべきかを確認します。
Shadow DOM要素でMutationObserverを使用する Shadow DOMを使用するアプリケーションの応答性を向上させ、動作をガイドするために、Shadowルート要素用のDOMオブザーバーを追加します。この設定は、MutationObserverのロジックを拡張して、シャドウツリー内の変更を監視するようにします。
複数フレームのサポートにBroadcastChannelを優先する

BroadcastChannel APIを使用して、同じオリジン(ドメイン)内で実行されている異なるiframe間で通信します。この設定は、複数のフレームを持つアプリケーションにのみ関係します。

この設定はデフォルトではオンになっています。

unloadイベントの代わりに可視性APIを使用する(Use visibility API instead of unload event) ページ可視性APIを使用して、ページがいつ表示または非表示になるか(たとえば、ユーザーがタブを切り替えたり、ウィンドウを最小化したとき)を検出します。Chromeでは「アンロード」イベントを廃止するため、この設定をオンにできます。旧バージョンのブラウザを使用している場合は、この設定は使用できません。
削除された要素のクリックキャプチャを試みる(Attempt click capture on removed elements) ユーザーアクションの結果としてDOMから削除された要素のクリックイベント(たとえば、ボタンをクリックすると、そのボタンが削除される)でもPendoは検出を試みます。

Web SDKの設定

[Web SDKの設定]タブでは、以下の操作が可能です。

  • ステージング環境本番環境で使用するPendo Web SDKのバージョンを管理する。詳細については、Pendo Web SDKの設定を参照してください。
  • Pendoを本番環境で有効化する。この設定をオフにすると、Pendo Web SDKの実行が停止するため、このアクションを実行するPendo ユーザーによる明示的な確認が必要になります。Pendo Web SDKをセルフホスティングしている場合、別のPendo Web SDKをダウンロードしない限り、この設定は影響しません。詳細については、Pendo Web SDKの設定を参照してください。
  • Pendoデバッガーツールにアクセスして、アプリの問題をトラブルシューティングする。詳細については、Pendo Web SDKデバッガーを参照してください。
  • データ収集において、PendoのデフォルトのHTML属性に加えてカスタムHTML属性を収集する。同じ設定には、タグ付けとガイドの設定タブからアクセスできます。カスタムHTML属性は次の用途に使用できます。
    • 手動自動の両方によるフィーチャーのタグ付け
    • ツールチップガイドの配置

イベントの生データ

Pendoは、アプリケーションでのユーザーインタラクションを「イベント」の生データとして収集し、このタブの[イベント]テーブルに表示します。詳細については、Pendoのデータ処理と可視性を参照してください。このテーブルには、次の情報が含まれています。

  • ブラウザの時間(Browser Time):訪問者のブラウザで取得されたイベントの生データのタイムスタンプ。
  • Web SDKのバージョン。訪問者のブラウザによってキャプチャされたPendo Web SDKのバージョン。これは、Web SDKの設定タブで現在のSDKバージョンと照合できます。
  • 訪問者(Visitor):イベントを作成したエンドユーザーの訪問者ID。
  • アカウント(Account):イベントの生データが収集される時点で訪問者が属しているアカウントのアカウントID。
  • イベント(Events):クリック読み込みフォーカスなどのイベントの生データのタイプ。
  • リモートIP(Remote IP):イベントの生データの発信元のパブリックIPアドレス。
  • ブラウザ/OS(Browser / OS):イベントの生データが発生したブラウザとオペレーティングシステム。
  • URL:イベントの生データが発生したアプリケーションのページのアドレス。
  • アプリ(App):イベントの生データが発生したアプリケーション。

データ同期をご利用のお客様は、データレイクやウェアハウスにデータを送信することで、Pendoが収集するイベントの生データにアクセスでき、その後さまざまなBIツールに送信できます。詳細については、Pendoのデータ同期機能の概要を参照してください。

インストール設定

ここでは、カスタマイズしたバージョンのコードをアプリケーションに挿入して、Pendoを直接実装するために必要なインストールスクリプトを見つけることができます。インストールスクリプトを使用したPendoの実装には、複数のオプションがあります。詳細については、直接インストールのオプションを参照してください。

ローカライズ設定

ここで、サブスクリプション内の特定のアプリケーションのガイドとリソースセンターのローカライズ設定を有効にして構成します。詳細と手順については、ローカライズを参照してください。

設定

ローカライズ アプリケーションのガイドとリソースセンターで複数の言語をサポートし、訪問者が希望する言語で表示できるようにします。
言語設定メタデータ(Language Preference Metadata) サポートされている言語に関連付けるために使用するメタデータ値を識別するために、Pendoが使用するメタデータフィールド名を指定できます。

サポートされている言語

ガイドとリソースセンターの翻訳用に選択された言語と関連するメタデータ値のリストです。言語を追加して、翻訳できるようにします。これらの言語は、翻訳言語がない場合の動作を判断するときに使用されます。

翻訳言語がない場合の動作

[翻訳がない場合、デフォルトの言語を表示する(Show Default Language if Translation is Missing)]では、翻訳版が利用できない場合に、訪問者にデフォルトの言語でガイドを表示するかどうかを制御できます。

公開済みのガイドまたはリソースセンターの翻訳がない場合、この設定では代わりにデフォルトの言語が表示されます。オフに設定されていると、訪問者の言語メタデータがサポートされている言語と一致しない場合、訪問者にはガイドやリソースセンターが表示されないことがあります。

ロケールフォールバックを使用すると、ガイドやリソースセンターに特定のロケールの翻訳がない場合に、より広範な言語でコンテンツを表示できます。例えば、スペイン語(メキシコ)が利用できない場合、Pendoは代わりにスペイン語を表示します(そのバージョンが存在する場合)。

タグ付けとガイドの設定

ビジュアルデザインスタジオ(Visual Design Studio)でのタグ付けとガイド作成の仕組みを設定します。アプリケーション設定のこのタブの設定の詳細については、ビジュアルデザインスタジオをガイドとタグ付け用に設定するを参照してください。

基本設定

基本設定では、ビジュアルデザインスタジオの起動動作を変更できます。以下のような動作があります。

  • デザイナー起動URLトークンを無効化する。これはデバッグ設定で、通常はPendoサポートが使用します。起動URLトークンをオフにし、window.openerメソッドを使用してビジュアルデザインスタジオで新しいタブを開きます。
  • ガイドコードブロックへのアクセスを阻止する。アプリケーション内のガイドのカスタムコードブロック要素へのアクセスをオフにします。この設定を更新するには、Pendoの担当者までお問い合わせください。
  • ガイドデザイナーのキーボードショートカットを無効化する。ビジュアルデザインスタジオを起動するための標準のキーボードショートカット(WindowsではAlt + Shift、MacではOption + Shift)をオフにします。

詳細については、ビジュアルデザインスタジオをガイドとタグ付け用に設定するを参照してください。

カスタムHTML属性

カスタムHTML属性を追加して自動タグ付けを有効にすると、カスタムHTML属性に関連付けられた要素がクリックされたときにフィーチャーが自動的に作成されます。カスタムHTML属性に関連する設定は以下の通りです。

  • カスタムHTML属性を収集。すでに収集されているデフォルトの属性に加えて、Pendo用のカスタムHTML属性を追加してイベントの生データに記録できます。詳細については、カスタムHTML属性を参照してください。
    • タグルールの提案時に動的属性値を許可。Pendoが動的であると判断したカスタムHTML属性の値(例えば、数字や記号の多い値、珍しい文字の組み合わせ、母音を含まない値)をPendoがフィルタリングするかどうかを制御します。これにより、不安定な値や自動生成された値が提案ルールで使用されるのを防ぐことができます。この設定は、デフォルトではオフになっています。詳細については、カスタムHTML属性を参照してください。
  • カスタムHTML属性による自動タグ付け。カスタムHTML属性のフィーチャーがクリックされたときに自動的に追加されます。詳細については、カスタムHTML属性によるフィーチャーの自動タグ付けをご覧ください。

除外事項

フィーチャーにタグ付けしてガイドを配置する際に、ビジュアルデザインスタジオの[推奨される一致(Suggested Match)]オプションから特定のCSSクラスとIDを除外できます。

  • 推奨される一致クラスの除外。フィーチャーにタグ付けしてガイドを配置する際に、ビジュアルデザインスタジオの[推奨される一致]オプションから特定のCSSクラスを除外できます。
  • 推奨される一致IDの除外。フィーチャーにタグ付けしてガイドを配置する際に、ビジュアルデザインスタジオの[推奨される一致]オプションから特定のIDを除外できます。

詳細については、ビジュアルデザインスタジオをガイドとタグ付け用に設定するを参照してください。

リプレイ設定

このタブは、サブスクリプションのアドオンとしてセッションリプレイを購入した場合にのみ表示されます。

プライバシー設定

この設定では、ウェブおよびモバイルアプリケーションと訪問者との対話を収集するリプレイでアプリケーションがどのように表示されるかを制御します。

初期設定オプションを選択した後、このセクションを使用してPendoリプレイのプライバシーを調整します。

  • ウェブアプリケーション用に、Pendoリプレイで特定の要素をマスク、マスク解除、またはブロックするためのセレクタールールを作成します。
  • モバイルアプリケーションでは、[画像をブロック]をオンにして、Pendoリプレイで画像が表示されないようにし、機密コンテンツが露出するリスクを軽減します。

詳細については、セッションリプレイのプライバシーを参照してください。

リプレイ取得設定

  • オーディエンスを追加。セグメントを選択または作成して、リプレイで取得する訪問者を定義します。
  • 非アクティブタイムアウト。訪問者が一定時間非アクティブになった後、リプレイが終了するまでの時間を選択します。デフォルトでは、非アクティブ時間の最大値は30分に設定されています。(ウェブアプリケーションでのみ利用可能です。)

詳細については、セッションリプレイを有効にするを参照してください。

無視されたフラストレーション

この表には、Pendoリプレイまたはフィーチャーの詳細ページで[フラストレーションタイプ]として無視するを選択したすべてのフィーチャーが表示されます。このオプションを選択すると、フラストレーションがフィーチャーの予想される動作としてマークされ、現在と将来のすべてのリプレイでこのフィーチャーとのインタラクションがフラストレーションとしてフラグ付けされないようになります。

詳細については、「リプレイを見る」をご参照ください。

Pendoリプレイの有効化

セッションリプレイをオンまたはオフにします。詳細については、セッションリプレイを有効にするを参照してください。

この記事は役に立ちましたか?
0人中0人がこの記事が役に立ったと言っています