getInstance getinstance
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
實例化 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
,第一個執行的 getInstance 將建立例項。後續呼叫將傳回現有的例項。
recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a