getInstance getinstance

最近更新： 2025年12月4日

创建对象：

{"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"},{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"f8a45b24-4be7-4f1b-909b-60d06b483a20"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

getInstance会返回指定IMS组织ID的访客ID对象。这是初始化通过 s.visitor 提供给 AppMeasurement 的访客 ID 对象所必需的。

语法

JavaScript

var visitor = Visitor.getInstance("INSERT-IMS-ORG-ID-HERE", {
     trackingServer: "INSERT-TRACKING-SERVER-HERE", // same as s.trackingServer
     trackingServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE", // same as s.trackingServerSecure

     // To enable CNAME support, add the following configuration variables
     // If you are not using CNAME, DO NOT include these variables
     marketingCloudServer: "INSERT-TRACKING-SERVER-HERE",
     marketingCloudServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE" // same as s.trackingServerSecure
});

CAUTION

当 var visitor = new Visitor 时，请不要实例化访客功能。您必须使用此处介绍的正确函数调用。适用于 VisitorAPI.js 代码库版本 3.0 或更高版本。

ActionScript / Flash

import com.adobe.mc.Visitor;
...
var visitor = Visitor.getInstance("INSERT-IMS-ORG-ID-HERE", {
     trackingServer: "INSERT-TRACKING-SERVER-HERE", // same as s.trackingServer
     trackingServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE", // same as s.trackingServerSecure

     // To enable CNAME support, add the following configuration variables
     // If you are not using CNAME, DO NOT include these variables
     marketingCloudServer: "INSERT-TRACKING-SERVER-HERE",
     marketingCloudServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE" // same as s.trackingServerSecure
});

如果 getInstance 未找到现有实例，则会创建并返回一个新实例。这类似于AppMeasurement中的s_gi()函数。

常见用法

访客ID服务API维护一个实例列表，其中包含为每个IMS组织ID创建的所有实例。如果使用访客ID服务API的应用程序没有传递对该实例的引用，它可以通过调用getInstance来查找该实例，而不是创建一个新实例。此外，该函数还可以为同一网页或应用程序中不同组织的多个实例提供支持。

这对于不具备清晰的init阶段、但是需要在多个位置调用访客ID服务API的应用程序而言，非常有用。您可以在所有这些位置中调用 getInstance，第一次执行调用时，将创建实例。后续调用将返回现有实例。

recommendation-more-help

id-service-help