Dynamic Media ViewersとAdobe AnalyticsおよびExperience Platformタグの統合

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

Dynamic Media ViewerExtension for Experience Tags and Dynamic Media Viewers 5.13を使用すると、Adobe AnalyticsおよびExperience Platformタグのお客様は、Experience Platformタグ設定でDynamic Mediaビューア固有のイベントとデータを使用できます。

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

Adobe拡張機能またはサードパーティ拡張機能について詳しくは、『Experience Platformタグユーザーガイド』の「Adobe拡張機能」を参照してください。

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

統合の制限

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

統合の事例

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

Experience ManagerサイトでのDynamic Mediaビューアの追跡を参照してください。

統合の 2 番目の事例は、Experience Manager Assets のみ、または Dynamic Media Classic を使用する顧客です。その場合、ビューアの埋め込みコードを取得して、Web サイトページに追加します。次に、Experience PlatformタグからExperience Platformタグライブラリ実稼動用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タグでは、データ要素​と​ルール​の概念が連携して、Adobe Analyticsトラッキングを有効にします。

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

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

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

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

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

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

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

タグタグのルールについてExperience Platform

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

  • イベント (if)は、Experience Platformタグにルールをトリガーするタイミングを伝えます。
  • 条件 (if)は、Experience Platformタグに、ルールのトリガー時に許可または禁止する他の制限を通知します。
  • アクション (then)は、Experience Platformタグに、ルールがトリガーされた場合の処理を伝えます。

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

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

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

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

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

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

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

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

サンプル設定

以下のタグタグ内のサンプルExperience Platformで、ビューアの読み込み時にアセット名を追跡する方法を示します。

  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 Viewers拡張機能の使用

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

Experience ManagerサイトでのDynamic Mediaビューアの追跡

Experience ManagerサイトでDynamic Mediaビューアを追跡するには、 すべての統合ピースの設定の節に示す手順をすべて実行する必要があります。 特に、IMS設定とタグクラウド設定をExperience Platformする必要があります。

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

埋め込みコードを使用したDynamic Mediaビューアの追跡

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

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

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

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

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

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

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

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

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

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

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

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

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

Dynamic Media Viewers拡張機能の設定

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

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

Adobe Media 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 ビューアイベントによってトリガーされたルール内でデータ要素が要求された場合、ルールを開始したビューアに対してデータ要素の値が返されます。また、データ要素は、他のイベントタグ拡張機能からイベントによってトリガーされたルール内でExperience Platformされます。 この時点で、データ要素の値は、このデータ要素を最後に更新したビューアから取得されます。

次の設定例を考えてみましょう

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

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

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

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

    • CoreExperience Platformタグ拡張のkey pressイベントをトリガーとして使用します。
    • 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ページに配置された後でも、Experience Platformタグライブラリコードに保存されます。 つまり、Dynamic Media 以外のビューアの拡張によってトリガーされるルールがあり、そのようなデータ要素を参照する場合、データ要素は最後に認識された値を返します。これには、ビューアが Web ページに存在しなくなった場合も含みます。

いずれの場合も、Dynamic Mediaビューアによって駆動されるデータ要素の値は、ローカルストレージやサーバーには保存されません。代わりに、クライアント側のタグライブラリにのみExperience Platformされます。 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%

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

始める前に

アドビでは、この節の前にドキュメントを十分に見直し、統合について完全に理解することをお勧めします。

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

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

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

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

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

設定の一環として、Adobe AnalyticsタグとExperience Platformタグが既に有効になっている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タグの設定

Experience Platformタグを設定した後、統合に対して次の設定がおこなわれます。

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

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

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

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

    image2019-7-8_15-38-44

タグでのプロパティのExperience Platform

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

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

  1. 「Experience Platformタグ」で、「新しいプロパティ」を選択します。

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

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

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

    image2019-7-8_16-3-47

  5. 保存」を選択します。

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

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

Experience Platformタグで使用可能な拡張機能は、Extensions > Catalog​に一覧表示されます。

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

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

  • (必須)Experience Cloud ID サービス​拡張機能。

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

Adobe 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> は、プロビジョニング電子メールの情報です。

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

Analytics for Audio and Video拡張機能を参照してください。

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

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

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

Experience Platformタグでプロパティを作成するを参照してください。

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

image2019-7-22_12-7-36

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

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

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

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

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

ライブラリの公開

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

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

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

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

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

新しいライブラリの追加とビルド

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

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

    image2019-7-15_14-43-17

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

    DynamicMediaViewersLib

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

    image2019-7-15_14-49-41

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

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

    image2019-7-15_15-3-34

    メモ

    次回Experience Platformタグの設定を変更する際に、プロパティ​設定の下の「公開」タブに移動し、以前に作成したライブラリを選択します。

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

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

  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タグでの公開プロセスについて詳しくは、公開を参照してください。

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

前提条件:

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

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

  • Experience Manager IMS の設定。
  • Experience Platformタグクラウドの設定

Experience ManagerIMSの設定

  1. Experience Manager作成者で、ツール​アイコン(ハンマー)を選択し、セキュリティ / Adobe IMS設定​に移動します。

    2019-07-25_11-52-58

  2. AdobeIMC設定ページの左上隅付近で、「作成」を選択します。

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

  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タグAPI」ラジオボタンを有効(オン)にします。 ページの右下隅にある「続行」を選択します。

    2019-07-25_13-13-54

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

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

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

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

    • 「Experience PlatformタグAPI の役割を選択」の見出しの下で、「​管理者​」を選択します。

    • Experience PlatformタグAPI​用の1つ以上の製品プロファイルを選択」の見出しの下で、「Tags - <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作成者に戻り、ツール / セキュリティ / Adobe IMS設定​に移動します。 「作成」を選択します。「クラウドソリューション」ドロップダウンリストで、「Experience Platformタグ」を選択します。 「証明書」ドロップダウンリストで、以前に作成した証明書の名前を選択します。)

    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. アカウント​ページの右上隅近くにある「作成」を選択します。

    Experience Manager IMS が設定され、Adobe IMS 設定​に新しい IMS アカウントが表示されます。

    image2019-7-15_14-17-54

統合用のExperience Platformタグクラウドの設定

  1. Experience Manager作成者の左上隅付近で、ツール​アイコン(ハンマー)を選択し、Cloud Services /Experience Platformタグ設定​に移動します。

    2019-07-26_12-10-38

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

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

    2019-07-26_12-20-06

  3. ページの左上隅付近にある「作成」を選択します。

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

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

    • 関連するAdobe IMS設定 -Experience ManagerIMSの設定で前に作成したIMS設 定を選択します

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

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

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

    image2019-7-15_14-34-23

  5. 左上隅付近で、「次へ」を選択します。

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

    Experience PlatformURI(Uniform Resource Identifier)」フィールドで、ライブラリタグライブラリのステージングバージョンの場所を確認します。 Experience Manager によってこのフィールドに自動的に入力されます。

    例えば、この手順では、Experience PlatformCDNにデプロイされるAdobeタグライブラリを使用します。

    メモ

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

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

    ステージング​ページは次のようになります。「アーカイブ」オプションと「ライブラリを非同期にロード」オプションは設定されて​いません

    image2019-7-15_15-21-8

  7. 右上隅付近にある「次へ」を選択します。

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

  9. 右上隅付近にある「作成」を選択します。

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

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

    image2019-7-15_15-47-6

現在、Experience Manager作成者は、Dynamic MediaビューアとExperience Platformタグの統合をサポートしていません。

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

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

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

このページ