Dynamic Media ビューアと Adobe Analytics および Experience Platform タグとの統合 integrating-dynamic-media-viewers-with-adobe-analytics-and-adobe-launch
Dynamic Media ビューアと Adobe Analytics および Experience Platform タグとの統合とは? what-is-dynamic-media-viewers-integration-with-adobe-analytics-and-adobe-launch
Experience Platform タグおよび Dynamic Media Viewers 5.13 用の Dynamic Media ビューア 拡張機能によって、Adobe Analytics および Experience Platform タグのユーザーは、Experience Platform タグの設定で Dynamic Media ビューアーに固有のイベントやデータを使用することができます。
この統合により、Adobe Analytics を使用して、Web サイト上での Dynamic Media ビューアの使用状況を追跡できます。それと同時に、ビューアで公開されたイベントやデータを、アドビまたはサードパーティの他の Experience Platform タグ拡張機能で使用することもできます。
アドビまたはサードパーティの拡張機能について詳しくは、Experience Platform タグユーザーガイドのアドビの拡張機能を参照してください。
このトピックは、 サイト管理者、Experience Platform での開発者および運用担当者を対象としています。
統合の制限 limitations-of-the-integration
- Dynamic Media ビューアの Experience Platform タグ統合は、Experience Manager オーサーノードでは機能しません。公開されるまで、WCM ページからのトラッキングを表示することはできません。
- Dynamic Media ビューアの Experience Platform タグ統合は、「ポップアップ」操作モードではサポートされません。このモードでは、ビューア URL は、アセットの詳細ページの「URL」ボタンを使用して取得します。
- Experience Platform タグ統合は、(
config2=
パラメーターを介して)従来のビューアの Analytics 統合と同時に使用することはできません。 - ビデオトラッキングのサポートは、トラッキングの概要で説明されているように、「コア再生」トラッキングのみに制限されます。具体的には、QoS、広告、チャプター/セグメント、エラーのトラッキングはサポートされていません。
- データ要素のストレージデュレーション設定は、Dynamic Media ビューア 拡張機能を使用したデータ要素ではサポートされません。ストレージデュレーションは None に設定する必要があります。
統合の事例 use-cases-for-the-integration
Experience Platform タグとの統合の主なユースケースは、Adobe Experience Manager Assets と Adobe Experience Manager Sites の両方を使用する顧客です。このようなシナリオでは、Experience Manager のオーサーノードと Experience Platform タグの間に標準的な統合を設定し、Sites インスタンスを Experience Platform タグプロパティに関連付けることができます。その後、Site ページに追加された Dynamic Media WCM コンポーネントは、ビューアのデータとイベントを追跡します。
Experience Manager Sites での Dynamic Media ビューアのトラッキングを参照してください。
統合の 2 番目の事例は、Experience Manager Assets のみ、または Dynamic Media Classic を使用する顧客です。その場合、ビューアの埋め込みコードを取得して、Web サイトページに追加します。次に、Experience Platform タグから Experience Platform タグライブラリの実稼動用 URL を取得し、web ページのコードに手動で追加します。
埋め込みコードを使用した Dynamic Media ビューアのトラッキングを参照してください。
統合でのデータとイベントのトラッキングの仕組み how-data-and-event-tracking-works-in-the-integration
この統合では、Adobe Analytics と Adobe Analytics for Audio and Video という、2 種類の独立したタイプの Dynamic Media ビューアのトラッキングを利用します。
Adobe Analytics を使用したトラッキングについて about-tracking-using-adobe-analytics
Adobe Analytics を使用すると、エンドユーザーが Web サイト上で Dynamic Media ビューアとやり取りしたときに実行したアクションを追跡できます。また、Adobe Analytics では、ビューア固有のデータも追跡できます。例えば、ビューの読み込みイベントを、アセット名や、発生したズーム操作、ビデオ再生操作などと共に追跡して記録できます。
Experience Platform タグでは、データ要素 と ルール の概念を組み合わせて、Adobe Analytics のトラッキングを有効にします。
Experience Platform タグのデータ要素について about-data-elements-in-adobe-launch
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 タグのルールについて about-rules-in-adobe-launch
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 拡張機能から得られます。
詳しくは、ルールを参照してください。
サンプル設定 sample-configuration
以下の Experience Platform タグのサンプル設定は、ビューアの読み込み時にアセット名を追跡する方法を示します。
-
「データ要素」タブで、Dynamic Media ビューア拡張機能から
LOAD
イベントのasset
パラメーターを参照するデータ要素AssetName
を定義します。 -
「ルール」タブで、ルール TrackAssetOnLoad を定義します。
このルールでは、「イベント」フィールドは、Dynamic Media ビューア拡張機能の LOAD イベントを使用します。
-
アクション設定には、Adobe Analytics 拡張機能の 2 つのアクションタイプがあります。
変数設定 は、選択した分析変数を
AssetName
データ要素の値にマップします。ビーコン送信 は、Adobe Analytics にトラッキング情報を送信します。
-
ルール設定結果は次のようになります。
Adobe Analytics for Audio and Video について about-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 ビューア拡張機能の使用 using-the-dynamic-media-viewers-extension
「統合の事例」で説明したように、Experience Manager Sites の新規 Experience Platform タグ統合では、埋め込みコードを使用して Dynamic Media ビューアを追跡できます。
Experience Manager Sites での Dynamic Media ビューアのトラッキング tracking-dynamic-media-viewers-in-aem-sites
Experience Manager Sites で Dynamic Media ビューアを追跡するには、すべての統合ピースの設定で説明している手順をすべて実行する必要があります。具体的には、IMS 設定と Experience Platform タグクラウド設定を作成する必要があります。
適切な設定に従い、Dynamic Media でサポートされる WCM コンポーネントを使用して Sites ページに追加した Dynamic Media ビューアは、Adobe Analytics、Adobe Analytics for Video、またはその両方のデータを自動的に追跡します。
埋め込みコードを使用した Dynamic Media ビューアのトラッキング tracking-dynamic-media-viewers-using-embed-code
Experience Manager Sites を使用していない、または Experience Manager Sites 以外の web ページに Dynamic Media ビューアを埋め込んでいる、またはその両方に該当するお客様は、引き続き Experience Platform タグ統合を使用できます。
Adobe Analytics の設定および Experience Platform タグの設定の設定手順を実行してください。ただし、Experience Manager 関連の設定手順は不要です。
適切に設定すれば、Dynamic Media ビューアを使用した web ページに Experience Platform タグサポートを追加できます。
Experience Platform タグライブラリの埋め込みコードの使用方法について詳しくは、Experience Platform タグの埋め込みコードの追加を参照してください。
埋め込みコードを使用した Dynamic Media ビューアのトラッキング:
- Dynamic Media ビューアを埋め込む web ページを準備します。
- まず、Experience Platform タグにログインして、Experience Platform タグライブラリの埋め込みコードを取得します(Experience Platform タグの設定を参照)。
- 「プロパティ」を選択したあと、「環境」タブを選択します。
- web ページの環境に関連する環境レベルを取得します。次に、「インストール」列のボックスアイコンを選択します。
- Web インストール手順 ダイアログボックスで、Experience Platform タグライブラリの埋め込みコード全体と、それを囲む
<script/>
タグをコピーします。
Dynamic Media ビューア拡張機能リファレンスガイド reference-guide-for-the-dynamic-media-viewers-extension
Dynamic Media ビューアの設定について about-the-dynamic-media-viewers-configuration
次の条件のすべてに当てはまる場合、Dynamic Media ビューアの拡張機能は Experience Platform タグライブラリと自動的に統合されます。
-
Experience Platform タグライブラリのグローバルオブジェクト(
_satellite
)がページに存在する。 -
Dynamic Media ビューア拡張機能の
_dmviewers_v001()
関数が、_satellite
で定義されている。 -
config2=
ビューアパラメーターが指定されていない。つまり、ビューアが従来の Analytics 統合を使用していない。
また、ビューアの設定で launch=0
パラメーターを指定して、ビューアで Experience Platform タグの統合を明示的に無効にするオプションもあります。このパラメーターのデフォルト値は 1
です。
Dynamic Media ビューア拡張機能の設定 configuring-the-dynamic-media-viewers-extension
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 拡張機能をインストール せずに このオプションを有効にしても、このオプションは無効です。
Dynamic Media ビューア拡張機能のデータ要素について about-data-elements-in-the-dynamic-media-viewers-extension
Dynamic Media ビューア拡張機能で提供されるデータ要素タイプは、「データ要素タイプ」ドロップダウンリストの ビューアイベント のみです。
選択すると、データ要素エディターは、次の 2 つのフィールドを含むフォームをレンダリングします。
- DM ビューアイベントデータタイプ - 引数を持つ Dynamic Media ビューア拡張機能でサポートされるすべてのビューアイベントと、特別な COMMON 項目を識別するドロップダウンリスト。COMMON 項目は、ビューアから送信されるすべてのタイプのイベントに共通するイベントパラメーターのリストを表します。
- トラッキングパラメーター- - 選択した Dynamic Media ビューアイベントの引数。
各ビューアタイプでサポートされるイベントのリストを照会するには、Dynamic Media ビューアリファレンスガイドを参照し、特定のビューアセクションに移動してサブセクションの「Adobe Analytics トラッキングのサポート」を選択します。現在、Dynamic Media ビューアリファレンスガイドには、イベント引数は記載されていません。
次に、Dynamic Media ビューアの データ要素 のライフサイクルを考えてみましょう。このようなデータ要素の値は、対応する Dynamic Media ビューアイベントがページで発生した後に入力されます。例えば、データ要素が LOAD イベントとその「asset」引数を指しているとします。このような場合、データ要素の値は、ビューアが初めて LOAD イベントを実行した後に有効なデータを受け取ります。データ要素が ZOOM イベントとその「scale」引数を指している場合、このようなデータ要素の値は、ビューアが初めて ZOOM イベントを送信するまで空のままです。
同様に、ビューアがページ上の対応するイベントを送信すると、データ要素の値は自動的に更新されます。値の更新は、特定のイベントがルール設定で指定されていない場合でも行われます。例えば、ZOOM イベントの「スケール」パラメーターに、データ要素 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 ルールには、次の情報が含まれます。
- Core Experience Platform タグ拡張機能のキー押下イベントをトリガーとして使用。
- 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 ページにビューア自体が配置された後でも、Experience Platform タグライブラリコードに保存されます。つまり、Dynamic Media 以外のビューアの拡張によってトリガーされるルールがあり、そのようなデータ要素を参照する場合、データ要素は最後に認識された値を返します。これには、ビューアが web ページに存在しなくなった場合も含みます。
いずれの場合も、Dynamic Media ビューアによって駆動されるデータ要素の値は、ローカルストレージやサーバーに保存されず、クライアント側の Experience Platform タグライブラリにのみ保存されます。web ページがリロードされると、このようなデータ要素の値は消去されます。
一般に、データ要素エディターでは、ストレージ期間の選択がサポートされます。ただし、Dynamic Media ビューア拡張機能を使用するデータ要素では、ストレージ期間「なし」オプションのみがサポートされます。その他の値はユーザーインターフェイスで設定可能ですが、この場合、データ要素の動作は定義されていません。拡張機能は、データ要素の値を独自に管理します。データ要素は、ビューアのライフサイクル全体でビューアのイベント引数の値を維持します。
Dynamic Media ビューア拡張機能のルールについて about-rules-in-the-dynamic-media-viewers-extension
ルールエディターで、イベントエディターの新しい設定オプションが追加されます。また、エディターには、事前に設定されたデータ要素を使用する代わりに、アクションエディターでイベントパラメーターを手動で参照する簡略オプションも用意されています。
イベントエディターについて about-the-events-editor
Dynamic Media ビューア拡張機能によって、イベントエディターで ビューアイベント と呼ばれる イベントタイプ が追加されます。
選択すると、イベントエディターによって「Dynamic Media ビューアイベント」ドロップダウンがレンダリングされ、Dynamic Media ビューアでサポートされる使用可能なイベントがすべて表示されます。
アクションエディターについて about-the-actions-editor
Dynamic Media ビューア拡張機能を使用すると、Dynamic Media ビューアのイベントパラメーターを使用して、Adobe Analytics 拡張機能の変数設定エディターで分析変数にマッピングできます。
最も簡単な方法は、次の 2 つの手順を実行することです。
- まず、1 つ以上のデータ要素を定義します。各データ要素は、Dynamic Media ビューアイベントのパラメーターを表します。
- 最後に、Adobe Analytics 拡張機能の変数設定エディターで、データ要素 ピッカーアイコン(3 つの重なったディスク)を選択し、データ要素選択ダイアログボックスを開き、データ要素を選択します。
ただし、別の方法を使用して、データ要素の作成をスキップすることは可能です。引数は、Dynamic Media ビューアイベントから直接参照できます。Analytics 変数の割り当ての「値」入力フィールドに、イベント引数の完全修飾名を入力します。必ずパーセント記号(%)で囲むようにしてください。例:
%event.detail.dm.LOAD.asset%
データ要素を使用する場合と、直接イベント引数の参照を使用する場合では、重要な違いがあることに注意してください。データ要素の場合、変数の設定アクションをどのイベントがトリガーしたかは関係ありません。ルールをトリガーするイベントは、Dynamic Viewer に関連させる必要はありません。例えば、コア拡張機能から web ページを選択します。ただし、直接引数参照を使用する場合は、ルールをトリガーするイベントが、参照するイベント引数に対応していることを確認することが重要です。
例えば、%event.detail.dm.LOAD.asset%
の参照は、ルールが Dynamic Media ビューア拡張機能の LOAD イベントによってトリガーされる場合、正しいアセット名を返します。ただし、他のイベントの場合は空の値を返します。
次の表に、Dynamic Media ビューアイベントと、サポートされている引数を示します。
すべての統合ピースの設定 configuring-all-the-integration-pieces
始める前に
アドビでは、この節の前にドキュメントを十分に見直し、統合について完全に理解することをお勧めします。
ここでは、Dynamic Media ビューアを Adobe Analytics および Adobe Analytics for Audio and video と統合するために必要な設定手順について説明します。Dynamic Media ビューア拡張機能を Experience Platform タグの他の目的で使用することは可能ですが、このドキュメントではそのようなシナリオは扱っていません。
次のアドビ製品を使用して統合を設定します。
- Adobe Analytics - トラッキング変数とレポートを設定します。
- Experience Platform タグ - ビューアトラッキングを有効にするプロパティ、1 つ以上のルールおよび 1 つ以上のデータ要素を定義します。
また、この統合ソリューションを Experience Manager Sites で使用する場合は、次の設定を行う必要があります。
- Adobe Developer Console - Experience Platform タグ用に統合が作成されます。
- Experience Manager オーサーノード - IMS 設定と Experience Platform タグクラウド設定。
設定の一環として、Adobe Analytics と Experience Platform タグが既に有効になっている Adobe Experience Cloud の会社にアクセスできることを確認してください。
統合のための Adobe Analytics の設定 configuring-adobe-analytics-for-the-integration
Adobe Analytics を設定した後、統合のために次の設定が行われます。
- レポートスイートが配置され、選択される。
- Analytics 変数がトラッキングデータを受け取るために使用可能になる。
- Adobe Analytics 内で収集されたデータを表示するレポートが使用可能になる。
Analytics 導入ガイドも参照してください。
統合のために Adobe Analytics を設定するには:
-
まず、Experience Cloud ホームページから Adobe Analytics にアクセスします。メニューバーで、ページの右上隅付近にある「ソリューション」アイコン(3 x 3 のドットテーブル)を選択し、「Analytics」を選択します。
次に、レポートスイートを選択します。
レポートスイートの選択 selecting-a-report-suite
-
Adobe Analytics ページの右上隅近くの「レポートの検索」フィールドの右側にあるドロップダウンリストから、適切なレポートスイートを選択します。複数のレポートスイートが使用可能で、どれを使用するか不明な場合は、Adobe Analytics 管理者が使用するレポートスイートを選択するのに役立ちます。
下のスクリーンショットでは、ユーザーが DynamicMediaViewersExtensionDoc という名前のレポートスイートを作成し、ドロップダウンリストから選択しています。レポートスイート名は一例です。最終的に選択するレポートスイート名は、ユーザーが決定できます。
使用できるレポートスイートがない場合は、設定を続行する前に、ユーザーまたは Adobe Analytics 管理者がレポートスイートを作成する必要があります。
レポートとレポートスイートおよびレポートスイートの作成を参照してください。
Adobe Analytics では、管理者/レポートスイート でレポートスイートを管理します。
次に、Adobe Analytics 変数を設定します。
Adobe Analytics 変数の設定 setting-up-adobe-analytics-variables
-
web ページ上の Dynamic Media ビューアの動作を追跡するために使用する、1 つ以上の Adobe Analytics 変数を指定します。
Adobe Analytics でサポートされている任意のタイプの変数を使用できます。変数のタイプ(カスタムトラフィック [props] や、コンバージョン [eVar] など)は、Analytics 実装の具体的なニーズに応じて決めます。
prop と eVar の概要を参照してください。
このドキュメントでは、カスタムトラフィック(prop)変数のみを使用します。これは、web ページでアクションが発生した場合、数分以内に Analytics レポートで使用できるようになるためです。
新しいカスタムトラフィック変数を有効にするには、Adobe Analytics のツールバーで、管理者/レポートスイート に移動します。
-
レポートスイート管理 ページで正しいレポートを選択し、ツールバーで 設定を編集/トラフィック/トラフィック変数 に移動します。
-
使用されていない変数を選択し、わかりやすい名前(ビューアアセット(prop 30))を付けて、「有効」列のコンボボックスを「有効」に変更します。
次のスクリーンショットは、ビューアが使用するアセット名を追跡するためのカスタムトラフィック変数(prop30)の例です。
-
変数リストの下部で、「保存」を選択します。
レポートの設定 setting-up-a-report
-
一般に、Adobe Analytics でのレポートの設定は、特定のプロジェクトのニーズに左右されます。したがって、詳細なレポート設定は、この統合の範囲外です。
ただし、Adobe Analytics 変数の設定でカスタムトラフィック変数を設定すると、カスタムトラフィックレポートが Adobe Analytics で自動的に使用可能になることを知っていれば十分です。
例えば、ビューアアセット(prop 30) 変数のレポートは、カスタムトラフィック/カスタムトラフィック 21~30/ビューアアセット(prop 30) 下のレポートメニューから使用できます。
ビューアアセット(prop 30) を作成した直後にこのレポートを表示すると、データが表示されません。これは、統合のこの時点で予想されることです。
統合用の Experience Platform タグの設定 configuring-adobe-launch-for-the-integration
Experience Platform タグを設定した後、統合のために次の設定が行われます。
- すべての設定をまとめるための新しいプロパティの作成。
- 拡張機能のインストールとセットアップ。プロパティにインストールされたすべての拡張機能のクライアント側コードは、1 つのライブラリにまとめられる。このライブラリは後で web ページで使用されます。
- データ要素とルールの設定。この設定は、Dynamic Media ビューアから取得するデータ、トラッキングロジックをトリガーするタイミング、Adobe Analytics でビューアのデータを送信する場所を定義するものです。
- ライブラリの公開。
Experience Platform タグを統合用に設定するには:
-
まず、Experience Cloud のホームページから Experience Platform タグにアクセスします。メニューバーで、ページの右上隅付近にある「ソリューション」アイコン(3 x 3 のドットテーブル)を選択し、「タグ」を選択します。
また、Experience Platform タグを直接開くこともできます。
Experience Platform タグでのプロパティの作成 creating-a-property-in-adobe-launch
Experience Platform タグのプロパティは、すべての設定をまとめた名前付きの設定です。構成設定のライブラリが様々な環境レベル(開発、ステージングおよび実稼動)で生成され、公開されます。
「タグプロパティの作成」も参照してください。
-
Experience Platform タグで「新しいプロパティ」を選択します。
-
プロパティを作成 ダイアログボックスの「名前」フィールドに、Web サイトのタイトルなど、わかりやすい名前を入力します。例:
DynamicMediaViewersProp.
-
「ドメイン」フィールドに、Web サイトのドメインを入力します。
-
使用したい拡張機能(この場合は ダイナミックメディアビューア)がまだリリースされていない場合、詳細オプション ドロップダウンで、拡張機能の開発用に設定(後で変更できません) を有効にします。
-
「保存」を選択します。
新しく作成されたプロパティを選択し、拡張機能のインストールとセットアップ に進みます。
拡張機能のインストールとセットアップ installing-and-setup-of-extensions
Experience Platform タグで使用可能なすべての拡張機能は、 拡張機能/カタログ に一覧表示されます。
拡張機能をインストールするには、「インストール」を選択します。必要に応じて、1 回限りの拡張機能の設定を実行し、「保存」を選択します。
必要に応じて、次の拡張機能をインストールし、設定する必要があります。
- (必須)Experience Cloud ID サービス 拡張機能。
追加の設定は必要ありません。提案されたあらゆる値を受け入れます。完了したら、必ず「保存」を選択します。
詳しくは、Adobe Experience Cloud ID サービス拡張機能を参照してください。
- (必須)Adobe Analytics 拡張機能
この拡張機能を設定するには、Adobe Analytics の 管理者/レポートスイート の「レポートスイート ID」列見出しにあるレポートスイート ID が必要です。
(以下のスクリーンショットでは、デモンストレーションのみを目的として、DynamicMediaViewersExtensionDoc レポートスイートのレポートスイート ID を使用しています。この ID は、以前の レポートスイートの選択で作成および使用されていました)
拡張機能のインストールページで、「開発レポートスイート」フィールド、「ステージングレポートスイート」フィールド、「実稼動レポートスイート」フィールドに、レポートスイート ID を入力します。
ビデオトラッキングを使用する予定の場合のみ、次の項目を設定します。
拡張機能のインストール ページで、「一般」を展開し、「トラッキングサーバー」を指定します。トラッキングサーバーはテンプレート <trackingNamespace>.sc.omtrdc.net
に従います。<trackingNamespace>
は、プロビジョニングメールで取得した情報です。
「保存」を選択します。
詳しくは、Adobe Analytics 拡張機能を参照してください。
- (オプション:ビデオトラッキングが必要な場合のみ)オーディオおよびビデオ用 Adobe Media Analytics 拡張機能
「トラッキングサーバー」フィールドに入力します。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 タグプロパティが開発用に作成されている場合にのみ使用できます。
Experience Platform タグでのプロパティの作成を参照してください。
拡張機能のインストールと設定が完了すると、少なくとも次の 5 つの拡張機能(ビデオをトラッキングしていない場合は 4 つ)が拡張機能/インストール領域に表示されます。
データ要素とルールの設定 setting-up-data-elements-and-rules
Experience Platform タグで、Dynamic Media ビューアのトラッキングに必要なデータ要素とルールを作成します。
Experience Platform タグを使用したトラッキングの概要については、統合でのデータとイベントのトラッキングの仕組みを参照してください。
ビューアの読み込み時にアセット名を追跡する方法を示す Experience Platform タグのサンプル設定については、サンプル設定を参照してください。
拡張機能の機能について詳しくは、Dynamic Media ビューア拡張機能の設定を参照してください。
ライブラリの公開 publishing-a-library
Experience Platform タグの設定(プロパティ、拡張機能、ルール、データ要素の設定を含む)を変更するには、変更を 公開 する必要があります。Experience Platform タグでの公開は、プロパティ設定の「公開」タブから実行します。
Experience Platform タグには、複数の開発環境、1 つのステージング環境、1 つの実稼動環境が存在する場合があります。Experience Manager の Experience Platform タグクラウド設定では、Experience Manager のオーサーノードはデフォルトで Experience Platform タグのステージング環境を指します。Experience Manager のパブリッシュノードは、Experience Platform タグの実稼動環境を指します。これは、デフォルトの Experience Manager 設定では、Experience Platform タグライブラリをステージング環境に公開する必要があることを意味します。これにより、ライブラリを Experience Manager オーサーで使用できるようになります。その後、実稼動環境に公開することで、Experience Manager のパブリッシュで使用できるようになります。
Experience Platform タグ環境について詳しくは、環境を参照してください。
ライブラリの公開には、次の 2 つの手順を実行します。
- 必要な変更(新しい変更や更新)をすべてライブラリに含めて、新しいライブラリを追加して構築。
- 様々な環境レベルを通じてライブラリを移動(開発からステージングおよび実稼動へ)。
新しいライブラリの追加と構築 adding-and-building-a-new-library
-
Experience Platform タグで初めて「公開」タブを開くと、ライブラリリストは空になります。
左の列で、「新しいライブラリを追加」を選択します。
-
新しいライブラリを作成ページの「名前」フィールドに、新しいライブラリのわかりやすい名前を入力します。例:
DynamicMediaViewersLib
「環境」ドロップダウンリストから、環境レベルを選択します。最初は、選択できるのは開発レベルのみです。ページの左下近くにある「変更されたすべてのリソースを追加」を選択します。
-
ページの右上隅にある「開発用に保存してビルド」を選択します。
数分でライブラリが作成され、使用できる状態になります。
note note NOTE 次回 Experience Platform タグの設定を変更するときは、プロパティ 設定の下の「公開」タブに移動し、以前に作成したライブラリを選択します。 ライブラリの公開画面で、「変更されたすべてのリソースを追加」を選択したあと、「開発用に保存してビルド」を選択します。
上位環境レベルへのライブラリの移動 moving-a-library-up-through-environment-levels
-
新しいライブラリが追加されると、そのライブラリはまず開発環境に表れます。これをステージング環境レベル(「送信済み」列に対応)に移動するには、ライブラリのドロップダウンメニューで「承認用に送信」を選択します。
-
確認ダイアログボックスで、「送信」を選択します。
ライブラリが「送信済み」列に移動した後、ライブラリのドロップダウンメニューで、「ステージング用にビルド」を選択します。
-
ステージング環境から実稼動環境(「発行済み」列)にライブラリを移動するには、同様のプロセスに従います。
まず、ドロップダウンメニューの「公開の承認」を選択します。
-
ドロップダウンメニューの「ビルドして実稼動環境に公開」を選択します。
Experience Platform タグでの公開プロセスについて詳しくは、公開を参照してください。
統合のための Adobe Experience Manager の設定 configuring-adobe-experience-manager-for-the-integration
前提条件:
- Experience Manager は、オーサーインスタンスとパブリッシュインスタンスの両方を実行します。
- Experience Manager オーサーノードは、Dynamic Media - Scene7 実行モード(dynamicmedia_s7)で設定されます
- Dynamic Media WCM コンポーネントは Experience Manager Sites で有効になっています。
Experience Manager 設定は、次の 2 つの主な手順で構成されます。
- Experience Manager IMS の設定。
- Experience Platform タグクラウドの設定。
Experience Manager IMS の設定 configuring-aem-ims
-
Experience Manager オーサーで、「ツール」アイコン(ハンマー)を選択し、セキュリティ/Adobe IMS 設定 に移動します。
-
Adobe IMC 設定ページの左上隅付近にある「作成」を選択します。
-
Adobe IMS テクニカルアカウント設定 ページの クラウドソリューション ドロップダウンリストで、「Experience Platform タグ」を選択します。
-
「新しい証明書を作成」を有効にし、テキストフィールドに証明書に意味のある値を入力します。例えば、AdobeLaunchIMSCert と入力します。「証明書を作成」を選択します。
次の情報メッセージが表示されます。
有効なアクセストークンを取得するには、新しい証明書の公開鍵を Adobe Developer Console のテクニカルアカウントに追加する必要があります。
情報ダイアログボックスを閉じるには、「OK」を選択します。
-
公開鍵ファイル(**.crt)をローカルシステムにダウンロードするには、「公開鍵のダウンロード」を選択します。
note note NOTE この時点で、Adobe IMS テクニカルアカウント設定 ページを 開いたままにします。ページは 閉じない で、「次へ」も 選択しません。このページには、手順の後半で戻ってきます。 -
新しいブラウザータブで、Adobe Developer Console に移動します。
-
Adobe Developer Console 統合 ページの右上隅近くにある「新規の統合」を選択します。
-
統合の新規作成 ダイアログボックスで、「API へのアクセス」ラジオボタンが選択されていることを確認し、「続行」を選択します。
-
統合の新規作成 の 2 ページ目で、「Experience Platform タグ API」ラジオボタンを有効(オン)にします。ページの右下隅にある「続行」を選択します。
-
統合の新規作成 の 3 ページ目で、次の操作を行います。
-
「名前」フィールドにわかりやすい名前を入力します。例えば、DynamicMediaViewersIO と入力します。
-
「説明」フィールドに、統合の説明を入力します。
-
「公開鍵証明書」領域で、この手順で以前にダウンロードした公開鍵ファイル(**.crt)をアップロードします。
-
「Experience Platform タグ API 用の役割を選択」の見出しの下から「管理者」を選択します。
-
「Experience Platform タグ API 用の製品プロファイルを 1 つ以上選択」の見出しの下から、タグ - <your_company_name> という名前の製品プロファイルを選択します。
-
-
「統合を作成」を選択します。
-
統合が作成された ページで、「統合の詳細を続行」を選択します。
-
次のような統合の詳細ページが****表示されます。
note note NOTE この統合の詳細ページは開いたままにします。「概要」タブと「JWT」タブの様々な情報がすぐに必要になります。 統合の詳細ページ。
-
前に開いておいた Adobe IMS テクニカルアカウント設定 ページに戻ります。ページの右上隅にある「次へ」を選択して、Adobe IMS テクニカルアカウント設定 ウィンドウで アカウント ページを開きます。
(先にページを閉じてしまった場合は、Experience Manager オーサーに戻り、ツール/セキュリティ/Adobe IMS 設定 に移動します。「作成」を選択します。クラウドソリューション ドロップダウンリストから、「Experience Platform タグ」を選択します。「証明書」ドロップダウンリストで、以前に作成した証明書の名前を選択します)。
Adobe IMS テクニカルアカウント設定 - 証明書ページ。
-
アカウント ページには 5 つのフィールドがあり、前の手順の統合詳細ページの情報を使って入力する必要があります。
Adobe IMS テクニカルアカウント設定 - アカウントページ。
-
アカウント ページで以下のフィールドに入力します。
- タイトル - 説明的なアカウントのタイトルを入力します。
- 認証サーバー - 以前に開いた統合の詳細ページに戻ります。「JWT」タブを選択します。次にハイライト表示するように、サーバー名(パスを除く)をコピーします。
アカウント ページに戻り、その名前を各フィールドにペーストします。
例:https://ims-na1.adobelogin.com/
(サーバー名は一例です)。統合の詳細ページ - 「JWT」タブ
-
API キー - 統合の詳細ページに戻ります。「概要」タブを選択し、「API キー(クライアント ID)」フィールドの右にある「コピー」を選択します。
アカウント ページに戻り、キーを各フィールドに貼り付けます。
統合の詳細ページ。
-
クライアントの秘密鍵 - 統合の詳細ページに戻ります。「概要」タブで、「クライアント秘密鍵を取得」を選択します。「クライアントの秘密鍵」フィールドの右側にある「コピー」を選択します。
アカウント ページに戻り、キーを各フィールドに貼り付けます。
-
ペイロード - 統合の詳細ページに戻ります。「JWT」タブの「JWT ペイロード」フィールドで、JSON オブジェクトコード全体をコピーします。
アカウント ページに戻り、コードを各フィールドに貼り付けます。
統合の詳細ページ - 「JWT」タブ
すべてのフィールドに値が入力されたアカウントページは、次のようになります。
-
アカウント ページの右上隅付近にある「作成」を選択します。
Experience Manager IMS が設定され、Adobe IMS 設定 に新しい IMS アカウントが表示されます。
統合用の Experience Platform タグクラウドの設定 configuring-adobe-launch-cloud-for-the-integration
-
Experience Manager 作成者の左上隅付近にある ツール アイコン(ハンマー)を選択し、クラウドサービス/Experience Platform タグの設定 Experience Platform に移動します。
-
Experience Platform タグの設定 ページの左パネルで、Experience Platform タグの設定を適用する Experience Manager サイトを選択します。
サンプル目的のみのため、以下のスクリーンショットでは、
We.Retail
サイトが選択されています。 -
ページの左上隅近くにある「作成」を選択します。
-
Experience Platform タグの設定を作成 ウィンドウの 一般 ページ(1/3 ページ)で、次のフィールドに入力します。
-
タイトル - 説明的な設定のタイトルを入力します。例:
We.Retail Tags cloud configuration
-
関連付けられた Adobe IMS 設定 - 以前に Experience Manager IMS の設定で作成した IMS 設定を選択します。
-
会社 - 「会社」ドロップダウンリストから、Experience Cloud の会社を選択します。リストが自動的に入力されます。
-
プロパティ - プロパティドロップダウンリストから、以前に作成した Experience Platform タグプロパティを選択します。リストが自動的に入力されます。
すべてのフィールドに入力すると、一般 ページは次のようになります。
-
-
左上隅付近にある「次へ」を選択します。
-
Experience Platform タグの設定を作成 ウィンドウの ステージング ページ(2/3 ページ)で、次のフィールドに入力します。
「ライブラリ URI」(Uniform Resource Identifier)フィールドで、Experience Platform タグライブラリのステージングバージョンの場所を確認します。Experience Manager によってこのフィールドに自動的に入力されます。
サンプル目的のみで、この手順では Adobe CDN にデプロイされた Experience Platform タグライブラリを使用します。
note note NOTE 自動入力されたライブラリ URI(Uniform Resource Identifier)の形式に誤りがないか確認します。必要に応じて、URI がプロトコル相対 URI を表すように修正します。つまり、ダブルスラッシュから始まります。 (例: //assets.adobetm.com/launch-xxxx
)。ステージング ページは次のようになります。「アーカイブ」オプションと「ライブラリを非同期にロード」オプションは設定されて いません。
-
右上隅付近にある「次へ」を選択します。
-
Experience Platform タグの設定を作成 ウィンドウの 実稼動 ページ(3/3 ページ)で、前の ステージング ページで行ったのと同様に、自動入力された実稼動 URI を必要に応じて修正します。
-
右上隅付近にある「作成」を選択します。
これで次の例のように、新しい Experience Platform タグクラウドの設定が作成され、Web サイトの横に一覧表示されます。
-
新しい Experience Platform タグクラウド設定を選択します(設定タイトルを選択すると、設定タイトルの左側にチェックマークが表示されます)。ツールバーの「公開」を選択します。
現在、Experience Manager オーサーノードでは、Dynamic Media ビューアと Experience Platform タグの統合をサポートしていません。
ただし、Experience Manager パブリッシュノードではサポートされています。Experience Platform タグクラウド構成のデフォルト設定を使用して、Experience Manager パブリッシュノードは Experience Platform タグの実稼働環境を使用します。そのため、テスト中は毎回、開発環境から実稼動環境に Experience Platform タグライブラリの更新をプッシュする必要があります。
この制限は回避することは可能です。上記の Experience Manager パブリッシュノードの Experience Platform タグクラウド設定で、Experience Platform タグライブラリの開発用 URL またはステージング用 URL を指定します。これにより、Experience Manager のパブリッシュノードでは、開発版またはステージング版の Experience Platform タグライブラリが使用されます。
Experience Platform タグクラウド設定の詳細に関しては、 ( Adobe Developer Console 経由による Experience Manager と Experience Platform タグの統合)を参照してください。