Show Menu
主題×

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 程式碼資料庫第三版或是更新版本。
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
找不到現有例項,則會建立與傳回新例項。This is similar to the
s_gi()
in AppMeasurement.
常見用法
Experience Cloud ID 服務 API 維護為每個 Adobe Experience Cloud 組織 ID 建立的所有例項清單。如果使用 ID 服務 API 的應用程式未將參照傳遞至例項,可藉由呼叫
getInstance
來尋找該例項,而不須建立新例項。這樣就能支援相同網頁或應用程式中,不同組織的多個例項。
對於沒有明確的
init
階段、卻需要在多處呼叫 ID 服務 API 的應用程式來說,這個用法很有幫助。您可以在所有位置呼叫
getInstance
,第一個執行的 getInstance 將建立例項。後續呼叫將傳回現有的例項。