设置第一方模式

本文档适用于希望在第一方环境中部署 Google 代码的用户 模式。我们建议使用第一方模式，以获得最持久的代码配置。

概览

在第一方模式下，您可以使用自己的第一方部署 Google 代码 基础架构，托管在网站域（例如 example.com）上。这个 是您的网站与 Google 服务之间的桥梁， 第一方基础架构是唯一能够与您的代理机构直接交互的技术。 。第一方模式增加了一个数据安全层 额外数据隐私控制（例如完整的 IP 混淆），而 影响衡量的准确性本文档中的设置可以帮助您 在您的网站上多找回 X% 的衡量信号。您可以使用 您的现有内容分发网络 (CDN)、负载平衡器或 Web 服务器， 启用第一方模式

在标准 Google 代码设置中，您的网页向 Google 域名（例如 www.googletagmanager.com）。当代码触发时，它会将 衡量请求。在第一方模式下 网站从您的第一方网域（例如 example.com）加载 Google 代码。 该代码触发后，会将衡量请求发送到您的第一方网域、 这些信息会转发到相关的 Google 产品。

从标准模式切换为 将 Google 代码设置更改为第一方模式配置。

下图显示了第一方模式下的信息流：

第一方模式架构

准备工作

本指南假定您已为网站进行了如下配置：

1. 选择代码投放路径

您必须在网站网域上预留路径以投放代码。请确保 此路径尚未在您的网域中使用。

选择您要设置第一方模式的任意路径。您的转化路径示例 可能用到的维度包括：/metrics、/securemetric、/analytics 或任何值 未在网站上使用的字母数字字符串。

请填写以下内容以填充本文档中的示例。

Your domain: example.com
Google tag ID: G-12345
Tag serving path: /metrics

2. 路由流量

本部分假定您的网站已在使用 CDN 或负载平衡器 支持按路径路由流量

Google Cloud

您需要设置一个新后端，用于查询大致地理位置 网站访问者的位置信息，并在您现有的 外部应用加载 负载平衡器。

创建新后端

  1. <ph type="x-smartling-placeholder"></ph> 打开 GCP 负载平衡器

  2. 在您的负载平衡器中，打开后端配置部分。 创建新的后端服务。 后端配置设置的屏幕截图

  3. 使用地理定位信息配置新的后端服务：

    • 指定一个名称，例如 measurement-be-svc。
    • 将后端类型设置为互联网网络端点组。
    • 将协议设置为 HTTPS，并将超时保留为预填充内容 值。
    • 在后端下，点击互联网网络端点组 下拉列表，然后创建新的互联网网络端点组： <ph type="x-smartling-placeholder">
        </ph>
      • 将网络端点组类型设置为互联网 NEG（全球级、 区域级）。
      • 将范围设置为全局。
      • 将添加方式设置为完全限定域名和端口。
      • 将完全限定域名设置为 G-12345.fps.goog。
      • 点击创建以创建端点。
      • 关闭网络端点组标签页以返回 新建后端服务标签页。
    • 搜索新网络端点组的名称并选择它。
    • 打开高级配置部分。添加以下代码 自定义请求标头
      标头名称 标头值
      Host G-12345.fps.goog
      X-Gclb-Country {client_region}
      X-Gclb-Region {client_region_subdivision}
    • 查看其他设置。既不是云 CDN 或 Cloud Armor 因此您可以放心地同时停用这两者。
    • 保存新的后端服务。

配置路由规则

  1. 在您的负载平衡器中，打开路由规则部分。

  2. 添加以下主机和路径规则：

    主机 路径 后端
    * /metrics/* measurement-be-svc

  3. 更新负载平衡器配置。

  4. 在浏览器中，前往 https://example.com/metrics/healthy，验证设置。页面上应包含 ok.验证是否已添加地理位置信息 导航到：https://example.com/metrics/?validate_geo=healthy。该网页应 其文本为 ok。

Cloudflare

要在第一方模式下投放代码，您需要为 新子网域，创建源 要转发的规则 请求，并创建一个 Transform 要包含的规则 地理定位信息。

创建 CNAME 条目

选择要为 CNAME 条目预留的子域名。填写以下内容， 将填充本文档中的示例。此 CNAME 绝不会公开 位于 Cloudflare 配置之外，因此可以任意命名。

CNAME subdomain: fps
  1. 在“DNS”标签页中，打开 Records（记录）部分。
  2. 添加一条具有以下配置的新记录： <ph type="x-smartling-placeholder">
      </ph>
    • 将类型设置为 CNAME。
    • 将名称设置为 fps。
    • 将目标设置为 G-12345.fps.goog。
  3. 保存 CNAME 记录。

创建源规则

  1. 在“规则”标签页中，打开来源规则并创建规则。
  2. 输入规则名称，例如 Route measurement。
  3. 根据自定义过滤器表达式匹配传入的请求，以及 点击 修改表达式。
  4. 将以下表达式粘贴到构建器中：(http.host eq "example.com" and starts_with(http.request.uri.path, "/metrics"))
  5. 将 Host Header（主机标头）更新为 Rewrite to...（重写到...）G-12345.fps.goog。
  6. 将 DNS Record（DNS 记录）更新为 Override to...。fps.example.com。
  7. 保存源规则。
  8. 如果存在其他源规则，请将新创建的规则的 以便在其他任何通配符路径之后运行。
  9. 在浏览器中，前往 https://example.com/metrics/healthy，验证设置。该页面应显示 ok。

包含地理定位信息

  1. 在“规则”标签页中，打开转换规则。
  2. 创建 Edit Request Header 规则。
  3. 将规则应用于所有传入请求。
  4. 使用以下配置修改请求标头： <ph type="x-smartling-placeholder">
      </ph>
    • 将运算符设置为设置动态值。
    • 将标头名称设置为 X-CfIpCountryRegion。
    • 将值设置为 ip.src.subdivision_1_iso_code。
  5. 部署转换规则。
  6. 请等待几分钟，让规则生效。在浏览器中，验证 设置方法：前往“https://example.com/metrics/?validate_geo=healthy”。该网页应 请参阅 ok。

（可选）移除访问者 IP 标头

第一方模式无需访问者 IP 即可正常运行。您可以 使用移除访问者 IP 标头来移除所有访问者 IP 标头 自选 转换。

其他

要在第一方模式下投放代码，您需要配置 CDN 或 负载平衡器将请求路由到第一方模式端点。

  1. 添加指向 G-12345.fps.goog 的来源或后端。
  2. 将主机标头替换为 G-12345.fps.goog。允许所有 Cookie 和 要转发的查询字符串。
  3. 将 /metrics/* 的路径规则添加到 将流量路由到第一方模式
  4. 将预留路径配置为高于默认路径的优先级 规则。
  5. 在浏览器中，前往 https://example.com/metrics/healthy，验证设置。该页面应显示 ok。

第 3 步：更新网站上的脚本以使用衡量路径

将网站每个网页上的脚本替换为以下某个脚本：

gtag.js

在 <head> 部分的顶部，找到包含您的 Google 代码 ID：

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-12345"></script>

并将其替换为衡量路径：

<!-- Google tag (gtag.js) -->
<script async src="/metrics/"></script>

gtm.js

在 <head> 部分的顶部，将跟踪代码管理器代码段替换为 以下：

<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'/metrics/?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','');</script>
<!-- End Google Tag Manager -->

第 4 步：测试衡量设置

要测试衡量设置，请将您的容器配置为至少一种 代码。

  1. <ph type="x-smartling-placeholder"></ph> 前往 Tag Assistant 并预览您的容器浏览您的网站以触发代码。

  2. 在摘要中 >输出 >Hits Sent（发送的命中）标签页中，验证命中 被路由到 /metrics。

    验证设置的屏幕截图

第 5 步：反馈

请通过以下链接提供有关第一方模式的反馈： 反馈表单。