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 
});
注意

請勿​以 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 將建立例項。後續呼叫將傳回現有的例項。

本頁內容