コミュニティ機能のための Analytics の設定 analytics-configuration-for-communities-features

概要 overview

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

Adobe AnalyticsをAEM Communities用に設定すると、メンバーがサポートされている Communities の機能を操作する際に、イベントがAdobe Analyticsに送信され、そこからレポートが生成されるようになります。

例えば、コミュニティサイトから、管理者はビデオの再生に関する様々なレポートを表示できます。

さらに、以下を行うには分析が必要です。

次の Communities 機能がサポートされています。

この節では、Analytics レポートスイートを Communities 機能と接続する方法について説明します。 基本的な手順は次のとおりです。

前提条件 prerequisites

Analytics for Communities 機能を設定するには、アカウント担当者と協力してAdobe Analytics アカウントおよび レポートスイートを設定する必要があります。 設定が完了すると、次の情報が利用できるようになります。

ビデオレポート用のAdobe Analytics レポートスイート adobe-analytics-report-suite-for-video-reporting

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

会社名とユーザー名を使用して Adobe Experience Cloud にログインすることにより、新規または既存のレポートスイートに以下を設定することができます。

新しいレポートスイート を使用する場合、新しいレポートスイートには 4 つの eVar と 6 つのイベント変数のみ含まれ、コミュニティには 11 つの eVar と 7 つのイベント変数が必要です。

既存のレポートスイート を使用する場合、コミュニティサイトの Analytics フレームワークをアクティブ化する前に、 変数のマッピングを変更する必要が生じる場合があります。

Communities 専用の変数に関するご懸念は、アカウント担当者にお問い合わせください。

Video Heartbeat Analytics video-heartbeat-analytics

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

ビデオレポート用の Analytics レポートスイートの設定後にビデオハートビートレポートを有効にするには：

Marketing Cloud Org Id は、 コミュニティサイトの作成時または後でコミュニティサイトのプロパティを 変更して入力できます。

Video Heartbeat Analytics が有効な場合、ビデオプレーヤーのJavaScript（JS）コードがビデオハートビートライブラリコード（これも JS に含まれる）をインスタンス化します。 このコードは、10 秒ごとに Analytics ビデオトラッキングサーバーにビデオステータスの更新を送信するすべてのロジックを処理します（設定はできません）。 最終的には、ビデオセッションの累積レポートがメインの Analytics サーバーに送信されます。

有効にしない場合、ビデオハートビートコードはインスタンス化されず、ビデオの進行状況と再開位置のトラッキングのみがレポート用に SRP に保持されます。

AEM Analytics Cloud サービスの設定 aem-analytics-cloud-service-configuration

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

設定を作成ダイアログ create-configuration-dialog

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

Analytics 設定ダイアログ analytics-settings-dialog

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

設定を保存するには：

フレームワークを作成 create-framework

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

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

AEM Analytics フレームワークの設定 aem-analytics-framework-configuration

フレームワークの目的は、AEM変数を Analytics 変数（eVar とイベント）にマッピングすることです。 マッピングに使用できる Analytics 変数は レポートスイートで定義されます。

レポートスイートの選択 select-report-suite

ビデオレポート用に設定されたレポートスイートを選択します。

レポートスイートがまだ作成されていない場合や、適切に設定されていない場合は、前の節を参照してください。
ビデオレポート用Adobe Analytics レポートスイート

Sidekickは不要で、レポートスイート設定へのアクセスの妨げにならないように最小化できます。

「項目を追加」を選択する前後のレポートスイートダイアログ report-suites-dialog-before-and-after-selecting-add-item

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

コミュニティサイトに対して Analytics を有効にする enable-analytics-for-a-community-site

新しいコミュニティサイトを有効にする enable-for-new-community-site

コミュニティサイトの作成中にAnalytics Cloud サービスを追加するには：

既存のコミュニティサイトに対して有効にする enable-for-existing-community-site

既存のコミュニティサイトにAnalytics Cloud サービスを追加するには：

カスタマイズされたサイトで有効にする enable-for-customized-sites

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-for-communities-features

Analytics は、複数の Communities 機能で自動的に使用されます。

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

Analytics 用に実装された新しいカスタムコンポーネントが作成された場合は、設定済みコンポーネントのこのリストに追加してください。

コンポーネント設定 component-configuration

Analytics からAEMへのマッピング変数 mapped-analytics-to-aem-variables

Analytics を有効にし、クラウド設定フレームワークを選択して、コミュニティサイトを保存すると、AEM変数が Analytics の eVar とイベントに自動的にマッピングされます。 evar1 と event1 で始まり、それぞれ 1 ずつ増分されます。

evar1 から evar11 まで、および event1 から event7 までの変数をマッピングした既存のレポートスイートを使用している場合、AEM変数を再マッピングし、元のマッピングを復元する必要が生じます。

デフォルトのマッピングの例を次に示します。

各イベントで送信された eVar のマップ map-of-evars-sent-with-each-event

eVar値の例：

Analytics 変数マッピングの変更 modifying-analytics-variable-mapping

コミュニティサイトに対して Analytics を有効にすると、Analytics eVar とイベントのAEM変数へのマッピングがフレームワーク設定に表示されます。

Analytics を有効にした後、コミュニティサイトを公開する前に、フレームワークでマッピングを変更できます。 目的の Analytics eVar またはイベントを左パネルからドラッグし、マッピングテーブルの関連する行にドロップするだけです。

マッピングの重複を避けるには、置き換えた Analytics evar またはイベントにカーソルを合わせ、Analytics 変数要素の右側に表示される「X」を選択して、その行から削除してください。

Communities の eVar とイベントで、レポートスイートに以前に存在したマッピングが上書きされる場合、データの損失を避けるために、Communities の機能のAEM変数を他の Analytics eVar またはイベントに割り当て、元のマッピングを復元します。

例 1:Analytics evar14 のマッピングテーブルへのドラッグ example-step-dragging-analytics-evar-into-mapping-table

例ステップ 2:「x」を選択して、置き換えられた evar11 を削除 example-step-selecting-x-to-remove-replaced-evar

例 3:AEM var eventdata.siteId が Analytics evar14 に再マッピングされる example-step-aem-var-eventdata-siteid-remapped-to-analytics-evar

コミュニティサイトの公開 publishing-the-community-site

Analytics からAEMへの変数マッピングの検証 verify-analytics-to-aem-variable-mapping

コミュニティサイトでは、Analytics Cloud サービスおよびフレームワークも公開します。その前に、変数マッピングを確認することをお勧めします。

セクションを参照：

プライマリ発行者 primary-publisher

選択したデプロイメントが パブリッシュファームであるとき、レポートデータを SRP に書き込むためにAdobe Analyticsをポーリングするには、1 つのAEM パブリッシュインスタンスをプライマリパブリッシャーとして識別する必要があります。

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

したがって、「プライマリパブリッシャー」チェックボックスを選択解除するには、すべてのセカンダリパブリッシュインスタンスの設定を編集する必要があります。

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

暗号鍵をレプリケート replicate-the-crypto-key

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

これを行うには、 暗号鍵をレプリケートの手順に従います。

Publish コミュニティサイトとAnalytics Cloud サービス publish-community-site-and-analytics-cloud-service

コミュニティサイトに対してAnalytics Cloud サービスを有効にし、必要に応じて Analytics とAEM変数のマッピングを調整した後、コミュニティサイトを （再）公開して設定をパブリッシュ環境にレプリケートします。

Analytics からのレポートの取得 obtaining-reports-from-analytics

レポート管理 report-management

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

オーサー環境では、クエリはリアルタイムレポート用です。

プライマリ・パブリッシャでは、Report Importer の分析データ・インポートに備えて、クエリーを使用して情報を提供します。

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

レポートインポーター report-importer

Analytics が有効なコミュニティサイトが公開されると、CRXDE で個別に設定されていない設定に対してデフォルトのポーリング間隔を設定するように、プライマリ発行者の OSGi 設定AEM Communities Analytics Report Importer が設定される場合があります。

ポーリングインターバルは、データを SRP に取り込んで保存するためにAdobe Analyticsに対するリクエストの頻度を制御します。

データが「ビッグデータ」に分類される場合、ポーリングの頻度が増えると、コミュニティサイトに大きな負荷がかかる可能性があります。

デフォルトのポーリング インポート間隔 は 12 時間に設定されています。

コンポーネントのレポートのカスタマイズ component-report-customization

現在、追跡する指標をカスタマイズするために、その指標に関するレポートを生成する期間を定義するノードがリポジトリーに作成されています。

現在、このカスタマイズの唯一の例は、フォーラムトピックです。

Analytics でのユーザーデータの管理 manage-user-data-in-analytics

Adobe Analyticsは、ユーザーデータへのアクセス、ユーザーデータの書き出し、ユーザーデータの削除を可能にする API を提供します。 詳しくは、 アクセスリクエストと削除リクエストの送信を参照してください。

リソース resources