この記事では、URL構文を使用して、ページのタグ付けでルールを作成する方法について説明します。また、ページのタグ付けルールの編集方法の例とガイダンスが含まれています。ページのタグ付けの概要については、ページのタグ付けを参照してください。
タグ付けの基礎について詳しく知りたい方は、Pendo Academyで関連するビデオチュートリアルをご覧ください。
URL構文
Pendoは標準的なウェブURL構文ルールに従って、ページにタグ付けを行います。URLはいくつかの部分から構成されています。URLの主要部分は、通信プロトコル、サブドメイン、ドメインもしくはホスト名、およびパスから成ります。たとえば、URL「https://www.example.com/category/user/profile.html」は、次のように構成されています。
| URL構文 | 説明 |
https:// |
ブラウザがウェブサイトにアクセスするために使用する必要がある通信プロトコルまたはスキーム。 |
www. |
サブドメイン。これはドメインを共有するウェブサイトのさまざまな部分をグループ化したものです。これは、www.である必要はありません。たとえば、https://app.example.comのようにapp.とすることも可能です。 |
example.com |
ドメイン名。これはセカンドレベルドメイン（ Pendoはデフォルトでワイルドカード（ |
/category/user/profile.html |
ウェブサーバー上のリソースへのパス。ドメインの後にあるものはすべてパスです。これは、ドメイン内の特定のコンテンツやフォルダを識別するものです。以下に例を示します。
ほとんどの場合、パスは大文字と小文字が区別されます。このため、Pendoではタグ付けされたページのケース構文を取り込むことをお勧めします。 |
URLはこれより複雑な場合もあれば、そうでない場合もあります。以下の例を参照してください。
フラグメントの例
フラグメントは、ウェブページ内のセクションを参照する内部ページ参照で、名前付きアンカーと呼ばれることもあります。通常、フラグメントはURLの末尾に表示され、ハッシュタグ（#）で始まり、その後に識別子が続きます。たとえば、URL https://www.example.com#someHeaderには、次の部分が含まれています。
https://は通信プロトコルwww.はサブドメインexample.comはドメイン#someHeaderはフラグメント
パスフラグメントの例
パスフラグメントとは、ウェブサイトのウェブフレームワーク技術のルーティングとして使用される内部ページ参照のことです。通常、パスフラグメントはURLの末尾に表示され、ハッシュタグ（#）で始まり、その後に識別子が続きます。たとえば、URL https://www.example.com#products/widgets/12345には、次の部分が含まれています。
https://は通信プロトコルwww.はサブドメインexample.comはドメイン#products/widgets/12345はパスフラグメント
クエリパラメータの例
クエリパラメータは、URLの末尾で渡されるデータに基づいて、特定のコンテンツやアクションを定義します。通常、クエリパラメータはURLの末尾に表示され、疑問符（?）で始まり、その後にクエリパラメータが続きます。たとえば、URL https://www.example.com?products=widgetsには、次の部分が含まれます。
https://は通信プロトコルwww.はサブドメインexample.comはドメイン?products=widgetsはクエリパラメータで、キーと値のペア
疑問符（?）に続く文字列に複数のクエリパラメータがある場合、通常、キーと値のペアはアンパサンド（&）で区切られます。例：?products=widgets&source=browser-search
パスフラグメントクエリパラメータの例
URLの末尾には、パス、フラグメント、クエリパラメータを組み合わせて記述することが可能です。たとえば、URL https://www.example.com/#products/widgets?item=12345 には、次の部分が含まれています。
https://は通信プロトコルwww.はサブドメインexample.comはドメイン#products=widgetsは、ウェブフレームワークのルーティングに使用されるパスフラグメント?item=12345は、パスフラグメントのクエリパラメータで、キーと値のペア
ビジュアルデザインスタジオ（Visual Design Studio）でのタグ付けルール
ビジュアルデザインスタジオでページにタグを付けるには、ルールビルダーまたはカスタム URLオプションを使用できます。どちらの方法でも、Pendoが類似したURLを識別してグループ化する方法を定義できますが、インターフェースは異なります。
- ルールビルダーは、URLの一部にステートメントを適用するためのドロップダウンスタイルのインターフェースを提供します。ステートメントを選択すると、Pendoは対応する構文を自動的に生成します。
- カスタムURLを使用すると、同じ構文を直接入力してルールを手動で作成できます。これにより完全な制御が可能になり、より高度なパターンを適用するときに役立ちます。
次のセクションでは、両方のオプションの動作を説明し、例を示します。これら2つのオプションの詳細については、ページのタグ付けを参照してください。
ルールビルダーのステートメントとその構文
以下の表は、ルールビルダーで選択できるステートメント、Pendoが生成する対応する構文、それぞれの意味を示しています。
- 「ステートメント」列は、ルールビルダーで選択可能な一致条件を表示します。これらは、ルールの動作を説明する使いやすいラベルです。
- 「構文」列は、ステートメントを選択するとルールビルダーが生成する基礎パターンを示します。これは、ルールビルダーの外でルールを作成する場合、［カスタムURL］フィールドに手動で入力する内容でもあります。
たとえば、ルールビルダーで tracking_id=<anything> のようなステートメントを選択すると、Pendoは https://app.example.com/dashboard?tracking_id=abc123 のようなURLに一致するルールを作成します。これは、tracking_id クエリパラメータが存在するページであれば、その値に関係なくPendoがタグ付けを行うということです。
| 詳細 | 構文 | 説明 |
<Ignore> |
/*/ |
URLを照合する際、2本のスラッシュ内のすべてを無視します。 |
<Ignore after> |
** |
ルールを追加しない限り、2つのアスタリスク後のURL内のすべてを無視します。**に続くルールが尊重されます。たとえば、//*/**/pathはwww.example.com/some/long/pathと一致します。 |
<Parameter> |
/*parameter*/ |
スラッシュ間の部分をページパラメータとして扱います。そのため、正確な値はマッチングには無視されますが、ページの詳細、セグメント、レポートに保存され、利用可能です。 |
<Contains> |
~contains: |
後続の特定の文字列が含まれます。 |
search_params=_value |
?parameter= value |
パラメータが指定した値と一致する場合。 |
search_params=<anything> |
?parameter |
パラメータが任意の値と一致する場合。 |
カスタムURL構文の例
ビジュアルデザインスタジオで「カスタムURL」を選択した場合、ステートメントを選択する代わりに、完全なルール構文を直接入力できます。このオプションは、より高度または柔軟なタグ付けが必要な場合に役立ちます。
以下の例は、ページルールを手動で定義するときに使用できる有効なルール形式を示しています。詳細については、本記事のサポートされているURLのセクションを参照してください。
サブドメインの例
| 構文 | 説明 | 一致しない |
//~contains:pendo.io/** |
https://app.pendo.io および https://support.pendo.io |
https://mindtheproduct.com |
クエリパラメータの例
| 構文 | 説明 | 一致しない |
//www.pendo.io/features?language=english |
https://www.pendo.io/features?language=english | https://www.pendo.io/features?language=french |
//www.pendo.io/features?language |
https://www.pendo.io/features?language=english および https://www.pendo.io/features?language=french |
|
//www.pendo.io/features?language=~contains:english |
https://www.pendo.io/features?language=english-ireland および https://www.pendo.io/features?language=australia-english |
https://www.pendo.io/features?language=french-canada |
タグ付けルールの組み合わせ
ユーザーによるアプリケーション操作はイベントの生データとして収集され、Pendo Web SDKを通じてPendoに送信されます。Pendoはこれらのイベントを処理し、ページのタグ付け用に作成したルールと照合します。ページのタグ付けルールで定義したイベントのみが、そのページのアナリティクスに取り込まれます。指定したページをベースにセグメント化やフィルタリングを行う場合、Pendoではイベントの生データを1件ずつ検索し、そのページ用に定義されたルールに一致するイベントのみを取り込みます。つまり、複数のルールを組み合わせれば、さらに充実したアナリティクスが実現できます。
Pendoのページは複数のルールで構成でき、ルールには複数のURLを収集するワイルドカードを含めることができます。これにより、イベントの生データの検索精度を高め、同じURLのバリエーションなど、特定のページビューでカウントすべきものを定義できます。また、アプリケーション全体やアプリケーションの各エリアのビューを表すページを作成することもできます。これは、セグメント化やレポートの作成、ガイドのターゲティングに役立ちます。たとえば、Pendoに「すべての連絡先」というページを設け、そこにすべての連絡先情報を収集することも可能です。
1つのページにあるURLのグループだけでなく、他のページにあるそのグループに属する個々のURLも収集できます。これによりアナリティクスの柔軟性が向上し、最も有用なデータにたどり着くことができます。タグ付けされた複数のページ用のタグ付けルールがあり、あるイベントが定義された基準を満たす場合、そのイベントは各ページの指標に取り込まれます。
たとえば、URLのグループ全体を収集する「すべての連絡先」という1つのページに加え、個々の連絡先情報をPendoの個別のページとして収集したいと仮定します。「すべての連絡先」ページと個々の連絡先情報ページの間で複数のタグ付けルールがあったり、同一のルールがあったりしても、お互いに影響することはありません。むしろ、複数または同一のタグ付けルールを持つページは、一致するタグを持つ関連する各ページに対して同じイベントをカウントします。
| URLの例 | タグ付けルール | ページ | ページ閲覧数 |
https://www.example.com/contacts |
//*/contacts | 連絡先のランディングページ | 10 |
|
|
//*/contacts/SteveRogers | Steve Rogers | 2 |
|
|
//*/contacts/TonyStark | Tony Stark | 3 |
https://www.example.com/contacts/jenniferwalters |
//*/contacts/JenniferWalters | Jennifer Walter | 1 |
https://www.example.com/contacts/thorodinson |
//*/contacts/ThorOdinson | Thor Odinson | 4 |
https://www.example.com/contacts/natasharomanoff |
//*/contacts/NatashaRomanoff | Natasha Romanoff | 2 |
| 上記のすべて |
//*/contacts //*contacts/* |
すべての連絡先 | 22 |
パラメータ化されたURL
PendoではURLのパラメータ化が可能です。Pendoページのパラメータは、アプリケーション内のURLまたはページのさまざまなバリエーションを特定して追跡するのに役立つ特定のクエリパラメータまたはパス変数です。これらのパラメーターは、構造は共通しているが特定の属性が異なる動的コンテンツやページでのユーザーインタラクションをより深く理解するのに役立ちます。
これはワイルドカード*と同様に機能しますが、異なる値を作成したページの下にネストし、1つのエントリで複数のURLにわたるページルールを作成するのに役立ちます。
たとえば、以下の3つのURLがあり、これらが類似したコンテンツを持っている場合や、まとめて表示したい場合：
https://www.pendo.io/features/foo/
https://www.pendo.io/features/bar/
https://www.pendo.io/features/ipsum/
次のページルールを使用すると、3つすべてを取得できます。
//*/features/*parameter*/
これらはサブスクリプション内のページルールの下に表示され、各パラメータ値とそのページ閲覧数が表示されます。
同じ構文を使用して、単一のクエリパラメータをページパラメータとして保存することもできます。たとえば：//*/?first=parameter
注：パラメータを含むページルールを使用する場合、同一ルール内に複数のパラメータを含めることはできません。そうすると、上位パラメータのデータが正しく表示されなくなります。以下はその例です。
- 正しい使い方：
//*/page/*parameter* - 誤った使い方：
//*/*parameter*/*parameter*
ページタグに複数のルールがある場合は、以下の点を念頭に置いてください：
- ルールの順序は重要です。Pendoはルールを順番に評価し、最初に一致した時点で停止します。
- パラメータ化されたルールを最初に配置すること。ルールにパラメータが含まれている場合は、URLが複数のルールに一致したときにパラメータをキャプチャできるように、包含リストの最初にリストアップします。
- パラメータはページタグ全体で共有されます。複数のルールにパラメーターを含めることができますが、Pendo は各ページタグのパラメーターの 1 つのリストを追跡する。データの不一致を避けるようにルールを構成するようにします。
パラメーター値は大文字と小文字を区別せず、Pendo UIで個々のページタグを表示すると、上位100個のパラメーターのみが表示されます。Pendo UIでさらに多くのページパラメータを見るには、データエクスプローラレポートを作成し、ページパラメータでグループ化します。APIでページパラメータを分析する説明にあるAPIを使用することもできます。
レポートおよびセグメント内のページパラメータを分析する
ページルールにパラメータが含まれている場合、Pendoはこれらの値をカスタムイベントプロパティとして自動的に収集します。つまり、セグメントやデータエクスプローラなど、ページ詳細ビューの外部でページパラメーター値を使用できます。
ページパラメータは、イベントの詳細テーブルに表示され、レポートのフィルターやグループ化オプションとしても使用できます。これにより、各バージョンを個別にタグ付けすることなく、動的またはパーソナライズされたページのバリエーション全体の行動を分析できます。
例えば、ページルールが//*/portfolio/*parameter*/として定義されている場合、個々のポートフォリオIDでレポートデータをフィルタリングまたはグループ化し、/portfolio/12345や/portfolio/67890などのページ間でエンゲージメントを比較できます。
注：ページルールを通じて収集されたパラメータのみがイベントプロパティとして表示されます。ページのタグ付けルールでパラメータが収集されない場合、セグメントビルダーやレポートフィルターのオプションとして表示されません。
URLにUTMパラメータを追加する
UTMとはURLの末尾に追加するタグで、リンクのソースに関する情報を提供します。たとえば、UTMを追加したリンクをメールに埋め込む場合、リンクはwww.example.com?utm_source=emailのようになります。この場合、utm_sourceは訪問者がメールリンクから来たことを示します。
2025年5月1日以降、PendoはWeb SDKバージョン2.272.0以降を使用するすべてのサブスクリプションのセッションプロパティとしてUTMパラメータを自動的に取得します。これらの値は、タグ付けを必要とせずに、ウェブアナリティクスなどのレポートツールで利用できます。
ただし、次を行う必要がある場合は、UTM固有のページにタグを付けることもできます。
- Webアナリティクスの外部（例：ファネルやパス）で個々のUTM値のアクティビティを追跡する。
- 特定のページの上位UTMパラメータ値を表示する。
- 標準のUTM名を使用しない他のマーケティングパラメータを収集する。
セッションプロパティは、2025年5月1日からすべてのサブスクリプションで利用可能です。
UTMパラメータをページとしてタグ付けする場合は、次のいずれかの方法をお勧めします。
- 各URLを個別にタグ付けしてください。関心のあるUTMパラメータ値ごとに1ページを作成します。
- パラメータ化されたURLを使用してください。Pendoのパラメータ機能を使用して、すべてのUTM値を収集する単一のページ定義を作成します。
方法1. UTMパラメータ値ごとにページを作成する
UTMパラメータ値の数が限られている場合や、選択した一部のパラメータ値のみに関心がある場合は、Pendoの個別のページとして各値をタグ付けします。PendoではUTMパラメータ値ごとにページが作成されるため、個々のUTMソースごとに使用状況アナリティクスを表示できます。また、データエクスプローラ、ファネル、パスのレポートなどを含むPendo UI全体で各値を調べることもできます。
たとえば、以下の3つのutm_source値に関するアクティビティを表示するために、各パラメータ値ごとにPendoのページを作成するといったことが、この方法に該当します。
| URL | ページのタグ付けルール |
https://www.pendo.io?utm_source=email |
//*/?utm_source=email |
https://www.pendo.io?utm_source=blog_post |
//*/?utm_source=blog_post |
https://www.pendo.io?utm_source=referral |
//*/?utm_source=referral |
方法2. 複数のUTMパラメータ値を収集するページを作成する
UTMパラメータとして有効な値が多くある場合、Pendoのパラメータ機能を使用して、有効な値すべてをPendoの1つのページに収集するルールを1つ作成します。
たとえば、以下の3つのutm_source値すべてのアクティビティを表示できるページを、1つのパラメータを持つ1つのルールで作成することができます。これらの値は、そのページの ［上位パラメータ（Top Parameters）］の下に表示され、各値の閲覧数もこのパラメータテーブルに表示されます。
| URL | ページのタグ付けルール |
https://www.pendo.io?utm_source=email |
//*/?utm_source=*parameter* |
https://www.pendo.io?utm_source=blog_post | |
https://www.pendo.io?utm_source=referral |
サポートされているURL
次の表に、サポートされている標準のURL構文と例を示します。
| 構文 | 説明 | 例 |
| 標準URL | ウェブページの完全なアドレス。 | https://www.pendo.io/features/platform/index.html |
ワイルドカード（*） |
URLに含まれる任意の数の文字と一致するようにするために使用されるシンボル。複数のワイルドカードを使用できます。 |
|
以降は無視（**） |
2つのワイルドカードの後はすべて無視します。 | https://www.pendo.io/features/platform/index.html/users/** |
フラグメント（#） |
内部ページの参照。 |
注：ページルールを作成する際、パスフラグメント（ |
パスフラグメント（#もしくは#!） |
内部ページのルーティング。 |
注：パスフラグメント（#）にワイルドカード（*）を使用できます。例えば、URL |
含む（~contains:） |
特定の文字列を含めます。 | https://www.pendo.io/features/platform/index.html/users/~contains:dashboard |
パラメータの存在を照会（?） |
パラメータが存在するかどうかを照会します。 | https://pendo.io?mobile |
パラメータ値を照会（?および=） |
パラメータの値を照会します。 | https://pendo.io?language=english |
複数のクエリパラメータ（?、&、および=） |
複数のパラメータの存在と値を照会します。 | https://pendo.io?mobile&language=english |
Pendoはhttps://domain.com/#page1とhttps://domain.com/#page2の違いを認識します。ページルールhttps://*は、両方のURLと一致します。URLがこのように構成されていて、https://domain.comのみに対応するページルールが必要な場合は、ロケーションAPIについてのドキュメントを確認してください。
サポートされていないURL
以下の表は、サポートされていないURL構文と例を示します。
| 構文 | 説明 |
ページパラメータ（;の後、?または#の前のセクション） |
Pendoは、URLで動的に設定されたページパラメータをスキップします。 |
ページルール内のNOTのあらゆる形式 |
PendoはURL構文でNOTをサポートしていません。 |
クエリパラメータ名のクエリ（?）の後に含む（~contains:） |
Pendoはクエリパラメータ名を評価するURL構文で たとえば、 |
*は、2つのスラッシュの間で文字列の全体を照合する場合にのみワイルドカードとして機能する |
たとえば、https://www.pendo.io/featuresはhttps://*/*と一致しますが、//*.pendo.io/featuresや//www.pendo.io/f*sとは一致しません。 |
*は?の後では機能しない
|
ワイルドカードは文字どおりに扱われます。 |
クエリパラメータの順序は、?の後では無視される
|
たとえば、https://www.pendo.io?first=one&second=twoとhttps://www.pendo.io?second=two&first=oneは、どちらもページルール//www.pendo.io?first=one&second=twoと一致します。 |
URLの正規化
正規化により、URLをルールに一致した、一貫性と信頼性が高いフォーマットに変換します。具体的には、スペースに対して%20や+などの特別なルールを適用します。これにより、URL内でスペースが伝達される方法ごとに個別のルールを作成する必要がなくなります。また、パスフラグメントに対しては、#を#!に正規化します。これは、フラグメントとパスフラグメントを区別するためのものです。
以下の表は、元のURLが正規化される方法の例と、それに一致するルールを示しています。
| 元のURL | 正規化済みURL | 一致ルール |
| https://www.example.com/foo%20bar | https://www.example.com/foo+bar | //*/foo%20bar |
| https://www.example.com/foo+bar | https://www.example.com/foo%20bar |
|
| https://www.example.com/?query=foo%20bar | https://www.example.com/?query=foo+bar |
|
| https://www.example.com/#path/to/page/ | https://www.example.com/#!/path/to/page | //*#!/path/to/page |
| https://www.example.com/#documents/123/widgets/ | https://www.example.com/#!/documents/123/widgets | //*/#!/documents/*/widgets |