getInstance getinstance

getInstance restituisce un ID visitatore per l’ID organizzazione IMS specificato. Questo è necessario per inizializzare l’ID visitatore fornito ad AppMeasurement tramite s.visitor.

Sintassi

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

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

Se getInstance non rileva un’istanza esistente, viene creata e restituita una nuova istanza. È simile alla funzione s_gi() in AppMeasurement.

Uso comune

L’API del servizio ID visitatore mantiene un elenco di tutte le istanze create per ogni ID organizzazione IMS. Se l’applicazione che utilizza l’API del servizio ID visitatori non utilizza un riferimento all’istanza, l’istanza può essere individuata chiamando getInstance anziché crearne una nuova. Questa funzione supporta anche più istanze per diverse organizzazioni all’interno della stessa pagina Web o della stessa applicazione.

Questa funzione è utile per le applicazioni che non dispongono di una fase init chiara e che devono essere richiamate nell’API del servizio ID visitatori in più posizioni. Puoi chiamare getInstance da tutte le posizioni, l’istanza verrà creata dalla prima posizione in cui viene eseguito. L’istanza esistente verrà restituita dalle chiamate successive.