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

概要 overview

Adobe AnalyticsとAdobe Experience Manager(AEM) は、共にAdobe Marketing Cloudのソリューションです。

Adobe AnalyticsをAEM Communities用に設定して、メンバーがサポートされている Communities 機能とやり取りする際に、レポートの生成元となるAdobe Analyticsにイベントを送信することができます。

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

さらに、以下に対して分析が必要です。

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

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

前提条件 prerequisites

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

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

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

にサインインする Adobe Marketing Cloud と 会社名とユーザ名を使用する場合、以下の項目を含む新しいレポートスイートまたは既存のレポートスイートを設定できます。

を使用している場合、 新しいレポートスイート ​新しいレポートスイートには 4 つの evar と 6 つのイベント変数しか設定できませんが、Communities では 11 個の evar と 7 個のイベント変数が必要です。

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

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

Video Heartbeat Analytics のライセンスが必要な場合、 Marketing Cloud Org Id が割り当てられます。

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

この Marketing Cloud Org Id は コミュニティサイトの作成 または後から 修正 コミュニティサイトのプロパティ。 🔗

Video Heartbeat Analytics が有効な場合、ビデオプレーヤーの JavaScript(JS) コードは、Video Heartbeat ライブラリコード（JS も含む）をインスタンス化し、10 秒ごとに（設定不可）Analytics ビデオトラッキングサーバーにビデオステータスの更新を送信するすべてのロジックを処理します。

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

AEM Analytics Cloud Service Configuration 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レポートスイート

サイドキックは不要で、レポートスイート設定へのアクセスを妨げないように最小化されている場合があります。

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

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

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

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

Analytics クラウドサービスを追加するには、以下を実行します。 新しいコミュニティサイトの作成:

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

Analytics クラウドサービスを 既存のコミュニティサイト:

カスタマイズされたサイトの有効化 enable-for-customized-sites

Analytics のトラッキングと読み込みがコミュニティサイトに対して適切に機能するように、ページ要素 scf-js-site-title class 属性と href 属性が存在する必要があります。 そのような要素は、変更されていないページ内に存在するなど、1 つだけページ上に存在する必要があります sitepage.hbs コミュニティサイト用のスクリプト の値 siteUrl 抽出され、Adobe Analyticsに サイトパス.

# present in default sitepage.hbs

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/jp/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=ja).
# only one scf-js-site-title class should be included

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/jp/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=ja).
# this example sets it to be hidden as it serves no visual purpose

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/jp/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=ja).
<div
    class="navbar-brand scf-js-site-title"
    href="{{siteUrl}}.html"
    style="visibility: hidden;"
>
</div>

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

の 汎用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

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

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

Analytics を有効にし、クラウド設定フレームワークを選択した状態でコミュニティサイトを保存すると、AEM変数は、evar1 と event1 で始まる Analytics の eVar およびイベントに自動的にマッピングされ、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 の例：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 クラウドサービスとフレームワークも公開しています。

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

プライマリ発行者 primary-publisher

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

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

したがって、すべてのセカンダリパブリッシュインスタンスの設定を編集して、 プライマリ発行者 チェックボックス。

具体的な手順については、 コミュニティのデプロイ.

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

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

それには、 暗号鍵のレプリケート.

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

Analytics クラウドサービスをコミュニティサイトに対して有効にし、必要に応じて Analytics 変数とAEM変数のマッピングが調整されましたを使用する場合は、次の手順で設定をパブリッシュ環境にレプリケートする必要があります。 （再）コミュニティサイトを公開する.

Analytics からレポートを取得する obtaining-reports-from-analytics

レポート管理 report-management

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

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

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

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

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

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

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

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

デフォルトのポーリング インポート間隔 が 12 時間に設定されている場合、

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

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

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

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

Adobe Analyticsには、ユーザーデータへのアクセス、データの書き出し、削除をおこなえる API が用意されています。 詳しくは、 アクセス要求および削除要求の送信.

リソース resources