コミュニティ機能のための Analytics の設定
- トピック:
- コミュニティ
作成対象:
- 管理者
概要
Adobe AnalyticsとAdobe Experience Manager(AEM)は、どちらもAdobe Experience Cloudのソリューションです。
Adobe AnalyticsをAEM Communities用に設定すると、メンバーがサポートされている Communities の機能を操作する際に、イベントがAdobe Analyticsに送信され、そこからレポートが生成されるようになります。
例えば、コミュニティサイトから、管理者はビデオの再生に関する様々なレポートを表示できます。
さらに、以下を行うには分析が必要です。
-
Publish環境で、次の操作を行います。
- コミュニティ トレンドのレポート
- サイト訪問者が「最も多く閲覧」、「最もアクティブ」、「最も高評価」で並べ替えられるようにする
- UGC (ユーザー生成コンテンツ)リストの表示数
-
オーサー環境で、次の操作を行います。
- メンバー管理コンソールのパーティシペーション データの表示(表示、投稿、フォロー、いいね)
- イネーブルメントリソースのトレンドサマリ、ビデオハートビートおよびビデオデバイス レポート
次の Communities 機能がサポートされています。
この節では、Analytics レポートスイートを Communities 機能と接続する方法について説明します。 基本的な手順は次のとおりです。
-
暗号キーをレプリケートすると、すべてのAEM インスタンスで暗号化/復号化が正しく行われることを確認できます
-
Adobe Analyticsの準備 レポートスイート
-
AEM Analytics Cloud Service および フレームワークを作成
-
コミュニティサイトの Analytics を有効にする
-
検証 Analytics からAEMへの変数マッピング
-
Publish コミュニティサイト
-
Adobe Analyticsからコミュニティサイトへの レポートデータのインポートの設定
前提条件
Analytics for Communities 機能を設定するには、アカウント担当者と協力してAdobe Analytics アカウントおよび レポートスイートを設定する必要があります。 設定が完了すると、次の情報が利用できるようになります。
-
会社名
Adobe Analytics アカウントに関連付けられている会社。
-
ユーザー名
Analytics アカウントの管理を許可されたユーザーのログインユーザー名
(Web サービスへのアクセス権限を含める必要があります)。 -
パスワード
許可されたユーザーのログインパスワード。
-
Analytics データセンター
アカウントの Analytics データセンターの URL。
-
レポートスイート
使用する Analytics レポートスイートの名前。
ビデオレポート用のAdobe Analytics レポートスイート
Adobe Experience Cloud Report Suite Manager を使用すると、Analytics レポートスイートを設定して、コミュニティサイトで Communities 機能のレポートを提供できるようになります。
会社名とユーザー名を使用して Adobe Experience Cloud にログインすることにより、新規または既存のレポートスイートに以下を設定することができます。
-
11 コンバージョン変数(eVars)
-
evar1
~evar11
が有効 -
既存の eVar の再利用(名前変更)や、Communities 機能に使用する eVar の作成が可能
-
-
7 成功イベント(イベント)
-
event1
~event7
が有効 -
type
Counter
Counter (no subrelations)
でない
-
既存のイベントを再利用(名前変更)したり、コミュニティ機能に使用するイベントを作成したりできます。
-
-
-
ビデオレポートコンソール
- Enable
Video Core
- 「保存」を選択します。
- Enable
-
ビデオコア測定コンソール
Use Solution Variables
を選択します。- 「保存」を選択します。
-
新しいレポートスイート を使用する場合、新しいレポートスイートには 4 つの eVar と 6 つのイベント変数のみ含まれ、コミュニティには 11 つの eVar と 7 つのイベント変数が必要です。
既存のレポートスイート を使用する場合、コミュニティサイトの Analytics フレームワークをアクティブ化する前に、 変数のマッピングを変更する必要が生じる場合があります。
Communities 専用の変数に関するご懸念は、アカウント担当者にお問い合わせください。
-
evar1
からevar11
まで -
event1
からevent7
まで
Video Heartbeat Analytics
Video Heartbeat Analytics のライセンスが取得されると、Marketing Cloud Org Id
が割り当てられます。
ビデオレポート用の Analytics レポートスイートの設定後にビデオハートビートレポートを有効にするには:
- Analytics Cloud サービスを作成
- コミュニティサイトの Analytics を有効にする
Marketing Cloud Org Id
をコミュニティサイトに関連付けます
Marketing Cloud Org Id
は、 コミュニティサイトの作成時または後でコミュニティサイトのプロパティを 変更して入力できます。
Video Heartbeat Analytics が有効な場合、ビデオプレーヤーのJavaScript(JS)コードがビデオハートビートライブラリコード(これも JS に含まれる)をインスタンス化します。 このコードは、10 秒ごとに Analytics ビデオトラッキングサーバーにビデオステータスの更新を送信するすべてのロジックを処理します(設定はできません)。 最終的には、ビデオセッションの累積レポートがメインの Analytics サーバーに送信されます。
有効にしない場合、ビデオハートビートコードはインスタンス化されず、ビデオの進行状況と再開位置のトラッキングのみがレポート用に SRP に保持されます。
AEM Analytics Cloud サービスの設定
オーサーインスタンスの標準 UI を使用して、Adobe AnalyticsをAEM コミュニティサイトと統合する Analytics 統合を作成するには、次のようにします。
- グローバルナビゲーションから:ツール/導入/Cloud Service
- Adobe Analytics まで下にスクロール
- 今すぐ設定 または 設定を表示 を選択します
設定を作成ダイアログ
- 利用可能
[+]
設定 の横にあるアイコンを選択して、設定を作成できます。
設定を作成ダイアログで、入力する値が設定を識別します。
-
タイトル
(必須)設定の表示タイトル。
例えば、「コミュニティ分析 と入力しま。 -
名前
(オプション)指定しない場合、名前はデフォルトでタイトルから派生した有効なノード名になります。
例えば、「communities と入力しま。 -
テンプレート
Adobe Analytics Configuration
を選択します。 -
「作成」を選択します。
- 設定ページを起動し、ダイアログ
Analytics Settings
開きます
- 設定ページを起動し、ダイアログ
Analytics 設定ダイアログ
新しい Analytics 設定を最初に作成すると、設定が表示され、Analytics 設定を入力するための新しいダイアログが表示されます。 このダイアログには、アカウント担当者から取得した 前提条件のアカウント情報が必要です。
-
会社
Adobe Analytics アカウントに関連付けられている会社。
-
ユーザー名
Analytics アカウントの管理を許可されたユーザーのログインユーザー名。
-
パスワード
許可されたユーザーのログインパスワード。
-
データセンター
レポートスイートをホストする Analytics データセンターを選択します。
-
ページにトラッキングタグを追加しない
デフォルトのままにします(選択解除)。
-
AppMeasurementを使用
デフォルトのままにします(選択解除)。
-
夜間にページインプレッションをインポートしない(オーサー)
デフォルトのままにします(選択解除)。
-
夜間にページインプレッションを読み込まない(公開)
デフォルトのままにします(選択解除)。
設定を保存するには:
-
「Analytics に接続」を選択します。
-
成功しなかった場合、
- エントリの先頭にスペースが含まれていないことを確認します。
- 別のデータセンターを試してください。
-
-
「OK」を選択します。
フレームワークを作成
Adobe Analyticsへの基本的な接続が正常に設定されたら、コミュニティサイトのフレームワークを作成または編集する必要があります。 フレームワークの目的は、Communities 機能(AEM)変数を Analytics (レポートスイート)変数にマッピングすることです。
-
使用可能
[+]
フレームワークの横 あるアイコンを選択して フレームワークを作成できるようにします。 -
タイトル
(必須) フレームワークの表示タイトル
例えば、「コミュニティフレームワーク と入力し す。 -
名前
(オプション)指定しない場合、名前はデフォルトでタイトルから派生した有効なノード名になります。
例えば、「communities と入力し す。 -
テンプレート
Adobe Analytics Framework
を選択します。 -
「作成」を選択します。
Analytics フレームワークを作成すると、設定用のフレームワークが開きます。
AEM Analytics フレームワークの設定
フレームワークの目的は、AEM変数を Analytics 変数(eVar とイベント)にマッピングすることです。 マッピングに使用できる Analytics 変数は レポートスイートで定義されます。
レポートスイートの選択
ビデオレポート用に設定されたレポートスイートを選択します。
レポートスイートがまだ作成されていない場合や、適切に設定されていない場合は、前の節を参照してください。
ビデオレポート用Adobe Analytics レポートスイート
Sidekickは不要で、レポートスイート設定へのアクセスの妨げにならないように最小化できます。
「項目を追加」を選択する前後のレポートスイートダイアログ
-
「項目を追加+」を選択します。
2 つのドロップダウンボックスが表示されます。
-
Choose a
Report suite.
会社アカウントに関連付けられているレポートスイートを選択できます。
-
開いたダイアログで はい を選択します。
Load default server settings? Do you want to load the default server settings and overwrite current values in the Server section?
-
Run Mode
を選択してください。 -
「公開」を選択します。
これで、Analytic Cloud サービスとフレームワークが完了しました。 マッピングは、この Analytics サービスを有効にしてコミュニティサイトを作成した後に定義されます。
コミュニティサイトに対して Analytics を有効にする
新しいコミュニティサイトを有効にする
コミュニティサイトの作成中にAnalytics Cloud サービスを追加するには:
-
手順 3 の 「ANALYTICS」タブで、次の操作を行います。
- 「Analytics を有効にする」チェックボックスを選択します。
- ドロップダウンボックスからフレームワークを選択します。
-
オプションで、Analytics フレームワーク設定に戻って変数のマッピングを調整します。
既存のコミュニティサイトに対して有効にする
既存のコミュニティサイトにAnalytics Cloud サービスを追加するには:
-
コミュニティ/サイト コンソールに移動します。
-
コミュニティサイトのサイトを編集アイコンを選択します。
-
設定を選択します。
-
「Analytics」セクションで、
- 「Analytics を有効にする」チェックボックスを選択します。
- ドロップダウンボックスからフレームワークを選択します。
-
オプションで、Analytics フレームワーク設定に戻って変数のマッピングを調整します。
カスタマイズされたサイトで有効にする
Analytics のトラッキングと読み込みがコミュニティサイトで正しく機能するには、scf-js-site-title
class 属性と 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 for Communities の機能
Analytics は、複数の Communities 機能で自動的に使用されます。
オーサー環境の OSGi 設定には、Analytics 用に実装されたコンポ AEM Communities Analytics Component Configuration
ネントのリストが表示されます。 変数の自動マッピングは、リストされるコンポーネントによって決まります。
Analytics 用に実装された新しいカスタムコンポーネントが作成された場合は、設定済みコンポーネントのこのリストに追加してください。
コンポーネント設定
Analytics からAEMへのマッピング変数
Analytics を有効にし、クラウド設定フレームワークを選択して、コミュニティサイトを保存すると、AEM変数が Analytics の eVar とイベントに自動的にマッピングされます。 evar1 と event1 で始まり、それぞれ 1 ずつ増分されます。
evar1 から evar11 まで、および event1 から event7 までの変数をマッピングした既存のレポートスイートを使用している場合、AEM変数を再マッピングし、元のマッピングを復元する必要が生じます。
デフォルトのマッピングの例を次に示します。
各イベントで送信された eVar のマップ
リソース
タイプ
タイトル
型
タイトル
パス
タイプ
タイトル
(メンバー)
パス
パス
リソース再生
SCFView
SCFCreate (Post)
SCFFollow
SCFVoteUp
SCFVoteDown
SCFRate
eVar値の例:
-
MIME タイプ:video/mp4
-
コミュニティサイトのタイトル:Geometrixxコミュニティ
-
コミュニティ機能名:フォーラム
-
コミュニティグループ名:ハイキング
-
コミュニティグループコンテンツへのパス:
/content/sites/<site name>/en/groups/hiking
-
UGC コンポーネント resourceType:
social/forum/components/hbs/topic
-
UGC コンポーネントタイトル:ハイキングトピック
-
ログイン (authorizableId):
aaron.mcdonald@mailinator.com
-
UGC への SRP パス:
/content/usergenerated/asi/.../forum/jmtz-topic3
または フォローするコンポーネントのパス:/content/sites/<site name>/en/jcr:content/content/primary/forum
-
コミュニティサイトコンテンツへのパス:
/content/sites/<site name>/en
Analytics 変数マッピングの変更
コミュニティサイトに対して Analytics を有効にすると、Analytics eVar とイベントのAEM変数へのマッピングがフレームワーク設定に表示されます。
Analytics を有効にした後、コミュニティサイトを公開する前に、フレームワークでマッピングを変更できます。 目的の Analytics eVar またはイベントを左パネルからドラッグし、マッピングテーブルの関連する行にドロップするだけです。
マッピングの重複を避けるには、置き換えた Analytics evar またはイベントにカーソルを合わせ、Analytics 変数要素の右側に表示される「X」を選択して、その行から削除してください。
Communities の eVar とイベントで、レポートスイートに以前に存在したマッピングが上書きされる場合、データの損失を避けるために、Communities の機能のAEM変数を他の Analytics eVar またはイベントに割り当て、元のマッピングを復元します。
例 1:Analytics evar14 のマッピングテーブルへのドラッグ
例ステップ 2:「x」を選択して、置き換えられた evar11 を削除
例 3:AEM var eventdata.siteId が Analytics evar14 に再マッピングされる
コミュニティサイトの公開
Analytics からAEMへの変数マッピングの検証
コミュニティサイトでは、Analytics Cloud サービスおよびフレームワークも公開します。その前に、変数マッピングを確認することをお勧めします。
セクションを参照:
-
evar1
からevar11
まで -
event1
からevent7
まで
プライマリ発行者
選択したデプロイメントが パブリッシュファームであるとき、レポートデータを SRP に書き込むためにAdobe Analyticsをポーリングするには、1 つのAEM パブリッシュインスタンスをプライマリパブリッシャーとして識別する必要があります。
デフォルトでは、AEM Communities Publisher Configuration
の OSGi 設定は、そのパブリッシュインスタンスをプライマリパブリッシャーとして識別します。これにより、パブリッシュファーム内のすべてのパブリッシュインスタンスがプライマリとして自己識別されます。
したがって、「プライマリパブリッシャー」チェックボックスを選択解除するには、すべてのセカンダリパブリッシュインスタンスの設定を編集する必要があります。
詳しい手順については、Communities のデプロイのプライマリパブリッシャーの節を参照してください。
暗号鍵をレプリケート
Adobe Analyticsの資格情報は暗号化されます。 暗号化された分析資格情報のオーサーとパブリッシャー間でのレプリケーションまたは転送を容易にするために、すべてのAEM インスタンスは同じプライマリ暗号化キーを共有する必要があります。
これを行うには、 暗号鍵をレプリケートの手順に従います。
Publish コミュニティサイトとAnalytics Cloud サービス
コミュニティサイトに対してAnalytics Cloud サービスを有効にし、必要に応じて Analytics とAEM変数のマッピングを調整した後、コミュニティサイトを (再)公開して設定をパブリッシュ環境にレプリケートします。
Analytics からのレポートの取得
レポート管理
Analytics のクエリには、オーサーとプライマリのパブリッシャーの OSGi 設定、AEM Communities Analytics Report Management
が使用されます。
オーサー環境では、クエリはリアルタイムレポート用です。
プライマリ・パブリッシャでは、Report Importer の分析データ・インポートに備えて、クエリーを使用して情報を提供します。
クエリ間隔のデフォルトは 10 秒です。
レポートインポーター
Analytics が有効なコミュニティサイトが公開されると、CRXDE で個別に設定されていない設定に対してデフォルトのポーリング間隔を設定するように、プライマリ発行者の OSGi 設定AEM Communities Analytics Report Importer
が設定される場合があります。
ポーリングインターバルは、データを SRP に取り込んで保存するためにAdobe Analyticsに対するリクエストの頻度を制御します。
データが「ビッグデータ」に分類される場合、ポーリングの頻度が増えると、コミュニティサイトに大きな負荷がかかる可能性があります。
デフォルトのポーリング インポート間隔 は 12 時間に設定されています。
コンポーネントのレポートのカスタマイズ
現在、追跡する指標をカスタマイズするために、その指標に関するレポートを生成する期間を定義するノードがリポジトリーに作成されています。
現在、このカスタマイズの唯一の例は、フォーラムトピックです。
-
プライマリパブリッシャーで、管理者権限でログインします。
-
CRXDE Lite に移動します。例えば、https://localhost:4503/crx/de です。
-
言語ルートの
jcr:content
ノード(例:/content/sites/engage/en/jcr:content
)の下で、Analytics レポート用に設定されたコンポーネントに移動します。
例えば、analytics/reportConfigs/social_forum_components_hbs_topic
のように指定します。 -
期間が作成されていることに注意してください。
last30Days
last90Days
thisYear
-
total
ノードに注目してください。interval
プロパティを変更すると、Report Importer の間隔が上書きされます。- 値は秒単位で、4 時間(14400 秒)に設定されます。
Analytics でのユーザーデータの管理
Adobe Analyticsは、ユーザーデータへのアクセス、ユーザーデータの書き出し、ユーザーデータの削除を可能にする API を提供します。 詳しくは、 アクセスリクエストと削除リクエストの送信を参照してください。
リソース
- Adobe Experience Cloud: Analytics ヘルプおよびリファレンス
- AEM:Adobe Analyticsとの統合
- AEM: Analytics と外部プロバイダー