Dynamic MediaビューアとAdobe AnalyticsおよびExperience Platform Launchの統合

Adobe AnalyticsおよびExperience Platform LaunchとのDynamic Media Viewersの統合とは

platform launchビューアおよびDynamic Mediaビューア5.13の新しい​Dynamic Mediaビューア​拡張機能を使用すると、Adobe AnalyticsおよびPlatform launchのお客様は、Platform launch設定でビューアに固有のイベントとデータを使用できます。

この統合により、Adobe Analytics を使用して、Web サイト上での Dynamic Media ビューアの使用状況を追跡できます。同時に、Adobeやサードパーティ製のその他のExperience Platform Launch拡張機能を持つビューアによって公開されたイベントやデータを使用できます。

拡張機能について詳しくは、『Experience Platform Launchユーザーガイド』の「Adobe拡張」を参照してください。

このトピックは、 サイト管理者、Experience Managerプラットフォームの開発者、および運用担当者を対象としています。

統合の制限

  • Dynamic MediaビューアのExperience Platform Launch統合は、Experience Managerオーサーノードでは機能しません。 公開されるまで、WCM ページからのトラッキングを表示することはできません。
  • Dynamic MediaビューアのExperience Platform Launch統合は、「ポップアップ」操作モードではサポートされていません。このモードでは、ビューアのURLは、アセットの詳細ページの「URL」ボタンを使用して取得されます。
  • Experience Platform Launch統合は、(config2=パラメーターを介して)従来のビューアAnalytics統合とは同時に使用することはできません。
  • ビデオトラッキングのサポートは、トラッキングの概要で説明されているように、「コア再生」トラッキングのみに制限されます。 具体的には、QoS、広告、チャプター/セグメント、エラーのトラッキングはサポートされていません。
  • データ要素のストレージデュレーション設定は、Dynamic Media ビューア​拡張機能を使用したデータ要素ではサポートされません。ストレージデュレーションは None に設定する必要があります。

統合の事例

Experience Platform Launchとの統合の主な使用例は、AEM AssetsとAEM Sitesの両方を使用するお客様です。 このような場合、AEMオーサーノードとExperience Platform Launchの標準的な統合を設定し、SitesインスタンスをExperience Platform Launchプロパティに関連付けることができます。 その後、Site ページに追加された Dynamic Media WCM コンポーネントは、ビューアのデータとイベントを追跡します。

AEM SitesでのDynamic Mediaビューアの追跡を参照してください。

統合が支える 2 番目の事例は、AEM Assets のみ、または Dynamic Media Classic を使用するお客様です。その場合、ビューアの埋め込みコードを取得して、Web サイトページに追加します。次に、Experience Platform Launchライブラリ実稼動用URLをExperience Platform Launchから取得し、Webページのコードに手動で追加します。

埋め込みコードを使用したDynamic Mediaビューアの追跡を参照してください。

統合でのデータとイベントのトラッキングの仕組み

この統合では、Adobe AnalyticsAdobe Analytics for Audio and Video という、2 種類の独立したタイプの Dynamic Media ビューアのトラッキングを利用します。

Adobe Analytics を使用したトラッキングについて

Adobe Analytics を使用すると、エンドユーザーが Web サイト上で Dynamic Media ビューアとやり取りしたときに実行したアクションを追跡できます。また、Adobe Analytics では、ビューア固有のデータも追跡できます。例えば、ビューの読み込みイベントを、アセット名、発生したズーム操作、ビデオ再生操作と共に追跡および記録できます。

Experience Platform Launchでは、データ要素​と​ルール​の概念が連携して、Adobe Analyticsのトラッキングを有効にします。

Experience Platform Launchのデータ要素について

Experience Platform Launch内のデータ要素は、名前の付いたプロパティです。このプロパティの値は、静的に定義されるか、Webページの状態やDynamic Mediaビューアのデータに基づいて動的に計算されます。

データ要素の定義で使用できるオプションは、拡張プロパティにインストールされる拡張機能のExperience Platform Launchによって異なります。 「コア」拡張機能はプレインストールされ、任意の設定で初期状態で使用できます。この「コア」拡張機能を使用すると、Cookie、JavaScriptコード、クエリ文字列、その他多くのソースから取得した値を持つデータ要素を定義できます。

Adobe Analyticsトラッキングの場合は、拡張機能のインストールとセットアップで説明されているように、さらに複数の拡張機能をインストールする必要があります。 Dynamic Media ビューア拡張機能には、Dynamic Viewer イベントの引数である値のデータ要素を定義する機能が追加されています。例えば、ビューアのタイプや、読み込み時にビューアから報告されたアセット名、エンドユーザーがズームしたときに報告されるズームレベルなどを参照できます。

Dynamic Media Viewer拡張機能は、データ要素の値を自動的に最新の状態に保ちます。

定義したデータ要素は、データ要素ピッカーウィジェットを使用して、Experience Platform LaunchUIの他の場所で使用できます。 特に、Dynamic Mediaビューアトラッキングの目的で定義されたデータ要素は、ルール内のAdobe Analytics拡張機能の変数設定アクションで参照されます(以下を参照)。

データ要素を参照してください。

Experience Platform Launchのルールについて

Experience Platform Launchのルールは、ルールを構成する次の3つの領域を定義する非依存型の設定です。イベント条件アクション:

  • イベント (if)は、Experience Platform Launchにルールをトリガーするタイミングを伝えます。
  • 条件 (if)は、ルールのトリガー時に許可または禁止する他の制限をExperience Platform Launchに伝えます。
  • アクション (then)は、ルールがトリガーされた場合にExperience Platform Launchに対して何をおこなうかを伝えます。

イベント、条件、アクションのセクションで使用できるオプションは、Experience Platform Launchプロパティにインストールされている拡張機能によって異なります。 コア​拡張機能はプレインストールされており、どのような設定でも初期状態ですぐに使用できます。拡張機能には、基本的なブラウザーレベルのアクションなど、イベントに関するいくつかのオプションが用意されています。 これらのアクションには、フォーカスの変更、キーの押下、フォームの送信が含まれます。 また、条件についても、cookie の値、ブラウザータイプなどのオプションが用意されています。アクションについては、カスタムコードオプションのみ使用できます。

Adobe Analyticsトラッキングの場合は、拡張機能のインストールとセットアップで説明されているように、他のいくつかの拡張機能をインストールする必要があります。 具体的には以下のとおりです。

  • Dynamic Media ビューア拡張機能は、サポートされるイベントのリストを、ビューアの読み込み、アセットの入れ替え、ズームイン、ビデオ再生など、Dynamic Media ビューアに固有のイベントに拡張します。
  • Adobe Analytics 拡張機能は、サポートされるアクションのリストを拡張し、データをトラッキングサーバーに送信するために必要な、変数設定​と​ビーコン送信​という 2 つのアクションが用意されています。

Dynamic Mediaビューアを追跡するには、次のいずれかのタイプを使用できます。

  • Dynamic Media ビューア拡張機能、コア拡張機能またはその他の拡張機能からのイベント。
  • ルール定義の条件。または、条件領域を空のままにすることもできます。

アクションセクションでは、変数設定​アクションが必要です。このアクションは、Adobe Analytics にデータを使用してトラッキング変数を設定する方法を知らせます。同時に、変数設定​アクションは、トラッキングサーバーに何も送信しません。

変数設定​アクションに続けて、ビーコン送信​アクションを使用する必要があります。ビーコン送信​アクションは、実際に Analytics トラッキングサーバーにデータを送信します。変数設定​と​ビーコン送信​アクションは、いずれも Adobe Analytics 拡張機能から得られます。

ルールを参照してください。

サンプル設定

以下の設定例は、Experience Platform Launchの読み込み時にアセット名を追跡する方法を示しています。

  1. データ要素」タブで、Dynamic Media ビューア拡張機能から LOAD イベントの asset パラメーターを参照するデータ要素 AssetName を定義します。

    image2019-11

  2. ルール」タブで、ルール TrackAssetOnLoad を定義します。

    このルールでは、「イベント」フィールドは、Dynamic Media ビューア拡張機能の LOAD イベントを使用します。

    image2019-22

  3. アクション設定には、Adobe Analytics 拡張機能の 2 つのアクションタイプがあります。

    変数設定​は、選択した分析変数を AssetName データ要素の値にマップします。

    ビーコン送信​は、Adobe Analytics にトラッキング情報を送信します。

    image2019-3

  4. ルール設定結果は次のようになります。

    image2019-4

Adobe Analytics for Audio and Video について

Experience Cloud アカウントが Adobe Analytics for Audio and Video を使用するよう登録されている場合、Dynamic Media ビューア​拡張機能の設定でビデオのトラッキングを有効にするだけで十分です。ビデオ指標が Adobe Analytics で使用できるようになります。ビデオトラッキングは、Adobe Media Analytics for Audio and Video 拡張機能の有無に依存します。

詳しくは、拡張機能のインストールとセットアップを参照してください。

現在、ビデオトラッキングのサポートは、トラッキングの概要で説明されているように、「コア再生」トラッキングのみに制限されます。具体的には、QoS、広告、チャプター/セグメント、エラーのトラッキングはサポートされていません。

Dynamic Media ビューア拡張機能の使用

統合の使用例で説明したように、AEM Sitesの新しいExperience Platform Launch統合で、埋め込みコードを使用してDynamic Mediaビューアを追跡できます。

AEM Sites での Dynamic Media ビューアのトラッキング

AEM Sites で Dynamic Media ビューアを追跡するには、すべての統合ピースの設定で説明している手順をすべて実行する必要があります。特に、IMS設定とCloudExperience Platform Launchを作成する必要があります。

適切な設定に従って、Dynamic Media でサポートされる WCM コンポーネントを使用してサイトページに追加した Dynamic Media ビューアは、Adobe Analytics、Adobe Analytics for Video、またはその両方に対するデータを自動的に追跡します。

埋め込みコードを使用した Dynamic Media ビューアのトラッキング

AEM Sitesを使用しない、またはAEM Sites以外のWebページにDynamic Mediaビューアを埋め込む、またはその両方をお使いのお客様は、引き続きExperience Platform Launch統合を使用できます。

Adobe Analyticsの設定およびExperience Platform Launchの設定の手順を実行します。 ただし、Experience Manager関連の設定手順は不要です。

適切な設定を行ったら、Dynamic Mediaビューアを使用したWebページにExperience Platform Launchサポートを追加できます。

platform launchライブラリの埋め込みコードの使用方法について詳しくは、Experience Platform Launchの埋め込みコードの追加を参照してください。

埋め込みコードを使用して Dynamic Media ビューアを追跡するには:

  1. Dynamic Media ビューアを埋め込む Web ページを準備します。
  2. 最初にExperience Platform Launchにログインして、Experience Platform Launchライブラリの埋め込みコードを取得します(Experience Platform Launchの設定を参照)。
  3. プロパティ​をクリックし、「環境」タブをクリックします。
  4. Web ページの環境に関連する環境レベルを取得します。次に、「インストール」列のボックスアイコンをクリックします。
  5. Web Install Instructionsダイアログボ ックスで、Experience Platform Launchライブラリの埋め込みコード全体と、それを囲むタグをコピー <script/> します。

Dynamic Media ビューア拡張機能リファレンスガイド

Dynamic Media ビューアの設定について

次の条件を満たす場合、Dynamic Media Viewer拡張機能はExperience Platform Launchライブラリと自動的に統合されます。

  • Experience Platform Launchライブラリグローバルオブジェクト(_satellite)がページに存在します。

  • Dynamic Media ビューア拡張機能の _dmviewers_v001() 関数が、_satellite で定義されている。

  • config2= ビューアパラメーターが指定されていない。つまり、ビューアが従来の Analytics 統合を使用していない。

また、ビューアの設定でlaunch=0パラメーターを指定して、ビューアでのExperience Platform Launchの統合を明示的に無効にするオプションもあります。 このパラメーターのデフォルト値は 1 です。

Dynamic Media ビューア拡張機能の設定

Dynamic Media ビューア拡張機能の唯一の設定オプションは、Adobe Media Analytics for Audio and Video を有効にする​です。

このオプションをオン(オン)にし、 Analytics for Audio and Video拡張機能がインストールされ、設定されると、ビデオ再生Adobe MediumがAdobe Analytics for Audio and Videoソリューションに送信されます。 このオプションを無効にすると、ビデオトラッキングがオフになります。

Analytics for Audio and Video拡張機能をインストールして​なしで​このオプションを有効にした場合、このオプションは無効になります。

image2019-7-22_12-4-23

Dynamic Media ビューア拡張機能のデータ要素について

Dynamic Media ビューア拡張機能で提供されるデータ要素タイプは、「データ要素タイプ」ドロップダウンリストの​ビューアイベント​のみです。

選択すると、データ要素エディターは、次の 2 つのフィールドを含むフォームをレンダリングします。

  • DM ビューアイベントデータタイプ - 引数を持つ Dynamic Media ビューア拡張機能でサポートされるすべてのビューアイベントと、特別な COMMON 項目を識別するドロップダウンリスト。COMMON 項目は、ビューアから送信されるすべてのタイプのイベントに共通するイベントパラメーターのリストを表します。
  • トラッキングパラメーター- - 選択した Dynamic Media ビューアイベントの引数。

image2019-7-22_12-5-46

各ビューアタイプでサポートされるイベントのリストについては、 Dynamic Mediaビューアリファレンスガイドを参照してください。特定のビューアセクションに移動し、「 Adobe Analyticsトラッキングのサポート」サブセクションをクリックします。 現在、Dynamic Media ビューアリファレンスガイドでは、イベントの引数について説明していません。

次に、Dynamic Mediaビューアの​データ要素​のライフサイクルを考えてみましょう。 このようなデータ要素の値は、対応する Dynamic Media ビューアイベントがページで発生した後に設定されます。例えば、データ要素が​LOAD​イベントとその「asset」引数を指すとします。 その場合、このようなデータ要素の値は、ビューアが初めて​LOAD​イベントを実行した後で有効なデータを受け取ります。 データ要素が​ZOOM​イベントとその「scale」引数を指す場合、このようなデータ要素の値は、ビューアが初めて​ZOOM​イベントを送信するまで空のままです。

同様に、ビューアがページ上の対応するイベントを送信すると、データ要素の値は自動的に更新されます。値の更新は、特定のイベントがルール設定で指定されていない場合でもおこなわれます。例えば、ZOOMイベントの「scale」パラメータにデータ要素​ZoomScale​が定義されているとします。 ただし、ルール設定に存在するルールは​LOAD​イベントによってトリガーされます。 ZoomScale​の値は、ユーザがビューア内でズームを実行するたびに更新されます。

Dynamic Media ビューアは Web ページ上で一意の識別子を持ちます。データ要素は、値自体と、値が入力されたビューアを追跡します。 例えば、同じページに複数のビューアがあり、 LOAD​イベントとその「asset」引数を指す​AssetName​データ要素があるとします。 AssetName​データ要素は、ページに読み込まれた各ビューアに関連付けられたアセット名のコレクションを保持します。

データ要素から返される正確な値は、コンテキストによって異なります。Dynamic Media ビューアイベントによってトリガーされたルール内でデータ要素が要求された場合、ルールを開始したビューアに対してデータ要素の値が返されます。また、データ要素は、他のイベント拡張機能からイベントによってトリガーされたルール内でPlatform launchされます。 その時点で、データ要素の値は、このデータ要素を更新する最後の値であるビューアから取得されます。

次のサンプル設定を考えてみましょう

  • 2つのDynamic Mediaズームビューアを持つWebページ:viewer1​と​viewer2

  • ZoomScale データ要素は、ZOOM イベントとその「scale」引数を指します。

  • TrackPan ルールには、次の情報が含まれます。

    • Dynamic Media ビューアの PAN イベントをトリガーとして使用。
    • ZoomScale データ要素の値を Adobe Analytics に送信。
  • TrackKey ルールには、次の情報が含まれます。

    • Coreイベント拡張機能のkey pressExperience Platform Launchをトリガーとして使用します。
    • ZoomScale データ要素の値を Adobe Analytics に送信。

ここで、エンドユーザーが 2 つのビューアで Web ページを読み込んだとします。viewer1 では 50%の拡大率でズームインし、次に、viewer2 では 25%の拡大率でズームインします。viewer1​では、画像がパンされ、最後にキーボードのキーが選択されます。

エンドユーザーのアクティビティによって、Adobe Analytics に対して次の 2 つのトラッキングコールが実行されます。

  • 最初の呼び出しは、ユーザーが viewer1 でパンしたときに TrackPan ルールがトリガーされることから発生します。この呼び出しでは、ルールが​viewer1​によってトリガーされたことをデータ要素が認識し、対応するスケール値を取得するので、 ZoomScale​データ要素の値として50%が送信されます。
  • 2 回目の呼び出しは、ユーザーがキーボードのキーを押したときに TrackKey ルールがトリガーされるので発生します。ルールをトリガーしたのがビューアでなかったので、この呼び出しでは ZoomScale データ要素の値として 25%が送信されます。このようにして、データ要素は最新の値を返します。

上記のサンプル設定は、データ要素の値の寿命にも影響します。Dynamic Media Viewerで管理されるデータ要素の値は、ビューア自体がWebページに配置された後でも、Platform launchライブラリコードに格納されます。 つまり、Dynamic Media以外のビューア拡張機能によってトリガーされるルールがあり、そのようなデータ要素を参照する場合、データ要素は最新の既知の値を返します。 ビューアがWebページに存在しなくなった場合でも、

いずれの場合も、Dynamic Mediaビューアによって駆動されるデータ要素の値は、ローカルストレージやサーバーには保存されません。代わりに、クライアント側のExperience Platform Launchライブラリにのみ保持されます。 Web ページがリロードされると、このようなデータ要素の値は消去されます。

一般に、データ要素エディターでは、ストレージ期間の選択がサポートされます。ただし、Dynamic Media ビューア拡張機能を使用するデータ要素は、ストレージ期間「なし」オプションのみサポートします。その他の値はユーザーインターフェイスで設定可能ですが、この場合、データ要素の動作は定義されていません。拡張機能は、データ要素の値を独自に管理します。データ要素は、ビューアのライフサイクル全体でビューアのイベント引数の値を維持します。

Dynamic Media ビューア拡張機能のルールについて

ルールエディターで、イベントエディターの新しい設定オプションが追加されます。また、事前に設定されたデータ要素を使用する代わりに、アクションエディターでイベントパラメーターを手動で参照するオプションも用意されています。

イベントエディターについて

イベントエディターで、Dynamic Mediaビューア拡張機能によって、イベントタイプ​と呼ばれる​ビューアイベント​が追加されます。

選択すると、イベントエディターによって「Dynamic Media ビューアイベント」ドロップダウンがレンダリングされ、Dynamic Media ビューアでサポートされる使用可能なイベントがすべて表示されます。

image2019-8-2_15-13-1

アクションエディターについて

Dynamic Media ビューア拡張機能を使用すると、Dynamic Media ビューアのイベントパラメーターを使用して、Adobe Analytics 拡張機能の変数設定エディターで分析変数にマッピングできます。

最も簡単な方法は、次の 2 つの手順を実行することです。

  • まず、1 つ以上のデータ要素を定義します。各データ要素は、Dynamic Media ビューアイベントのパラメーターを表します。
  • 最後に、Adobe Analytics 拡張機能の変数設定エディターで、データ要素ピッカーアイコン(3 つの重なったディスク)をクリックし、データ要素を選択ダイアログボックスを開き、データ要素を選択します。

image2019-7-10_20-41-52

ただし、別の方法を使用して、データ要素の作成をスキップすることは可能です。Dynamic Mediaビューアイベントから引数を直接参照できます。 Analytics変数割り当ての​​入力フィールドに、イベント引数の完全修飾名を入力します。 必ずパーセント記号(%)で囲んでください。 例:

%event.detail.dm.LOAD.asset%

image2019-7-12_19-2-35

データ要素を使用する場合と、直接イベント引数の参照を使用する場合では、重要な違いがあります。 データ要素の場合、「Set Variables」アクションでどのイベントがトリガーを実行したかは関係ありません。ルールをトリガーするイベントは、Dynamic Viewerとは無関係にすることができます。 例えば、Core拡張機能からwebページをクリックします。 ただし、直接引数参照を使用する場合は、ルールをトリガーするイベントが、参照するイベント引数に対応していることを確認することが重要です。

例えば、%event.detail.dm.LOAD.asset% の参照は、ルールが Dynamic Media ビューア拡張機能の LOAD イベントによってトリガーされる場合、正しいアセット名を返します。ただし、他のイベントの場合は空の値を返します。

次の表に、Dynamic Media ビューアイベントと、サポートされている引数を示します。

ビューアのイベント名 引数の参照
COMMON %event.detail.dm.objID%
%event.detail.dm.compClass%
%event.detail.dm.instName%
%event.detail.dm.timeStamp%
BANNER %event.detail.dm.BANNER.asset%
%event.detail.dm.BANNER.frame%
%event.detail.dm.BANNER.label%
HREF %event.detail.dm.HREF.rollover%
ITEM %event.detail.dm.ITEM.rollover%
LOAD %event.detail.dm.LOAD.applicationname%
%event.detail.dm.LOAD.asset%
%event.detail.dm.LOAD.company%
%event.detail.dm.LOAD.sdkversion%
%event.detail.dm.LOAD.viewertype%
%event.detail.dm.LOAD.viewerversion%
METADATA %event.detail.dm.METADATA.length%
%event.detail.dm.METADATA.type%
MILESTONE %event.detail.dm.MILESTONE.milestone%
PAGE %event.detail.dm.PAGE.frame%
%event.detail.dm.PAGE.label%
PAUSE %event.detail.dm.PAUSE.timestamp%
PLAY %event.detail.dm.PLAY.timestamp%
SPIN %event.detail.dm.SPIN.framenumber%
STOP %event.detail.dm.STOP.timestamp%
SWAP %event.detail.dm.SWAP.asset%
SWATCH %event.detail.dm.SWATCH.frame%
%event.detail.dm.SWATCH.label%
TARG %event.detail.dm.TARG.frame%
%event.detail.dm.TARG.label%
ZOOM %event.detail.dm.ZOOM.scale%

すべての統合ピースの設定

始める前に

Adobeでは、統合の詳細を理解できるよう、この節の前にすべてのドキュメントを十分に確認することをお勧めします。

ここでは、Dynamic Media ビューアを Adobe Analytics および Adobe Analytics for Audio and video と統合するために必要な設定手順について説明します。Dynamic Mediaビューア拡張機能をExperience Platform Launchの他の目的で使用することは可能ですが、このドキュメントでは、このようなシナリオについては説明しません。

次のAdobe製品を使用して統合を設定します。

  • Adobe Analytics — トラッキング変数およびレポートの設定に使用します。
  • Experience Platform Launch — ビューアトラッキングを有効にするプロパティ、1つ以上のルールおよび1つ以上のデータ要素を定義するために使用します。

また、この統合ソリューションをExperience ManagerSitesで使用する場合は、次の設定もおこなう必要があります。

  • Adobe I/O コンソール — 統合用に作成されたExperience Platform Launch。
  • Experience Manager作成者ノード — IMS設定およびExperience Platform Launchクラウド設定。

設定の一環として、Adobe AnalyticsとExperience Platform Launchが既に有効になっているAdobe Experience Cloudの会社にアクセスできることを確認してください。

統合のための Adobe Analytics の設定

Adobe Analytics を設定した後、統合のために次の設定がおこなわれます。

  • レポートスイートが配置され、選択される。
  • Analytics 変数がトラッキングデータを受け取るために使用可能になる。
  • Adobe Analytics 内で収集されたデータを表示するレポートが使用可能になる。

Analytics 導入ガイドも参照してください。

統合のために Adobe Analytics を設定するには

  1. まず、Experience Cloud ホームページから Adobe Analytics にアクセスします。メニューバーで、ページの右上隅付近にあるソリューションアイコン(3 x 3 のドットテーブル)をクリックし、Analytics をクリックします。

    2019-07-22_18-08-47

    次に、レポートスイートを選択します。

レポートスイートの選択

  1. Adobe Analytics ページの右上隅近くの「レポートの検索」フィールドの右側にあるドロップダウンリストから、適切なレポートスイートを選択します。複数のレポートスイートが使用可能で、どれを使用するか不明な場合は、Adobe Analytics 管理者が使用するレポートスイートを選択するのに役立ちます。

    下の図では、ユーザーが DynamicMediaViewersExtensionDoc という名前のレポートスイートを作成し、ドロップダウンリストから選択しています。レポートスイート名は説明用です。 最終的に選択するレポートスイートの名前は、ユーザー次第です。

    使用できるレポートスイートがない場合は、設定を続行する前に、ユーザーまたは Adobe Analytics 管理者がレポートスイートを作成する必要があります。

    レポートとレポートスイートおよびレポートスイートの作成を参照してください。

    Adobe Analytics では、管理者/レポートスイート​でレポートスイートを管理します。

    2019-07-22_18-09-49

    次に、Adobe Analytics変数を設定します。

Adobe Analytics 変数の設定

  1. Webページ上のDynamic Mediaビューアの動作を追跡するために使用する1つ以上のAdobe Analytics変数を指定します。

    Adobe Analytics でサポートされている任意のタイプの変数を使用できます。変数タイプ(カスタムトラフィック[prop]、コンバージョン[eVar]など)に関する決定は、Analytics実装の特定のニーズに左右されます。

    prop と eVar の概要を参照してください。

    このドキュメントの目的では、カスタムトラフィック(prop)変数のみが使用されます。これは、Webページでアクションが発生してから数分以内にAnalyticsレポートで使用できるようになるからです。

    新しいカスタムトラフィック変数を有効にするには、Adobe Analyticsのツールバーで、管理者/レポートスイート​をクリックします。

  2. Report Suite Manager​ページで正しいレポートを選択し、ツールバーで​設定を編集/トラフィック/トラフィック変数​をクリックします。

  3. ここで、未使用の変数を選択し、わかりやすい名前(ビューアアセット(prop 30))を付け、「有効」列のコンボボックスを「有効」に変更します。

    次のスクリーンショットは、ビューアが使用するアセット名を追跡するためのカスタムトラフィック変数(prop30)の例です。

    image2019-6-26_23-6-59

  4. 変数リストの下部で、「保存」をクリックします。

レポートの設定

  1. 一般に、Adobe Analytics でのレポートの設定は、特定のプロジェクトのニーズに左右されます。したがって、詳細なレポート設定は、この統合の範囲外です。

    ただし、Adobe Analytics変数の設定でカスタムトラフィック変数を設定すると、カスタムトラフィックレポートがAdobe Analyticsで自動的に使用可能になることがわかります。

    例えば、ビューアアセット(prop 30)​変数のレポートは、カスタムトラフィック/カスタムトラフィック 21~30/ビューアアセット(prop 30)​下のレポートメニューから使用できます。

    ビューアアセット(prop 30)​を作成した直後にこのレポートを表示すると、データが表示されません。これは、統合のこの時点で予想されることです。

    image2019-6-26_23-12-49

統合のExperience Platform Launchの設定

Experience Platform Launchを設定すると、統合に対して次の設定がおこなわれます。

  • すべての設定をまとめるための新しいプロパティの作成。
  • 拡張機能のインストールとセットアップ。プロパティにインストールされたすべての拡張機能のクライアント側コードは、1 つのライブラリにまとめられる。このライブラリは後で Web ページで使用されます。
  • データ要素とルールの設定。この設定は、Dynamic Media ビューアから取得するデータ、トラッキングロジックをトリガーするタイミング、Adobe Analytics でビューアのデータを送信する場所を定義するものです。
  • ライブラリの公開。

統合のExperience Platform Launchを設定するには:

  1. まず、Experience CloudホームページからExperience Platform Launchにアクセスします。 メニューバーで、ページの右上隅付近にあるソリューションアイコン(3 x 3 ドットのテーブル)をクリックし、Launch をクリックします。

    Experience Platform Launchを直接開くこともできます

    image2019-7-8_15-38-44

Experience Platform Launchでのプロパティの作成

Experience Platform Launchのプロパティは、すべての設定をまとめた名前付き設定です。 構成設定のライブラリが様々な環境レベル(開発、ステージングおよび実稼動)で生成され、公開されます。

Launch プロパティの作成」も参照してください。

  1. Experience Platform Launchで、「新しいプロパティ」をクリックします。

  2. プロパティを作成​ダイアログボックスの「名前」フィールドに、Web サイトのタイトルなど、わかりやすい名前を入力します。例:DynamicMediaViewersProp.

  3. ドメイン」フィールドに、Web サイトのドメインを入力します。

  4. 使用したい拡張機能(この場合は​Dynamic Mediaビューア)がまだリリースされていない場合に備えて、「詳細オプション」ドロップダウンで、「拡張機能の開発用に設定(後で変更できません)」を有効にします。

    image2019-7-8_16-3-47

  5. 保存」をクリックします。

    新しく作成されたプロパティをクリックし、「拡張機能のインストールと設定」に進みます。

拡張機能のインストールとセットアップ

Experience Platform Launchで使用可能な拡張機能は、拡張機能/カタログ​に一覧表示されます。

拡張機能をインストールするには、「インストール」をクリックします。必要に応じて、1 回限りの拡張機能の設定を実行し、「保存」をクリックします。

必要に応じて、次の拡張機能をインストールし、設定する必要があります。

  • (必須) Experience CloudIDサービス拡張

追加の設定は必要ありません。提案されたあらゆる値を受け入れます。完了したら、必ず「保存」をクリックします。

詳しくは、Experience Cloud ID サービス拡張機能を参照してください。

  • (必須)Adobe Analytics​拡張機能

この拡張機能を設定するには、Adobe Analyticsの​管理者/レポートスイート​の、レポートスイートID​列見出しの下にあるレポートスイートIDが必要です。

(例として、以下のスクリーンショットでは、 DynamicMediaViewersExtensionDoc​レポートスイートのレポートスイートIDを使用します。 この ID は、以前のレポートスイートの選択で作成および使用されていました)

image2019-7-8_16-45-34

拡張機能のインストールページで、「開発レポートスイート」フィールド、「ステージングレポートスイート」フィールド、「実稼動レポートスイート」フィールドに、レポートスイート ID を入力します。

image2019-7-8_16-47-40

ビデオトラッキングを使用する予定の場合のみ、次の項目を設定します。

拡張機能のインストール​ページで、「一般」を展開し、「トラッキングサーバー」を指定します。トラッキングサーバーはテンプレート <trackingNamespace>.sc.omtrdc.net に従います。<trackingNamespace> は、プロビジョニング電子メールで取得した情報です。

保存」をクリックします。

詳しくは、Adobe Analytics 拡張機能を参照してください。

  • (オプション。ビデオトラッキングが必要な場合のみ必須) Analytics for Audio and Video拡張機能 Adobe Medium

「トラッキングサーバー」フィールドに入力します。Adobe Media Analytics for Audio and Video 拡張機能のトラッキングサーバーは、Adobe Analytics で使用されるトラッキングサーバーとは異なります。これはテンプレート <trackingNamespace>.hb.omtrdc.net に従います。<trackingNamespace> は、プロビジョニング電子メールの情報です。

その他のフィールドはオプションです。

詳しくは、Adobe Media Analytics for Audio and Video 拡張機能を参照してください。

  • (必須)Dynamic Media ビューア​拡張機能

Adobe Analytics for Video を有効にする​を選択して、ビデオハートビートトラッキングを有効(オン)にします。

このドキュメントの作成時点では、 Dynamic Mediaビューア​拡張機能は、開発用にExperience Platform Launchプロパティが作成されている場合にのみ使用できます。

Experience Platform Launchでのプロパティの作成を参照してください。

拡張機能のインストールと設定が完了すると、少なくとも次の 5 つの拡張機能(ビデオをトラッキングしていない場合は 4 つ)が拡張機能/インストール領域に表示されます。

image2019-7-22_12-7-36

データ要素とルールの設定

Experience Platform Launchで、Dynamic Mediaビューアの追跡に必要なデータ要素とルールを作成します。

Experience Platform Launchを使用したトラッキングの概要については、統合でのデータとイベントのトラッキングの仕組みを参照してください。

ビューアの読み込み時にアセット名を追跡する方法を示すExperience Platform Launchのサンプル設定については、 サンプル設定を参照してください。

拡張機能の機能について詳しくは、Dynamic Media ビューア拡張機能の設定を参照してください。

ライブラリの公開

Experience Platform Launchの設定(プロパティ、拡張機能、ルール、データ要素の設定を含む)を変更するには、publish​する必要があります。 「公開」Experience Platform Launchは、プロパティ設定の「公開」タブから実行します。

platform launchには、複数の開発環境、1つのステージング環境、1つの実稼動環境が存在する場合があります。 デフォルトでは、Platform launchのExperience Managerクラウド設定は、Experience ManagerオーサーノードをPlatform launchのステージ環境に指します。 Experience Managerパブリッシュノードが、Platform launchの実稼動環境を指している。 これは、デフォルトのExperience Manager設定では、Platform launchライブラリをステージング環境に公開する必要があることを意味します。 これにより、Experience Manager作成者で使用できます。 その後、実稼動環境にパブリッシュして、Experience Managerのパブリッシュで使用できます。

環境環境について詳しくは、Experience Platform Launchを参照してください。

ライブラリの公開には、次の 2 つの手順を実行します。

  • 必要な変更(新しい変更や更新)をすべてライブラリに含めて、新しいライブラリを追加して構築。
  • 様々な環境レベルでのライブラリの移動(開発からステージングおよび実稼動へ)。

新しいライブラリの追加と構築

  1. 「公開」タブを初めてExperience Platform Launchで開くと、ライブラリリストは空になります。

    左の列で、「新しいライブラリを追加」をクリックします。

    image2019-7-15_14-43-17

  2. 新しいライブラリを作成ページの「名前」フィールドに、新しいライブラリのわかりやすい名前を入力します。例:

    DynamicMediaViewersLib

    「環境」ドロップダウンリストから、環境レベルを選択します。最初は、選択できるのは開発レベルのみです。ページの左下近くにある「変更されたすべてのリソースを追加」をクリックします。

    image2019-7-15_14-49-41

  3. ページの右上隅にある「開発用に保存してビルド」をクリックします。

    数分でライブラリが作成され、使用できる状態になります。

    image2019-7-15_15-3-34

    メモ

    次にExperience Platform Launch設定を変更する場合は、プロパティ​設定の下の「公開」タブに移動し、以前に作成したライブラリをクリックします。

    ライブラリの公開画面で、「変更されたすべてのリソースを追加」をクリックし、「開発用に保存してビルド」をクリックします。

環境レベルでのライブラリの移動

  1. 新しいライブラリが追加されると、開発環境に表示されます。 これをステージング環境レベル(「送信済み」列に対応)に移動するには、ライブラリのドロップダウンメニューで「承認用に送信」をクリックします。

    image2019-7-15_15-52-37

  2. 確認ダイアログボックスで、「送信」をクリックします。

    ライブラリが「送信済み」列に移動した後、ライブラリのドロップダウンメニューで、「ステージング用にビルド」をクリックします。

    image2019-7-15_15-54-37

  3. ステージング環境から実稼動環境(「公開済み」列)にライブラリを移動するには、同様のプロセスに従います。

    まず、ドロップダウンメニューの「公開の承認」をクリックします。

    image2019-7-15_16-7-39

  4. ドロップダウンメニューの「ビルドして実稼動環境に公開」をクリックします。

    image2019-7-15_16-8-9

    Experience Platform Launchでの公開プロセスについて詳しくは、公開を参照してください。

統合のための Adobe Experience Manager の設定

前提条件:

  • AEM は、オーサーインスタンスとパブリッシュインスタンスの両方を実行します。
  • AEMオーサーノードは、Dynamic Media - Scene7実行モード(dynamicmedia_s7)で設定されます。
  • Dynamic Media WCM コンポーネントは AEM Sites で有効になっています。

AEM 設定は、次の 2 つの主な手順で構成されます。

  • AEM IMS の設定。
  • Experience Platform Launchクラウドの設定

AEM IMS の設定

  1. AEM オーサーで、ツールアイコン(ハンマー)をクリックし、セキュリティ/Adobe IMS 設定​をクリックします。

    2019-07-25_11-52-58

  2. Adobe IMC 設定ページの左上隅付近にある「作成」をクリックします。

  3. AdobeIMSテクニカルアカウント設定​ページの「クラウドソリューション」ドロップダウンリストで、「Experience Platform Launch」をクリックします。

  4. 新しい証明書を作成」を有効にし、テキストフィールドに証明書に意味のある値を入力します。例えば、AdobeLaunchIMSCert と入力します。「証明書を作成」をクリックします。

    次の情報メッセージが表示されます。

    有効なアクセストークンを取得するために、新しい証明書の公開鍵がAdobe I/Oのテクニカルアカウントに追加されます。

    [情報]ダイアログボックスを閉じるには、[OK]をクリックします。

    2019-07-25_12-09-24

  5. 公開鍵ファイル(*.crt)をローカルシステムにダウンロードするには、「公開鍵をダウンロード」をクリックします。

    メモ

    この時点で、Adobe IMS テクニカルアカウント設定​ページを​開いたまま​にします。ページは​閉じずに、「次へ」もクリック​しません。このページは、手順の後半で開きます。

    2019-07-25_12-52-24

  6. 新しいブラウザータブで、Adobe I/O コンソールに移動します。

  7. Adobe I/O コンソール統合​ページの右上隅近くにある「新規の統合」をクリックします。

  8. 統合の新規作成​ダイアログボックスで、「API へのアクセス」ラジオボタンが選択されていることを確認し、「続行」をクリックします。

    2019-07-25_13-04-20

  9. 統合の新規作成​の 2 ページ目で、「Experience Platform Launch API」ラジオボタンを有効(オン)にします。ページの右下隅にある「続行」をクリックします。

    2019-07-25_13-13-54

  10. 統合の新規作成​の 3 ページ目で、次の操作をおこないます。

    • 名前」フィールドにわかりやすい名前を入力します。例えば、DynamicMediaViewersIO と入力します。

    • 説明」フィールドに、統合の説明を入力します。

    • 公開鍵証明書」領域に、この手順で以前にダウンロードした公開鍵ファイル(*.crt)をアップロードします。

    • Experience Platform Launch API 用の役割を選択」の見出しの下から「管理者」を選択します。

    • Experience Platform Launch API 用の製品プロファイルを 1 つ以上選択」の見出しの下から、Launch - <your_company_name>​という名前の製品プロファイルを選択します。

    2019-07-25_13-49-18

  11. 統合を作成」をクリックします。

  12. 統合が作成された​ページで、「統合の詳細を続行」をクリックします。

    2019-07-25_14-16-33

  13. 統合の詳細ページが表示されます。​は次のようになります。

    メモ

    この統合の詳細ページは開いたままにします。「概要」タブと「JWT」タブの様々な情報がすぐに必要になります。

    2019-07-25_14-35-30

    統合の詳細ページ.

  14. 前に開いておいた Adobe IMS テクニカルアカウント設定​ページに戻ります。ページの右上隅にある「次へ」をクリックして、Adobe IMS テクニカルアカウント設定​ウィンドウで​アカウント​ページを開きます。

    (前にページを閉じた場合は、Experience Manager作成者に戻り、ツール/セキュリティ/AdobeIMS設定​をクリックします。 「作成」をクリックします。「クラウドソリューション」ドロップダウンリストで、「Experience Platform Launch」を選択します。 「証明書」ドロップダウンリストで、以前に作成した証明書の名前を選択します。)

    2019-07-25_20-57-50

    Adobe IMS テクニカルアカウント設定 - 証明書ページ.

  15. アカウント​ページには5つのフィールドがあり、前の手順の統合の詳細ページから情報を使用して入力する必要があります。

    2019-07-25_20-42-45

    Adobe IMS テクニカルアカウント設定 - アカウントページ.

  16. アカウント​ページで以下のフィールドに入力します。

    • タイトル - 説明的なアカウントのタイトルを入力します。
    • 認証サーバー - 以前に開いた統合の詳細ページに戻ります。「JWT」タブをクリックします。次に示すように、サーバ名(パスなし)をコピーします。

(サーバー名の例は説明用です) アカウント​ページに戻り、その名前を各フィールドに貼り付けます。
例:https://ims-na1.adobelogin.com/(サーバー名の例は説明用です)。

2019-07-25_15-01-53

統合の詳細ページ - 「JWT」タブ

  1. API キー - 統合の詳細ページに戻ります。「概要」タブをクリックし、「API キー(クライアント ID)」フィールドの右にある「コピー」をクリックします。

    アカウント​ページに戻り、キーを各​​フィールドに貼り付けます。

    2019-07-25_14-35-333

    統合の詳細ページ.

  2. クライアントシークレット - 統合の詳細ページに戻ります。「概要」タブで、「クライアントシークレットを取得」をクリックします。「クライアントシークレット」フィールドの右側の「コピー」をクリックします。

    アカウント​ページに戻り、キーを各フィールドに貼り付けます。

  3. ペイロード - 統合の詳細ページに戻ります。「JWT」タブの「JWT ペイロード」フィールドで、JSON オブジェクトコード全体をコピーします。

    アカウント​ページに戻り、コードを各フィールドに貼り付けます。

    2019-07-25_21-59-12

    統合の詳細ページ - 「JWT」タブ

    すべてのフィールドに値が入力されたアカウントページは、次のようになります。

    2019-07-25_22-08-30

  4. アカウント​ページの右上隅にある「作成」をクリックします。

    AEM IMS が設定され、Adobe IMS 設定​に新しい IMSAccount が表示されます。

    image2019-7-15_14-17-54

Experience Platform Launchクラウドの統合の設定

  1. AEMオーサーの左上隅付近で、ツールアイコン(ハンマー)をクリックし、Cloud Services/Experience Platform Launch設定​をクリックします。

    2019-07-26_12-10-38

  2. Experience Platform Launch設定​ページの左側のパネルで、Experience Platform Launch設定を適用するAEMサイトを選択します。

    以下のスクリーンショットでは、We.Retail サイトが選択されています。

    2019-07-26_12-20-06

  3. ページの左上隅近くにある「作成」をクリックします。

  4. Experience Platform Launch設定を作成​ウィンドウの​一般​ページ(1/3ページ)で、次のフィールドに入力します。

    • タイトル - 説明的な設定のタイトルを入力します。例: We.Retail Launch cloud configuration

    • 関連付けられた Adobe IMS 設定 - AEM IMS の設定で前に作成した IMS 設定を選択します

    • 会社 - 「会社」ドロップダウンリストから、Experience Cloud の会社を選択します。リストが自動的に入力されます。

    • プロパティ - 「プロパティ」ドロップダウンリストから、以前に作成したExperience Platform Launchプロパティを選択します。リストが自動的に入力されます。

    すべてのフィールドに入力すると、一般​ページは次のようになります。

    image2019-7-15_14-34-23

  5. 左上隅近くにある「次へ」をクリックします。

  6. Experience Platform Launch設定を作成​ウィンドウの​ステージング​ページ(2/3ページ)で、次のフィールドに入力します。

    Experience Platform LaunchURI」フィールドで、ライブラリライブラリのステージングバージョンの場所を確認します。 AEM はこのフィールドに自動的に入力します。

    説明の目的でのみ、この手順では、Experience Platform LaunchCDNにデプロイされるAdobeライブラリを使用します。

    メモ

    自動入力されたライブラリ URI(Uniform Resource Identifier)の形式に誤りがないか確認します。必要に応じて、URI がプロトコル相対 URI を表すように修正します。つまり、ダブルスラッシュから始まります。

    例://assets.adobetm.com/launch-xxxx

    ステージング​ページは、次のように表示されます。 アーカイブ​と​非同期でライブラリを読み込む​オプションは、設定​ではありません。

    image2019-7-15_15-21-8

  7. 右上隅近くにある「次へ」をクリックします。

  8. Experience Platform Launch設定を作成​ウィンドウの​実稼動​ページ(3/3ページ)で、必要に応じて、前の​ステージング​ページでおこなったのと同様に、自動入力された実稼動URIを修正します。

  9. 右上隅近くにある「作成」をクリックします。

    新しいExperience Platform Launchクラウド設定が作成され、Webサイトの横に次の例のように表示されます。

  10. 新しいExperience Platform Launchクラウド設定を選択します(設定タイトルを選択すると、設定タイトルの左側にチェックマークが表示されます)。 ツールバーの「公開」をクリックします。

    image2019-7-15_15-47-6

現在、AEMオーサーは、Dynamic MediaビューアとExperience Platform Launchの統合をサポートしていません。

ただし、パブリッシュノードではサポートされているExperience Managerです。 platform launchクラウド設定のデフォルト設定を使用して、Experience Manager公開ノードはExperience Platform Launchの実稼動環境を使用します。 そのため、テスト中は毎回、Experience Platform Launchライブラリの更新を開発環境から実稼動環境にプッシュする必要があります。

この制限を回避できます。 上記のPlatform launchパブリッシュノードのPlatform launchクラウド設定で、Experience Managerライブラリの開発URLまたはステージングURLを指定します。 これにより、Experience Managerパブリッシュノードは、開発またはステージングバージョンのPlatform launchライブラリを使用します。

Experience Platform Launchクラウド設定の設定について詳しくは、Via Adobe I/Oを使用したAEMとExperience Platform Launchの統合を参照してください。

このページ