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

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

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

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

インストールスクリプトでPendoをインストールしている場合：URL変更後もインストールスクリプトがインストールされたままになることを開発者に確認してください。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のプロダクト体験が同じである場合は、既存のページタグを変更し、1つのページタグを使用して古いURLと新しいURLの両方を追跡する必要があります。ユーザー体験も変化している場合は、新しいページタグを作成して使用状況を個別に追跡することをお勧めします。また、特定の体験にのみ関連するフィーチャータグやガイドにも役立ちます。

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

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

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

現在のルールを評価する

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

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

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

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

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

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

ページタグ付けに関する詳しいガイダンスについては、ページのタグ付けおよびページのタグ付けを行うURLをご覧ください。ページタグの一括作成または編集に関するサポートが必要な場合は、Pendoサポートにお問い合わせください。

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

新しいページタグが作成されておらず、全体的なユーザー体験が同じであれば、通常、既存のガイドタグとフィーチャータグを変更する必要はありません。

しかし、ユーザー体験が異なり、新しいページタグを作成している場合は、以下の点も確認してください。

ガイド（Guides）

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

フィーチャー

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

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

ステージングドメイン

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

1. ［設定］>［ステージング］の順に進みます。
2. 必要に応じてドメインを追加・更新できます。

除外リストと包含リスト

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

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

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

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