利用转换功能，控制可供代码使用的事件参数

本文档面向需要控制向代码公开哪些事件参数而采用服务器端代码植入的用户。

服务器端容器包含一个用于接受传入 HTTP 请求的客户端。系统将 HTTP 请求中的信息转换为一个事件数据对象。然后您的服务器端代码会读取该事件数据对象。

什么是转换？

借助转换功能，您可以在向代码公开事件参数输出之前，在客户端中对这些输出执行包含、排除或修改操作。有了转换功能，您可以保护敏感信息并精细控制哪些事件参数可用于进一步处理。

利用转换功能，您可以创建规则以实现以下目标：

• 允许仅与代码共享明确定义的事件参数。
• 通过创建关于修改或添加事件参数的规则，扩充事件参数。
• 通过从代码中排除事件参数，隐去相应的传入信息。

您可以将转换应用于所有代码、整个代码类型或个别选中的代码集。 此外，您还可以应用在转换运行之前必须满足的一组条件。

系统会在每次转换运行时评估各个变量。您的变量可能会解析为不同的值，具体取决于转换的运行内容。

允许代码使用事件参数

通过允许参数转换，您可以指定某些要向代码公开的事件参数。系统会舍弃未明确定义的事件参数。

注意：允许参数转换会移除未明确指定的所有事件参数，即使是 Google 代码所需的值也不例外。创建此类转换之前，请检查您的代码使用了哪些事件参数，并确保包含所需的所有事件参数。否则，您的衡量结果可能会受到影响。如需了解详情，请参阅事件数据参考和 Measurement Protocol 事件。

若要允许代码使用某些事件参数，请执行下列操作：

1. 在您的工作区中，打开 转换菜单。
2. 创建一条新转换规则。
3. 点击转换配置，然后选择允许参数。
4. 添加代码可使用的事件参数。查看所有常见的事件参数。
5. 可选：使用匹配条件，您可以定义关于何时启用转换的规则。默认情况下，转换规则始终适用。
6. 在受影响的代码中，选择能够响应此转换规则的代码类型或个别代码。默认情况下，该转换适用于所有代码。
7. 为该转换规则命名并保存。

示例：将选定信息记录到 BigQuery 表中

通过控制记录的参数，您可以：

• 确保敏感信息未记录到内部数据存储区中。
• 防止过度记录，从而节省存储费用和 Cloud 费用。
• 存储用于监控和报告的相关指标。

具体操作说明！

若要仅允许记录某些参数，请执行下列操作：

1. 创建一条新转换规则。
2. 点击转换配置，然后选择允许参数。
3. 在要列入许可名单的参数中，添加您所需的参数，例如 event_name、page_hostname、page_path、client_id 等。
4. 在受影响的代码中，选择将数据发送到数据仓库的代码。对于 BigQuery，您可以使用自定义代码中的 addEventCallback 和 BigQuery APIs，或者浏览社区模板库以获取用于监控服务器容器的预先构建好的选项。
5. 为该转换命名并保存。保存后的结果应类似于下图：

扩充事件参数

通过增强事件转换，您可以修改事件参数的值，或者添加可供代码使用的新参数。

注意：如果代码所用的参数已经过修改，则代码可能不会按预期运行。在扩充参数之前，请查看您的代码依赖于哪些参数。

若要修改或添加某些事件参数，请执行下列操作：

1. 在您的工作区中，打开 转换菜单。
2. 创建一条新转换规则。
3. 点击“转换配置”，然后选择增强事件。

4. 在要扩充的参数中：

   • 若要修改现有事件参数，请在名称中输入您要修改的参数，然后添加一个新的值。查看所有常见的事件参数。

   • 若要添加新的事件数据对象值，请输入您选择的名称和变量。

5. 可选：使用匹配条件，您可以定义关于何时启用转换的规则。默认情况下，转换规则始终适用。

6. 在受影响的代码中，选择能够响应此转换规则的代码类型或个别代码。默认情况下，该转换适用于所有代码。

7. 为该转换规则命名并保存。

示例：针对购买事件设置基于价值的出价策略

利用基于价值的出价策略，您可以面向对业务而言价值更高的目标用户来优化广告支出，从而提升广告系列效果。设置基于价值的出价策略后，Google Ads 会根据您设定的转化价值，为您设置可带来更高价值的出价。增强事件转换有助于在服务器端设置基于价值的出价策略。

具体操作说明！

以下说明仅在 Google Ads 转化跟踪代码未指定转化价值的情况下适用。

若要设置基于价值的出价策略，请执行下列操作：

1. 创建一条新转换规则。
2. 点击转换配置，然后选择增强事件。
3. 在要扩充的参数中，添加一个新行。设置变量以将商品的货币价值加载到转换中：
   1. 在参数名称中，输入您要调整的值的名称，例如 value。替换所有 value 字段，因为它们表示事件的货币价值。
   2. 在参数值中，配置一个从数据库中检索价格的变量。例如，如果您在 Firestore 中存储商品数据，请添加 Firestore 查找变量。
4. 在匹配条件中，设置此转换应仅应用于某些事件。若要仅针对购买事件应用基于价值的出价策略，请设置：{{Event Name}} 等于 purchase。
5. 在受影响的代码中，添加应应用此转换的所有 Google Ads 转化跟踪代码。
6. 为您的代码命名并保存。保存后的结果应类似于下图：

排除代码中的事件参数

排除参数转换有助于移除代码中的特定事件参数。

注意：如果代码所需的参数已被排除，则代码可能不会按预期运行。在转换参数之前，请检查您的代码依赖于哪些参数。

若要排除代码中的某些事件参数，请执行下列操作：

1. 在您的工作区中，打开 转换菜单。
2. 创建一条新转换规则。
3. 点击“转换配置”，然后选择排除参数。
4. 添加代码无法使用的事件参数。查看所有常见的事件参数。
5. 可选：使用匹配条件，您可以定义关于何时启用转换的规则。默认情况下，转换规则始终适用。
6. 在受影响的代码中，选择能够响应此转换规则的代码类型或个别代码。默认情况下，该转换适用于所有代码。
7. 为该转换规则命名并保存。

示例：根据用户同意情况排除选定的 GA4 自定义维度

借助排除参数，您可以控制向 Google 发送哪些第一方数据。例如，当用户拒绝 analytics_storage Cookie 时，您可能希望移除选定的自定义维度。

具体操作说明！

若要移除自定义维度，请执行下列操作：

1. 创建一条新转换规则。
2. 点击转换配置，然后选择排除参数。
3. 在要排除的参数中，添加一个新行，然后设置您要排除的自定义维度，例如 payment_type、payment_status。
4. 在匹配条件中，设置应仅当用户拒绝 analytics_storage Cookie 时才应用此转换。
   需要形成以下条件：
   • {{gcs}} 等于 G100
   • {{gcs}} 等于 G110
5. 可选：在受影响的代码中，添加应应用此转换的所有代码。
6. 为您的代码命名并保存。保存后的结果应类似于下图：

验证是否已应用转换规则

您可以通过预览工作区验证您的转换规则：

1. 打开您的网站。

2. 在您的 Google 跟踪代码管理器服务器容器中，选择预览。

   Tag Assistant 会启动并加载您的服务器容器。

3. 若要查看针对某个事件触发的所有代码和操作，请从左侧列表中选择相应的事件名称。

验证转换是否已运行：

1. 在您要验证的事件中，打开代码标签页。

2. 选择某个已触发的代码，以查看相应的代码属性、传出的 HTTP 请求、触发型触发器和转换。

   注意：转换只会影响已触发的代码。如果转换修改或移除了必填的事件参数字段，则可能会导致代码无法触发。

3. 通过查看代码详情概览，您可以了解系统针对某个代码运行了哪些转换以及按何种顺序运行。默认顺序为：

   1. 允许参数
   2. 扩充参数
   3. 排除参数
   提示：您可以通过向转换分配优先级值来更改默认顺序。值越高，优先级越高。

   

4. 若要查看转换详情，请点击相应的转换。为代码提供的事件参数显示在事件数据部分下。

   

5. 点击事件数据框后，您会看到所有转换运行完成后的事件参数状态。若要查看原始事件参数和转换后的事件参数，请选中显示原始数据复选框。