Personalização da estrutura do Adobe Analytics customizing-the-adobe-analytics-framework

A estrutura do Adobe Analytics determina as informações que são rastreadas com o Adobe Analytics. Para personalizar a estrutura padrão, use o JavaScript para adicionar rastreamento personalizado, integrar plug-ins do Adobe Analytics e alterar as configurações gerais na estrutura usada para rastreamento.

Sobre o JavaScript gerado para Frameworks about-the-generated-javascript-for-frameworks

Quando uma página é associada a uma estrutura do Adobe Analytics e a página inclui referências ao módulo do Analytics, um arquivo analytics.sitecatalyst.js é gerado automaticamente para a página.

O JavaScript na página cria uma s_gi(que a biblioteca Adobe Analytics s_code.js define) e atribui valores às suas propriedades. O nome da instância do objeto é s. Os exemplos de código apresentados nesta seção fazem várias referências a isso s variável.

O código de exemplo a seguir é semelhante ao código em um arquivo 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;
*/

Ao usar o código JavaScript personalizado para personalizar a estrutura, você altera o conteúdo desse arquivo.

Configuração das propriedades do Adobe Analytics configuring-adobe-analytics-properties

Há várias variáveis predefinidas no Adobe Analytics que podem ser configuradas em uma estrutura. A variável charset, cookieLifetime, currencyCode, e trackInlineStats as variáveis são incluídas no Configurações gerais do Analytics por padrão.

É possível adicionar nomes e valores de variáveis à lista. Essas variáveis predefinidas e quaisquer variáveis adicionadas são usadas para configurar as propriedades da variável s no arquivo analytics.sitecatalyst.js. O exemplo a seguir mostra como o adicionou prop10 propriedade do valor CONSTANT é representado no código JavaScript:

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";

Use o procedimento a seguir para adicionar variáveis à lista:

Adicionar JavaScript personalizado a uma estrutura do Adobe Analytics adding-custom-javascript-to-an-adobe-analytics-framework

A caixa de código livre do JavaScript no Configurações gerais do Analytics permite adicionar código personalizado a uma estrutura Adobe Analytics.

O código adicionado é anexado ao arquivo analytics.sitecatalyst.js. Portanto, você pode acessar a variável s que é uma instância da variável s_gi Objeto JavaScript definido em s_code.js. Por exemplo, adicionar o código a seguir é equivalente a adicionar uma variável chamada prop10 de valor CONSTANT, que é o exemplo na seção anterior:

s.prop10= 'CONSTANT';

O código na variável analytics.sitecatalyst.js arquivo (que inclui o conteúdo do Adobe Analytics) s-code.js arquivo) contém o seguinte código:

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

O procedimento a seguir demonstra como usar a caixa JavaScript para personalizar o rastreamento do Adobe Analytics. Se o JavaScript precisar usar plug-ins do Adobe Analytics, integrá-los no AEM.

O exemplo a seguir concatena os dados capturados em uma página em ordem hierárquica, usando um separador comum de "|".

Uma estrutura Adobe Analytics tem as seguintes configurações:

Por exemplo, os seguintes valores são gerados no Adobe Analytics:

Adição de código personalizado global para todas as estruturas do Adobe Analytics adding-global-custom-code-for-all-adobe-analytics-frameworks

Forneça o código JavaScript personalizado integrado a todas as estruturas do Adobe Analytics. Quando a estrutura Adobe Analytics de uma página não contém informações personalizadas, JavaScript de forma livre, o JavaScript gerado pelo script /libs/cq/analytics/components/sitecatalyst/config.js.jsp é anexado ao analytics.sitecatalyst.js arquivo. Por padrão, o script não tem efeito porque está comentado. O código também define s.usePlugins para false:

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

O código no arquivo analytics.sitecatalyst.js (que inclui o conteúdo do arquivo s_code.js do Adobe Analytics) contém o seguinte código:

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

Portanto, seu JavaScript deve definir s.usePlugins para true para que qualquer código na s_doPlugins é executada. Para personalizar o código, sobreponha o arquivo config.js.jsp por um que use seu próprio JavaScript. Se o JavaScript precisar usar plug-ins do Adobe Analytics, integrá-los no AEM.

Utilização de plug-ins do Adobe Analytics no AEM using-adobe-analytics-plugins-in-aem

Obtenha o código JavaScript para plug-ins do Adobe Analytics e integre-os à sua estrutura do Adobe Analytics no AEM. Adicionar o código a uma pasta da biblioteca do cliente da categoria sitecatalyst.plugins para que estejam disponíveis para seu código JavaScript personalizado.

Por exemplo, se você integrar a variável getQueryParams , você pode chamar o plug-in na s_doPlugins função do seu JavaScript personalizado. O código de exemplo a seguir envia a cadeia de caracteres de consulta em "pid" do URL do referenciador como EVAR 1, quando uma chamada de Adobe Analytics é acionada.

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;

O AEM instala os seguintes plug-ins do Adobe Analytics, para que estejam disponíveis por padrão:

A pasta da biblioteca do cliente /libs/cq/analytics/clientlibs/sitecatalyst/plugins inclui esses plug-ins na categoria sitecatalyst.plugins.

Use o procedimento a seguir para criar a pasta da biblioteca do cliente para seus plug-ins. Você só precisa executar esse procedimento uma vez. Para adicionar um plug-in à pasta da biblioteca do cliente, use o procedimento subsequente.

Use o procedimento a seguir para obter o código do plug-in, armazená-lo no repositório AEM e adicioná-lo à pasta da biblioteca do cliente.