Plug-in Adobe: getGeoCoordinates

Il getGeoCoordinates plug-in consente di acquisire la latitudine e la longitudine dei dispositivi dei visitatori. Adobe consiglia di utilizzare questo plug-in per acquisire i dati di geolocalizzazione variabili Analytics.

Installare il plug-in utilizzando l'estensione Lancio del Adobe Experience Platform

Adobe offre un’estensione che consente di utilizzare la maggior parte dei plug-in usati comunemente.

1. Accedete a launch.adobe.com utilizzando le credenziali AdobeID.
2. Fate clic sulla proprietà desiderata.
3. Vai alla Extensions scheda, quindi fai clic sul Catalog pulsante
4. Installare e pubblicare l’ Common Analytics Plugins estensione
5. Se non lo avete già fatto, create una regola con l'etichetta "Inizializza plug-in" con la seguente configurazione:
   • Condizione: nessuna
   • Evento: Core - Libreria caricata (Page Top)
6. Aggiungete un'azione alla regola precedente con la seguente configurazione:
   • Estensione: Plug-in Analytics comuni
   • Tipo azione: Inizializza getGeoCoordinates
7. Salvate e pubblicate le modifiche alla regola.

Installare il plug-in utilizzando l'editor di codice personalizzato Launch

Se non desiderate utilizzare l'estensione del plug-in, potete utilizzare l'editor di codice personalizzato.

1. Accedete a launch.adobe.com utilizzando le credenziali AdobeID.
2. Fate clic sulla proprietà desiderata.
3. Vai alla Extensions scheda, quindi fai clic sul Configure pulsante sotto l'estensione Adobe Analytics.
4. Espandere la struttura Configure tracking using custom code a soffietto, che mostra il Open Editor pulsante.
5. Aprite l’editor di codice personalizzato e incollate il codice plug-in fornito di seguito nella finestra di modifica.
6. Salvate e pubblicate le modifiche nell’estensione Analytics .

Installare il plug-in utilizzando AppMeasurement

Copiate e incollate il seguente codice in qualsiasi punto del file AppMeasurement dopo che è stata creata un'istanza dell'oggetto di tracciamento Analytics (utilizzando s_gi). La conservazione di commenti e numeri di versione del codice nell’implementazione consente ad Adobe di risolvere eventuali problemi.

/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: getGeoCoordinates v1.0 */
s.getGeoCoordinates=function(){var d=this,b="",a=d.c_r("s_ggc").split("|"),e={timeout:5E3,maximumAge:0},f=function(c){c=c.coords;var a=new Date;a.setTime(a.getTime()+18E5);d.c_w("s_ggc",parseFloat(c.latitude.toFixed(4))+"|"+parseFloat(c.longitude.toFixed(4)),a); b="latitude="+parseFloat(c.latitude.toFixed(4))+" | longitude="+parseFloat(c.longitude.toFixed(4))},g=function(a){b="error retrieving geo coordinates"};1<a.length&&(b="latitude="+a[0]+" | longitude="+a[1]);navigator.geolocation&& navigator.geolocation.getCurrentPosition(f,g,e);""===b&&(b="geo coordinates not available");return b};
/******************************************** END CODE TO DEPLOY ********************************************/

Utilizzare il plug-in

Il getGeoCoordinates metodo non utilizza argomenti. Restituisce uno dei seguenti valori:

• "geo coordinates not available": Per i dispositivi che non dispongono di dati di geolocalizzazione al momento dell’esecuzione del plug-in. Questo valore è comune per il primo hit della visita, soprattutto quando i visitatori devono fornire il consenso al tracciamento della loro posizione.
• "error retrieving geo coordinates": Quando il plug-in rileva errori durante il tentativo di recuperare la posizione del dispositivo
• "latitude=[LATITUDE] | longtitude=[LONGITUDE]": Dove [LATITUDINE]/[LONGITUDINE] sono rispettivamente la latitudine e la longitudine

Questo plug-in utilizza un cookie denominato "s_ggc" per memorizzare le coordinate tra gli hit, se necessario.

Chiamate di esempio

Esempio n. 1

Codice seguente…

s.eVar1 = s.getGeoCoordinates();

…imposta eVar1 uguale a uno dei valori restituiti sopra a seconda dello stato del dispositivo del visitatore

Esempio n. 2

Il codice seguente estrae latitudine e longitudine nelle proprie variabili denominate finalLatitude e finalLongitude per l’utilizzo in altri codici/applicazioni

var coordinates = s.getGeoCoordinates();
if(coordinates.indexOf("latitude") > -1)
{
  var finalLatitude = Number(coordinates.split("|")[0].trim().split("=")[1]),
  finalLongitude = Number(coordinates.split("|")[1].trim().split("=")[1]);
}

Da qui potete determinare se un visitatore si trova, ad esempio, nella Statua della Libertà:

if(finalLatitude >= 40.6891 && finalLatitude <= 40.6893 && finalLongtude >= -74.0446 && finalLongitude <= -74.0444)
  var visitorAtStatueOfLiberty = true;
else
  var visitorAtStatueOfLiberty = false;

Cronologia versioni

1.0 (25 maggio 2015)

• Versione iniziale.