コミュニティ機能のための Analytics の設定 analytics-configuration-for-communities-features
概要 overview
Adobe AnalyticsとAdobe Experience Manager(AEM) は、共にAdobe Experience Cloudのソリューションです。
Adobe AnalyticsをAEM Communities用に設定して、メンバーがサポートされている Communities 機能とやり取りする際に、レポートの生成元となるAdobe Analyticsにイベントを送信することができます。
例えば、コミュニティサイトから、管理者はビデオの再生に関する様々なレポートを表示できます。
さらに、以下に対して分析が必要です。
-
パブリッシュ環境では、次の操作をおこないます。
- コミュニティのレポート トレンド
- サイト訪問者に対し、「最も多く閲覧された」、「最もアクティブ」、「最も「いいね!」が多い」での並べ替えを許可
- UGC(ユーザー生成コンテンツ)リストでの表示回数
-
オーサー環境では、次の操作をおこないます。
- でのパーティシペーションデータの表示 メンバー管理コンソール (閲覧、投稿、フォロー、「いいね!」)
- イネーブルメントリソースのトレンドの概要、ビデオハートビート、ビデオデバイス レポート
サポートされるコミュニティ機能は次のとおりです。
この節では、Analytics レポートスイートを Communities の機能と接続する方法について説明します。 基本的な手順は次のとおりです。
-
暗号鍵のレプリケート したがって、すべてのAEMインスタンスで暗号化/復号化が正しく実行されるようにすることができます
-
Adobe Analyticsの準備 レポートスイート
-
AEM Analytics の作成 Cloud service および 枠組み
-
Analytics を有効にする コミュニティサイト用
-
検証 Analytics からAEM変数へのマッピング
-
特定 主発行者
-
公開 コミュニティサイト
-
設定 レポートデータのインポート Adobe Analyticsからコミュニティサイトへ
前提条件 prerequisites
Analytics for Communities 機能を設定するには、アカウント担当者と協力してAdobe Analyticsアカウントを設定し、 レポートスイート. 設定が完了したら、次の情報を利用できるようになります。
-
会社名
Adobe Analyticsアカウントに関連付けられている会社。
-
ユーザー名
Analytics アカウントの管理権限を持つユーザーのログインユーザー名です(Web サービスへのアクセス権限を含める必要があります)。
-
パスワード
認証済みユーザーのログインパスワード。
-
Analytics データセンター
アカウントの Analytics データセンターの URL。
-
レポートスイート
使用する Analytics レポートスイートの名前。
ビデオレポート用のAdobe Analyticsレポートスイート adobe-analytics-report-suite-for-video-reporting
Adobe Experience Cloudの使用 Report Suite Managerを設定すると、コミュニティサイトでコミュニティ機能のレポートを提供できるように、Analytics レポートスイートを設定できます。
にサインインする Adobe Experience Cloud 次を使用 会社名とユーザー名を使用する場合、以下の項目を含む新しいレポートスイートまたは既存のレポートスイートを設定できます。
-
11 個のコンバージョン変数 (eVar)
-
evar1
経由evar11
有効 -
既存の eVar を転用(名前を変更)したり、コミュニティ機能で使用する eVar を作成したりできます。
-
-
7 件の成功イベント (イベント)
-
event1
経由event7
有効 -
type
Counter
- not
Counter (no subrelations)
- not
-
既存のイベントを転用(名前を変更)したり、コミュニティ機能で使用するイベントを作成したりできます。
-
-
-
ビデオレポートコンソール
- Enable(有効)
Video Core
- 「保存」を選択します
- Enable(有効)
-
ビデオコア指標コンソール
Use Solution Variables
を選択します。- 「保存」を選択します
-
を使用している場合、 新しいレポートスイート に設定すると、新しいレポートスイートには 4 つの evar と 6 つのイベント変数しか設定できませんが、Communities では 11 個の evar と 7 個のイベント変数が必要です。
を使用する場合、 既存のレポートスイート を使用する場合は、次の操作が必要になる場合があります。 変数マッピングの変更 コミュニティサイト用の Analytics フレームワークをアクティブ化する前に。
コミュニティ専用の変数に関するご不明な点は、アカウント担当者にお問い合わせください。
-
evar1
からevar11
まで -
event1
からevent7
まで
ビデオハートビート分析 video-heartbeat-analytics
Video Heartbeat Analytics のライセンスが必要な場合、 Marketing Cloud Org Id
が割り当てられます。
次の後にビデオハートビートレポートを有効にするには ビデオレポート用の Analytics レポートスイートの設定:
- の作成 Analytics Cloudサービス
- 有効にする コミュニティサイト用 Analytics
- を関連付ける
Marketing Cloud Org Id
コミュニティサイトで
The Marketing Cloud Org Id
次の時点で入力可能 コミュニティサイトの作成 または後から 修正中 コミュニティサイトのプロパティ。
ビデオハートビート分析が有効な場合、ビデオプレーヤーの JavaScript(JS) コードが、ビデオハートビートライブラリコードをインスタンス化します(また、JS にも含まれます)。 このコードは、ビデオステータスの更新を 10 秒ごとに Analytics ビデオトラッキングサーバーに送信する(設定できない)すべてのロジックを処理します。 最終的に、ビデオセッションの累積レポートがメインの Analytics サーバーに送信されます。
有効にしない場合、ビデオハートビートコードはインスタンス化されず、ビデオの進行状況と再開位置のトラッキングのみがレポート用に SRP に保持されます。
AEM Analytics Cloud Service Configuration aem-analytics-cloud-service-configuration
オーサーインスタンスの標準 UI を使用して、Adobe AnalyticsとAEMコミュニティサイトを統合する Analytics 統合を作成するには、次の手順を実行します。
- グローバルナビゲーションから: ツール > 導入 > Cloud Service
- 下にスクロールして Adobe Analytics
- 選択 今すぐ設定 または 設定を表示
設定を作成ダイアログ create-configuration-dialog
- 選択
[+]
隣のアイコン 利用可能な設定 設定を作成できます。
設定を作成ダイアログで、入力する値で設定が識別されます。
-
タイトル
(必須)設定の表示タイトル。
例えば、 コミュニティ分析 -
名前
(オプション)指定しない場合、名前はデフォルトでタイトルから派生した有効なノード名になります。
例えば、 コミュニティ -
テンプレート
Adobe Analytics Configuration
を選択します。 -
選択 作成
- 設定ページを起動して開きます
Analytics Settings
ダイアログ
- 設定ページを起動して開きます
Analytics 設定ダイアログ analytics-settings-dialog
新しい Analytics 設定を初めて作成すると、設定が表示され、Analytics 設定を入力するための新しいダイアログが表示されます。 このダイアログでは、 前提条件のアカウント情報 アカウント担当者から取得します。
-
Company(会社)
Adobe Analyticsアカウントに関連付けられている会社。
-
ユーザー名
Analytics アカウントの管理を許可されたユーザーのログインユーザー名。
-
パスワード
認証済みユーザーのログインパスワード。
-
データセンター
レポートスイートをホストしている Analytics データセンターを選択します。
-
ページに追跡タグを追加しない
デフォルト(選択解除)のままにします。
-
AppMeasurement を使用
デフォルト(選択解除)のままにします。
-
ページインプレッション数を夜間に読み込まない (作成者)
デフォルト(選択解除)のままにします。
-
ページインプレッション数を夜間に読み込まない (発行)
デフォルト(選択解除)のままにします。
設定を保存するには:
-
選択 Analytics に接続
-
成功しなかった場合、
- エントリの先頭にスペースが含まれていないことを確認します。
- 別のデータセンターを試してみてください。
-
-
「OK」を選択します。
フレームワークを作成 create-framework
Adobe Analyticsへの基本的な接続を正常に設定したら、コミュニティサイトのフレームワークを作成または編集する必要があります。 このフレームワークの目的は、コミュニティ機能 (AEM) 変数を Analytics(レポートスイート)変数にマッピングすることです。
-
選択
[+]
隣のアイコン 使用可能なフレームワーク フレームワークを作成できます。 -
タイトル
(必須)フレームワークの表示タイトル。例えば、次のように入力します。 コミュニティフレームワーク.
-
名前
(オプション)指定しない場合、名前はデフォルトでタイトルから派生した有効なノード名になります。
例えば、 コミュニティ. -
テンプレート
選択
Adobe Analytics Framework
. -
「作成」を選択します。
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
-
選択 項目を追加+.
2 つのドロップダウンボックスが表示されます。
-
を選択します。
Report suite.
会社アカウントに関連付けられているレポートスイートを選択できます。
-
選択 はい 表示されるダイアログで、次の操作を実行します。
code language-none Load default server settings? Do you want to load the default server settings and overwrite current values in the Server section?
-
を選択します。
Run Mode
. -
選択 公開.
これで、Analytics Cloud サービスとフレームワークが完了しました。 マッピングは、この Analytics サービスを有効にしてコミュニティサイトを作成した後に定義されます。
コミュニティサイト用に Analytics を有効にする enable-analytics-for-a-community-site
新しいコミュニティサイト用に有効化 enable-for-new-community-site
Analytics Cloudサービスを コミュニティサイトの作成:
-
手順 3 で、 「ANALYTICS」タブ:
- を選択します。 Analytics を有効にする 」チェックボックスをオンにします。
- ドロップダウンボックスからフレームワークを選択します。
-
必要に応じて、Analytics フレームワーク設定に戻り、変数のマッピングを調整します。
既存のコミュニティサイトに対して有効にする enable-for-existing-community-site
Analytics Cloudサービスを 既存のコミュニティサイト:
-
次に移動: コミュニティ/サイト コンソール。
-
コミュニティサイトのサイトを編集アイコンを選択します。
-
設定を選択します。
-
「Analytics」セクションで、以下の操作をおこないます。
- を選択します。 Analytics を有効にする 」チェックボックスをオンにします。
- ドロップダウンボックスからフレームワークを選択します。
-
必要に応じて、Analytics フレームワーク設定に戻り、変数のマッピングを調整します。
カスタマイズされたサイトの有効化 enable-for-customized-sites
Analytics のトラッキングと読み込みがコミュニティサイトに対して適切に機能するように、ページ要素を scf-js-site-title
class 属性と 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
スクリプトを使用する場合は、要素が存在することを確認します。 The 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
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値の例:
-
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 変数のマッピングの変更 modifying-analytics-variable-mapping
Analytics の eVar およびイベントとAEM変数とのマッピングは、Analytics をコミュニティサイトで有効にした後、フレームワーク設定から表示されます。
Analytics を有効にした後、コミュニティサイトを公開する前に、フレームワーク内でマッピングを変更できます。 目的の Analytics eVar またはイベントを左側のパネルからドラッグし、マッピングテーブルの関連する行にドロップするだけです。
マッピングの重複を避けるには、置き換えられた Analytics の eVar またはイベントを必ず行から削除するように、マウスポインターを置き、Analytics 変数要素の右側に表示される「X」を選択してください。
コミュニティの eVar とイベントがレポートスイートに以前存在したマッピングを上書きする場合、データの損失を避けるために、コミュニティ機能の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 Cloudのサービスとフレームワークも公開しています。
次の節を参照してください。
-
evar1
からevar11
まで -
event1
からevent7
まで
プライマリ発行者 primary-publisher
選択したデプロイメントが パブリッシュファームその場合、1 つのAEMパブリッシュインスタンスを、レポートデータを書き込むためのポーリングAdobe Analyticsのプライマリパブリッシャーとして識別する必要があります。 SRP.
デフォルトでは、 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 に対するクエリに使用されます。
オーサー環境では、クエリはリアルタイムレポート用です。
プライマリパブリッシャでは、クエリを使用して、レポートインポータの Analytics データのインポートに備えて情報を提供します。
クエリ間隔のデフォルト値は 10 秒です。
レポートインポーター report-importer
Analytics が有効なコミュニティサイトが公開されると、プライマリパブリッシャーは OSGi 設定, AEM Communities Analytics Report Importer
CRXDE で個別に設定されない設定に対して、デフォルトのポーリング間隔を設定するように設定できます。
ポーリング間隔は、データを取り込んでに保存するためのAdobe Analyticsへのリクエストの頻度を制御します SRP.
データが「ビッグデータ」に分類される場合、ポーリングの頻度が高いほど、コミュニティサイトに大きな負荷がかかる可能性があります。
デフォルトのポーリング インポート間隔 が 12 時間に設定されている場合、
コンポーネントレポートのカスタマイズ component-report-customization
現在、追跡する指標をカスタマイズするために、リポジトリにノードが作成され、その指標に関するレポートを生成する期間が定義されます。
現在、このカスタマイズの例はフォーラムトピックのみです。
-
プライマリパブリッシャーで、管理者権限でログインします。
-
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 でのユーザーデータの管理 manage-user-data-in-analytics
Adobe Analyticsには、ユーザーデータにアクセス、書き出し、削除できる API が用意されています。 詳しくは、 アクセス要求および削除要求の送信.
リソース resources
- ADOBE EXPERIENCE CLOUD: Analytics ヘルプとリファレンス
- AEM: Adobe Analyticsとの統合
- AEM: Analytics と外部プロバイダー