ドキュメントCommerceAEM Assets統合

Commerce メタデータをサポートするようにAEM Assets プロジェクトを設定する

最終更新日： 2026年5月12日

作成対象：

  • {"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"}

AEM AssetsをCommerceのデジタルアセット管理システム （DAM）として使用する場合、assets-commerce パッケージをインストールすると、AEM オーサリング環境からCommerce製品の画像とビデオを管理できます。

AEM オーサリング環境からAEM Assets アセットを管理するために必要なパッケージコードとメタデータを使用してCommerce プロジェクトを設定するには、次の手順を実行します。

  1. assets-commerce パッケージの内容について説明します

  2. Commerce メタデータをサポートするようにAEM Assets プロジェクトを設定するには、インストール手順を実行します

AEM Commerce assets-commerce パッケージの内容

Adobeは、Experience Manager Assets as a Cloud Service環境設定にCommerce名前空間およびメタデータスキーマリソースを追加するためのAEM Commerce パッケージコード assets-commerceを提供します。

このパッケージコードは、次のリソースをAEM Assets オーサリング環境に追加します。

  • Commerce関連のプロパティを識別するための​ カスタム名前空間、Commerce。

    • Adobe Commerce プロジェクトに関連付けられたCommerce アセットにタグ付けするためのラベル Eligible for Commerceを持つカスタムメタデータタイプ commerce:isCommerce。

    • カスタムメタデータタイプ commerce:skusと、対応するUI コンポーネントを使用して​Product Data プロパティを追加します。 商品データには、Commerce アセットを商品SKUに関連付けるためのメタデータプロパティが含まれています。

      ​ カスタム製品データ UI コントロール ​ {width="600" modal="regular"}

    • Commerceでのアセットのビジュアライゼーション方法を示すカスタムメタデータタイプ commerce:rolesとcommerce:positions属性。

    • 代替テキストマルチフィールド （Alt texts） メタデータ。エディターは、Commerce ストアビューコードでキー付きの代替テキストを入力できます。 これは、カタログ内での製品画像の割り当てやスコープ設定は変更されません。 AEM Assets メタデータの代替テキスト ​を参照してください。

  • Commerce アセットのタグ付け用のEligible for CommerceおよびProduct Data フィールドを含むCommerce タブを持つメタデータスキーマフォーム。 このフォームには、AEM Assets UIからrolesおよびposition フィールドを表示または非表示にするオプションも用意されています。

    AEM Assets メタデータスキーマフォームの「Commerce」タブ ​ {width="600" modal="regular"}

  • 最初のアセットの同期をサポートするために、​ サンプルにタグ付けして承認されたCommerce アセット ​ equipment_6.jpgが含まれています。 AEM AssetsからAdobe Commerceに同期できるのは、承認済みのCommerce アセットのみです。

NOTE
AEM Commerce パッケージコード​について詳しくは、GitHubのreadme ページを参照してください。

AEM Assets メタデータの代替テキスト

Alt texts​マルチフィールドは、対象となる画像を編集するときに、Commerce​タブのAEM Assets アセットメタデータエディターで使用できます。

IMPORTANT
ストアごとのビューの動作は、代替テキストにのみ適用されます。 AEM Assetsとの連携では、Adobe Commerceのストアビューごとに異なる商品画像が同期されません。 AEMの製品画像は、このリリース以前と同じギャラリー割り当て動作で引き続きCommerceに同期されます。

マルチフィールドには、Commerce ストアビューごとに1行が含まれます。 各行には2つの入力があります。

  • Store View Code — ストアビュー識別子（defaultまたはen_USなど）。

  • Alt Text – そのストアビューの代替テキスト（255文字に制限）。

追加のストアビュー用に行を追加するには、Add​を選択します。 行を削除するには、その行の​Delete アイコンを選択して削除します。

​ ストアビューコードと代替テキスト入力を含む代替テキストマルチフィールド ​ {width="600" modal="regular"}

保存すると、クライアント側の検証により、任意の行に空の​ Store View Code ​がある場合、または2つの行で同じストアビューコードが使用されている場合は、送信がブロックされます（大文字と小文字は区別されません）。

代替テキストエントリは、次の2つのインデックス整列String[] プロパティとしてJCR アセットメタデータに保持されます。

  • commerce:altTextStoreViews：各行のビューコードを格納します。
  • commerce:altTextValues: commerce:altTextStoreViewsの各エントリと同じインデックスにあるalt テキストに一致します。

これらのアセットがAdobe Commerceに同期すると、一致するストアビューコードのストアごとのビュー代替テキストが商品メディアギャラリーに書き込まれます。 基になる画像マッピングは変更されません。

前提条件

assets-commerce パッケージコードをAEM Assets as a Cloud Service AEM環境にデプロイするには、次のリソースと権限が必要です。

製品ビジュアル

OpenAPI機能を備えた[SaaSのみ]{class="badge positive" title="Adobe Commerce as a Cloud ServiceおよびAdobe Commerce Optimizer プロジェクト（Adobeが管理するSaaS インフラストラクチャ）にのみ適用されます。"}のDynamic Mediaは、AEM Assetsを活用した商品ビジュアルのセルフサービスです。

  1. Cloud Managerに移動します。

  2. 目的の環境を選択します。

  3. OpenAPI機能を使用して​Dynamic Mediaを有効にする。

    OpenAPI機能を備えた​Dynamic Media ボタンがアクティブでない場合は、サポートチケットを開きます。

AEM Assets

[PaaSのみ]{class="badge informative" title="Cloud プロジェクト上のAdobe Commerce（Adobeで管理されるPaaS インフラストラクチャ）にのみ適用されます。"} AEM as a Cloud Serviceで、次の情報を記載したAdobe サポートチケットを送信します。

  • タイトル：Dynamic Media OpenAPIを有効にして、Adobe CommerceとAEM Assetsを完全に統合する

    • サポートチケットの内容：

      • AEM Program ID
      • Adobe Commerce URL
      • AEM Environment ID
      • IMS Org ID

サポートチケットを送信すると、AdobeはCloud Services環境でOpenAPI機能を備えたDynamic Mediaを有効にし、IMS クライアント IDなどの詳細を共有して、統合を進めることができます。

手順1:assets-commerce パッケージのインストール

  1. AEM Cloud Managerに移動し、プログラムを選択し、Adobe Commerceと統合する実稼動環境とステージング環境を作成します。

  2. 選択したプログラムのAdobe管理Git リポジトリ ​を複製します。

    Cloud Manager リポジトリの資格情報とコピーコマンド ​ {width="600" modal="regular"}

    Cloud Manager パイプライン​で、Access Repo Info​を選択して​ Repository Info ​を開きます。 URL​または​ Git command line ​の値をコピーし、必要に応じてアクセス パスワードを生成してから、Git クライアントとローカルにクローンを作成します。

  3. GitHubから、AEM Assets Commerce リポジトリ ​からパッケージコードをダウンロードします。

  4. ​ ローカルのAEM開発環境から、ダウンロードしたコードを既存のAdobe管理リポジトリに手動でコピーします。

  5. プロジェクトのすべてのfilter.xmlおよびpom.xml ファイルで、<my-app>のすべての出現箇所をアプリ名に置き換えます。

    note
    NOTE
    または、カスタムコードを​Maven パッケージとしてAEM Assets プロジェクト設定にインストールすることもできます。

  6. 変更を確定し、ローカル開発ブランチをCloud Manager Git リポジトリにプッシュします。

  7. ​ デプロイメントパイプライン ​を設定するか、パイプラインが選択した環境に変更をデプロイできることを確認します。

    Cloud Manager パイプライン ​ {width="600" modal="regular"}

    パイプラインが存在する場合、アクションメニュー（…）を開きます Run、Edit、View/Edit variables​またはその他のアクションへ – 上記のリンクされたCloud Manager パイプラインのドキュメントを参照してください。

  8. AEM Cloud Managerから、​ パイプラインを使用してコードをデプロイし、AEM環境を更新します。

  9. 任意のアセットに移動し、そのプロパティを編集して変更を検証します。

    • デフォルトのメタデータスキーマには、「Commerce」タブが含まれています。

    • 製品SKUとEligible for Commerce フィールドが表示されます。

「Commerce」タブがプロパティに表示されない

「Commerce」タブがプロパティに表示されない場合は、メタデータスキーマエディターで次の手順を手動で実行する必要があります。

  1. メタデータスキーマエディターに移動します。

  2. 編集​を選択して、デフォルトのメタデータスキーマフォームを変更します。

  3. 「Commerce」タブを作成し、選択します。

  4. Product コンポーネントを​Commerce タブにドラッグ&ドロップし、プロパティ commerce:skusにマッピングします。

  5. 役割を表示​および​ 順序を表示 ​のチェックボックスを選択します。

  6. checkbox コンポーネントを​Commerce タブにドラッグ&ドロップし、プロパティ commerce:isCommerceにマッピングします。 オプションとして​ Yes ​と​ No ​を定義します。

その他の問題が発生した場合は、​ サポートチケット ​を作成するか、AEM Assets Integrationの営業担当者にお問い合わせください。

手順2：オプション。 メタデータプロファイルの設定

AEM Assets オーサー環境で、メタデータプロファイルを作成して、Commerce アセットメタデータのデフォルト値を設定します。 次に、新しいプロファイルをAEM Asset フォルダーに適用して、これらのデフォルトを自動的に使用します。 この設定により、手作業を削減してアセット処理が合理化されます。

メタデータプロファイルを設定する場合、次のコンポーネントのみを設定する必要があります。

  • 「Commerce」タブを追加します。 このタブでは、テンプレートによって追加されたCommerce固有の設定を有効にします。

  • 「Eligible for Commerce」フィールドを「Commerce」タブに追加します。

製品データ UI コンポーネントは、テンプレートに基づいて自動的に追加されます。

メタデータプロファイルの定義

  1. Adobe Experience Manager オーサー環境にログインします。

  2. Adobe Experience Manager ワークスペースから、「Adobe Experience Manager」アイコンをクリックして、AEM Assetsのコンテンツ管理ワークスペースを作成します。

    AEM Assets オーサリング ​ {width="600" modal="regular"}

  3. ハンマーアイコンを選択して、管理者ツールを開きます。

    AEM オーサー管理者管理メタデータプロファイル ​ {width="600" modal="regular"}

  4. Metadata Profiles​をクリックして、プロファイル設定ページを開きます。

  5. Commerce統合用のメタデータプロファイル Create。

    AEM オーサー管理者メタデータプロファイルを追加 {width="600" modal="regular"}

  6. Commerce メタデータのタブを追加します。

    1. 左側で、Settings​をクリックします。

    2. タブ セクションの​ + ​をクリックし、Tab Name、Commerceを指定します。

  7. フォームにEligible for Commerce フィールドを追加します。

    AEM オーサー管理者がメタデータ フィールドをプロファイルに追加 {width="600" modal="regular"}

    • Build form​をクリックします。

    • Single Line text フィールドをフォームにドラッグします。

    • Field Label​をクリックして、ラベルのEligible for Commerce テキストを追加します。

    • 「設定」タブで、「フィールドラベル」にラベルテキストを追加します。

    • プレースホルダーテキストをyesに設定します。

    • Map to Property フィールドに、次の値をコピーして貼り付けます

      code language-terminal 
      ./jcr:content/metadata/commerce:isCommerce

  8. オプション。 承認済みのCommerce アセットをAEM Assets環境にアップロードするときに自動的に同期させるには、Basic タブの​ Review Status ​フィールドのデフォルト値をapprovedに設定します。

  9. アップデートを保存します。

メタデータプロファイルをCommerce assets ソースフォルダーに適用する

  1. Metadata Profiles ページから、Commerce統合プロファイルを選択します。

  2. アクションメニューから、Apply Metadata Profiles to Folders​を選択します。

  3. Commerce アセットを含むフォルダーを選択します。

    Commerce フォルダーが存在しない場合は作成します。

  4. Apply​を選択します。

次のステップ

recommendation-more-help
commerce-help-aem-assets-integration