Het Adobe Analytics-framework aanpassen

Het Adobe Analytics-framework bepaalt welke informatie wordt bijgehouden met Adobe Analytics. Als u het standaardframework wilt aanpassen, gebruikt u javascript om aangepaste tracking toe te voegen, Adobe Analytics-plug-ins te integreren en algemene instellingen te wijzigen in het framework dat wordt gebruikt voor bijhouden.

Over de gegenereerde javascript voor frames

Wanneer een pagina aan een kader van Adobe Analytics wordt geassocieerd, en de pagina verwijzingen naar de module van Analytics omvat, wordt een analytics.sitecatalyst.js- dossier automatisch geproduceerd voor de pagina.

Het javascript in de pagina maakt een s_giobject (dat door de Adobe Analytics-bibliotheek s_code.js wordt gedefinieerd) en wijst waarden toe aan de eigenschappen ervan. De naam van de objectinstantie is s. De codevoorbeelden die in deze sectie worden voorgesteld maken verscheidene verwijzingen naar deze s variabele.

De volgende voorbeeldcode lijkt op de code in het bestand analytics.sitecatalyst.js:

var s_account = "my_sitecatalyst_account";
var s = s_gi(s_account);
s.fpCookieDomainPeriods = "3";
s.currencyCode= 'USD';
s.trackInlineStats= true;
s.linkTrackVars= 'None';
s.charSet= 'UTF-8';
s.linkLeaveQueryString= false;
s.linkExternalFilters= '';
s.linkTrackEvents= 'None';
s.trackExternalLinks= true;
s.linkDownloadFileTypes= 'exe,zip,wav,mp3,mov,mpg,avi,wmv,doc,pdf,xls';
s.linkInternalFilters= 'javascript:,'+window.location.hostname;
s.trackDownloadLinks= true;

s.visitorNamespace = "mynamespace";
s.trackingServer = "xxxxxxx.net";
s.trackingServerSecure = "xxxxxxx.net";

/* Plugin Config */
/*
s.usePlugins=false;
function s_doPlugins(s) {
    //add your custom plugin code here
}
s.doPlugins=s_doPlugins;
*/

Wanneer u aangepaste javascript-code gebruikt om het framework aan te passen, wijzigt u de inhoud van dit bestand.

Adobe Analytics-eigenschappen configureren

Er zijn een aantal vooraf gedefinieerde variabelen binnen Adobe Analytics die kunnen worden geconfigureerd op een framework​. ​ De charset, cookieLifetime, currencyCode en trackInlineStats variabelen zijn standaard opgenomen in de lijst Algemene analytische instellingen.

aa-22

U kunt namen en waarden van variabelen aan de lijst toevoegen. Deze vooraf gedefinieerde variabelen en alle variabelen die u toevoegt, worden gebruikt om de eigenschappen van het object s in het bestand analytics.sitecatalyst.js te configureren. In het volgende voorbeeld wordt getoond hoe de toegevoegde prop10-eigenschap van waarde CONSTANT wordt vertegenwoordigd in de javascript-code:

var s_account = "my_sitecatalyst_account";
var s = s_gi(s_account);
s.fpCookieDomainPeriods = "3";
s.currencyCode= 'USD';
s.trackInlineStats= true;
s.linkTrackVars= 'None';
s.charSet= 'UTF-8';
s.linkLeaveQueryString= false;
s.linkExternalFilters= '';
s.linkTrackEvents= 'None';
s.trackExternalLinks= true;
s.linkDownloadFileTypes= 'exe,zip,wav,mp3,mov,mpg,avi,wmv,doc,pdf,xls';
s.prop10= 'CONSTANT';
s.linkInternalFilters= 'javascript:,'+window.location.hostname;
s.trackDownloadLinks= true;

s.visitorNamespace = "mynamespace";
s.trackingServer = "xxxxxxx.net";
s.trackingServerSecure = "xxxxxxx.net";

Gebruik de volgende procedure om variabelen aan de lijst toe te voegen:

  1. Vouw op uw Adobe Analytics-frameworkpagina het gebied Algemene analytische instellingen uit.

  2. Klik onder de lijst met variabelen op Item toevoegen om een nieuwe variabele aan de lijst toe te voegen.

  3. Voer in de linkercel een naam voor de variabele in, bijvoorbeeld prop10.

  4. Voer in de rechterkolom een waarde voor de variabele in, bijvoorbeeld CONSTANT.

  5. Als u een variabele wilt verwijderen, klikt u op de knop (-) naast de variabele.

OPMERKING

Wanneer het ingaan van variabelen en waarden, zorg ervoor zij correct geformatteerd en gespeld zijn, of de vraag zal niet worden verzonden met de correcte waarde/het veranderlijke paar. Verkeerd gespelde variabelen en de waarden kunnen vraag zelfs verhinderen voor te komen.

Neem contact op met uw Adobe Analytics-vertegenwoordiger om te controleren of deze variabelen correct zijn ingesteld.

LET OP

Sommige variabelen in deze lijst zijn mandatory opdat de vraag van Adobe Analytics correct werkt, (b.v. currencyCode, charSet)

Dus zelfs als ze uit het framework zelf worden verwijderd, zullen ze nog steeds met een standaardwaarde worden gekoppeld wanneer de Adobe Analytics-oproep wordt gedaan.

Aangepaste javascript toevoegen aan een Adobe Analytics-framework

Met het vak free-from javascript in het gebied General Analytics Settings kunt u aangepaste code toevoegen aan een Adobe Analytics-framework.

aa-21

De code die u toevoegt, wordt toegevoegd aan het bestand analytics.sitecatalyst.js. Daarom kunt u tot s variabele toegang hebben, die een geval van s_gi javascript is voorwerp dat in s_code.js wordt bepaald. Bijvoorbeeld, is het toevoegen van de volgende code gelijkwaardig aan het toevoegen van een variabele genoemd prop10 van waarde CONSTANT, die het voorbeeld in de vorige sectie is:

s.prop10= 'CONSTANT';

De code in het bestand analytics.sitecatalyst.js (dat de inhoud van het bestand Adobe Analytics s-code.js bevat) bevat de volgende code:

if (s.usePlugins) s.doPlugins(s)

De volgende procedure laat zien hoe u het vak javascript kunt gebruiken om het bijhouden van Adobe Analytics aan te passen. Als uw javascript Adobe Analytics plug-ins moet gebruiken, integreert u deze in AEM.

  1. Voeg de volgende javascript-code toe aan het vak, zodat s.doPlugins wordt uitgevoerd:

    s.usePlugins=true;
    function s_doPlugins(s) {
        //add your custom code here
    }
    s.doPlugins=s_doPlugins;
    
    LET OP

    Deze code is noodzakelijk als u variabelen in een vraag van Adobe Analytics wilt verzenden die op één of andere manier zijn aangepast die niet door de basis belemmering & dalingsinterface OF door gealigneerd javascript in de Mening van Adobe Analytics kan worden gedaan.

    Als de douanevariabelen buiten de functie s_doPlugins zijn zullen zij als *undefined *in de vraag van Adobe Analytics worden verzonden

  2. Voeg uw javascript-code toe in de functie s_doPlugins.

In het volgende voorbeeld worden de gegevens die op een pagina in hiërarchische volgorde zijn vastgelegd, samengevoegd met een algemeen scheidingsteken "|".

Een Adobe Analytics-framework heeft de volgende configuraties:

  • De prop2 Adobe Analytics-variabele wordt toegewezen aan de pagedata.sitesection-site-eigenschap.

  • De prop3 Adobe Analytics-variabele wordt toegewezen aan de pagedata.subsection-site-eigenschap.

  • De volgende code wordt toegevoegd aan het vak free-from javascript:

    s.usePlugins=true;
     function s_doPlugins(s) {
     s.prop1 = s.prop2+'|'+s.prop3;
     }
     s.doPlugins=s_doPlugins;
    
  • Wanneer de webpagina die gebruikmaakt van het framework wordt bezocht (of in de bewerkingsmodus wordt de pagina opnieuw geladen of voorvertoond), worden de aanroepen naar Adobe Analytics uitgevoerd.

De volgende waarden worden bijvoorbeeld gegenereerd in Adobe Analytics:

aa-20

Globale aangepaste code toevoegen voor alle Adobe Analytics-frameworks

Aangepaste javascript-code opgeven die in alle Adobe Analytics-frameworks is geïntegreerd. Wanneer het Adobe Analytics-framework van een pagina geen aangepaste free-form javascript bevat, wordt het JavaScript dat door het script /libs/cq/analytics/components/sitecatalyst/config.js.jsp wordt gegenereerd, toegevoegd aan het bestand analytics.sitecatalyst.js. Het script heeft standaard geen effect omdat het geen opmerkingen bevat. De code stelt s.usePlugins ook in op false:

/* Plugin Config */
/*
s.usePlugins=false;
function s_doPlugins(s) {
    //add your custom plugin code here
}
s.doPlugins=s_doPlugins;
*/

De code in het bestand analytics.sitecatalyst.js (die de inhoud van het bestand s_code.js van Adobe Analytics bevat) bevat de volgende code:

als (s.usePlugins) s.doPlugins

Daarom moet uw javascript s.usePlugins aan true plaatsen zodat om het even welke code in de s_doPlugins functie wordt uitgevoerd. Als u de code wilt aanpassen, bedekt u het bestand config.js.jsp met een bestand dat uw eigen javascript gebruikt. Als uw javascript Adobe Analytics plug-ins moet gebruiken, integreert u deze in AEM.

OPMERKING

Bewerk het bestand /libs/cq/analytics/components/sitecatalyst/config.js.jsp niet. Bepaalde AEM upgrade- of onderhoudstaken kunnen het oorspronkelijke bestand opnieuw installeren, waardoor uw wijzigingen worden verwijderd.

  1. Maak in CRXDE Lite de mapstructuur /apps/cq/analytics/components:

    1. Klik met de rechtermuisknop op de map /apps en klik op Maken > Map maken.
    2. Geef cq op als mapnaam en klik op OK.
    3. Maak op dezelfde manier de mappen analytics en components.
  2. Klik met de rechtermuisknop op de map components die u net hebt gemaakt en klik op Maken > Component maken. Geef de volgende eigenschapswaarden op:

    • Label: sitecatalyst
    • Titel: sitecatalyst
    • Supertype: /libs/cq/analytics/components/sitecatalyst
    • Groeperen: hidden
  3. Klik herhaaldelijk op Volgende totdat de knop OK is ingeschakeld en klik vervolgens op OK.

    De component sitecatalyst bevat het automatisch gemaakte bestand sitecatalyst.jsp.

  4. Klik met de rechtermuisknop op het bestand sitecatalyst.jsp en klik op Verwijderen.

  5. Klik met de rechtermuisknop op de component sitecatalyst en klik op Maken > Bestand maken. Geef de naam config.js.jsp op en klik op OK.

    Het bestand config.js.jsp wordt automatisch geopend voor bewerking.

  6. Voeg de volgende tekst toe aan het bestand en klik op Alles opslaan:

    <%@page session="true"%>
    /* Plugin Config */
    s.usePlugins=true;
    function s_doPlugins(s) {
        //add your custom plugin code here
    }
    s.doPlugins=s_doPlugins;
    

    De javascript-code die door het script /apps/cq/analytics/components/sitecatalyst/config.js.jsp wordt gegenereerd, wordt nu ingevoegd in het bestand analytics.sitecatalyst.js voor alle pagina's die een Adobe Analytics-framework gebruiken.

  7. Voeg de javascript-code toe die u in de functie s_doPlugins wilt uitvoeren en klik op Alles opslaan.

LET OP

Als er tekst aanwezig is in de javascript-vrije vorm van het raamwerk van een pagina (zelfs alleen witruimte), wordt config.js.jsp genegeerd.

Adobe Analytics-plug-ins gebruiken in AEM

Vraag de javascript-code voor Adobe Analytics-plug-ins aan en integreer deze in AEM in uw Adobe Analytics-framework. Voeg de code aan een omslag van de cliëntbibliotheek van de categorie sitecatalyst.plugins toe zodat zij aan uw douanecode javascript beschikbaar zijn.

Als u bijvoorbeeld de getQueryParams plug-in integreert, kunt u de plug-in vanuit de functie s_doPlugins van uw aangepaste javascript oproepen. De volgende voorbeeldcode verzendt het vraagkoord in "pid" van URL van de verwijzer als eVar1, wanneer een vraag van Adobe Analytics wordt teweeggebracht.

s.usePlugins=true;
function s_doPlugins(s) {
   // take the query string from the referrer
   s.eVar1=s.getQueryParam('pid','',document.referrer);
}
s.doPlugins=s_doPlugins;

AEM installeert de volgende Adobe Analytics-plug-ins, zodat deze standaard beschikbaar zijn:

  • getQueryParam()
  • getPreviousValue()
  • split()

De clientbibliotheekmap /libs/cq/analytics/clientlibs/sitecatalyst/plugins bevat deze plug-ins in de categorie sitecatalyst.plugins.

OPMERKING

Maak een nieuwe clientbibliotheekmap voor uw plug-ins. Voeg geen plug-ins toe aan de map /libs/cq/analytics/clientlibs/sitecatalyst/plugins. Deze praktijk zorgt ervoor dat uw bijdrage aan de sitecatalyst.plugins categorie niet tijdens AEM re-installeert of verbeteringstaken wordt beschreven.

Gebruik de volgende procedure om de map met de clientbibliotheek voor uw plug-ins te maken. U hoeft deze procedure slechts eenmaal uit te voeren. Gebruik de volgende procedure om een plug-in toe te voegen aan de map met clientbibliotheken.

  1. Open CRXDE Lite in een webbrowser. (http://localhost:4502/crx/de)

  2. Klik met de rechtermuisknop op de map /apps/my-app/clientlibs en klik op Maken > Node maken. Voer de volgende eigenschapswaarden in en klik op OK:

    • Naam: Een naam voor de clientbibliotheekmap, zoals mijn plug-ins

    • Type: cq:ClientLibraryFolder

  3. Selecteer de clientbibliotheekmap die u net hebt gemaakt en gebruik de onderste eigenschappenbalk rechts om de volgende eigenschap toe te voegen:

    • Naam: categorieën
    • Type: String
    • Waarde: sitecatalyst.plugins
    • Meerdere: geselecteerd

    Klik op OK in het venster Bewerken om de waarde van de eigenschap te bevestigen.

  4. Klik met de rechtermuisknop op de clientbibliotheekmap die u net hebt gemaakt en klik op Maken > Bestand maken. Typ js.txt als bestandsnaam en klik op OK.

  5. Klik op Alles opslaan.

Gebruik de volgende procedure om de insteekmodulecode op te halen, de code op te slaan in de AEM opslagplaats en de code toe te voegen aan de map met de clientbibliotheek.

  1. Meld u met uw Adobe Analytics-account aan bij sc.omniture.com.

  2. Ga op de bestemmingspagina naar Help > Help Home.

  3. Klik in de inhoudsopgave aan de linkerkant op Plug-ins voor implementatie.

  4. Klik op de koppeling naar de plug-in die u wilt toevoegen. Wanneer de pagina wordt geopend, zoekt u de javascript-broncode voor de plug-in en selecteert u de code en kopieert u deze.

  5. Klik met de rechtermuisknop op de clientbibliotheekmap en klik op Maken > Bestand maken. Typ voor de bestandsnaam de naam van de plug-in die u wilt integreren, gevolgd door .js, en klik op OK. Als u bijvoorbeeld de insteekmodule getQueryParam integreert, geeft u het bestand de naam getQueryParam.js.

    Wanneer u het bestand maakt, wordt het geopend voor bewerking.

  6. Plak de javascript-insteekmodule in het bestand, klik op Alles opslaan en sluit het bestand.

  7. Open het bestand js.txt vanuit de clientbibliotheekmap.

  8. Voeg in een nieuwe regel de naam toe van het bestand dat de insteekmodule bevat, bijvoorbeeld getQueryParam.js. Klik vervolgens op Alles opslaan en sluit het bestand.

OPMERKING

Als u plug-ins gebruikt, moet u ook eventuele ondersteunende plug-ins integreren. Als dit niet het geval is, herkent de insteekmodule javascript niet de aanroepen die het naar de functies in de ondersteunende plug-in voert. De getPreviousValue()-insteekmodule vereist bijvoorbeeld dat de split()-insteekmodule correct werkt.

De naam van de ondersteuningsinsteekmodule moet ook worden toegevoegd aan js.txt.

Op deze pagina