コミュニティ機能のための Analytics の設定

概要

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

Adobe Analytics を AEM Communities と連携させ、サポートされるコミュニティ機能をメンバーが操作した際にイベントが Adobe Analytics に送信され、レポートが生成されるように設定することができます。

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

さらに、Analytics は以下の処理のために必要です。

• パブリッシュ環境では、次の操作を実行します。

  • コミュニティのレポート トレンド
  • サイト訪問者に対し、「最も多く閲覧された」、「最もアクティブ」、「最も「いいね！」が多い」での並べ替えを許可
  • UGC リストでの表示回数

• オーサー環境では、次の操作をおこないます。

  • でのパーティシペーションデータの表示 メンバー管理コンソール （閲覧、投稿、フォロー、「いいね！」）
  • トレンドの概要、ビデオハートビート、イネーブルメントリソース用のビデオデバイス レポート

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

• イネーブルメントリソース
• フォーラム
• Q&A
• ブログ
• ファイルライブラリ
• Calendar

ドキュメントのこのセクションでは、Analytics のレポートスイートとコミュニティ機能を接続する方法について説明します。基本的な手順は以下のとおりです。

1. すべての AEM インスタンス上で暗号化や復号化が正しく実行されるよう、暗号鍵をレプリケートする

2. Adobe Analytics のレポートスイートを準備する

3. AEM Analytics クラウドサービスとフレームワークを作成する

4. Analytics を有効にする コミュニティサイトの

5. Analytics と AEM 変数との間のマッピングを​検証​する

6. 特定 主発行者

7. 公開 コミュニティサイト

8. 設定 レポートデータのインポート Adobe Analyticsからコミュニティサイトへ

前提条件

Analytics をコミュニティ機能と連携するよう設定するには、アカウント担当者と協力して Adobe Analytics アカウントとレポートスイートをセットアップする必要があります。設定が完了したら、次の情報を利用できるようになります。

• name

  Adobe Analyticsアカウントに関連付けられている会社。

• User Name

  Analytics アカウントの管理権限を持つユーザーのログインユーザー名です（Web サービスへのアクセス権限を含める必要があります）。

• パスワード

  認証済みユーザーのログインパスワード。

• Analytics データセンター

  アカウントの Analytics データセンターの URL。

• レポートスイート

  使用する Analytics レポートスイートの名前。

ビデオレポートのための Adobe Analytics レポートスイート

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

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

• 11 個のコンバージョン変数 (eVar)

  • evar1 経由 evar11 有効

  • 既存の eVar を再利用（名前を変更）したり、新しい eVar を作成してコミュニティ機能に使用したりできます。

• 7 個の成功イベント（event）

  • event1 経由 event7 有効

  • type Counter

    • string not required​Counter (no subrelations)

  • 既存のイベントを転用（名前を変更）したり、新しいイベントを作成してコミュニティ機能に使用したりできます

• ビデオ管理

  • ビデオレポートコンソール

    • Enable（有効） Video Core
    • 保存を選択

  • ビデオコア測定コンソール

    • Use Solution Variables
    • 保存を選択

新しいレポートスイート​を使用する場合、新しいレポートスイートには、4 個の evar と 6 個の event 変数しかないことに注意してください。コミュニティサイトでは 11 個の ever と 7 個の event 変数が必要です。

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

コミュニティ専用の変数に関するご不明な点は、アカウント担当者にお問い合わせください。

Video Heartbeat Analytics

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

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

• の作成 Analytics クラウドサービス
• 有効にする コミュニティサイトの分析
• を関連付ける Marketing Cloud Org Id コミュニティサイトで

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

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

有効にしない場合、Video Heartbeat コードはインスタンス化されず、ビデオの再生状況と再開位置の追跡のみが報告のために SRP に維持されます。

AEM Analytics クラウドサービス設定

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

• グローバルナビゲーションから： ツール > 導入 > Cloud Services
• 下にスクロールして Adobe Analytics
• 選択 今すぐ設定 または 設定を表示

設定を作成ダイアログ

• 選択 [+] 隣のアイコン 利用可能な設定 新しい設定を作成するには

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

• タイトル

  （必須）設定の表示タイトル。
  例えば、 イネーブルメントコミュニティ分析

• 名前

  （オプション）指定しない場合、名前はデフォルトで、タイトルから派生した有効なノード名になります。
  例えば、「communities」と入力します。**

• テンプレート

  Adobe Analytics Configuration

• 「作成」を選択します。

  • 設定ページを起動して開きます Analytics Settings ダイアログ

Analytics 設定ダイアログ

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

• 会社

  Adobe Analyticsアカウントに関連付けられている会社。

• ユーザー名

  Analytics アカウントの管理を許可されたユーザーのログインユーザー名。

• パスワード

  認証済みユーザーのログインパスワード。

• データセンター

  レポートスイートをホストしている Analytics データセンターを選択します。

• ページに追跡タグを追加しない

  デフォルト（選択解除）のままにします。

• AppMeasurement を使用

  デフォルト（選択解除）のままにします。

• ページインプレッション数を夜間に読み込まない (作成者)

  デフォルト（選択解除）のままにします。

• ページインプレッション数を夜間に読み込まない (発行)

  デフォルト（選択解除）のままにします。

設定を保存するには：

• 選択 Analytics に接続

  • 成功しなかった場合、

    • エントリの先頭にスペースが含まれていないことを確認します。
    • 別のデータセンターを試してみてください。

• 「OK」を選択します。

  

フレームワークの作成

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

• 選択 [+] 隣のアイコン 使用可能なフレームワーク 新しいフレームワークを作成するには

  

• タイトル

  （必須）フレームワークの表示タイトル。例えば、次のように入力します。 イネーブルメントコミュニティフレームワーク.

• 名前

  （オプション）指定しない場合、名前はデフォルトで、タイトルから派生した有効なノード名になります。
  例えば、 コミュニティ.

• テンプレート

  Adobe Analytics Framework.

• 「作成」を選択します。

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

AEM Analytics フレームワーク設定

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

レポートスイートの選択

ビデオレポート用にセットアップされているレポートスイートを選択します。

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

サイドキックは必要ないので、レポートスイート設定にアクセスするときの邪魔にならないよう最小化しておくことができます。

「項目を追加」選択前および選択後のレポートスイートダイアログ

1. 選択 項目を追加+.

   2 つのドロップダウンボックスが表示されます。

2. を選択します。 Report suite.

   会社アカウントに関連付けられているレポートスイートを選択できます。

3. 選択 はい 表示されるダイアログで、次の操作を実行します。

   Load default server settings?
    Do you want to load the default server settings and overwrite current values in the Server section?
   

4. を選択します。 Run Mode.

5. 「発行」を選択します。

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

コミュニティサイトに対する Analytics の有効化

新しいコミュニティサイトに対する有効化

新しいコミュニティサイトの作成中に Analytics クラウドサービスを追加するには：

• 手順 3 で、 「ANALYTICS」タブ:

  • を選択します。 Analytics を有効にする チェックボックスをオンにします。
  • ドロップダウンボックスからフレームワークを選択します。

• Analytics フレームワーク設定に戻り、変数マッピングを調整します（オプション）。

既存のコミュニティサイトに対する有効化

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

• 次に移動： コミュニティ/サイト コンソール。

• コミュニティサイトのサイトを編集アイコンを選択します。

• 設定を選択します。

• 「Analytics」セクションで、以下の操作をおこないます。

  • を選択します。 Analytics を有効にする チェックボックスをオンにします。
  • ドロップダウンボックスからフレームワークを選択します。

• Analytics フレームワーク設定に戻り、変数マッピングを調整します（オプション）。

カスタマイズされたサイトに対する有効化

コミュニティサイトで Analytics の追跡とインポートが正常に機能するようにするには、scf-js-site-title クラスと href 属性のページ要素が存在する必要があります。そのような要素は、変更されていないページ内に存在するなど、1 つだけページ上に存在する必要があります sitepage.hbs コミュニティサイト用のスクリプト の値 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

Analytics は複数のコミュニティ機能で自動的に使用されます。

オーサー環境の OSGi 設定, AEM Communities Analytics Component Configurationは、Analytics 用に実装されたコンポーネントの一覧を提供します。 変数の自動マッピングは、リストされているコンポーネントによって決定されます。

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

コンポーネントの設定

Analytics と AEM 変数とのマッピング

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

evar1 ～ evar11 および event1 ～ event7 の範囲内のいずれかの変数がマップされた既存のレポートスイートを使用する場合は、AEM 変数を再マップして、元のマッピングを復元する必要があります。

使用の手引きのチュートリアルに従った場合のデフォルトのマッピング例を以下に示します。

各イベントと共に送信される eVars のマップ

eVar の値の例：

• MIME タイプ: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 変数のマッピングの変更

Analytics の eVar およびイベントとAEM変数とのマッピングは、Analytics をコミュニティサイトで有効にした後、フレームワーク設定から表示されます。

Analytics を有効にした後、コミュニティサイトを公開する前に、フレームワーク内で必要な Analytics の evar または event を左のレールからマッピングテーブルの適切な行にドラッグ＆ドロップすることで、マッピングを変更できます。

マッピングの重複を避けるために、置き換えられた Analytics の evar または event は列から削除するようにしてください（削除するには、カーソルを合わせたときに Analytics 変数要素の右に表示される「X」を選択します）。

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

手順 1 の例：Analytics の evar14 をマッピングテーブルにドラッグ

手順 2 の例：「x」を選択し、置き換える evar11 を削除

手順 3 の例：AEM 変数 eventdata.siteId を Analytics の evar14 に再マップ

コミュニティサイトの公開

Analytics と AEM 変数とのマッピングの検証

コミュニティサイトの公開前に、変数マッピングを確認することを推奨します。サイトの公開時には、Analytics クラウドサービスとフレームワークも公開されます。

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

• Analytics と AEM 変数とのマッピング
• Analytics 変数のマッピングの変更

プライマリパブリッシャー

選択したデプロイメントがパブリッシュファームの場合は、レポートデータのポーリングをおこなう Adobe Analytics が SRP に書き込めるよう、1 つの AEM パブリッシュインスタンスをプライマリパブリッシャーに指定する必要があります。

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

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

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

暗号鍵のレプリケーション

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

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

コミュニティサイトと Analytics クラウドサービスの公開

Analytics クラウドサービスをコミュニティサイトに対して有効にし、また必要に応じて Analytics 変数と AEM 変数とのマッピングを調整したら、コミュニティサイトの（再）公開をおこない、設定をパブリッシュ環境にレプリケートする必要があります。

Analytics からのレポートの取得

レポート管理

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

オーサー環境では、リアルタイムレポートを入手するにはクエリを使用します。

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

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

レポートインポーター

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

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

データが「ビッグデータ」に類するものである場合は、ポーリングの頻度を上げるとコミュニティサイトに大きな負荷がかかる場合があります。

デフォルトのポーリングの​読み込みインターバル​は、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 プロパティは、レポートインポーターの間隔よりも優先されます。
  • 値は秒単位で、4 時間 (14400秒 ) に設定されます。

Analytics でのユーザーデータの管理

Adobe Analytics は、ユーザーデータのアクセス、書き出し、削除をおこなう API を提供しています。詳しくは、アクセス要求および削除要求の送信を参照してください。

リソース

• Adobe Experience Cloud: Analytics ヘルプとリファレンス
• AEM: Adobe Analyticsとの統合
• AEM: Analytics と外部プロバイダー