WebアプリケーションのURLを変更する際のベストプラクティス

この記事は、Pendoのインストールスクリプトまたはブラウザ拡張を通じてPendoがインストールされているWebアプリケーションに適用されます。アプリケーションのURLが変更される場合は、以下の手順に従って、Pendoのサブスクリプションに変更が必要かどうかを確認してください。

インストールとURLの変更を確認する

アプリケーションのURLを変更する前に、Pendoがどのようにインストールされているか、そしてURL構造のどの部分が具体的に変更されるかを確認してください。

Pendoがインストールされたままになることを確認する

インストールスクリプトを通じてPendoをインストールしている場合、URL変更後もPendoのインストールスクリプトがインストールされたままとなることを開発者に確認してください。Pendoを新しい環境に追加する場合は、Pendoインストールスクリプトが追加されていることを確認してください。

Pendoがブラウザ拡張機能経由でインストールされている場合：

1. ［設定］>［サブスクリプション設定］>［アプリケーション］に移動し、特定のアプリケーションを選択してください。
2. ウェブサイトの行にカーソルを合わせて、編集アイコンを選択します。
3. 必要に応じてドメインを追加するか、既存のドメインを編集してください。

URL のどの部分が変更されているかを確認する

URL構造を見る場合、https://と最初の/の間にあるものをドメインとみなします。最初の/以降のすべてはドメインとはみなされません。

ドメインのみを変更する例を以下に示します。

• 古いURL： https://acmecrm.io/dashboards/sales-metrics
• 新しいURL：https://app.product.io/dashboards/sales-metrics

ドメインだけでなく、他の部分も変更される例を以下に示します。

• 古いURL： https://acmecrm.io/dashboards/sales-metrics
• 新しいURL：https://app.product.io/reports/dashboards/sales-metrics

URLの変更がユーザー体験に影響するかどうかを確認する

URLのみが変更され、旧URLと新URLで製品体験が同一である場合は、既存のページタグを修正し、単一のページタグを使用して旧URLと新URLの両方を追跡する必要があります。ユーザー体験も変化している場合は、利用状況を別途追跡するために新しいページタグを作成することをお勧めします。これは、特定の体験にのみ関連するフィーチャータグやガイドにも役立ちます。

ページタグを確認して更新する

インストールを確認した後、既存のページタグが更新されたURLと一致しているかどうかを確認してください。

現在のページタグをエクスポートする

1. ［プロダクト（Product）］>［ページ（Pages）］に移動します。
2. ［列を管理］を選択し、包含ルールと除外ルールを追加します。
3. テーブルをCSVファイルとしてエクスポートします。

現在のルールを評価する

包含ルール」と除外ルールの列を確認してください。

• ルールが//*で始まる場合、ドメインはワイルドカードとなり、このルールは任意のドメインの URL に一致します。
• ルールがドメイン( //app.acme.io)で始まる場合、このルールは、その特定のドメインを持つURLのみに一致します。

既存のページタグを更新する（ユーザー体験が変わらない場合）

• ドメインのみが変更される場合は、現在のページルールでワイルドカードドメインが使用されていることを確認してください。
• URLの残りの部分が変更される場合は、新しいURLと一致するように既存のページタグに新しいルールを追加してください。

新しいページタグを作成する（ユーザー体験が異なる場合）

1. 元のページタグは古いURLに合わせてそのままにしてください。
2. 新しいURLに一致する新しいページタグを作成してください。

ページのタグ付けに関する詳しい手順については、「ページのタグ付け」および「ページのタグ付けを行うURL」を参照してください。ページタグの一括作成や編集についてのサポートが必要な場合は、サポートチームまでご連絡ください。

ガイドとフィーチャータグを確認する

新しいページタグを作成したり、ユーザー体験を変更したりした場合は、ガイドとフィーチャータグを見直して、期待どおりに機能することを確認しましょう。

ガイド（Guides）

• 公開されている各ガイドを開き、ガイドの内容を更新する必要があるかどうかを確認してください。
• ガイドステップが特定のターゲットページを対象としている場合は、割り当てられたタグが正確であることを確認してください。
• ガイドステップが要素に固定されている場合は、設定されたCSSセレクターがその要素と一致していることを確認してください。

フィーチャー

• CSSセレクタールールが正しいUI要素に一致しているか確認するために、機能タグを確認しましょう。
• CSSセレクターが変更された場合は、既存の機能ルールを更新するか、新しい機能タグを作成してください。

関連するサブスクリプション設定を確認する

最後に、関連するサブスクリプション設定を確認し、ステージング、ドメインフィルター、CNAMEが新しいURLと一致するようにしてください。

ステージングドメイン

ガイドをテストするためにステージング環境を使用する場合：

1. ページ右上の［設定］>［ステージング］に移動します。
2. 必要に応じてドメインを追加・更新できます。

除外リストと包含リスト

Pendoに非本番環境のイベントを除外させたい場合は：

1. ページ右上の ［設定］>［除外リストと包含リスト］に移動します。
2. ［サーバーホスト/ドメイン］のセクションで、関連するドメインを追加または更新します。

CNAME設定（ドメイン変更のみ）

アプリケーションでCNAMEが有効になっている場合は、新しいドメイン用に新しいCNAMEレコードを設定し、Pendoでアプリケーションに割り当てる必要がある場合があります。これらの変更を行うには、当社サポートチームと調整してください。