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

Dynamic MediaビューアとAdobe AnalyticsおよびExperience Platform Launchの統合について教えてください。

新しい​Dynamic Mediaビューア Platform launchビューアおよびDynamic Mediaビューア5.13の拡張機能により、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統合は、従来のビューアのAnalytics統合と同時に(config2=パラメーターを介して)使用することはできません。
  • ビデオトラッキングのサポートは、トラッキングの概要で説明されているように、「コア再生」のトラッキングのみに制限されます。 具体的には、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からExperience Platform Launchライブラリの実稼働URLを取得し、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ビューア拡張機能は、データ要素の値を自動的に最新の状態に保ちます。

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

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

Experience Platform Launchのルールについて

Experience Platform Launchのルールは不可知の設定で、ルールを構成する3つの領域を定義します。イベント条件アクション:

  • イベント (if)は、ルールをトリガーするタイミングをExperience Platform Launchに伝えます。
  • 条件 (if)は、ルールのトリガー時に他のどの制限を許可または許可しないかをExperience Platform Launchに伝えます。
  • アクション (次に)は、ルールがトリガーされた場合に実行する操作を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設定とExperience Platform Launchクラウド設定を作成する必要があります。

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

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

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

Adobe Analyticsの設定Experience Platform Launchの設定の節の設定手順を実行します。 ただし、Experience Manager関連の設定手順は必要ありません。

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

Experience Platform Launchライブラリの埋め込みコードの使用方法について詳しくは、追加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 MediaViewer拡張機能は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 を有効にする​です。

このオプションをオン(有効)にした場合に、オーディオおよびビデオ用のAdobe MediumのAnalyticsの拡張機能がインストールされ、設定されると、ビデオ再生指標がAdobe Analyticsに送信され、オーディオおよびビデオソリューションが使用されます。 このオプションを無効にすると、ビデオトラッキングがオフになります。

Adobe Mediumのオーディオおよびビデオ用のAnalytics拡張機能がインストールされていない状態で​このオプションを有効にした場合、このオプションは無効です。

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​イベントを送信するまで空のままです。

同様に、ビューアがページ上の対応するイベントを送信すると、データ要素の値は自動的に更新されます。値の更新は、特定のイベントがルール設定で指定されていない場合でもおこなわれます。例えば、データ要素​ZoomScale​がZOOMイベントの「scale」パラメータに定義されているとします。 ただし、ルール設定に存在する唯一のルールは、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 ルールには、次の情報が含まれます。

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

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

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

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

上記のサンプル設定は、データ要素の値の寿命にも影響します。Dynamic Mediaビューアで管理されるデータ要素の値は、ビューア自体が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」トリガーがどのイベントに属していてもかまいません。ルールをトリガーするイベントは、動的ビューアとは無関係の場合があります。 例えば、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 と統合するために必要な設定手順について説明します。Experience Platform Launchの他の目的でDynamic Mediaビューア拡張機能を使用することは可能ですが、このドキュメントではそのようなシナリオについては説明しません。

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

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

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

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

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

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

    新しいカスタムトラフィック変数を有効にするには、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の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つの実稼動環境が存在する可能性があります。 デフォルトでは、Experience ManagerのPlatform launchクラウド設定は、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 authorノードは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設定​をクリックします。 「作成」をクリックします。Cloud Solution​ドロップダウンリストで、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 authorで、左上隅近くにあるツールアイコン(ハンマー)をクリックし、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ページ)で、次のフィールドに入力します。

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

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

    メモ

    自動入力されたライブラリ 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 authorは、Dynamic MediaビューアとExperience Platform Launchの統合をサポートしていません。

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

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

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

このページ

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now