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 實例化 Visitor 函數。您必須使用此處指出的適當函數呼叫。套用至 VisitorAPI.js 程式碼資料庫第三版或是更新版本。

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，第一個執行的 getInstance 將建立例項。後續呼叫將傳回現有的例項。

recommendation-more-help

id-service-help