ドキュメントExperience Platformタグ

AEM Asset Insights 拡張機能の概要

Last update: Wed Mar 15 2023 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：
  • Tags

作成対象：

  • Developer
NOTE
Adobe Experience Platform Launch は、Adobe Experience Platform のデータ収集テクノロジースイートとしてリブランドされています。 その結果、製品ドキュメント全体でいくつかの用語が変更されました。用語の変更点の一覧については、次のドキュメントを参照してください。

この拡張機能は、AEM Asset Insights と共に使用することを意図しています。具体的には、「pageTracker」プロセスと埋め込みコードが置き換えられます。設定すると、この拡張機能によって Asset Impression と Click 指標が Adobe Analytics に送信され、その後、AEM Asset Insights レポートに読み込まれます。その後、AEM Asset Insights または Adobe Analytics プロジェクトの Workspace を使用して、アセット指標をレポートできます。

拡張機能の前提条件

Analytics

Analytics の AEM Asset レポートには、次の 3 つのディメンションが含まれます。

  • アセット ID
  • アセットソース
  • アセットのクリック

また、次の 2 つの指標があります。

  • アセットのインプレッション
  • アセットのクリック

この拡張機能を使用してレポートを入力するには、Analytics Administrator（Analytics／管理／レポートスイート／<report suite>／設定を編集／AEM／AEM Assets レポート）を使用してこれらのレポートを有効にする必要があります。

Adobe Experience Platform 用の「Adobe Analytics」タグ拡張機能は、同じ Web プロパティにインストールする必要があります。

Adobe Experience Manager（AEM）

  1. 「AEM Asset Insights」を有効にします。AEM で、ツール／Assets を選択し、インサイト設定 ​パネルを開きます。

  2. 「UUID トラッキング」を無効にします。

    note important
    IMPORTANT
    AEM Asset 設定の「UUID の追跡を無効化」がオンになっている場合、この拡張機能は​ 機能しません。デフォルトでは選択解除されています。

    UUID トラッキングの無効化

Adobe Experience Manager（AEM）の設定

ここでは、Adobe Experience Platform でタグを使用して AEM を設定する方法、AEM で Asset Insight を有効にする方法、およびアセット の UUID トラッキングを有効にする方法について説明します。

AEM とタグの統合

Platform を Adobe Experience Manager と統合する場合、Adobe I/O を使用して実行することをお勧めします。

  1. Adobe I/O を使用して AEM をタグに接続します。

  2. Adobe Experience Platform Cloud Service 設定を作成します。

AEM での Asset Insight の有効化

Asset Insights を有効にする手順については、Experience Manager 6.5 Assets ユーザーガイドを参照してください。

アセットの UUID トラッキングの有効化

AEM でアセットの UUID を使用して、Analytics のアセットをトラッキングします。

アセットの UUID を使用したトラッキングを有効にするには、編集可能なテンプレートのコンポーネントポリシーコンソールを開いて、「UUID の追跡を無効化」プロパティをオフにします（デフォルトでは、このプロパティは、OOTB 画像コンポーネント用にオンになっています）。

UUID を有効にしたら、「data-asset-id」データ要素にアセットの UUID が入力されていることを確認する必要があります。Analytics は、このUUID を使用してアセットクリックまたはインプレッションをトラッキングします。

拡張機能の使用

この拡張機能には 2 つのイベントと 1 つのアクションがあります。

  • アセットのクリック： ​トラッキングが有効になっていて、宛先（href 属性）を持つ AEM Asset を訪問者が選択したときに発生する​ イベント。

  • アセットのクリック（宛先なし）： ​トラッキングが有効になっていて、宛先を持たない（href 属性なし）AEM Asset を訪問者が選択したときに発生する​ イベント。

  • AA 変数の設定：使用されたイベントと、イベントとアクションの設定方法に応じて、AEM Assets 用に予約された Analytics 変数（コンテキストデータ変数であるa.assets.source、a.assets.idlist、a.asset.clickedid）を設定する​ アクション。この拡張機能では、Analytics のイベント、prop、eVar は使用されません。

アセットのインプレッション

すべてのページで実行され、Analytics イメージリクエストを送信する新規または既存のタグルールに「AA 変数の設定」アクションを追加します。「AA 変数の設定」アクションは、「Adobe Analytics - ビーコンの送信」アクションの​ 前 ​に記述する必要があります。必要に応じて、追加のアクションを追加できます。

[AA 変数の設定] ​設定ページで、「[表示されたアセット]」（デフォルト）オプションを選択します。これは、訪問者が実際に表示するアセットのインプレッションイベントのみを設定します。

NOTE
「AA 変数の設定」アクションでは、「loaded」オプションもサポートされます。このオプションは、訪問者がアセットを表示したかどうかに関係なく、ページ上のすべてのアセットに対するアセットのインプレッションを送信します。

インプレッション

アセットのクリック

「アセットのクリック」イベントと「AA 変数の設定」アクションを使用して、2 つ目のルールを設定します。「アセットのクリック」イベントは、「アセットのクリック - イメージリクエスト」が「ページロード時」（デフォルト）に設定されるように設定する必要があります。アセット ID は後続のインプレッションルールで sessionStorage に保存および送信されるので、このルールでは、Adobe Analytics のアクション（ビーコンの送信など）は必要ありません。

「アセットのクリック」イベントでは、「クリック時」の「アセットのクリック - イメージリクエスト」設定もサポートされています。これにより、クリック指標が即座に Analytics に送信され、Analytics の「ビーコンの送信」アクションも必要になります。

ページの読み込み時のアセットのクリック

リンク先を持たない（href 属性なし）ページにアセットが存在する場合に実行する 3 つ目のルールを設定します。少なくとも、新しいルールでは、「アセットのクリック（宛先なし）」イベントと、「AA 変数の設定」および「Adobe Analytics — ビーコンの送信」アクションを使用する必要があります。必要に応じて、追加の条件とアクションを追加できます。

アセットのクリック（宛先なし）

拡張機能のテストに関するヒント

上記の説明に従って、3 つのルールを設定します。

  • アセットのインプレッション
  • アセットのクリック
  • アセットのクリック（宛先なし）

インプレッション

  1. AEM アセットを含むページに移動します。

  2. ブラウザーにアセットが表示されない場合は、1 つ以上のアセットが表示されるまでスクロールしてそのアセットを選択するか、別のページに移動します。

  3. Analytics イメージリクエストを確認します。

    前のページに表示されたアセット ID が a.assets.idlist に含まれている場合は、ルールが正しく動作しています。

    a.assets.idlist がイメージリクエストに含まれていない場合、次の 2 つの理由のうちの 1 つが考えられます。

    • ブラウザーの表示領域にアセットがありませんでした

    • AEM で Asset Insights が有効になっているページにアセットが設定されていませんでした。

クリック数

  1. AEM アセットを含むページに移動します。

  2. いずれかのアセットを選択します。

（次のページからの）結果の Analytics イメージリクエストで、宛先ページのアセット ID が a.assets.idlist に含まれ、元のページで選択されたアセットのアセット ID が a.assets.clickedid に含まれる場合、ルールは正しく動作しています。

a.assets.clickedid がイメージリクエストに含まれていない場合、選択したアセットのアセットインサイトが AEM で有効になっていないことがほとんどです。

クリック（宛先なし）

  1. 宛先のない（href 属性のない）1 つ以上の AEM アセットを含むページに移動します。

  2. そのアセットを選択します。

結果の Analytics イメージリクエストで、a.assets.clickedid にアセット ID がある場合、ルールは正しく動作しています。

a.assets.clickedid がイメージリクエストに含まれていない場合、選択されたアセットのアセットインサイトが AEM で有効になっていないことがほとんどです。

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743