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

概要 overview

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

AEM Communities用にAdobe Analyticsを設定すると、サポートされているコミュニティ機能を利用するメンバーが、レポートの生成元となるイベントをAdobe Analyticsに送信できるようになります。

例えば、コミュニティサイトでは、管理者はビデオの再生に関するさまざまなレポートを確認できます。

さらに、分析は次のために必要です。

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

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

前提条件 prerequisites

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

ビデオレポート用Adobe Analytics Report Suite adobe-analytics-report-suite-for-video-reporting

Adobe Experience Cloudの​ レポートスイートマネージャーを使用して、Analytics レポートスイートを設定し、コミュニティサイトでコミュニティ機能のレポートを提供できるようにすることができます。

会社名とユーザー名を使用してAdobe Experience Cloudにログインすると、次の機能を持つように新規または既存のレポートスイートを設定できます。

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

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

コミュニティ専用の変数に関する懸念事項については、アカウント担当者にお問い合わせください。

ビデオハートビート分析 video-heartbeat-analytics

ビデオハートビート分析のライセンスが付与されると、Marketing Cloud Org Idが割り当てられます。

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

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

ビデオハートビート分析が有効になっている場合、ビデオプレーヤーの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への基本接続の設定が正常に完了したら、コミュニティサイト用のフレームワークを作成または編集する必要があります。 このフレームワークの目的は、コミュニティ機能（AEM）変数をAnalytics （レポートスイート）変数にマッピングすることです。

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

AEM Analytics Frameworkの設定 aem-analytics-framework-configuration

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

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

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

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

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

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

Analytics クラウドサービスとフレームワークが完了しました。 マッピングは、この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 クラスと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は、複数のコミュニティ機能に対して自動的に使用されます。

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

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

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

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のeVarとイベントのAEM変数へのマッピングは、Analyticsがコミュニティサイトに対して有効になった後、フレームワーク設定から表示されます。

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：置き換えられたevar11を削除するために「x」を選択する example-step-selecting-x-to-remove-replaced-evar

例ステップ 3: Analytics evar14にリマップされたAEM var eventdata.siteId 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設定は、パブリッシュファーム内のすべてのパブリッシュインスタンスがプライマリとして自己識別するように、パブリッシュインスタンスをプライマリパブリッシャーとして識別します。

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

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

暗号化キーのレプリケート replicate-the-crypto-key

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

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

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

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

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

レポート管理 report-management

オーサーおよびプライマリ発行者のOSGi設定、AEM Communities Analytics Report Managementは、Analyticsのクエリに使用されます。

作成者は、リアルタイムレポート用にクエリを作成します。

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

クエリ間隔はデフォルトで10秒になります。

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

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

ポーリング間隔は、SRPに引き出して保存するデータに対するAdobe Analyticsへのリクエストの頻度を制御します。

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

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

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

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

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

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

Adobe Analyticsには、ユーザーデータにアクセス、書き出し、削除できるAPIが用意されています。 詳細については、​ アクセス要求と削除要求の送信を参照してください。

リソース resources