s_gi
La funzione s_gi()
crea un'istanza o trova un'istanza di AppMeasurement in base all'ID suite di rapporti. AppMeasurement tiene traccia di ogni istanza creata e s_gi()
restituisce l'istanza esistente per una suite di rapporti, se ne esiste una. Se non esiste alcuna istanza, viene creata una nuova istanza.
Creare un’istanza di un oggetto di tracciamento utilizzando l’estensione Web SDK
L'estensione Web SDK crea un'istanza e gestisce l'oggetto di tracciamento automaticamente. Tuttavia, puoi personalizzare il nome dell’oggetto di tracciamento nelle impostazioni dell’estensione:
- Accedi a Raccolta dati di Adobe Experience Platform utilizzando le credenziali Adobe ID.
- Fai clic sulla proprietà del tag desiderata.
- Vai alla scheda Extensions, quindi fai clic sul pulsante Configure in Adobe Experience Platform Web SDK.
- Modificare il campo Name nel valore desiderato. Il valore predefinito è
alloy
.
Creare un’istanza di un oggetto di tracciamento implementando manualmente l’SDK per web
Il codice seguente carica l'SDK Web e crea un'istanza di un oggetto di tracciamento. È possibile personalizzare il nome dell'oggetto di tracciamento modificando la stringa "alloy"
alla fine dello script in linea con il valore desiderato.
<script>
!function(n,o){o.forEach(function(o){n[o]||((n.__alloyNS=n.__alloyNS||
[]).push(o),n[o]=function(){var u=arguments;return new Promise(
function(i,l){n[o].q.push([i,l,u])})},n[o].q=[])})}
(window,["alloy"]);
</script>
<script src="https://cdn1.adoberesources.net/alloy/2.6.4/alloy.min.js" async></script>
Per ulteriori informazioni, consulta Installare l'SDK nella documentazione dell'SDK Web.
Creare un’istanza di un oggetto di tracciamento utilizzando l’estensione Adobe Analytics
L'estensione Analytics crea e gestisce automaticamente l'oggetto di tracciamento. Tuttavia, è anche possibile impostare un oggetto di tracciamento globale nel pannello a soffietto Library Management durante la configurazione dell'estensione Adobe Analytics.
- Accedi a Raccolta dati di Adobe Experience Platform utilizzando le credenziali Adobe ID.
- Fai clic sulla proprietà del tag desiderata.
- Vai alla scheda Extensions, quindi fai clic sul pulsante Configure in Adobe Analytics.
- Espandere il pannello a soffietto Library Management e selezionare un pulsante di opzione diverso da Manage the library for me.
Il campo di testo variabile globale consente di impostare un oggetto di tracciamento personalizzato. Il valore predefinito è s
.
s_gi() in AppMeasurement e nell’editor di codice personalizzato dell’estensione Analytics
Chiamare la funzione s_gi()
per creare un'istanza di un oggetto di tracciamento. Il suo unico argomento contiene una stringa delimitata da virgole di ID suite di rapporti. L’argomento ID suite di rapporti è obbligatorio.
s
come oggetto di tracciamento. Adobe utilizza s
nella documentazione, negli esempi di implementazione e nei plug-in. Tuttavia, puoi utilizzare qualsiasi variabile purché sia coerente all’interno del sito.// Instantiate the tracking object with a single report suite
var s = s_gi("examplersid");
// Instantiate the tracking object to send to multiple report suites
var s = s_gi("examplersid1,examplersid2");
Gestire più implementazioni utilizzando diversi oggetti di tracciamento
Se crei un'istanza di più oggetti di tracciamento, puoi inviare dati diversi a suite di rapporti diverse. Questi due oggetti di tracciamento operano in modo indipendente l'uno dall'altro.
// Instantiate two separate tracking objects to two different report suites
var s = s_gi('examplersid1');
var z = s_gi('examplersid2');
// The s object and z object contain their own independent Analytics variables simultaneously
s.pageName = "Example page name 1";
z.pageName = "Example page name 2";
// Send data to the examplersid1 report suite
s.t();
// Send data to the examplersid2 report suite
z.t();
Ripristina le variabili di AppMeasurement dopo la sovrascrittura dell’oggetto s
Alcuni strumenti di terze parti potrebbero inoltre utilizzare l'oggetto JavaScript s
. Se si sovrascrive accidentalmente l'oggetto s
sul sito, è possibile chiamare s_gi
con lo stesso argomento stringa RSID per ripristinare tutte le variabili e i metodi sovrascritti.
// Step 1: Instantiate the tracking object
var s = s_gi("examplersid");
// Step 2: Set eVar1
s.eVar1 = "Example value";
// Step 3: Accidentally overwrite the tracking object
s = "3rd party tool";
// Step 4: If you attempt to send a tracking call, an error is returned. Instead, re-instantiate the tracking object
s = s_gi("examplersid");
// Step 5: The previous values of all variables are preserved. You can send a tracking call and eVar1 is correctly set
s.t();
Fare riferimento allo stesso oggetto di tracciamento con più variabili
Se due variabili fanno riferimento alla stessa funzione s_gi()
con la stessa suite di rapporti, è possibile utilizzare le variabili in modo intercambiabile.
// If the RSID is the same, any variables set in the 's' tracking object also get set in 'z' tracking object
var s = s_gi('examplersid');
var z = s_gi('examplersid');
s.eVar1 = "Shared tracking object value";
// This tracking call contains the above eVar1 value
z.t();