インタラクティブ画像

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

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

chlimage_1-152

上の図に示す Web ページの実際のインタラクティブ画像を参照してください。

インタラクティブ画像バナーの作成方法

インタラクティブ画像バナーの作成方法に関する説明を視聴します(10 分 33 秒)。このガイドでは、インタラクティブ画像バナーのプレビュー、編集、配信方法も説明します。

クイックスタート:インタラクティブ画像

次のワークフローの手順説明は、Adobe Experience Manager Assets 内のインタラクティブ画像をすぐに使い始めることを目的としたものです。

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

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

インタラクティブ画像の手順:

  1. (オプション)ホットスポットの変数を識別します。Adobe Experience Manager アセットと Dynamic Media スタンドアロンを使用する場合は、既存のクイックビュー実装で使用する動的変数を指定します。これにより、インタラクティブ画像を作成する際に、ホットスポットデータを入力できるようになります。(オプション)ホットスポットの変数の識別を参照してください。ただし、Experience Manager Sites または Experience Manager eCommerce(あるいは両方)を使用している場合、この手順は必要ありません。

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

  3. 画像バナーをアップロードします。インタラクティブにする画像バナーをアップロードします。画像バナーのアップロードを参照してください。

  4. 画像バナーにホットスポットを追加します。1 つ追加以上のホットスポットを画像バナーに追加します。各ハイパーリンクを、ハイパーリンク、クイックビュー、エクスペリエンスフラグメントなどのアクションに関連付けます。ホットスポットを追加した後は、インタラクティブ画像を公開するとタスクが終了します。画像バナーへのホットスポットの追加を参照してください。(オプション)インタラクティブ画像のプレビューを参照してください。必要に応じて、ショッパブルバナーの表示を確認して、インタラクティビティをテストすることができます。インタラクティブ画像アセットの公開方法について詳しくは、アセットの公開を参照してください。

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

(オプション)ホットスポットの変数の識別

メモ

このタスクが必要になるのは次に該当する場合のみです。

  • クイックビューをトリガーして、画像にインタラクティブ機能を追加する。
  • Experience Manager の実装で、製品データを eCommerce ソリューションから Experience Manager に取り込む際に、e コマース統合フレームワークを​使用していない。このようなソリューションには、IBM WebSphere® Commerce、Elastic Path、SAP Hybris、Intershop などがあります。

Adobe Experience Manager の実装で Adobe Experience Manager eCommerce を使用している場合は、このタスクをスキップして次のタスクに進みます。

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

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

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

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

既存のクイックビュー実装を担当している IT 担当者に問い合わせれば済む場合もあります。おそらく IT 担当者であれば、システムのクイックビューを識別するために必要な最小限のデータセットを知っている可能性が高くなります。ただし、フロントエンドコードの既存の動作を分析するだけでもかまいません。

ほとんどのクイックビュー実装では、次のような枠組みが使用されています。

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

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

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

  • Google Chrome で、ブラウザーから送信されるすべての HTTP リクエストを参照するには、F12 キーを押してデベロッパーツールパネルを開き、「Network」タブを選択します。Mac の場合、Command + Option + I キーを押してデベロッパーツールパネルを開き、「Network」タブを選択します。

  • Firefox で F12 キーを押して、Firebug プラグインをアクティブ化し、「ネット」タブを使用します。または、組み込みのインスペクターツールと「ネットワーク」タブを使用できます。
    Mac の場合、Command + Option + I キーを押してデベロッパーツールパネルを開き、「Inspector」タブを選択します。

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

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

このプロセスの実行中は、製品カテゴリや製品タイプが異なる、Web サイトの様々な領域にアクセスすることが重要です。クイックビュー URL には、特定の web サイトカテゴリに共通する部分を含めることができるからです。ただし、変更されるのは、Web サイトの別の領域を訪問した場合のみです。

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

ただし、複雑なケースでは、クイックビュー URL には SKU に加えて様々な要素が含まれます。これらの要素には、例えば、カテゴリ ID、カラーコード、サイズコードなどが含まれます。その場合、各要素は Experience Manager 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 パラメーターに、カテゴリ IDcategory= パラメーターに格納されています。

そのため、ホットスポット定義はペアになります。つまり、SKU 値と、categoryId という追加の変数です。結果のペアは次のようになります。

  • SKU が 305466categoryId1100004

  • SKU が 310181categoryId1100004

  • SKU が 308706categoryId1740148

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

このデモ Web ページにはいくつかの製品サムネールがあり、それぞれのサムネールには、「See More」というラベルの付いたクイックビューボタンが用意されています。Web ブラウザーのデバッグツールをアクティブにしたまま各ボタンを選択し、記録されたクイックビュー URL に注目してください。そのページの 4 つの製品クイックビューをすべてアクティベートすると、バックエンドに対して次のリストのクイックビューリクエストが作成されます。

  • /datafeed/Male-Windbreaker.json
  • /datafeed/Male-SimpleHenley.json
  • /datafeed/Male-CamoPullover.json
  • /datafeed/Female-QuiltedDownJacket.json

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

  • 最初のタイプは Male または Female です。これは「製品カテゴリ」と呼ばれます。
  • 2 つ目のタイプは製品名です(CamoPullover など)。これは製品の SKU であることが大半です。

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

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

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

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

(オプション)インタラクティブ画像ビューアプリセットの作成

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

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

ビューアプリセットを保存すると、Experience Manager Assets のビューアプリセットリストページで自動的にアクティベートされます(有効になります)。つまり、そのビューアプリセットは、インタラクティブメディアコンポーネントで、アセットを表示するときに常に表示されます。ただし、このビューアプリセットが設定されているインタラクティブバナーを​配信​するには、ビューアプリセットも​公開​します。このルールは、カスタムまたは初期設定のビューアプリセットに対して適用されます。

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

  1. 左パネルで、ツールアセットビューアプリセット​に移動します。

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

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

    このタイトルは、保存後、ビューアプリセットリストページに表示されます。

  4. 「リッチメディアタイプ」プルダウンメニューで、「インタラクティブ画像」を選択します。

  5. 作成」を選択します。

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

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

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

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

    ビューアプリセットの公開を参照してください。

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

画像バナーのアップロード

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

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

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

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

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

画像バナーへのホットスポットの追加

ホットスポット管理ページのエディターを使用して、画像バナーにホットスポットを追加できます。

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

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

メモ

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

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

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

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

メモ

インタラクティブ画像またはカルーセルバナー内の画像にホットスポットを追加すると、ホットスポット情報は同じメタデータの場所に保存されます。この場所は、インタラクティブ画像かカルーセルバナーかに関係なく、画像の場所に対する相対的な位置になります。つまり、どちらのビューアでも、同じ画像を、定義済みのホットスポットデータとともに簡単に再使用することができます。
ただし、カルーセルバナーでは、ホットスポットを含む画像のイメージマップをサポートしていますが、インタラクティブ画像ではサポートしていません。同じ画像を使用するインタラクティブ画像またはカルーセルバナーを作成する場合には、このことに注意してください。同じ画像の別々のコピーを使用してインタラクティブ画像とカルーセルバナーを作成することもできます。
カルーセルバナーも参照してください。

メモ

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

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

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

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

    • 画像の上にマウスポインターを置き、選択(チェックマークアイコン)をタップします。ツールバーの「編集」をタップします。

    • 画像の上にマウスポインターを置き、その他のアクション(3 つのドットのアイコン)/編集​をタップします。

    • 詳細表示ページで画像を開くには、画像をタップします。ツールバーの「編集」をタップします。

  3. ページの左上隅にある「ホットスポットを追加」(指先アイコン)をタップして、ホットスポット管理ページを開きます。

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

    1. ホットスポット管理ページの左上隅にある「ホットスポット」をタップします。
    2. 画像上で、ホットスポットを表示する場所をタップします。必要に応じて、ホットスポットをドラッグして場所を調整します。または、キーボードの矢印キーを使用して、選択したホットスポットの位置を制御します。
    3. 必要に応じて手順 1 と 2 を繰り返し、他のホットスポットを追加します。
    4. (オプション)ホットスポットを削除するには、そのホットスポットを画像上で選択した後、「ホットスポット」見出しの下にある​削除(ごみ箱アイコン)をタップします。
  5. 「名前」テキストフィールドにホットスポットの名前を入力します。この名前は、選択したホットスポットドロップダウンリストにも表示されます。

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

    • クイックビュー」を選択します。

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

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

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

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

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

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

    • エクスペリエンスフラグメント」を選択します。

      • Adobe Experience Manager Sites のユーザーである場合は、検索アイコン(虫眼鏡)を選択してエクスペリエンスフラグメントページを開きます。使用するエクスペリエンスフラグメントを選択します。次に、ページの右上隅にある「選択」をタップします。「ホットスポット管理」ページに戻ります。
        エクスペリエンスフラグメントを参照してください。

      • エクスペリエンスフラグメントがバナーに表示されるときの幅と高さを指定します。

        メモ

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

  7. 保存」を選択して作業内容を保存し、参照ページに戻ります。

  8. インタラクティブ画像を公開します。公開すると、クラウドにバナーが配信され、埋め込みコードが生成されてサードパーティの Web サイトと統合できます。

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

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

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

    メモ

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

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

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

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

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

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

インタラクティブ画像アセットの公開

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

インタラクティブ画像の Web サイトへの統合

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

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

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

  1. 公開済みのインタラクティブ画像の埋め込みコードをコピーします。Web ページへのビデオビューアまたは画像ビューアの埋め込みを参照してください。

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

デモ Web サイトを例として使用する際は、3 人の人物の写真が静的 IMG タグであることに注意してください。

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

統合は、IMG タグを削除して Experience Manager Assets からコピーした埋め込みコードに置き換えるだけで簡単にできます。その結果、3 つの円のホットスポットがあるページにショッパブルインタラクティブ画像が表示されます

メモ

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

レスポンシブ環境用のショッパブルインタラクティブ画像に「crop(切り抜き)」を適用するには、パスにインタラクティブ画像設定属性 ZoomView.iscommand を含めます。この場合、ZoomView コンポーネントが呼び出され、iscommand は適用する「crop」画像提供コマンドです。

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

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

これで、インタラクティブ画像を Web サイト上の既存のクイックビューに統合できるようになりました。

インタラクティブ画像の既存のクイックビューへの統合

メモ

このタスクはスタンドアロン Adobe Experience Manager Assets のユーザーにのみ当てはまります。

このプロセスの最後の手順は、インタラクティブ画像を Web サイトの既存のクイックビュー実装に統合することです。すべてのケースで機能する統合のソリューションはありません。クイックビューの実装はそれぞれがユニークで、特定のアプローチが必要となります。したがって、フロントエンドの IT 担当者の支援が役立ちます。

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

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

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

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

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

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

Experience Manager 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 + "&amp;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 + "&amp;prodId=" + inData.sku; }, });

クイックビュー URL をトリガーしてクイックビューパネルをアクティベートするための最後の手順では、フロントエンドの IT 担当者の支援が必要になります。フロントエンド IT 担当者は、すぐに使用できるクイックビュー URL を含め、クイックビュー実装を適切な手順から正しくトリガーするための最適な方法について理解しています。

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

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

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

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 サイトです。

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

クイックビューを使用したカスタムポップアップウィンドウの作成を参照してください。

このページ