# Ptengineのパラメータ一覧

Google Tag Manager（GTM）などのタグ管理ツールでPtengineのタグが配信される範囲を制限されている場合、Ptengine独自のパラメータを含むURLにタグが配信されないような設定をしていると、Ptengineの一部の機能をご利用いただけない場合があります。

例えば、GTMのトリガー設定で「一部のページビュー」かつ「Page URL = 等しい」にてURLを指定すると、パラメータを含むURLが対象外になります。

![](/files/MEvL1SO48P97bvPxD0QJ)

この事象を解決するため、「一部のページビュー」を利用する際は、マッチングルールは「等しい」ではなく、「含む」または「先頭一致」を利用されることをお勧めしております。

下記には、Ptengineを利用する際に発行されるパラメータの一覧を記載しますので、ご参考にしてください。

## パラメータ一覧 <a href="#id-1-toc-title" id="id-1-toc-title"></a>

GTMを利用して、タグの配信範囲を制限する（＝一部のページにのみタグを設置する）場合は、下記のパラメータURLが配信条件に含まれているかご確認ください。

* ウェブビューヒートマップを見る際に必要\
  ptengine\_heatmap\_token\
  pt\_lang
* ビジュアルイベントを設定する際に必要\
  ptengine-event-explore\
  target-url\
  ptengine-url-type
* Experienceの体験エディターでサイトを編集する際に必要\
  ptengine\_engage\_editor\_token\
  poster\_uid
* Experienceの体験をプレビューする際に必要\
  hasAntiFlicker\
  preview\_ptx\_token\
  hasInline\
  hasRedirect

## 事例 <a href="#id-2-toc-title" id="id-2-toc-title"></a>

Ptengineはプランごとに月間の計測可能PV数に上限があります。\
そのため、サイト全体を計測するのではなく一部のページにのみ計測したい場合、GTMでタグの配信範囲を制限するケースがございます。

この時、上記のパラメータURLが含まれない条件で範囲を設定してしまうと、上記のパラメータが付与される画面などが開けなくなります。

例：

トリガー条件：下記のURLでPage URL = 等しいで設定した場合：\
<https://www.example.com/>

* トリガーしないURL：<https://www.example.com/?utm_source=abc>\
  <https://www.example.com/?utm_source=abcptengine_heatmap_token_xxxxx>

その他、GTMでタグを設置したのに正しく計測されない場合は[こちらの記事](/start-guide/othertag/tag-gtm.md)をご確認ください。

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helps.ptengine.com/faq/tag-and-domain/ptengine-parameters.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.