DocumentatieAnalyticsImplementatiehandleiding

Adobe-insteekmodule: getGeoCoordinates

Last update: Mon Jun 23 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Beheerder
  • Ontwikkelaar
IMPORTANT
Deze insteekmodule wordt door Adobe Consulting geleverd als hoffelijkheid om u te helpen meer waarde uit Adobe Analytics te krijgen. De Adobe Customer Care biedt geen ondersteuning voor deze plug-in, inclusief installatie of probleemoplossing. Neem contact op met het Adobe-accountteam van uw organisatie als u hulp nodig hebt met deze plug-in. Zij kunnen een vergadering voor hulp met een consultant organiseren.

Met de plug-in getGeoCoordinates kunt u de breedte en lengte van bezoekersapparaten vastleggen. Adobe raadt u aan deze plug-in te gebruiken als u geo-locatiegegevens wilt vastleggen in variabelen van Analytics.

De insteekmodule installeren met de extensie Web SDK

Adobe biedt een extensie waarmee u veelgebruikte plug-ins kunt gebruiken voor de webversie van SDK.

  1. Login aan de Inzameling van Gegevens van Adobe Experience Platformgebruikend uw geloofsbrieven van AdobeID.

  2. Klik op Tags aan de linkerkant en klik op de gewenste eigenschap Tag.

  3. Klik op Extensions aan de linkerkant en klik vervolgens op de tab Catalog

  4. Zoek en installeer de extensie Common Web SDK Plugins .

  5. Klik op Data Elements aan de linkerkant en klik op het gewenste gegevenselement.

  6. Stel de gewenste naam van het gegevenselement in met de volgende configuratie:

    • Extensie: algemene SDK-plug-ins voor het web
    • Gegevenselement: getGeoCoordinates

  7. Sla de wijzigingen in het gegevenselement op en publiceer deze.

De insteekmodule handmatig installeren voor de Web SDK

Deze insteekmodule wordt nog niet ondersteund voor gebruik in een handmatige implementatie van de Web SDK.

De insteekmodule installeren met de Adobe Analytics-extensie

Adobe biedt een extensie waarmee u veelgebruikte plug-ins kunt gebruiken in Adobe Analytics.

  1. Login aan de Inzameling van Gegevens van Adobe Experience Platformgebruikend uw geloofsbrieven van AdobeID.

  2. Klik op de gewenste tageigenschap.

  3. Ga naar de tab Extensions en klik vervolgens op de knop Catalog

  4. De extensie Common Analytics Plugins installeren en publiceren

  5. Als u niet reeds hebt, creeer een regel geëtiketteerd "Initialize stop-ins"met de volgende configuratie:

    • Voorwaarde: geen
    • Event: Core - bibliotheek geladen (pagina boven)

  6. Voeg een actie aan de bovengenoemde regel met de volgende configuratie toe:

    • Extensie: veelgebruikte plug-ins voor Analytics
    • Type handeling: getGeoCoordinates initialiseren

  7. Sla de wijzigingen in de regel op en publiceer deze.

Plug-in installeren met aangepaste code-editor

Als u niet de Gemeenschappelijke Insteekmodule van Analytics wilt gebruiken, kunt u de redacteur van de douanecode gebruiken.

  1. Login aan de Inzameling van Gegevens van Adobe Experience Platformgebruikend uw geloofsbrieven van AdobeID.
  2. Klik op de gewenste eigenschap.
  3. Ga naar de tab Extensions en klik vervolgens op de knop Configure onder de extensie Adobe Analytics.
  4. Vouw de accordeon Configure tracking using custom code uit, zodat de knop Open Editor zichtbaar wordt.
  5. Open de aangepaste code-editor en plak de onderstaande plug-incode in het bewerkingsvenster.
  6. Sla de wijzigingen in de extensie Analytics op en publiceer deze.

Plug-in installeren met AppMeasurement

Kopieer en plak de volgende code ergens in het AppMeasurement-bestand nadat het object Analytics tracking is geïnstantieerd (met s_gi ). Door opmerkingen en versienummers van de code in uw implementatie te behouden, helpt Adobe bij het oplossen van mogelijke problemen.

/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: getGeoCoordinates v2.0  */
function getGeoCoordinates(){if(arguments&&"-v"===arguments[0])return{plugin:"getGeoCoordinates",version:"2.0"};var b=function(){if("undefined"!==typeof window.s_c_il)for(var a=0,c;a<window.s_c_il.length;a++)if(c=window.s_c_il[a],c._c&&"s_c"===c._c)return c}();"undefined"!==typeof b&&(b.contextData.getGeoCoordinates="2.0");window.cookieWrite=window.cookieWrite||function(a,c,f){if("string"===typeof a){var h=window.location.hostname,b=window.location.hostname.split(".").length-1;if(h&&!/^[0-9.]+$/.test(h)){b=2<b?b:2;var e=h.lastIndexOf(".");if(0<=e){for(;0<=e&&1<b;)e=h.lastIndexOf(".",e-1),b--;e=0<e?h.substring(e):h}}g=e;c="undefined"!==typeof c?""+c:"";if(f||""===c)if(""===c&&(f=-60),"number"===typeof f){var d=new Date;d.setTime(d.getTime()+6E4*f)}else d=f;return a&&(document.cookie=encodeURIComponent(a)+"="+encodeURIComponent(c)+"; path=/;"+(f?" expires="+d.toUTCString()+";":"")+(g?" domain="+g+";":""),"undefined"!==typeof cookieRead)?cookieRead(a)===c:!1}};window.cookieRead=window.cookieRead||function(a){if("string"===typeof a)a=encodeURIComponent(a);else return"";var c=" "+document.cookie,b=c.indexOf(" "+a+"="),d=0>b?b:c.indexOf(";",b);return(a=0>b?"":decodeURIComponent(c.substring(b+2+a.length,0>d?c.length:d)))?a:""};var d="";b=cookieRead("s_ggc").split("|");var k={timeout:5E3,maximumAge:0},l=function(a){a=a.coords;cookieWrite("s_ggc",parseFloat(a.latitude.toFixed(4))+"|"+parseFloat(a.longitude.toFixed(4)),30);d="latitude="+parseFloat(a.latitude.toFixed(4))+" | longitude="+parseFloat(a.longitude.toFixed(4))},m=function(a){d="error retrieving geo coordinates"};1<b.length&&(d="latitude="+b[0]+" | longitude="+b[1]);navigator.geolocation&&navigator.geolocation.getCurrentPosition(l,m,k);""===d&&(d="geo coordinates not available");return d};
/******************************************** END CODE TO DEPLOY ********************************************/

De plug-in gebruiken

De functie getGeoCoordinates gebruikt geen argumenten. Deze geeft een van de volgende waarden:

  • "geo coordinates not available": voor apparaten waarvoor geen gegevens over de geolocatie beschikbaar zijn op het moment dat de plug-in wordt uitgevoerd. Deze waarde komt vaak voor bij de eerste treffer van het bezoek, vooral wanneer bezoekers eerst toestemming moeten geven om hun locatie te volgen.
  • "error retrieving geo coordinates": Wanneer de plug-in fouten aantreft bij het ophalen van de locatie van het apparaat
  • "latitude=[LATITUDE] | longtitude=[LONGITUDE]": Waar [ LATITUDE ]/[ LONGITUDE ] de breedte en de lengtegraad, respectievelijk zijn
NOTE
Coördinaatwaarden worden afgerond tot op het dichtstbijzijnde vierde decimaal. De waarde van "40.438635333" wordt bijvoorbeeld afgerond naar "40.4386" om het aantal unieke waarden te beperken dat moet worden vastgelegd. De waarden zijn dicht genoeg om de exacte locatie van het apparaat binnen ongeveer 10 meter te bepalen.

Deze plug-in gebruikt een cookie met de naam "s_ggc" om indien nodig coördinaten tussen hits op te slaan.

Voorbeelden

// Sets eVar1 to one of the above return values depending on the visitor's device status.
s.eVar1 = getGeoCoordinates();

// Extracts latitude and longitude into their own variables called finalLatitude and finalLongitude for use in other code/applications.
var coordinates = getGeoCoordinates();
if(coordinates.indexOf("latitude") > -1)
{
  var finalLatitude = Number(coordinates.split("|")[0].trim().split("=")[1]),
  finalLongitude = Number(coordinates.split("|")[1].trim().split("=")[1]);
}

// From there, you can determine whether a visitor is at, for example, the Statue of Liberty:
if(finalLatitude >= 40.6891 && finalLatitude <= 40.6893 && finalLongitude >= -74.0446 && finalLongitude <= -74.0444)
{
  var visitorAtStatueOfLiberty = true;
}
else
{
  var visitorAtStatueOfLiberty = false;
}

Versiehistorie

2.0 (19 maart 2021)

  • Versienummer toegevoegd als contextgegevens.

1.0 (25 mei 2015)

  • Eerste release.
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690