コミュニティ機能のための Analytics の設定

概要

Adobe Analytics と Adobe Experience Manager(AEM)は、どちらも Adobe Marketing Cloud のソリューションです。

Adobe Analytics を AEM Communities と連携させ、サポートされるコミュニティ機能をメンバーが操作した際にイベントが Adobe Analytics に送信され、レポートが生成されるように設定することができます。

例えば、イネーブルメントコミュニティサイトのメンバーが自分に割り当てられているビデオリソースを再生すると、リソースプレイヤーによって、イベント(ビデオハートビートのデータを含む)が自動的に Analytics に送信されます。コミュニティサイトから、管理者はビデオの再生に関する様々なレポートを表示できます。

さらに、Analytics は以下の処理のために必要です。

  • パブリッシュ環境では、次の操作を実行します。

    • コミュニティトレンドのレポート
    • サイト訪問者が「最も多く閲覧された」、「最もアクティブ」、「最も「いいね!」が多い」で並べ替えられるようにする
    • UGCリストの表示回数
  • オーサー環境では、次の操作を実行します。

    • メンバー管理コンソールでの参加データの表示(閲覧、投稿、フォロー、「いいね!」)
    • イネーブルメントリソースレポートのトレンド概要、ビデオハートビート、ビデオデバイス

サポートされるコミュニティ機能は以下のとおりです。

ドキュメントのこのセクションでは、Analytics のレポートスイートとコミュニティ機能を接続する方法について説明します。基本的な手順は以下のとおりです。

  1. すべての AEM インスタンス上で暗号化や復号化が正しく実行されるよう、暗号鍵をレプリケートする
  2. Adobe Analytics のレポートスイートを準備する
  3. AEM Analytics クラウドサービスフレームワークを作成する
  4. コミュニティ サイトでのAnalyticsの有効化
  5. Analytics と AEM 変数との間のマッピングを検証する
  6. プライマリパブリッシャーを識別します。
  7. 🔗 コミュニティサイトの公開
  8. Adobe Analyticsからコミュニティサイトへのレポートデータのインポートを設定します

前提条件

Analytics をコミュニティ機能と連携するよう設定するには、アカウント担当者と協力して Adobe Analytics アカウントとレポートスイートをセットアップする必要があります。確立後は、次の情報を使用できるようになります。

  • name(会社名)

    Adobe Analyticsアカウントに関連付けられている会社

  • ユーザー名

    Analyticsアカウントを管理する権限を持つユーザーのログインユーザー名。

    (Webサービスのアクセス権限を含める必要があります)

  • パスワード

    認証済みユーザーのログインパスワード

  • Analyticsデータセンター

    アカウントのAnalyticsデータセンターのURL

  • レポートスイート

    使用するAnalyticsレポートスイートの名前

ビデオレポートのための Adobe Analytics レポートスイート

Adobe Marketing CloudのReport Suite Managerを使用して、コミュニティサイトでコミュニティ機能のレポートを提供できるようにAnalyticsレポートスイートを設定できます。

Adobe Marketing Cloud会社名とユーザー名でサインインすると、新しいレポートスイートや既存のレポートスイートに次の情報を設定できます。

  • 11 個のコンバージョン変数(evar)

    • evar1 有効な evar11 方法
    • 既存のeVarを再利用(名前変更)したり、コミュニティ機能で使用する新しいeVarを作成したりできます。
  • 7 個の成功イベント(event)

    • event1 有効な event7 方法

    • タイプ Counter

      • string not requiredCounter (no subrelations)
    • 既存のイベントを再利用(名前変更)したり、コミュニティ機能で使用する新しいイベントを作成できます。

  • ビデオ管理

    • ビデオレポートコンソール

      • Enable(有効) Video Core
      • 「保存」を選択します。
    • ビデオコア測定コンソール

      • Use Solution Variables
      • 「保存」を選択します。

新しいレポートスイート​を使用する場合、新しいレポートスイートには、4 個の evar と 6 個の event 変数しかないことに注意してください。コミュニティサイトでは 11 個の ever と 7 個の event 変数が必要です。

既存のレポートスイート​を使用する場合は、コミュニティサイト用の Analytics フレームワークをアクティベートする前に、変数マッピングを変更する必要があります。コミュニティ専用の変数に関するご不明な点は、アカウント担当者にお問い合わせください。

注意

以下の範囲内の変数を使用している既存のレポートスイートを使用する場合は、

  • evar1 から evar11 まで
  • event1 から event7 まで

その後、コミュニティサイトが公開される前に、 コミュニティサイトに対してAnalyticsが有効になっている場合に、自動的にマッピングされたAEM変数をAnalytics変数に移動して、既存のマッピングを復元することが重要です。

既存のマッピングを復元し、AEM変数を他のAnalytics変数に移動するには、Analytics変数のマッピングの変更の節を参照してください。

この作業をしておかないと、修復不可能なデータ損傷が発生することがあります。

Video Heartbeat Analytics

Video Heartbeat Analyticsのライセンスを取得すると、Marketing Cloud Org Idが割り当てられます。

ビデオレポート用にAnalyticsレポートスイートを設定した後にビデオハートビートレポートを有効にするには、次の手順を実行します。

Marketing Cloud Org Idは、コミュニティサイトの作成時以降に、コミュニティサイトのプロパティを変更することで入力できます。🔗

chlimage_1-264

Video Heartbeat Analytics が有効になっている場合、ビデオプレーヤー用の Javascript(JS)コードによって Video Heartbeat ライブラリコード(JS)がインスタンス化されます。このコードは、Analytics ビデオ追跡サーバーにビデオステータスの更新を 10 秒間隔(設定不可)で送信するすべてのロジックを処理し、最後にメイン Analytics サーバーにビデオセッションの累積レポートを送信するすべてのロジックを処理します。

有効にしない場合、Video Heartbeat コードはインスタンス化されず、ビデオの再生状況と再開位置の追跡のみが報告のために SRP に維持されます。

AEM Analytics クラウドサービス設定

オーサーインスタンスの標準UIを使用してAdobe AnalyticsとAEMコミュニティサイトを統合する、新しいAnalytics統合を作成するには:

  • グローバルナビゲーションから:ツール/デプロイメント/Cloud Services
  • Adobe Analytics​まで下にスクロールします。
  • 今すぐ設定」または「設定を表示」を選択します。

chlimage_1-265

設定を作成ダイアログ

  • 利用可能な設定」の横にある[+]アイコンを選択して、新しい設定を作成します。

設定を作成ダイアログでは、設定を識別するための値を入力します。

chlimage_1-266

  • タイトル

    (必須)設定の表示タイトル。

    例えば、Enablement Community Analytics​と入力します。

  • Name

    (オプション)指定しない場合、名前はデフォルトでタイトルから派生した有効なノード名になります。

    例えば、「communities」と入力します。**

  • テンプレート

    Adobe Analytics Configuration

  • 作成」を選択します。

    • 設定ページを起動し、Analytics Settingsダイアログを開きます

Analytics 設定ダイアログ

新しい Analytics 設定を初めて作成したときには、その設定と、Analytics 設定を入力するための新しいダイアログが表示されます。このダイアログには、アカウント担当者から取得した前提条件のアカウント情報が必要です。

chlimage_1-267

  • 会社

    Adobe Analyticsアカウントに関連付けられている会社

  • ユーザー名

    Analyticsアカウントを管理する権限を持つユーザーのログインユーザー名。

  • パスワード

    認証済みユーザーのログインパスワード

  • データセンター

    レポートスイートをホストするAnalyticsデータセンターを選択します。

  • ページに追跡タグを追加しない

    デフォルトのまま(オフ)

  • AppMeasurement を使用

    デフォルトのまま(オフ)

  • ページインプレッション数を夜間に読み込まない (作成者)

    デフォルトのまま(オフ)

  • ページインプレッション数を夜間に読み込まない (発行)

    デフォルトのまま(オン)

設定を保存するには:

  • Analyticsに接続」を選択します。

    • 成功しない場合は、

      • エントリの先頭にスペースが含まれていないことを確認します。
      • 別のデータセンターを試す
      • アカウント担当者にお問い合わせください
  • OK」を選択します。

chlimage_1-268

フレームワークの作成

Adobe Analytics への基本的な接続を正しく設定したら、コミュニティサイトのフレームワークを作成または編集する必要があります。このフレームワークの目的は、コミュニティ機能(AEM)変数をAnalytics(レポートスイート)変数にマッピングすることです。

  • 使用可能なフレームワーク」の横にある[+]アイコンを選択し、新しいフレームワークを作成します。

chlimage_1-269

  • タイトル

    (必須)フレームワークの表示タイトル

    例えば、Enablement Community Framework​と入力します。

  • 名前

    (オプション)指定しない場合、名前はデフォルトでタイトルから派生した有効なノード名になります。

    例えば、「communities」と入力します。**

  • テンプレート

    Adobe Analytics Framework

  • 作成」を選択します。

Analytics フレームワークを作成すると、フレームワークを設定するための画面が開きます。

AEM Analytics フレームワーク設定

このフレームワークは、AEM 変数を Analytics(evar および event)変数にマップするためのものです。マッピングに使用できるAnalytics変数は、レポートスイートで定義されます。

chlimage_1-270

レポートスイートの選択

ビデオレポート用にセットアップされているレポートスイートを選択します。

レポートスイートがまだ作成されていない、または適切に設定されていない場合は、前の節を参照してください。
Adobe Analytics Report Suite for Video Reporting

サイドキックは必要ないので、レポートスイート設定にアクセスするときの邪魔にならないよう最小化しておくことができます。

「項目を追加」選択前および選択後のレポートスイートダイアログ

chlimage_1-271

  1. 項目を追加 +」を選択します。2 つのドロップダウンボックスが表示されます。
  2. 会社アカウントに関連付けられているレポートスイートを選択できるようにするReport suiteを選択します
  3. 開いたダイアログで「はい」を選択します。Load default server settings? Do you want to load the default server settings and overwrite current values in the Server section?
  4. Run Modeを選択します。
    publish​を選択します。

chlimage_1-272

これで Analytic クラウドサービスとフレームワークの準備が完了しました。マッピングは、このAnalyticsサービスを有効にしてコミュニティサイトを作成した後に定義されます。

コミュニティサイトに対する Analytics の有効化

新しいコミュニティサイトに対する有効化

新しいコミュニティサイトの作成中に Analytics クラウドサービスを追加するには:

  • 手順3

  • 「分析」タブの下で、次の操作を行います。

    • Analytics​を有効にする」チェックボックスをオンにします。
    • ドロップダウンボックスからフレームワークを選択します
  • Analytics フレームワーク設定に戻り、変数マッピングを調整します(オプション)。

既存のコミュニティサイトに対する有効化

Analytics クラウドサービスを既存のコミュニティサイトに追加するには:

  • コミュニティ/サイト​コンソールに移動します。

  • コミュニティサイトのサイトを編集アイコンを選択します。

  • 設定を選択します。

  • Analyticsセクションで、以下の操作をおこないます。

    • Analytics​を有効にする」チェックボックスをオンにします。
    • ドロップダウンボックスからフレームワークを選択します
  • Analytics フレームワーク設定に戻り、変数マッピングを調整します(オプション)。

カスタマイズされたサイトに対する有効化

コミュニティサイトで Analytics の追跡とインポートが正常に機能するようにするには、scf-js-site-title クラスと href 属性のページ要素が存在する必要があります。コミュニティサイト用の変更されていないsitepage.hbsスクリプトなど、ページ上には1つの要素のみが存在する必要があります。 siteUrlの値が抽出され、サイトパス​としてAdobe Analyticsに送信されます。

# present in default sitepage.hbs
# only one scf-js-site-title class should be included
# this example sets it to be hidden as it serves no visual purpose
<div
    class="navbar-brand scf-js-site-title"
    href="{{siteUrl}}.html"
    style="visibility: hidden;"
>
</div>

sitepage.hbsスクリプトをオーバーレイする​カスタマイズされたコミュニティサイト​の場合は、要素が存在することを確認します。 siteUrl変数は、クライアントに提供される前にサーバーでレンダリングされる際に設定されます。

Communities コンポーネントが含まれているがサイト作成ウィザードで作成されていない​一般的な AEM サイト​の場合は、要素を追加する必要があります。hrefの値は、サイトへのパスにする必要があります。 例えば、サイトパスが/content/my/company/enの場合は、次を使用します。

<div
    class="navbar-brand scf-js-site-title"
    href="/content/my/company/en.html"
    style="visibility: hidden;"
>
</div>

コミュニティ機能のための Analytics

Analytics は複数のコミュニティ機能で自動的に使用されます。

オーサー環境のOSGi設定AEM Communities Analytics Component Configurationは、Analytics用に実装されたコンポーネントのリストを提供します。 変数の自動マッピングは、リストされたコンポーネントによって決定されます。

Analytics 用の新しいカスタムコンポーネントを作成した場合は、この設定済みコンポーネントのリストに追加する必要があります。

コンポーネントの設定

chlimage_1-273

注意:journalコンポーネントは、ブログ機能の実装に使用されます。

Analytics と AEM 変数とのマッピング

Analytics を有効にしてクラウド設定フレームワークを選択したコミュニティサイトを保存すると、AEM 変数が Analytics の evar および event に自動的にマップされます。マップ先はそれぞれ evar1 と event1 から始まり、変数名の数値部分は 1 ずつ増加していきます。

evar1 ~ evar11 および event1 ~ event7 の範囲内のいずれかの変数がマップされた既存のレポートスイートを使用する場合は、AEM 変数を再マップして、元のマッピングを復元する必要があります。

使用の手引きのチュートリアルに従った場合のデフォルトのマッピング例を以下に示します。

chlimage_1-274

各イベントと共に送信される eVars のマップ

イネーブルメントリソースのタイプ サイトのタイトル 機能のタイプ グループのタイトル グループのパス UGCのタイプ UGCのタイトル ユーザー(メンバー) UGCのパス サイトのパス
eVar1 eVar2 eVar3 eVar4 eVar5 eVar6 eVar7 eVar8 eVar9 eVar10
event1 リソース再生 (a) - - - - - - - (i) -
event2 SCFView (b) © (d) (E) (f) (g) (h) (j)
event3 SCFCreate(投稿) - (b) © (E) (f) (g) (h) (j)
event4 SCFFollow - (b) © (E) (f) (g) (h) (j)
event5 SCFVoteUp - (b) © (E) (f) (g) (h) (j)
event6 SCFVoteDown - (b) © (E) (f) (g) (h) (j)
event7 SCFRate - (b) © (E) (f) (g) (h) (j)

eVar の値の例:

  • MIMEタイプ:video/mp4
  • コミュニティサイトのタイトル:Geometrixxコミュニティ
  • コミュニティ機能名:フォーラム
  • コミュニティグループ名:ハイキング
  • コミュニティグループコンテンツへのパス:/content/sites/communities/en/groups/hiking
  • UGCコンポーネントのresourceType:social/forum/components/hbs/topic
  • UGCコンポーネントのタイトル:ハイキングトピック
  • ログイン(許可可能ID):aaron.mcdonald@mailinator.com
  • UGCへのSRPパス:/content/usergenerated/asi/…/forum/jmtz-topic3または​フォローするコンポーネントのパス:/content/sites/communities/en/jcr:content/content/primary/forum
  • コミュニティサイトコンテンツへのパス:/content/sites/community/en

Analytics 変数のマッピングの変更

Analytics の evar および event と AEM 変数とのマッピングは、Analytics をコミュニティサイトに対して有効にした後に、フレームワーク設定から表示できるようになります。

Analytics を有効にした後、コミュニティサイトを公開する前に、フレームワーク内で必要な Analytics の evar または event を左のレールからマッピングテーブルの適切な行にドラッグ&ドロップすることで、マッピングを変更できます。

マッピングの重複を避けるために、置き換えられた Analytics の evar または event は列から削除するようにしてください(削除するには、カーソルを合わせたときに Analytics 変数要素の右に表示される「X」を選択します)。

Communities の ever および event がレポートスイート内の既存のマッピングを上書きする場合は、データの損失を避けるために、コミュニティ機能の AEM 変数を他の Analytics の ever や event に割り当てて、元のマッピングを復元してください。

注意

Analytics を有効にしたコミュニティサイトを公開する前に再マップすることが重要です。そうしないと、データが損失するおそれがあります。

手順 1 の例:Analytics の evar14 をマッピングテーブルにドラッグ

chlimage_1-275

手順 2 の例:「x」を選択し、置き換える evar11 を削除

chlimage_1-276

手順 3 の例:AEM 変数 eventdata.siteId を Analytics の evar14 に再マップ

chlimage_1-277

コミュニティサイトの公開

Analytics と AEM 変数とのマッピングの検証

コミュニティサイトの公開前に、変数マッピングを確認することを推奨します。サイトの公開時には、Analytics クラウドサービスとフレームワークも公開されます。

以下の節を参照してください。

注意

以下の範囲内の変数を使用している既存のレポートスイートを使用する場合は、

  • evar1 から evar11 まで
  • event1 から event7 まで

その後、コミュニティサイトを公開する前に、 既存のマッピングを復元し、自動的にマッピングされたCommunities AEM変数を(コミュニティサイトに対してAnalyticsが有効になっている場合)他のAnalytics変数に移動することが重要です。この再マッピングは、すべてのコミュニティコンポーネントで一貫している必要があります。

この作業をしておかないと、修復不可能なデータ損傷が発生することがあります。

プライマリパブリッシャー

選択したデプロイメントがパブリッシュファームの場合は、レポートデータのポーリングをおこなう Adobe Analytics が SRP に書き込めるよう、1 つの AEM パブリッシュインスタンスをプライマリパブリッシャーに指定する必要があります。

デフォルトでは、 AEM Communities Publisher Configuration OSGi設定は、そのパブリッシュインスタンスをプライマリパブリッシャーとして識別し、パブリッシュファーム内のすべてのパブリッシュインスタンスがプライマリとして自己識別されるようにします。

したがって、すべてのセカンダリパブリッシュインスタンスの設定を編集して、「Primary Publisher」チェックボックスをオフにする必要があります。

具体的な手順については、Communitiesのデプロイのプライマリパブリッシャーの節を参照してください。

注意

複数のパブリッシュインスタンスからのポーリングを防ぐように、プライマリパブリッシャーを設定することが重要です。

暗号鍵のレプリケーション

Adobe Analytics の資格情報は暗号化されます。オーサーとパブリッシャー間で暗号化された分析資格情報のレプリケーションまたは送信を容易にするには、すべてのAEMインスタンスが同じプライマリ暗号化キーを共有する必要があります。

そのためには、暗号鍵のレプリケーションの手順に従います。

コミュニティサイトと Analytics クラウドサービスの公開

Analytics クラウドサービスをコミュニティサイトに対して有効にし、また必要に応じて Analytics 変数と AEM 変数とのマッピングを調整したら、コミュニティサイトの(再)公開をおこない、設定をパブリッシュ環境にレプリケートする必要があります。

Analytics からのレポートの取得

レポート管理

作成者とプライマリパブリッシャーのOSGi設定AEM Communities Analytics Report Managementは、Analyticsに対するクエリに使用されます。

オーサー環境では、リアルタイムレポートを入手するにはクエリを使用します。

プライマリパブリッシャーでは、レポートインポーターの分析データ読み込みに備えた情報提供のためにクエリを使用します。

クエリの間隔は、デフォルトで 10 秒間です。

レポートインポーター

Analyticsが有効なコミュニティサイトが公開されると、プライマリパブリッシャーのOSGi設定AEM Communities Analytics Report Importerを設定して、CRXDEで個別に設定されない設定のデフォルトのポーリング間隔を設定できます。

ポーリング間隔は、SRPに保存するデータのAdobe Analyticsへの要求の頻度を制御します。

データが「ビッグデータ」に類するものである場合は、ポーリングの頻度を上げるとコミュニティサイトに大きな負荷がかかる場合があります。

デフォルトのポーリングの​読み込みインターバル​は、12 時間に設定されています。

chlimage_1-278

コンポーネントレポートのカスタマイズ

現在、追跡する指標をカスタマイズするには、リポジトリ内にノードを作成し、その指標に関するレポートを生成する期間を定義します。

現在、このカスタマイズの例を確認できるのはフォーラムトピックのみです。

  • プライマリパブリッシャー

  • 管理者権限でログイン

  • CRXDE Liteに移動します。

  • 言語ルートのjcr:contentノードの下

    • 例:/content/sites/engage/en/jcr:content
  • Analyticsレポート用に設定されたコンポーネントに移動します。

    • 例:analytics/reportConfigs/social_forum_components_hbs_topic
  • 作成された期間に注意してください。

    • last30Days
    • last90Days
    • thisYear
  • totalノードに注意してください。

    • intervalプロパティを変更すると、レポートインポーターの間隔が上書きされます
    • 値は秒単位で、4時間(14400秒)に設定します。

chlimage_1-279

Analytics でのユーザーデータの管理

Adobe Analytics は、ユーザーデータのアクセス、書き出し、削除をおこなう API を提供しています。詳しくは、アクセス要求および削除要求の送信を参照してください。

リソース

このページ