文档Analytics实施指南

使用AppMeasurement进行访客识别

Last update: Wed Oct 22 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 用户
  • 管理员

AppMeasurement是Adobe Analytics用于数据收集的旧版JavaScript库。 虽然AppMeasurement本身提供了用于识别访客的本机方法，但许多现代浏览器会拒绝它尝试设置的第三方Cookie。 Adobe强烈建议在所有实施中使用Adobe Experience Cloud访客ID服务以符合现代浏览器隐私标准。 所有版本的AppMeasurement都与VisitorAPI.js捆绑在一起，JavaScript库用于实施访客ID服务。

使用访客ID服务识别访客（推荐）

确保您已做好以下准备：

  • 下载最新版本的AppMeasurement。 下载的库包含AppMeasurement.js和VisitorAPI.js。

  • 开发报表包ID。

  • trackingServerSecure的所需边缘域。

  • 您的IMS组织ID：

    1. 使用您的Adobe ID凭据登录experience.adobe.com。
    2. 在Experience Cloud界面中的任意位置，按[Cmd] + [I] (iOS)或[Ctrl] + [I] (Windows)。
    3. 出现​用户数据调试器。 选择​ 分配的组织 ​选项卡。
    4. 展开所需的IMS组织。
    5. 找到​ ID ​字段。

获得上述资源后，以下基本示例页面包含将数据发送到Adobe Analytics所需的最低调用：

<html>
  <head>
    <title>Example AppMeasurement implementation page</title>
    <script src="AppMeasurement.js"></script>
    <script src="VisitorAPI.js"></script>
  </head>
  <body>
    <h1>Hello world!</h1>
    <script>
      var s = s_gi("examplersid"); // Include development report suite ID here
      s.trackingServerSecure = "example.data.adobedc.net"; // Include edge domain here
      s.visitor = Visitor.getInstance("ADB3LETTERSANDNUMBERS@AdobeOrg"); // Include IMS org ID here
      s.pageName = document.title;
      s.t();
    </script>
  </body>
</html>
TIP
您可以通过将Visitor的存在分配给doPlugins中的自定义变量来跟踪点击是否使用访客ID服务：
code language-js 
s.doPlugins = function() {
   s.prop1 = typeof(Visitor) != "undefined" ? "VisitorAPI present" : "VisitorAPI missing";
};

使用s_vi Cookie识别访客（不推荐）

IMPORTANT
Adobe建议不要使用此方法来识别访客。

如果贵组织未使用访客ID服务，则AppMeasurement将使用其自身的访客识别形式。 当访客首次访问您的网站时，库会检查s_vi Cookie。 此Cookie在匹配trackingServerSecure（对于HTTPS）或trackingServer（对于HTTP）的域中设置。

  • 如果您参与托管证书计划，您的跟踪服务器通常是第一方域，使s_vi Cookie成为第一方。
  • 如果您未参与托管证书计划，则跟踪服务器通常是adobedc.net、omtrdc.net或2o7.net的子域，从而使s_vi Cookie成为第三方Cookie。 由于现代浏览器隐私标准，第三方Cookie被大多数浏览器拒绝。 被拒绝后，AppMeasurement会尝试改为设置第一方回退Cookie (fid)。

如果您正确设置trackingServerSecure，则无需进一步的访客识别措施。

使用visitorID识别访客（不推荐）

IMPORTANT
Adobe建议不要使用此方法来识别访客。

使用visitorID变量可让您的组织完成识别访客的独立控制。 如果您使用visitorID，请注意以下限制：

  • 每次点击必须包含相同的visitorID值才能计为单个访客。

    • 任何忽略visitorID的点击都会自动尝试使用其他访客识别方法，将它们视为单独的访客。
    • 任何包含与上一次点击不同的visitorID值的点击都将被视为单独的访客。
    • Adobe不提供在Adobe Analytics中将使用不同访客ID的点击拼合在一起的方法。

  • 使用visitorID标识的访客不支持共享受众、Analytics for Target和客户属性。

有关使用此变量的实施说明，请参阅visitorID。

recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690