# Google Analytics 4（GA4）的集成方法

## Google Analytics 4（GA4）的集成方法

Google Analytics 4（GA4）是一个用于收集和分析网站和应用访问者数据的下一代工具。 通过将Ptengine与GA4集成，可以将弹窗、页面编辑、A/B测试等交互数据发送到GA4，从而进行更详细的分析。 以下将详细说明集成方法。

## 集成的前提条件

GA4代码已经安装在您的网站上

如果您使用Google Tag Manager（GTM），请将Ptengine标签放在GA代码之后。

GA4集成一旦设置，之后无需对每个新的Experience重复设置。

并非所有数据都可以集成。不支持重定向类型的Experience交互数据发送。

## 在Ptengine中启用GA4集成的方法

要启用GA4集成，请执行以下步骤：

登录并访问相应的帐户。

点击右上角的⚙，在显示的菜单中点击"Intergation"。显示如下： 在此页面上，提供了在配置文件级别启用推送的功能，启用后将默认应用于所有后续的Experience。

点击Google Analytics 4卡片，展开如下图所示，点击"立即启用"。

至此，Ptengine内的操作已完成。

## 在GA4中将Experience变量设置为自定义维度

在Ptengine中启用GA4集成后，需要将Experience变量映射到GA4。这样，实验数据就可以发送到GA4。 请按照以下步骤操作：

登录到GA4帐户。

从左侧的主菜单面板中，转到\[管理] → \[自定义定义] → \[创建自定义维度]。操作屏幕如下所示：

在新的自定义维度弹出窗口中创建自定义维度。

💡自定义维度说明： **维度名** 输入自定义维度的名称作为Experience变量的名称。

```
**范围**
将范围指定为"事件"。

**说明**
输入自定义维度的说明。

**事件参数**
需要分别创建两个自定义维度，以将以下相关的Experience信息粘贴到事件参数中。以下信息表示Experience的名称和版本名称。
• pt_experience_name
• pt_experience_version_name

在GA4中，可以从下拉列表中选择，也可以直接输入或复制粘贴。GA4的官方文档在[这里]()。
```

### GA4可接收的事件

高级模式可能包含多个弹窗。为了确保A/B测试的准确性，在此模式下，每个Page View Experience仅可以发送一个事件包。（pt\_experience\_impression，pt\_experience\_close，pt\_experience\_click）

## 验证集成设置

映射GA4的Experience变量后，可以通过验证网络请求来确认Ptengine向GA4的数据发送是否正常进行。请执行以下步骤：

在Experience弹窗页面上，右键单击并选择"检查元素"。

选择"网络"标签，搜索"analytics.google.com"以过滤GA4网络请求。

如果可以看到显示"pt\_experience\_impression"等事件，则表明Ptengine正在正常地将事件发送到GA4。

注意事项：GA4数据处理需要时间，启用集成后，GA4中显示数据可能需要24-48小时。请耐心等待。

## 关于GA4集成故障

如果您使用Google Tag Manager（GTM）并通过"Google标签"安装，GA4可能无法收集来自Ptengine的数据。

### **解决方法**

为了使Ptengine与GA4集成顺利进行，请将以下标签放在**Ptengine基础标签之前**。

```
<script>
var ptTimer = setInterval(function(){
    if(dataLayer){
        clearInterval(ptTimer);
        if (typeof(gtag) === 'undefined') { 
                    gtag = function() { dataLayer.push(arguments); };
                    gtag('js', new Date());
                    gtag('config', 'G- set your GA4 sid');
                }
    }
},500)
</script>
```

※需要将代码中的"G- set your GA4 sid"替换为您网站的GA4 sid。

🔰如何获取GA4 sid

1.进入GA4的管理界面。

2.点击"数据收集和修正"中的"数据流"按钮。

3.选择指定的数据流，可以确认"测量ID"。

确认"测量ID"后，将上述"G- set your GA4 sid"替换为"测量ID"，gTag配置即完成。

### 创建GA4数据探索和添加细分

进入"探索"，选择数据探索的类型或从空白状态开始。

在左侧的"变量"面板中，点击"细分"旁边的加号图标。在"创建新细分"页面上，点击"用户细分"。

输入细分的名称。例如，特定的Experience或版本名称。

展开"添加说明"下拉列表，点击"事件"，然后选择"pt\_experience\_impression"或"pt\_experience\_click"（取决于要创建的细分）。

点击"添加参数"下拉列表。

点击"自定义"并选择pt\_experience\_name。

选择或指定要为其创建此细分的特定Experience名称。

如果要指定特定版本，请再次点击"添加参数"下拉列表以添加另一个参数，点击pt\_experience\_version\_name，并选择或指定要为其创建此细分的特定版本名称。

点击"保存"后，可以在报告中使用该细分。

### 创建GA4受众

转到"管理"，选择"受众"，然后点击"受众"。

在"创建受众"屏幕上，展开"添加新条件"下拉列表，点击"事件"，然后选择**pt\_experience\_impression**或**pt\_experience\_click**（取决于要创建的受众）。 例如，如果要为显示退出意图弹窗的用户创建受众，请选择事件**pt\_experience\_impression**，点击"添加参数"选择**pt\_experience\_name**，将条件设置为"包含"，然后输入"Experience名称"。

如果在下拉列表中找不到事件或事件属性，数据可能尚未同步到GA4。在这种情况下，您可以点击"创建事件"或"注册新定义"来创建新事件。

点击"保存"保存受众。通常，数据反映在受众中可能需要24-48小时。

创建受众后，可以在报告中使用它。


---

# 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/cn/integrations/ga4.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.