インタラクティブ画像 interactive-images

CAUTION
AEM 6.4 の拡張サポートは終了し、このドキュメントは更新されなくなりました。 詳細は、 技術サポート期間. サポートされているバージョンを見つける ここ.

「ショッパブル」ホットスポットを画像にドラッグドロップすることで、静的な画像を、顧客にとってリッチで魅力的なエクスペリエンスに簡単に変えることができます。ショッパブルホットスポットは、製品やサービスに関する追加情報と、販売に直結する「買い物かごに追加」機能や「購入」機能を組み合わせています。顧客はこれらのホットスポットをタップして、製品やサービスに直接リンクしたり、買い物かごに追加したり、Web ページにリンクしたりできます。 直接的なエクスペリエンス(これらのエクスペリエンスにより、Web サイトでの顧客エンゲージメントとコンバージョンが増加します)。

次に、クイックビューポップアップを含むショッパブルバナーを示します。モデルの上の円(「ホットスポット」)をタップすると、クイックビューがアクティブになります。

chlimage_1-368

この web ページの実際のインタラクティブ画像は、次の URL から参照してください。

https://experienceleague.adobe.com/tools/dynamic-media-demo/shoppable-banner/we-fashion-QVzoom/index2-shoppable.html?lang=ja

インタラクティブ画像バナーの作成方法をご覧ください。 watch-how-interactive-image-banners-are-created

インタラクティブ画像バナーの作成方法を示す 10 分 33 秒のガイドをご覧ください。また、インタラクティブ画像バナーのプレビュー、編集、配信方法についても説明します。

クイックスタート:インタラクティブ画像 quick-start-interactive-images

次のワークフローの手順説明は、AEM Assetsのインタラクティブ画像をすばやく使い始めることを目的としています。

一部のクイックスタートタスク内には「」という見出しがあります。これには、まだインタラクティブ画像が追加されていない次の Web ページの例に基づく、簡単なチュートリアルが含まれています。

https://experienceleague.adobe.com/tools/dynamic-media-demo/shoppable-banner/we-fashion/landing-0.html?lang=ja

このチュートリアルでは、Web サイトにインタラクティブ画像を統合する手順を説明します。

インタラクティブ画像のワークフロー:

  1. (オプション)ホットスポットの変数の識別 - AEM AssetsとDynamic Mediaをスタンドアロンで使用している場合は、まず、既存のクイックビュー実装で使用されている動的変数を識別してから、インタラクティブ画像の作成時にホットスポットデータを入力できます。 (オプション)ホットスポットの変数の識別を参照してください。

    ただし、AEM Sites または AEM eCommerce(あるいは両方)を使用している場合、この手順は必要ありません。

    詳しくは、 AEM Assetsの e コマースの概念.

  2. (オプション)インタラクティブ画像ビューアプリセットの作成 — ホットスポットを表すために使用するグラフィック画像をカスタマイズします。 独自のインタラクティブ画像ビューアプリセットの作成は、標準提供のインタラクティブ画像ビューアプリセット Shoppable_Banner を使用する場合には必要ありません。

    (オプション)インタラクティブ画像ビューアプリセットの作成を参照してください。

  3. 画像バナーのアップロード — インタラクティブにする画像バナーをアップロードします。

    画像バナーのアップロードを参照してください。

  4. 画像バナーへのホットスポットの追加 — 画像バナーに 1 つ以上のホットスポットを追加し、それぞれにアクション(ハイパーリンク、クイックビュー、エクスペリエンスフラグメントなど)を関連付けます。 ホットスポットを追加した後は、インタラクティブ画像を公開するとタスクが終了します。

  5. AEMで Web サイトまたは Web サイトにインタラクティブ画像を追加する

    • AEM Sites、AEM e コマース、またはその両方を使用する場合は、インタラクティブメディアコンポーネントをページにドラッグすることで、インタラクティブ画像をAEMの Web ページに直接追加できます。 ページへの Dynamic Media アセットの追加を参照してください。
    • を参照してください。AEM Assets と Dynamic Media をスタンドアロンで使用している場合は、埋め込みコードを Web サイトにコピーしてから、既存のクイックビューに統合する必要があります。インタラクティブ画像の Web サイトへの統合を参照してください。
    • サードパーティの WCM(Web Content Manager)を使用している場合は、新しいインタラクティブビデオを、Web サイトで使用されている既存のクイックビュー実装に統合する必要があります。インタラクティブ画像の既存のクイックビューへの統合を参照してください。

(オプション)ホットスポットの変数の識別 optional-identifying-hotspot-variables

NOTE
このタスクが必要になるのは次に該当する場合のみです。
  • クイックビューをトリガーして、画像にインタラクティビティを追加する。
  • eコマースソリューション​*(* IBM Websphere Commerce、Elastic Path、hybris、Intershop など)から AEM に製品データを取り出すために、AEM の実装が eコマース統合フレームワークを使用していない。詳しくは、 AEM Assetsの e コマースの概念.
AEM の実装で AEM eCommerce を使用している場合は、このタスクをスキップして次のタスクに進みます。

まず、既存のクイックビュー実装で使用されている動的変数を識別します。こうすることで、ホットスポットデータを入力してインタラクティブ画像を作成できます。

AEM Assets 内でバナー画像にホットスポットを追加する場合は、各ホットスポットに SKU(Stock Keeping Unit。提供される個々の異なる製品やサービス用の一意の識別子)とオプションの追加変数を割り当てる必要があります。そのようなホットスポットの変数は、後でホットスポットとクイックビューコンテンツを対応付けるために使用されます。

重要なのは、ホットスポットデータに関連付けられる変数の数とタイプを正しく識別することです。バナー画像に追加するそれぞれのホットスポットに、既存のバックエンドシステム内で製品を一意に識別するための十分な情報がある必要があります。

ホットスポットデータに使用する一連の変数を識別するには、様々な方法があります。

システム内のクイックビューを識別するために必要な最小のデータセットは何かを知っている可能性が高いので、既存のクイックビューの実装を担当する IT 専門家に相談するのに十分な場合があります。 ただし、ほとんどの場合は、フロントエンドコードの既存の動作を簡単に分析することもできます。

クイックビュー実装の大部分では、次のパラダイムを使用しています。

  • ユーザーは Web サイト上の特定のユーザーインターフェイス要素をアクティベートします。例えば、 クイックビュー 」ボタンをクリックします。
  • Web サイトでは、必要に応じて、クイックビューのデータまたはコンテンツを読み込むための Ajax リクエストをバックエンドに送信します。
  • クイックビューのデータは、Web ページでのレンダリングに備えて、コンテンツに変換されます。
  • 最後に、フロントエンドコードによってそのコンテンツが画面上に視覚的にレンダリングされます。

その後、クイックビュー機能が実装されている既存の Web サイトの様々な領域にアクセスし、クイックビューをトリガーして、Web ページから送信された Ajax URL を取り込み、クイックビューのデータやコンテンツを読み込みます。

通常は、特別なデバッグツールを使用する必要はありません。最新の Web ブラウザーには、十分なタスクを実行できる Web インスペクターが備わっています。Web インスペクターが搭載されている Web ブラウザーの例を次に示します。

  • Google Chrome で、送信されるすべての HTTP リクエストを表示するには、F12 キーを押して、 開発者ツール パネルを開き、 ネットワーク タブをクリックします。

    Macで、 Command+Option+I 開く 開発者ツール パネルをクリックし、「ネットワーク」タブをクリックします。

  • Firefox では、F12 キーを押して Firebug プラグインを有効にし、「Net」タブを使用するか、組み込みの 検査官 ツールとその ネットワーク タブをクリックします。

    Macで、 Command+Option+I 開く 開発者ツール パネルを開き、 検査官 タブをクリックします。

ブラウザーでネットワーク監視をオンにして、ページ上でクイックビューをトリガーします。

次に、ネットワークログ内でクイックビューの Ajax URL を見つけ、記録された URL を今後の分析のためにコピーします。ほとんどの場合、クイックビューをトリガーすると、サーバーに送信される多数のリクエストが存在します。 クイックビューの Ajax URL は通常、そのリスト内の最初のほうにあります。この URL には複雑なクエリ文字列部分またはパスが含まれ、その応答の MIME タイプは text/htmltext/xmltext/javascript のいずれかになります。

このプロセスの実行中は、様々な製品カテゴリや製品タイプが含まれる Web サイトの様々な領域にアクセスすることが重要です。なぜなら、クイックビュー URL には、ある特定の Web サイトカテゴリに共通するが、Web サイトの異なる領域にアクセスした場合にのみ変化する部分が存在する場合があるからです。

最も単純なケースでは、クイックビュー URL 内で変化する唯一の部分が製品 SKU となります。この場合、SKU 値は、バナー画像にホットスポットを追加するために必要な唯一のデータです。

一方、複雑なケースでは、クイックビュー URL に SKU 以外の様々な要素が含まれます(カテゴリ ID、カラーコード、サイズコードなど)。その場合、各要素は、AEM Assetsのショッパブルインタラクティブ画像機能のホットスポットデータ定義内の個別の変数になります。

クイックビュー URL の次の例と、その結果として生成されるホットスポット変数について考えてみましょう。

単一の SKU(クエリ文字列内)

記録されたクイックビューの URLとしては以下が挙げられます。

  • https://server/json?productId=866558&source=100

  • https://server/json?productId=1196184&source=100

  • https://server/json?productId=1081492&source=100

  • https://server/json?productId=1898294&source=100

この URL で変化する唯一の部分は productId= というクエリ文字列パラメーターの値であり、これが SKU 値であることは明白です。したがって、ホットスポットでは、866558119618410814921898294 などの値が入力された SKU フィールドのみが必要になります。

単一の SKU(URL パス内)

記録されたクイックビューの URLとしては以下が挙げられます。

  • https://server/product/6422350843

  • https://server/product/1607745002

  • https://server/product/0086724882

パスの最後の要素が変化する部分であり、これがホットスポットの SKU 値(642235084316077450020086724882)になります。

SKU とカテゴリ ID(クエリ文字列内)

記録されたクイックビューの URLとしては以下が挙げられます。

  • https://server/quickView/product/?category=1100004&prodId=305466

  • https://server/quickView/product/?category=1100004&prodId=310181

  • https://server/quickView/product/?category=1740148&prodId=308706

この場合、URL には変化する部分が 2 つあります。SKU は prodId パラメーターとカテゴリ ID

categoryId

  • 305466``categoryId``1100004

  • 310181``categoryId``1100004

  • 308706``categoryId``1740148

上記の 3 つの例で使用されているのと同じアプローチを次のデモ Web ページに適用できます。

https://experienceleague.adobe.com/tools/dynamic-media-demo/shoppable-banner/we-fashion/landing-0.html?lang=ja

デモ Web ページには複数の製品サムネールがあり、それぞれにクイックビューボタンのラベルが付いています 詳細を見る. Web ブラウザーのデバッグツールをアクティブにしたまま、各ボタンをクリックして、記録されたクイックビュー URL をメモします。 ページで使用可能な 4 つの製品クイックビューをすべてアクティベートすると、バックエンドに対して次のリストのクイックビューリクエストが作成されます。

  • /datafeed/Men-Windbreaker.json
  • /datafeed/Men-SimpleHenley.json
  • /datafeed/Men-CamoPullover.json
  • /datafeed/Women-QuiltedDownJacket.json

これらのサーバー呼び出しを見ると、製品固有の情報がリクエストパスにのみ存在することがわかります。 また、クエリ文字列がまったく使用されていないこと、2 つの異なるタイプのデータが含まれることもわかります。

  • 1 つ目のタイプは「男性」または「女性」です。 これは「製品カテゴリ」と呼ばれます。
  • 2 つ目のタイプは製品名(CamoPullover など)です。 これが製品 SKU であるとします。

この情報に基づいて、全体的なクイックビュー URL は次のようなパターンであることがわかります。

/datafeed/$categoryId$-$SKU$.json

このような分析に基づいて、ホットスポットに対して categoryIdSKU を使用することになります。

これで、AEM Assetsのショッパブルインタラクティブ画像機能を使用して、画像バナーをアップロードし、そのバナーにホットスポットを追加する準備が整いました。

(オプション)インタラクティブ画像ビューアプリセットの作成 optional-creating-an-interactive-image-viewer-preset

デフォルトの標準提供インタラクティブ画像ビューアプリセット ( ) であるを使用するように選択できます。 Shoppable_Banner それはAEM Assetsに付属しています。 または、インタラクティブ画像で使用するために独自のカスタムビューアプリセットを作成できます。

カスタムインタラクティブ画像ビューアプリセットを作成する場合は、画像バナーのホットスポットの外観を決定できます。ビューアプリセットの作成中に、事前定義済みの画像ギャラリーからホットスポットのグラフィックを選択して使用できます。

ビューアプリセットを保存すると、 ビューアプリセット AEM Assetsのリストページ つまり、そのビューアプリセットは、インタラクティブメディアコンポーネントで、アセットを表示するときに常に表示されます。ただし、 配信 このビューアプリセットを含むインタラクティブバナー 公開 ビューアプリセットも同様に使用できます(これは、カスタムビューアプリセットまたは標準提供ビューアプリセットの場合に当てはまります)。

インタラクティブ画像ビューアプリセットを作成するには::

  1. 左側のパネルで、ツール/Assetss/ビューアプリセット ​をタップします。

  2. ページの右上隅にある「作成」をタップします。

  3. 新しいビューアプリセット ダイアログボックスに、インタラクティブバナーのビューアプリセットを説明する名前を入力します。

    これは、 ビューアプリセット リストページに表示されます。

  4. リッチメディアタイプ プルダウンメニューで、「 インタラクティブ画像.

  5. 作成」をタップします。

  6. ビューアプリセットを編集 ページで、 外観 タブをクリックします。

  7. 次のいずれかの操作を行います。

    • 画像で使用する独自のホットスポット画像をアップロードするには、 アセットピッカー アイコン 内 コンテンツを選択 ページで、使用するホットスポット画像の場所に移動して選択し、 チェックマーク アイコンが表示されます。
    • 定義済みのホットスポット画像を選択するには、 ホットスポットギャラリー アイコン ホットスポットギャラリーパレットで、使用するホットスポット画像をタップします。
  8. ページの右上隅にある「保存」をタップします。

    新しいビューアプリセットを忘れずに公開してください。

    詳しくは、 追加したビューアプリセットの公開.

    これで、画像バナーをアップロードできるようになりました。

画像バナーのアップロード uploading-an-image-banner

使用する画像を既にアップロードしている場合は、次の手順(画像バナーへのホットスポットの追加)に進んでください。

画像バナーをアップロードするには::

  1. インタラクティブにする画像バナーをアップロードします。

    アセットのアップロードを参照してください。

    これで、画像バナーにホットスポットを追加する準備が整いました。この後のタスクを参照してください。

画像バナーへのホットスポットの追加 adding-hotspots-to-an-image-banner

画像バナーにホットスポットを追加するには、 ホットスポット管理 ページ。

ホットスポットを追加する際に、クイックビューポップアップディスプレイ、ハイパーリンク、エクスペリエンスフラグメントとして定義できます。

エクスペリエンスフラグメントを参照してください。

NOTE
ビューアをエクスペリエンスフラグメントに埋め込む場合、インタラクティブ画像のソーシャルメディア共有ツールはサポートされないことに注意してください。この問題を回避するには、ソーシャルメディア共有ツールのないビューアプリセットを使用または作成します。このようなビューアプリセットを使用すると、ビューアをエクスペリエンスフラグメントに正常に埋め込むことができます。

ページの右上隅にある「取り消し」および「やり直し」オプションは、現在の作成/編集セッションの間で有効です。

インタラクティブ画像の作成が完了したら、 プレビュー を使用して、インタラクティブ画像が顧客にどのように表示されるかを確認できます。

(オプション)インタラクティブ画像のプレビューを参照してください。

NOTE
インタラクティブ画像またはカルーセルバナーの画像にホットスポットを追加すると、インタラクティブ画像かカルーセルバナーかにかかわらず、ホットスポット情報が同じメタデータの場所(画像に対して相対的な場所)に格納されます。つまり、どちらのビューアでも、同じ画像を定義済みのホットスポットデータと共に簡単に再利用できます。
ただし、カルーセルバナーでは、画像上の画像マップ(ホットスポットを含むことができる)がサポートされることに注意してください。インタラクティブ画像ではサポートされません。同じ画像を使用するインタラクティブ画像またはカルーセルバナーを作成する場合は、この点に注意してください。 同じ画像の別のコピーを使用して、インタラクティブ画像とカルーセルバナーを作成することもできます。
関連トピック カルーセルバナー.
NOTE
ホットスポットを含むインタラクティブ画像を編集しているときに、画像を切り取ると、ホットスポットは削除されます。

画像バナーにホットスポットを追加するには:

  1. Assets ビューで、インタラクティブにする画像バナーに移動します。

  2. 次のいずれかの操作を行います。

    • 画像の上にマウスポインターを置き、選択(チェックマークアイコン)をタップします。ツールバーの「編集」をタップします。
    • 画像の上にマウスポインターを置いて、をタップします。 その他のアクション (3 つのドットのアイコン) > 編集.
    • 画像をタップして、 詳細ビュー ページ。 ツールバーの「編集」をタップします。
  3. ページの左上隅付近にあるをタップします。 ホットスポットを追加 (指でタップするアイコン) ホットスポット管理 ページ。

  4. ページの左上隅付近にあるをタップします。 ホットスポット.

  5. a.の左上隅付近 ホットスポット管理 ページ、タップ ホットスポット.
    b.画像上で、ホットスポットを表示する場所をタップします。 必要に応じて、ホットスポットをドラッグして場所を調整します。c.必要に応じて、手順 a および b を繰り返して、他のホットスポットを追加します。d.(オプション)ホットスポットを削除するには、画像上でそのホットスポットを選択して、をタップします 削除 (ごみ箱アイコン)を ホットスポット 見出し。

  6. 名前 テキストフィールドに、ホットスポットの名前を入力します。 この名前は、 選択したホットスポット 」ドロップダウンリストから選択できます。

  7. 次のいずれかの操作をおこないます。

    • クイックビュー」をタップします。

      • AEM Sitesまたは e コマースのユーザーである場合は、 製品ピッカー アイコン(虫眼鏡)を使用して 製品を選択 ページ。 使用する製品をタップし、 選択 ページの右上隅に ホットスポット管理 ページ。

      • AEM Sites または AEM eCommerce のユーザーではない場合は次のようにします

        • ホットスポットの変数の識別を参照してください。これらの変数を定義する必要があります。
        • 次に、SKU 値を手動で入力します。内 SKU 値 「 」テキストフィールドに、製品の SKU(Stock Keeping Unit) を入力します。SKU は、提供する個々の製品またはサービスの一意の識別子です。 入力した SKU 値によってクイックビューテンプレートの変数部分が自動的に入力され、タップされたホットスポットが特定の SKU のクイックビューに関連付けられます。
        • (オプション)クイックビュー内で製品をさらに識別するために必要になる他の変数がある場合は、「汎用変数を追加」をタップします。テキストフィールドに追加の変数を指定します。例えば、追加の変数として category=Mens などと指定します。
    • ハイパーリンク」をタップします。

      • AEM Sitesのユーザーである場合は、 サイトセレクター アイコン(フォルダー)を使用して URL に移動します。 インタラクティブコンテンツに相対 URL のリンク(特に AEM Sites ページへのリンク)がある場合、URL ベースのリンク方法は使用できません。
      • スタンドアロンのユーザーの場合は、 HREF テキストフィールドで、リンクされた Web ページへの完全な URL パスを指定します。

      このリンクを新しいブラウザータブで開く(推奨のデフォルト)か同じタブで開くかを指定してください。

      詳しくは、セレクターの操作を参照してください。

    • エクスペリエンスフラグメント」をタップします。

      • AEM Sitesのユーザーである場合は、 検索 アイコン(虫眼鏡)を使用して エクスペリエンスフラグメント ページ。 使用するエクスペリエンスフラグメントをタップし、 選択 をクリックして、ホットスポット管理ページに戻ります。

        エクスペリエンスフラグメントを参照してください。

        note note
        NOTE
        ビューアをエクスペリエンスフラグメントに埋め込む場合、インタラクティブ画像のソーシャルメディア共有ツールはサポートされないことに注意してください。この問題を回避するには、ソーシャルメディア共有ツールのないビューアプリセットを使用または作成します。このようなビューアプリセットを使用すると、ビューアをエクスペリエンスフラグメントに正常に埋め込むことができます。
      • エクスペリエンスフラグメントがバナーに表示されるときの幅と高さを指定します。

  8. タップ 保存 作業内容を保存して、 参照 ページ。

  9. インタラクティブ画像を公開します。公開すると、バナーをクラウド経由で配信でき、サードパーティの Web サイトと統合する必要がある場合は埋め込みコードも生成されます。

    アセットの公開を参照してください。

    ホットスポットを追加してインタラクティブ画像を公開したら、次に既存の Web サイトにその画像を追加できます。

    インタラクティブ画像の Web サイトへの統合を参照してください。

    note note
    NOTE
    ホットスポットを含むインタラクティブ画像を編集しているときに、画像を切り取ると、ホットスポットは削除されます。

(オプション)インタラクティブ画像のプレビュー optional-previewing-interactive-images

プレビューを使用して、顧客に対して示されるインタラクティブ画像の表示方法を確認し、画像のホットスポットをテストして動作が期待どおりであるかを確認することができます。

インタラクティブ画像の設定が完了したら、この画像を公開できます。
Web ページへのビデオビューアまたは画像ビューアの埋め込みを参照してください。
Web アプリケーションへの URL のリンクを参照してください。インタラクティブコンテンツに相対 URL のリンク(特に AEM Sites ページへのリンク)がある場合、URL ベースのリンク方法は使用できません。
ページへの Dynamic Media アセットの追加を参照してください。

インタラクティブ画像をプレビューするには::

  1. Assets ビューで、作成した既存のインタラクティブ画像の場所に移動し、タップしてプレビューで表示します。
  2. プレビューページの左上隅付近にある コンテンツ ドロップダウンリストから、 ビューア.
  3. ビューア リスト、タップ Shoppable_Banner または作成したインタラクティブ画像ビューアプリセットの名前。
  4. 画像上のホットスポットをタップし、関連付けられたアクションをテストします。

インタラクティブ画像アセットの公開 publishing-interactive-image-assets

インタラクティブ画像アセットの公開方法について詳しくは、アセットの公開を参照してください。

インタラクティブ画像の Web サイトへの統合 integrating-an-interactive-image-with-your-website

バナー画像をアップロードし、ホットスポットを画像に追加してインタラクティブ画像を公開したら、次に Web サイトページにその画像を追加できます。

AEM Sites のユーザーである場合は、インタラクティブメディアコンポーネントをページにドラッグすることによりインタラクティブ画像を追加できます。ページへの Dynamic Media アセットの追加を参照してください。

スタンドアロン AEM Assets のユーザーである場合は、この節で説明するようにインタラクティブ画像を手動で Web サイトに追加できます。

  1. 公開済みのインタラクティブ画像の埋め込みコードをコピーします。

    Web ページへのビデオビューアまたは画像ビューアの埋め込みを参照してください。

  2. コピーした埋め込みコードを、Web ページ内の必要な場所に追加します。

    コピーされた埋め込みコードはレスポンシブ環境向けに設定されているので、追加された場所に自動的に適応します。

次のデモ Web サイトを例として使用します。

https://experienceleague.adobe.com/tools/dynamic-media-demo/shoppable-banner/we-fashion/landing-0.html?lang=ja

3 人の男の写真は静止的です IMG タグ:

<img class="img-responsive" width="100%" title="Hero Image 2" alt="Hero Image 2" src="images/shoppable-banner.jpg">

統合は、IMG タグを削除して AEM Assets からコピーした埋め込みコードに置き換えるだけで簡単にできます。以下の URL を確認すると、ページ上に 3 つの円のホットスポットを伴うショッパブルインタラクティブ画像が表示されています。

https://experienceleague.adobe.com/tools/dynamic-media-demo/shoppable-banner/we-fashion/landing-1.html?lang=ja

NOTE
この時点では、デモ Web サイトのショッパブルインタラクティブ画像上のホットスポットは表示用のみで、まだ既存のクイックビューと統合されていません。

レスポンシブ環境用のショッパブルインタラクティブ画像に切り抜きを適用するには、インタラクティブ画像設定属性を含めます ZoomView.iscommand 道へ ZoomView は呼び出すコンポーネントで、は iscommand は、適用する crop 画像サービングコマンドです。

ZoomView.iscommand 設定属性を参照してください。

crop 画像サービングコマンドを参照してください。

これで、インタラクティブ画像を Web サイト上の既存のクイックビューに統合する準備が整いました。

インタラクティブ画像の既存のクイックビューへの統合 integrating-an-interactive-image-with-an-existing-quickview

NOTE
このタスクはスタンドアロン AEM Assets のユーザーのみに適用されます。

このプロセスの最後の手順は、インタラクティブ画像を Web サイト上の既存のクイックビュー実装に統合することです。 すべてのケースで機能する統合のソリューションはありません。クイックビューの実装はすべて独自であり、最も多くの場合、フロントエンドの IT 担当者の支援を伴う具体的なアプローチが必要です。

既存のクイックビュー実装は一般的に、Web ページ上で以下の順に発生する、相互に関連するアクションの連鎖となっています。

  1. ユーザーは、Web サイトのユーザーインターフェイス内で、特定の要素を起動します。
  2. フロントエンドコードは、手順 1 で起動されたユーザーインターフェイスの要素に基づいてクイックビュー URL を取得します。
  3. フロントエンドコードは、手順 2 で取得した URL を使用して Ajax リクエストを送信します。
  4. バックエンドロジックは、対応するクイックビューのデータまたはコンテンツをフロントエンドコードに返します。
  5. フロントエンドコードは、クイックビューのデータまたはコンテンツを読み込みます。
  6. (オプション)フロントエンドコードは、読み込んだクイックビューのデータを HTML 表現に変換します。
  7. フロントエンドコードは、モーダルダイアログボックスまたはパネルを表示し、エンドユーザー向けに、画面上に HTML コンテンツをレンダリングします。

これらの呼び出しは、必ずしもそれぞれ独立した、Web ページのロジックから任意の手順で呼び出すことができるパブリックな API 呼び出しを表すわけではありません。むしろ、次の手順が前の手順の最後のフェーズ(コールバック)に隠されているような連鎖的な呼び出しになっています。

ショッパブルインタラクティブ画像が手順 1 と手順 2 の一部を置き換えるのと同時に、ユーザーがショッパブル画像内のホットスポットをクリックすると、そのようなユーザー操作がビューアによって処理されます。 ビューアは、以前にAEM Assetsに追加されたすべてのホットスポットデータを含む Web ページにイベントを返します。

そのようなイベントハンドラーでは、フロントエンドコードは次の処理を実行します。

  • ショッパブルインタラクティブ画像から発生するイベントをリッスンします。
  • ホットスポットデータに基づいてクイックビュー URL を作成します。
  • バックエンドからクイックビューを読み込み、表示用に画面にレンダリングするプロセスをトリガーします。

AEM Assetsから返される埋め込みコードには、次のハイライトされたコードスニペットに示すように、既にすぐに使用できるイベントハンドラーがコメントアウトされています。

        var s7interactiveimageviewer = new s7viewers.InteractiveImage({
            "containerId" : "s7interactiveimage_div",
            "params" : {
                "serverurl" : "https://aodmarketingna.assetsadobe.com/is/image",
                "contenturl" : "https://aodmarketingna.assetsadobe.com/",
                "config" : "/etc/dam/presets/viewer/Shoppable_Media",
                "asset" : "/content/dam/mac/aodmarketingna/shoppable-banner/shoppable-banner.jpg" }
        })
        /* // Example of interactive image event for Quickview.
             s7interactiveimageviewer.setHandlers({
                "quickViewActivate": function(inData) {
                    var sku=inData.sku; //SKU for product ID
                    //To pass other parameter from the hotspot, you will need to add custom parameter during the hotspot setup as parameterName=value
                    loadQuickView(sku); //Replace this call with your Quickview plugin
                    //Please refer to your Quickviewer plugin for the Quickview call
                 },
             });
        */
        s7interactiveimageviewer.init();

そのため、必要な処理は、このコードのコメントアウトを解除し、ダミーのハンドラー本体を、特定の Web ページ専用のコードに置き換えることだけです。

クイックビュー URL を作成するプロセスは、基本的に、前述のホットスポットの変数を識別するプロセスとは反対です。

ホットスポットの変数の識別を参照してください。

以前のクイックビュー URL の例を使用すると、クイックビュー URL の各ケースでの構築方法を以下の例で確認できます。

単一の SKU(クエリ文字列内)
s7interactiveimageviewer.setHandlers({ "quickViewActivate": function(inData) { var quickViewUrl = "https://server/json?productId=" + inData.sku + "&source=100"; }, });
単一の SKU(URL パス内)
s7interactiveimageviewer.setHandlers({ "quickViewActivate": function(inData) { var quickViewUrl = "https://server/product/" + inData.sku; }, });
SKU とカテゴリ ID(クエリ文字列内)
s7interactiveimageviewer.setHandlers({ "quickViewActivate": function(inData) { var quickViewUrl = "https://server/quickView/product/?category=" + inData.categoryId + "&prodId=" + inData.sku; }, });

クイックビュー URL をトリガーしてクイックビューパネルをアクティベートするための最後の手順では、フロントエンドの IT 担当者のサポートが必要になる可能性が高くなります。フロントエンド IT 担当者は、すぐに使用できるクイックビュー URL を用意し、クイックビューを適切な手順で正しく実装するための最適な方法を知っています。

これらの手順をデモ Web サイトに適用してショッパブルインタラクティブ画像をクイックビューのコードに完全に統合する方法を確認できます。 以前は、クイックビュー URL の構造は次のように識別されていました。

/datafeed/$categoryId$-$SKU$.json

この URL を quickViewActivate ハンドラー内で再構成するために、ビューアのコードからハンドラーに渡される inData オブジェクト内の categoryId フィールドと SKU フィールドを使用できます。

var sku=inData.sku;
var categoryId=inData.categoryId;
var quickViewUrl = "datafeed/" + categoryId + "-" + sku + ".json";

このデモ Web サイトは、単純な loadQuickView() 関数呼び出しを使用してクイックビューダイアログボックスを起動しています。この関数は、1 つの引数(クイックビューデータの URL)のみを受け取ります。したがって、ショッパブルインタラクティブ画像を統合するために必要な最後の手順は、quickViewActivate ハンドラーに次のコード行を追加することです。

loadQuickView(quickViewUrl);

次に、ソースコード全体を示します。

 var s7interactiveimageviewer = new s7viewers.InteractiveImage({
  "containerId" : "s7interactiveimage_div",
  "params" : {
   "serverurl" : "https://aodmarketingna.assetsadobe.com/is/image",
   "contenturl" : "https://aodmarketingna.assetsadobe.com/",
   "config" : "/etc/dam/presets/viewer/Shoppable_Media",
   "asset" : "/content/dam/mac/aodmarketingna/shoppable-banner/shoppable-banner.jpg" }
 })
   s7interactiveimageviewer.setHandlers({
   "quickViewActivate": function(inData) {
     var sku=inData.sku;
     var categoryId=inData.categoryId;
    var quickViewUrl = "datafeed/" + categoryId + "-" + sku + ".json";
    loadQuickView(quickViewUrl);
    },
   });
 s7interactiveimageviewer.init();

インタラクティブ画像が完全に統合された最終的なデモ Web サイトは、次のようになります。

https://experienceleague.adobe.com/tools/dynamic-media-demo/shoppable-banner/we-fashion/landing-3.html?lang=ja

クイックビューを使用したカスタムポップアップの作成 using-quickviews-to-create-custom-pop-ups

詳しくは、 クイックビューを使用したカスタムポップアップの作成.

recommendation-more-help
4452738f-2bdf-4cd4-9b45-905a69d607ad