コンポーネントへのAdobe Analyticsトラッキングの追加

ページコンポーネントにAdobe Analyticsモジュールを含める

ページテンプレートコンポーネント(head.jsp, body.jsp) ContextHubとAdobe Analytics統合(Cloud Servicesの一部)を読み込むには、JSPインクルードが必要です。すべてに、JavaScriptファイルの読み込みが含まれます。

ContextHubエントリは<head>タグのすぐ下に含める必要がありますが、Cloud Servicesは<head>内および</body>セクションの前に含める必要があります。例：

<head>
   <sling:include path="contexthub" resourceType="granite/contexthub/components/contexthub" />
...
   <cq:include script="/libs/cq/cloudserviceconfigs/components/servicelibs/servicelibs.jsp?lang=ja"/>
...
</head>
<body>
...
    <cq:include path="cloudservices" resourceType="cq/cloudserviceconfigs/components/servicecomponents"/>
</body>

<head>要素の後に挿入するcontexthubスクリプトは、ページにContextHub機能を追加します。

<head>セクションと<body>セクションに追加するcloudservicesスクリプトは、ページに追加されるクラウドサービスの設定に適用されます。 (ページで複数のCloud Services設定を使用する場合は、ContextHub JSPとCloud ServicesJSPを1回だけ含める必要があります)。

Adobe Analyticsフレームワークがページに追加されると、cloudservicesスクリプトは、次の例のように、Adobe Analytics関連のjavascriptとクライアント側ライブラリへの参照を生成します。

<div class="sitecatalyst cloudservice">
<script type="text/javascript" src="/etc/clientlibs/foundation/sitecatalyst/sitecatalyst.js?lang=ja"></script>
<script type="text/javascript" src="/etc/clientlibs/foundation/sitecatalyst/util.js?lang=ja"></script>
<script type="text/javascript" src="/content/geometrixx-outdoors/_jcr_content/analytics.sitecatalyst.js?lang=ja"></script>
<script type="text/javascript" src="/etc/clientlibs/mac/mac-sc.js?lang=ja"></script>
<script type="text/javascript" src="/etc/clientlibs/foundation/sitecatalyst/plugins.js?lang=ja"></script>
<script type="text/javascript">
<!--
CQ_Analytics.Sitecatalyst.frameworkComponents = ['foundation/components/page'];
/**
 * Sets Adobe Analytics variables accordingly to mapped components. If <code>options</code>
 * object is provided only variables matching the options.componentPath are set.
 *
 * @param {Object} options Parameter object from CQ_Analytics.record() call. Optional.
 */
CQ_Analytics.Sitecatalyst.updateEvars = function(options) {
    this.frameworkMappings = [];
 this.frameworkMappings.push({scVar:"pageName",cqVar:"pagedata.title",resourceType:"foundation/components/page"});
    for (var i=0; i<this.frameworkMappings.length; i++){
  var m = this.frameworkMappings[i];
  if (!options || options.compatibility || (options.componentPath == m.resourceType)) {
   CQ_Analytics.Sitecatalyst.setEvar(m);
  }
    }
}

CQ_Analytics.CCM.addListener("storesinitialize", function(e) {
 var collect = true;
    var lte = s.linkTrackEvents;
    s.pageName="content:geometrixx-outdoors:en";
    CQ_Analytics.Sitecatalyst.collect(collect);
    if (collect) {
  CQ_Analytics.Sitecatalyst.updateEvars();
     /************* DO NOT ALTER ANYTHING BELOW THIS LINE ! **************/
     var s_code=s.t();if(s_code)document.write(s_code);
     s.linkTrackEvents = lte;
     if(s.linkTrackVars.indexOf('events')==-1){delete s.events};
     $CQ(document).trigger("sitecatalystAfterCollect");
    }
});
//-->
</script>
<script type="text/javascript">
<!--
if(navigator.appVersion.indexOf('MSIE')>=0)document.write(unescape('%3C')+'\!-'+'-')
//-->
</script>
<noscript><img src="https://daydocumentation.112.2o7.net/b/ss/daydocumentation/1/H.25--NS/1380120772954?cdp=3&gn=content%3Ageometrixx-outdoors%3Aen" height="1" width="1" border="0" alt=""/></noscript>
<span data-tracking="{event:'pageView', values:{}, componentPath:'foundation/components/page'}"></span>
<div id="cq-analytics-texthint" style="background:white; padding:0 10px; display:none;">
 <h3 class="cq-texthint-placeholder">Component clientcontext is missing or misplaced.</h3>
</div>
<script type="text/javascript">
$CQ(function(){
 if( CQ_Analytics &&
  CQ_Analytics.ClientContextMgr &&
  !CQ_Analytics.ClientContextMgr.isConfigLoaded )
  {
   $CQ("#cq-analytics-texthint").show();
  }
});
</script>
</div>

Geometrixx Outdoors をはじめ、すべての AEM サンプルサイトにはこのコードが含まれています。

sitecatalystAfterCollect イベント

cloudservicesスクリプトはsitecatalystAfterCollectイベントをトリガーします。

$CQ(document).trigger("sitecatalystAfterCollect");

このイベントは、ページの追跡が完了したことを示すために呼び出されます。このページに対して追加の追跡操作を実行する場合は、ドキュメント読み込みイベントやドキュメント準備完了イベントではなく、このイベントをリスンする必要があります。sitecatalystAfterCollectイベントを使用すると、衝突や予測できないその他の動作を回避できます。

メモ

/libs/cq/analytics/clientlibs/sitecatalyst/sitecatalyst.jsライブラリには、Adobe Analyticss_code.jsファイルのコードが含まれています。

カスタムコンポーネントのAdobe Analyticsトラッキングの導入

AEMコンポーネントがAdobe Analyticsフレームワークとやり取りできるようにします。次に、Adobe Analyticsがコンポーネントデータを追跡するようにフレームワークを設定します。

フレームワークを編集する際に、Adobe Analyticsフレームワークとやり取りするコンポーネントがサイドキックに表示されます。コンポーネントをフレームワークにドラッグすると、コンポーネントのプロパティが表示され、Adobe Analyticsのプロパティを使用してマッピングできます。（「基本追跡用のフレームワークの設定」を参照）。

コンポーネントにanalyticsという名前の子ノードがある場合、コンポーネントはAdobe Analyticsフレームワークとやり取りできます。 analytics ノードには以下のプロパティがあります。

cq:trackevents:コンポーネントが公開するCQイベントを識別します。（カスタムイベントを参照）。
cq:trackvars:Adobe AnalyticsプロパティでマッピングされるCQ変数の名前を指定します。
cq:componentName：サイドキックに表示されるコンポーネントの名前。
cq:componentGroup:コンポーネントを含むサイドキックのグループです。

コンポーネントの JSP のコードによって、追跡を呼び出し、追跡対象のデータを定義する Javascript がページに追加されます。JavaScriptで使用されるイベント名とデータ名は、analyticsノードプロパティの対応する値と一致する必要があります。

ページの読み込み時にイベントデータを追跡するには、data-tracking 属性を使用します（ページの読み込み時のカスタムイベントの追跡を参照）。
ユーザーがページの機能とやり取りするときにイベントデータを追跡するには、CQ_Analytics.record 関数を使用します（ページの読み込み後のカスタムイベントの追跡を参照）。

これらのデータ追跡方法を使用すると、Adobe Analytics統合モジュールは、イベントとデータを記録するためにAdobe Analyticsへの呼び出しを自動的に実行します。

例：topnav クリック数の追跡

Foundation TopNavコンポーネントを拡張し、Adobe Analyticsがページの上部にあるナビゲーションリンクのクリックを追跡できるようにします。ナビゲーションリンクがクリックされると、Adobe Analyticsはクリックされたリンクとクリックされたページを記録します。

以降の手順をおこなうには、以下のタスクを終えている必要があります。

CQ アプリケーションの作成。
Adobe Analytics構成とAdobe Analytics枠組みを作成。

topnav コンポーネントのコピー

topnav コンポーネントを CQ アプリケーションにコピーします。この手順では、アプリケーションが CRXDE Lite で設定されている必要があります。

/libs/foundation/components/topnavノードを右クリックし、「コピー」をクリックします。
アプリケーションフォルダーの下の Components フォルダーを右クリックして、「貼り付け」をクリックします。
「すべて保存」をクリックします。

TopnavとAdobe Analyticsフレームワークの統合

topnav コンポーネントを設定し、追跡するイベントとデータを定義するように JSP ファイルを編集します。

topnav ノードを右クリックして、作成／ノードを作成をクリックします。次のプロパティ値を指定して、「OK」をクリックします。
- 名前：analytics
- 型：nt:unstructured
次のプロパティを analytics ノードに追加して、追跡するイベントに名前を付けます。
- 名前：cq:trackevents
- タイプ：String
- 値：topnavClick
次のプロパティを analytics ノードに追加して、データ変数に名前を付けます。
- 名前：cq:trackvars
- タイプ：String
- 値：topnavTarget、topnavLocation
次のプロパティを analytics ノードに追加して、サイドキックのコンポーネントに名前を付けます。
- 名前：cq:componentName
- タイプ：String
- 値：topnav（追跡）
次のプロパティを analytics ノードに追加して、サイドキックのコンポーネントグループに名前を付けます。
- 名前：cq:componentGroup
- タイプ：String
- 値：一般
「すべて保存」をクリックします。
topnav.jspファイルを開きます。

要素内で、次の属性を追加します。

onclick = "tracknav('<%= child.getPath() %>.html')"

ページの下部に以下の Javascript コードを追加します。

<script type="text/javascript">
    function tracknav(target) {
            if (CQ_Analytics.Sitecatalyst) {
                CQ_Analytics.record({
                    event: 'topnavClick',
                    values: {
                        topnavTarget: target,
                        topnavLocation:'<%=currentPage.getPath() %>.html'
                    },
                    componentPath: '<%=resource.getResourceType()%>'
                });
            }
    }
</script>

「すべて保存」をクリックします。

topnav.jspファイルの内容は次のようになります。

<%@page session="false"%><%--
  Copyright 1997-2008 Day Management AG
  Barfuesserplatz 6, 4001 Basel, Switzerland
  All Rights Reserved.

  This software is the confidential and proprietary information of
  Day Management AG, ("Confidential Information"). You shall not
  disclose such Confidential Information and shall use it only in
  accordance with the terms of the license agreement you entered into
  with Day.

  ==============================================================================

  Top Navigation component

  Draws the top navigation

--%><%@include file="/libs/foundation/global.jsp?lang=ja"%><%
%><%@ page import="java.util.Iterator,
        com.day.text.Text,
        com.day.cq.wcm.api.PageFilter,
        com.day.cq.wcm.api.Page,
        com.day.cq.commons.Doctype,
        org.apache.commons.lang3.StringEscapeUtils" %><%

    // get starting point of navigation
    long absParent = currentStyle.get("absParent", 2L);
    String navstart = Text.getAbsoluteParent(currentPage.getPath(), (int) absParent);

    //if not deep enough take current node
    if (navstart.equals("")) navstart=currentPage.getPath();

    Resource rootRes = slingRequest.getResourceResolver().getResource(navstart);
    Page rootPage = rootRes == null ? null : rootRes.adaptTo(Page.class);
    String xs = Doctype.isXHTML(request) ? "/" : "";
    if (rootPage != null) {
        Iterator<Page> children = rootPage.listChildren(new PageFilter(request));
        while (children.hasNext()) {
            Page child = children.next();
            %><a onclick = "tracknav('<%= child.getPath() %>.html')"  href="<%= child.getPath() %>.html"><%
            %><img alt="<%= StringEscapeUtils.escapeXml(child.getTitle()) %>" src="<%= child.getPath() %>.navimage.png"<%= xs %>></a><%
        }
    }
%><script type="text/javascript">
    function tracknav(target) {
            if (CQ_Analytics.Sitecatalyst) {
                CQ_Analytics.record({
                    event: 'topnavClick',
                    values: {
                        topnavTarget:target,
                        topnavLocation:'<%=currentPage.getPath() %>.html'
                    },
                    componentPath: '<%=resource.getResourceType()%>'
                });
            }
    }
</script>

メモ

多くの場合、ContextHubからのデータを追跡することが望ましいです。 JavaScriptを使用してこの情報を取得する方法について詳しくは、ContextHub内の値へのアクセスを参照してください。

サイドキックへの追跡コンポーネントの追加

フレームワークに追加できるように、サイドキックへのAdobe Analyticsを使用した追跡を有効にする追加コンポーネント。

Adobe Analytics設定からAdobe Analyticsのフレームワークを開きます。（http://localhost:4502/etc/cloudservices/sitecatalyst.html）。
サイドキックでデザインボタンをクリックします。
「リンクトラッキング設定」領域で、「継承を設定」をクリックします。
許可されたコンポーネントリストで、「一般」セクションの「topnav（追跡）」を選択して、「OK」をクリックします。
サイドキックを展開して編集モードに入ります。コンポーネントが一般グループに表示されるようになっています。

topnav コンポーネントのフレームワークへの追加

topnavコンポーネントをAdobe Analyticsフレームワークにドラッグし、コンポーネント変数とイベントをAdobe Analytics変数とイベントにマップします。（「基本追跡用のフレームワークの設定」を参照）。

chlimage_1-1

topnavコンポーネントは、現在はAdobe Analyticsフレームワークと統合されています。コンポーネントをページに追加する際に、上部ナビゲーションバーの項目をクリックすると、トラッキングデータがAdobe Analyticsに送信されます。

s.productsデータをAdobe Analyticsに送信

コンポーネントは、Adobe Analyticsに送信されるs.products変数のデータを生成できます。 s.products変数に貢献するようにコンポーネントを設計します。

特定の構造の product という値を記録します。
product値のデータメンバーを公開して、Adobe Analyticsフレームワーク内のAdobe Analytics変数にマップできるようにします。

Adobe Analyticsのs.products変数は次の構文を使用します。

s.products="category;product;quantity;price;eventY={value}|eventZ={value};evarA={value}|evarB={value}"

Adobe Analytics統合モジュールは、AEMコンポーネントが生成するproduct値を使用してs.products変数を構築します。 AEMコンポーネントが生成するJavaScriptのproduct値は、次の構造を持つ値の配列です。

"product": [{
    "category": "",
    "sku"     : "path to product node",
    "quantity": quantity,
    "price"   : price,
    "events   : {
      "eventName1": "eventValue1",
      "eventName_n": "eventValue_n"
    }
    "evars"   : {
      "eVarName1": "eVarValue1",
      "eVarName_n": "eVarValue_n"
    }
}]

product 値からデータ項目を省略すると、s.products 内の空の文字列として送信されます。

メモ

製品の値にイベントが関連付けられていない場合、Adobe AnalyticsはデフォルトでprodViewイベントを使用します。

コンポーネントのanalyticsノードは、cq:trackvarsプロパティを使用して変数名を公開する必要があります。

product.category
product.sku
product.quantity
product.price
product.events.eventName1
product.events.eventName_n
product.evars.eVarName1
product.evars.eVarName_n

e コマースモジュールには、s.products 変数データを生成するいくつかのコンポーネントがあります。例えば、submitorder コンポーネント（http://localhost:4502/crx/de/index.jsp#/libs/commerce/components/submitorder/submitorder.jsp）は、以下の例のような Javascript を生成します。

<script type="text/javascript">
    function trackCartPurchase() {
        if (CQ_Analytics.Sitecatalyst) {
            CQ_Analytics.record({
                "event": ["productsCartPurchase"],
                "values": {
                    "product": [
                        {
                            "category": "",
                            "sku"     : "/path/to/prod/1",
                            "quantity": 3,
                            "price"   : 179.7,
                            "evars"   : {
                                "childSku": "/path/to/prod/1/green/xs",
                                "size"    : "XS"
                            }
                        },
                        {
                            "category": "",
                            "sku"     : "/path/to/prod/2",
                            "quantity": 10,
                            "price"   : 150,
                            "evars"   : {
                                "childSku": "/path/to/prod/2",
                                "size"    : ""
                            }
                        },
                        {
                            "category": "",
                            "sku"     : "/path/to/prod/3",
                            "quantity": 2,
                            "price"   : 102,
                            "evars"   : {
                                "childSku": "/path/to/prod/3/m",
                                "size"    : "M"
                            }
                        }
                    ]
                },
                "componentPath": "commerce/components/submitorder"
            });
            CQ_Analytics.record({
                "event": ["discountRedemption"],
                "values": {
                    "discount": "/path/to/discount/1 - /path/to/discount/2",
                    "product" : [{
                        "category": "",
                        "sku"     : "Promotional Discount",
                        "events"  : {"discountRedemption": 20.00}
                    }]
                },
                "componentPath": "commerce/components/submitorder"
            });
            CQ_Analytics.record({
                "event": ["cartPurchase"],
                "values": {
                    "orderId"       : "00e40e2d-13a2-4a00-a8ee-01a9ebb0bf68",
                    "shippingMethod": "overnight",
                    "paymentMethod" : "Amex",
                    "billingState"  : "NY",
                    "billingZip"    : "10458",
                    "product"       : [{"category": "", "sku": "", "quantity": "", "price": ""}]
                },
                "componentPath": "commerce/components/submitorder"
            });
        }
        return true;
    }
</script>

トラッキングコールのサイズの制限

一般的に、Web ブラウザーでは GET リクエストのサイズが制限されます。CQ の product と SKU の値はリポジトリのパスなので、複数の値を含む product 配列はリクエストサイズの制限を超えることがあります。したがって、各CQ_Analytics.record functionのproduct配列内の項目数はコンポーネントで制限する必要があります。追跡する必要がある項目数が制限を超える可能性がある場合は、複数の関数を作成します。

例えば、e コマースの submitorder コンポーネントでは、1 つのコール内の product 項目数が 4 に制限されています。カートに 5 つ以上の製品が含まれると、このコンポーネントは複数の CQ_Analytics.record 関数を生成します。