getInstance getinstance

getInstance renvoie un objet d’identifiant visiteur pour l’ID d’organisation IMS spécifié. Cela est nécessaire pour initialiser l’objet ID de visiteur fourni à AppMeasurement via s.visitor.

Syntaxe

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

Si getInstance ne trouve pas d’instance existante, une instance est créée et renvoyée. Ceci est similaire à la fonction 🔗 dans AppMeasurement.s_gi()

Utilisation courante

L’API du service d’identification des visiteurs conserve une liste de toutes les instances créées pour chaque ID d’organisation IMS. Si l’application qui utilise l’API du service d’identification des visiteurs ne transmet pas de référence à l’instance, elle peut trouver cette instance en appelant getInstance au lieu d’en créer une nouvelle. Cela permet également la prise en charge de plusieurs instances pour différentes organisations dans la même page/application Web.

Cela s’avère utile pour les applications qui n’ont pas de phase de init claire, mais qui doivent appeler l’API du service d’identification des visiteurs à plusieurs endroits. Vous pouvez appeler getInstance à tous ces emplacements et le premier à s’exécuter crée l’instance. L’instance existante est renvoyée par les appels qui suivent.