ページのタグ付けを行うURLについて

最終更新日: 2022年11月29日 04:48

Pendoは、標準的なウェブURLの構文ルールに従っています。URLはさまざまな部分で構成されています。URLの3つの主要部分は、プロトコル、ドメインまたはホスト名、およびパスです。

URLの例：https://www.example.com/path/to/myfile.html

httpsはプロトコルです。
www.example.comはドメイン名です。
/path/to/myfile.htmlは、ウェブサーバー上のリソースへのパスです。

注：ほとんどの場合、URLのパスは大文字と小文字が区別されます。このため、Pendoではタグ付けされたページのケース構文を取り込むことをお勧めします。

サポートされているURL

次の表に、サポートされている標準のURL構文と例を示します。

	説明	例
標準URL	ウェブページの完全なアドレス。	`*https://www.pendo.io/features/platform/index.html`
ワイルドカード（`*`）	URLに含まれる任意の数の文字と一致するようにするために使用されるシンボル。複数のワイルドカードを使用できます。	`https://www.pendo.io/features/` `https://www.pendo.io/features/platform/index.html//*`
以降は無視（`**`）	2つのワイルドカードの後はすべて無視します。	`https://www.pendo.io/features/platform/index.html/users/**`
フラグメント（`#`）	内部ページの参照。	`https://domain.com/#page1`。ページルールでは、フラグメント（`#`）の後にワイルドカード（`*`）を使用することはできません。
含む（`~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

Pendoには、ページのURLを「パラメータ化」する機能があります。これは、ワイルドカード * と同様の機能ですが、独自のページ結果としてさまざまなワイルドカードの結果を作成できるという（作成した「ページ」の下にネストされます）、大きな特典があります。これは便利な機能で、無数のURLを対象に、1つのエントリにてページルールを簡単に作成することができます。

たとえば、以下のような3つのページのURLがあり、それらが類似の内容であったり、一緒に表示させたい場合。

https://www.pendo.io/features/foo/

https://www.pendo.io/features/bar/

https://www.pendo.io/features/ipsum/

次のページルールを使用すると、3つすべてを取得できます。

https://www.pendo.io/features/*parameter*/

これらはサブスクリプション内のページルールの下に以下のように表示されます。

上記と同じ構文を使用して、単一のクエリパラメータをページパラメータとして保存できます。例：

https://www.pendo.io?first=*parameter*

*parameter*でページルールを使用している場合、同じページに他のルールを含めることはできません。含めた場合、上位のパラメータデータが表示されません。

サポートされていないURL

ページパラメータ（`;`の後、`?`または`#`の前のセクション）	Pendoは、URLで動的に設定されたページパラメータをスキップします。
ページルール内の`NOT`のあらゆる形式	PendoはURL構文で`NOT`をサポートしていません。
クエリ（`?`）の後に含む（`~contains:`）	PendoはURL構文で`~contains:?`をサポートしていません。
`*`は、2つのスラッシュの間で文字列の全体を照合する場合にのみワイルドカードとして機能する	たとえば、`https://www.pendo.io/features`は`https:///`と一致しますが、`//.pendo.io/features`や`//www.pendo.io/fs`とは一致しません。
`*`も`~contains:`も`?`の後では機能しない	ワイルドカードと「Contains」は文字通りに扱われます。
クエリパラメータの順序は、`?`の後では無視される	たとえば、`https://www.pendo.io?first=one&second=two`と`https://www.pendo.io?second=two&first=one`は、どちらもページルール`//www.pendo.io?first=one&second=two`と一致します。

カスタムマッチ

「アプリ内ページの管理（Manage Pages In-App）」でカスタムマッチを使用すると、URLの下にさまざまなオプションが表示されます。

オプションの説明は次のとおりです。

<Ignore>：これは、2つのスラッシュ内/*/のすべてと一致します
<Ignore after>: これは、2つのアスタリスク/**の後のURLのすべてと一致します
<Parameter>：これは<Ignore>と同じように機能しますが、スラッシュの間の値をキャプチャします
search_params=：これは、特定の値に設定されたURLの検索/クエリ部分（つまり、?の後で、#の前のすべて）に関連しています
search_params=<anything>：これには、任意の値に設定されたURLの検索/クエリ部分が含まれます

例

クエリパラメータ

To match https://www.pendo.io/features?language=english&mobile=falseand https://www.pendo.io/features?language=french&mobile=true https://www.pendo.io/features?mobile=true: //www.pendo.io/features?language

To match https://www.pendo.io/features?language=english but not https://www.pendo.io/features?language=french: //www.pendo.io/features?language=english

サブドメイン

To match https://app.pendo.io/ and https://help.pendo.io/ but not https://www.insert.io/: //~contains:pendo.io/**