Adobe Analytics と Adobe Experience Manager(AEM)は、どちらも Adobe Marketing Cloud のソリューションです。
Adobe Analytics を AEM Communities と連携させ、サポートされるコミュニティ機能をメンバーが操作した際にイベントが Adobe Analytics に送信され、レポートが生成されるように設定することができます。
例えば、イネーブルメントコミュニティサイトのメンバーが自分に割り当てられているビデオリソースを再生すると、リソースプレイヤーによって、イベント(ビデオハートビートのデータを含む)が自動的に Analytics に送信されます。コミュニティサイトでは、管理者はビデオの再生に関する様々なレポートを閲覧できます。
さらに、Analytics は以下の処理のために必要です。
公開環境で次の操作を行います。
作成者環境で、次の操作を行います。
サポートされるコミュニティ機能は以下のとおりです。
ドキュメントのこのセクションでは、Analytics のレポートスイートとコミュニティ機能を接続する方法について説明します。基本的な手順は以下のとおりです。
すべての AEM インスタンス上で暗号化や復号化が正しく実行されるよう、暗号鍵をレプリケートする
Adobe Analytics のレポートスイートを準備する
コミュニティサイトでの Analyticsの有効化
Analytics と AEM 変数との間のマッピングを検証する
プライマリパブリッシャーを特定
コミュニティサイト の公開
Adobe Analyticsからコミュニティサイトへのレポートデータのインポートを構成
Analytics をコミュニティ機能と連携するよう設定するには、アカウント担当者と協力して Adobe Analytics アカウントとレポートスイートをセットアップする必要があります。設定が完了したら、次の情報を使用できます。
会社名
Adobe Analyticsアカウントに関連付けられている会社です。
User Name
Analyticsアカウントの管理を承認されたユーザーのログインユーザー名
(Webサービスアクセス権限を含む)
パスワード
認証済みユーザーのログインパスワード。
Analyticsデータセンター
アカウントのAnalyticsデータセンターのURL。
レポートスイート
使用する Analytics レポートスイートの名前。
Adobe Marketing CloudのReport Suite Managerを使用して、コミュニティサイトでCommunities機能のレポートを提供できるようにAnalyticsレポートスイートを設定できます。
会社名とユーザー名を使用してAdobe Experience Cloudにサインインすると、次の情報を含む新しいレポートスイートまたは既存のレポートスイートを設定できます。
11コンバージョン変数 (eVar)
evar1
有 evar11
効にして
既存のeVarを再利用(名前変更)したり、Communitiesの機能で使用する新しいeVarを作成したりできます。
7 個の成功イベント(event)
event1
有 event7
効にして
type Counter
Counter (no subrelations)
既存のイベントを再利用(名前変更)したり、Communities機能で使用する新しいユーザーを作成できます。
ビデオレポートコンソール
Video Core
ビデオコア測定コンソール
Use Solution Variables
新しいレポートスイートを使用する場合、新しいレポートスイートには、4 個の evar と 6 個の event 変数しかないことに注意してください。コミュニティサイトでは 11 個の ever と 7 個の event 変数が必要です。
既存のレポートスイートを使用する場合は、コミュニティサイト用の Analytics フレームワークをアクティベートする前に、変数マッピングを変更する必要があります。
Communities専用の変数に関する懸念は、アカウント担当者にお問い合わせください。
以下の範囲内の変数を使用している既存のレポートスイートを使用する場合は、
evar1
から evar11
まで
event1
から event7
まで
次に、コミュニティサイトが公開される前 に、Analyticsがコミュニティサイトに対して有効になっている場合に、Analytics変数に自動的にマッピングされたAEM変数を移動して、既存のマッピングを復元することが重要です。
既存のマッピングを復元し、AEM変数を他のAnalytics変数に移動するには、Analytics変数マッピングの変更の節を参照してください。
この作業をしておかないと、修復不可能なデータ損傷が発生することがあります。
ビデオハートビート分析がライセンスされると、Marketing Cloud Org Id
が割り当てられます。
ビデオレポート用のAnalyticsレポートスイートの設定後にビデオハートビートレポートを有効にするには:
Marketing Cloud Org Id
をコミュニティサイトに関連付けるMarketing Cloud Org Id
は、コミュニティサイトの作成時以降に、コミュニティサイトのプロパティを変更することで入力できます。
ビデオハートビート分析が有効な場合、ビデオプレーヤーのJavaScript(JS)コードは、ビデオハートビートライブラリコード(同じJS)をインスタンス化します。このコードは、10秒ごと(設定不可)にビデオステータス更新を送信するロジックを処理します。
有効にしない場合、Video Heartbeat コードはインスタンス化されず、ビデオの再生状況と再開位置の追跡のみが報告のために SRP に維持されます。
作成者インスタンスの標準UIを使用して、Adobe AnalyticsをAEMコミュニティサイトと統合する、新しいAnalytics統合を作成するには:
[+]
アイコンを選択して、新しい構成を作成します設定を作成ダイアログでは、設定を識別するための値を入力します。
タイトル
(必須)設定の表示タイトル。
例えば、有効化コミュニティ分析と入力します。
名前
(オプション)指定しなかった場合、名前はデフォルトでタイトルから派生した有効なノード名になります。
例えば、「communities」と入力します。**
テンプレート
Adobe Analytics Configuration
「作成」を選択します。
Analytics Settings
ダイアログを開きます新しい Analytics 設定を初めて作成したときには、その設定と、Analytics 設定を入力するための新しいダイアログが表示されます。このダイアログには、アカウント担当者から取得した前提条件のアカウント情報が必要です。
会社情報
Adobe Analyticsアカウントに関連付けられている会社です。
ユーザー名
Analyticsアカウントの管理を承認されたユーザーのログインユーザー名。
パスワード
認証済みユーザーのログインパスワード。
データセンター
レポートスイートをホストするAnalyticsデータセンターを選択します。
ページに追跡タグを追加しない
デフォルトのまま(選択解除)
AppMeasurement を使用
デフォルトのまま(選択解除)
ページインプレッション数を夜間に読み込まない (作成者)
デフォルトのまま(選択解除)
ページインプレッション数を夜間に読み込まない (発行)
デフォルトのまま(選択解除)
設定を保存するには:
「Analyticsに接続」を選択します。
成功しなかった場合、
「OK」を選択します。
Adobe Analytics への基本的な接続を正しく設定したら、コミュニティサイトのフレームワークを作成または編集する必要があります。フレームワークの目的は、Communities機能(AEM)変数をAnalytics(レポートスイート)変数にマッピングすることです。
「Available Frameworks 」の横の[+]
アイコンを選択して、新しいフレームワークを作成します。
タイトル
(必須)フレームワークの表示タイトル
例えば、有効化コミュニティフレームワークと入力します。
名前
(オプション)指定しなかった場合、名前はデフォルトでタイトルから派生した有効なノード名になります。
例えば、communitiesと入力します。
テンプレート
Adobe Analytics Framework
.
「作成」を選択します。
Analytics フレームワークを作成すると、フレームワークを設定するための画面が開きます。
フレームワークの目的は、AEM変数をAnalytics変数(eVarおよびイベント)にマッピングすることです。 マッピングに使用できるAnalytics変数はレポートスイートで定義されます。
ビデオレポート用にセットアップされているレポートスイートを選択します。
レポートスイートがまだ作成されていない、または適切に設定されていない場合は、前のセクションを参照してください。
ビデオレポート用Adobe Analyticsレポートスイート
サイドキックは必要ないので、レポートスイート設定にアクセスするときの邪魔にならないよう最小化しておくことができます。
「追加アイテム+」を選択します。
2つのドロップダウンボックスが表示されます。
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 クラウドサービスとフレームワークの準備が完了しました。マッピングは、このAnalyticsサービスを有効にしてコミュニティサイトを作成すると定義されます。
新しいコミュニティサイトの作成中に Analytics クラウドサービスを追加するには:
手順3の「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 は複数のコミュニティ機能で自動的に使用されます。
作成者環境のOSGi設定AEM Communities Analytics Component Configuration
は、Analyticsに実装されたコンポーネントの一覧を提供します。 変数の自動マッピングは、リストに表示されているコンポーネントによって決まります。
Analytics 用の新しいカスタムコンポーネントを作成した場合は、この設定済みコンポーネントのリストに追加する必要があります。
ジャーナルコンポーネントは、ブログ機能の実装に使用されます。
Analyticsを有効にしてコミュニティサイトを保存し、クラウド設定フレームワークを選択すると、AEM変数は、evar1とイベント1で始まり、それぞれ1ずつ増分されるAnalytics eVarとイベントに自動的にマッピングされます。
evar1 ~ evar11 および event1 ~ event7 の範囲内のいずれかの変数がマップされた既存のレポートスイートを使用する場合は、AEM 変数を再マップして、元のマッピングを復元する必要があります。
使用の手引きのチュートリアルに従った場合のデフォルトのマッピング例を以下に示します。
イネーブルメント リソース のタイプ |
サイトのタイトル |
機能 のタイプ |
グループ のタイトル |
グループのパス |
UGC のタイプ |
UGC のタイトル |
ユーザー (メンバー) |
UGC のパス |
サイトのパス |
|
eVar1 | eVar2 | eVar3 | eVar4 | eVar5 | eVar6 | eVar7 | eVar8 | eVar9 | eVar10 | |
event1 リソース再生 |
(a) | - | - | - | - | - | - | - | (i) | - |
event2 SCFView |
イ | (b) | (c) | (d) | (E) | (f) | (g) | (h) | 一 | (j) |
event3 SCFCreate(投稿) |
- | (b) | (c) | (d) | (E) | (f) | (g) | (h) | 一 | (j) |
event4 SCFFollow |
- | (b) | (c) | (d) | (E) | (f) | (g) | (h) | 一 | (j) |
event5 SCFVoteUp |
- | (b) | (c) | (d) | (E) | (f) | (g) | (h) | 一 | (j) |
event6 SCFVoteDown |
- | (b) | (c) | (d) | (E) | (f) | (g) | (h) | 一 | (j) |
event7 SCFRate |
- | (b) | (c) | (d) | (E) | (f) | (g) | (h) | 一 | (j) |
eVar の値の例:
MIME type:video/mp4
コミュニティサイトのタイトル:Geometrixxコミュニティ
コミュニティ関数名:フォーラム
コミュニティグループ名:ハイキング
コミュニティグループコンテンツへのパス: /content/sites/<site name>/en/groups/hiking
UGCコンポーネントresourceType: social/forum/components/hbs/topic
UGCコンポーネントタイトル:トピックのハイク
login (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 eVarとAEM変数のマッピングは、コミュニティサイトでAnalyticsを有効にした後、フレームワーク設定から確認できます。
Analytics を有効にした後、コミュニティサイトを公開する前に、フレームワーク内で必要な Analytics の evar または event を左のレールからマッピングテーブルの適切な行にドラッグ&ドロップすることで、マッピングを変更できます。
マッピングの重複を避けるために、置き換えられた Analytics の evar または event は列から削除するようにしてください(削除するには、カーソルを合わせたときに Analytics 変数要素の右に表示される「X」を選択します)。
CommunitiesのeVarおよびイベントがレポートスイートに以前存在したマッピングを上書きする場合、データの損失を防ぐために、Communities機能のAEM変数を他のAnalytics eVarまたはイベントに割り当て、元のマッピングを復元します。
Analytics を有効にしたコミュニティサイトを公開する前に再マップすることが重要です。そうしないと、データが損失するおそれがあります。
コミュニティサイトの公開前に、変数マッピングを確認することを推奨します。サイトの公開時には、Analytics クラウドサービスとフレームワークも公開されます。
以下の節を参照してください。
以下の範囲内の変数を使用している既存のレポートスイートを使用する場合は、
evar1
から evar11
まで
event1
から event7
まで
次に、コミュニティサイトが公開される前 に、既存のマッピングを復元し、自動的にマップされたCommunities AEM変数(コミュニティサイトでAnalyticsが有効な場合)を他のAnalytics変数に移動することが重要です。この再マッピングは、すべてのCommunitiesコンポーネントで一貫している必要があります。
この作業をしておかないと、修復不可能なデータ損傷が発生することがあります。
選択したデプロイメントがパブリッシュファームの場合は、レポートデータのポーリングをおこなう Adobe Analytics が SRP に書き込めるよう、1 つの AEM パブリッシュインスタンスをプライマリパブリッシャーに指定する必要があります。
デフォルトでは、AEM Communities Publisher Configuration
OSGi設定は、パブリッシュインスタンスをプライマリパブリッシャーとして識別します。これにより、パブリッシュファーム内のすべてのパブリッシュインスタンスがプライマリとして自己識別されます。
したがって、すべてのセカンダリ発行インスタンスの設定を編集して、「プライマリパブリッシャー」チェックボックスの選択を解除する必要があります。
具体的な手順については、コミュニティの展開の主な発行者の節を参照してください。
複数の発行インスタンスからのポーリングを防ぐようにプライマリ発行者を設定することが重要です。
Adobe Analytics の資格情報は暗号化されます。作成者と発行者間で暗号化された解析資格情報のレプリケーションまたは送信を容易にするには、すべてのAEMインスタンスで同じプライマリ暗号化キーを共有する必要があります。
これを行うには、暗号キーを複製の手順に従ってください。
Analytics クラウドサービスをコミュニティサイトに対して有効にし、また必要に応じて Analytics 変数と AEM 変数とのマッピングを調整したら、コミュニティサイトの(再)公開をおこない、設定をパブリッシュ環境にレプリケートする必要があります。
作成者およびプライマリパブリッシャーのOSGi設定AEM Communities Analytics Report Management
は、Analyticsのクエリに使用されます。
オーサー環境では、リアルタイムレポートを入手するにはクエリを使用します。
プライマリパブリッシャーでは、レポートインポーターの分析データ読み込みに備えた情報提供のためにクエリを使用します。
クエリの間隔は、デフォルトで 10 秒間です。
Analyticsが有効なコミュニティサイトが公開されると、プライマリパブリッシャーのOSGi設定AEM Communities Analytics Report Importer
が、CRXDEで個別に設定されていない設定に対して、デフォルトのポーリング間隔を設定できます。
ポーリング間隔は、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
プロパティを変更すると、レポートインポーターの間隔が上書きされます。Adobe Analytics は、ユーザーデータのアクセス、書き出し、削除をおこなう API を提供しています。詳しくは、アクセス要求および削除要求の送信を参照してください。