> 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/integrations/ga4.md).

# 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小时。

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