getInstance getinstance

Last update: Wed May 24 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

Developer
User
Admin
Leader

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

语法

JavaScript

var visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION-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-MARKETING-CLOUD-ORGANIZATION-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() 函数类似。

常见用法

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

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

recommendation-more-help

9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a