> For the complete documentation index, see [llms.txt](https://helps.ptengine.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helps.ptengine.com/cn/start-guide/quick/tag-setup.md).

# 基础代码的安装方法

### **什么是基础代码** <a href="#what-is-a-basic-tag" id="what-is-a-basic-tag"></a>

要使用Ptengine，需要在监测目标页面上安装特定代码。此代码称为“基础代码”，是一段包含档案 ID 的 JavaScript。

![](https://2044586328-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnucbKsG9WGIoxCpzyoHL%2Fuploads%2Fgit-blob-6afb7e3c08df05fad87b75c5e3392a3cf22cd0d5%2Fstart-guide-tag-setup-01.png?alt=media)

通过在网站上安装此基础代码，您可以收集数值数据、利用热图了解客户、实施弹窗、AB测试和个性化等一系列措施。

装好之后，数据报告、热图、弹窗、A/B 测试、个性化这一整套能力就都能用了。

***

## 开始之前 <a href="#before-you-start" id="before-you-start"></a>

* 已经创建好档案（没有的话先看 [如何创建档案](/cn/start-guide/quick/create-project.md)）
* 需要能改网站 HTML 的权限。改不了的话走 [其他安装方法](/cn/start-guide/othertag.md)（GTM / WordPress / Adobe DTM）
* **Shopify 站不要直接写进 HTML**，按 [Ptengine for Shopify 应用安装](/cn/start-guide/othertag/tag-shopify-app.md) 来

***

## 安装步骤（推荐：直接写进 HTML） <a href="#how-to-install-tags-recommended" id="how-to-install-tags-recommended"></a>

直接写进网站 HTML 的 `<head>` 里，数据最完整、也最不容易出闪烁。

{% stepper %}
{% step %}
**基础设置和标签获取**

访问目标档案，点击“现在安装”按钮。或者，点击档案名称旁边的齿轮图标，选择“基础设置”，然后进入“监测代码”页面。

{% hint style="info" %}
本站统一把这段代码叫**基础代码**；产品“基础设置”侧栏里的菜单项字面是**监测代码**，指的是同一个东西。
{% endhint %}

![](https://2044586328-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnucbKsG9WGIoxCpzyoHL%2Fuploads%2Fgit-blob-c5782a7ac971ff61ab439e80c04d8b2b99b6af58%2Fstart-guide-tag-gtm-01.png?alt=media)

![](https://2044586328-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnucbKsG9WGIoxCpzyoHL%2Fuploads%2Fgit-blob-1384bb6e3eae10e991e1027c1af0baa16d8ea619%2Fstart-guide-tag-setup-02.png?alt=media)
{% endstep %}

{% step %}
**复制基础代码**

复制基础代码。为防止错误，建议使用复制按钮。

![](https://2044586328-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnucbKsG9WGIoxCpzyoHL%2Fuploads%2Fgit-blob-bc6fda27d2896efe1b378d4b62e03d8bf5b93f8c%2Fstart-guide-tag-setup-03.png?alt=media)
{% endstep %}

{% step %}
**访问HTML**

访问要监测的网站或页面的HTML。
{% endstep %}

{% step %}
**粘贴**

找到`head`标签，将复制的标签粘贴到其中。保存更改并重新加载页面。
{% endstep %}
{% endstepper %}

***

## 做完之后怎么确认 <a href="#verify" id="verify"></a>

1. **等 30 分钟以上**再看数据（实时数据除外），刚装好就查是看不到的
2. 确认代码真的触发了 → [确认基础代码是否正常触发](/cn/faq/start-guide/check-tag-firing.md)
3. 装了但没数据 → [基础代码正确部署但没有数据流入](/cn/faq/tracking-code/no-data-after-deploy.md)
4. 数据有但看着不对 → [虽然已安装标签但无法正确监测的情况](/cn/faq/start-guide/incorrect-tracking.md)

***

## 相关页面 <a href="#related-pages" id="related-pages"></a>

* [其他安装方法](/cn/start-guide/othertag.md) — GTM / WordPress / Adobe DTM / Shopify
* [闪烁现象及应对方法](/cn/faq/experience-edit/anti-flicker.md) — 通过标签管理器部署时尤其要注意
* [推荐基础代码同步加载](/cn/faq/tracking-code/sync-load-recommendation.md)
* [基础代码对页面加载速度的影响](/cn/faq/tracking-code/page-load-impact.md)