Adobe Commerce OptimizerのAEM Assetsを設定
[SaaSのみ]{class="badge positive" title="Adobe Commerce Optimizer プロジェクトにのみ適用されます。"}
Adobe Commerce OptimizerのAEM Assets統合により、販売者はAEM Assetsを商品画像用の一元的なデジタルアセット管理ソリューションとして使用できるようになります。 このガイドでは、Commerce Optimizerに固有の設定について説明します。
Adobe Commerce （PaaS）またはAdobe Commerce as a Cloud Service （ACCS）とは異なり、Commerce Optimizerには管理者設定UIがありません。 統合を有効にするには、Adobe Commerce OptimizerとAEM Assetsの詳細を記載したサポートチケットを作成します。 Adobe サポートは、統合を設定し、Assets Integration Serviceにテナントを登録します。
次の図は、Adobe Commerce OptimizerとAEM Assets統合の間の製品同期の概要です。
この統合には、主に2つのフローがあります。
-
AEM Assetsから：アセットが承認、拒否、または削除されると、イベントはAdobe パイプラインを通じてAssets Integration Serviceに流れます。 このサービスは、
match-by-SKU（メタデータ駆動型）または カスタムマッチャー（App Builder） を使用してアセットを商品と照合し、次にproduct-assetマッピングをCommerce Optimizerに送信し、そこで商品レイヤーとして保存します。 -
Adobe Commerce Optimizerから：Commerce Optimizerで商品が更新されると、イベントはAdobe パイプラインを経由してAssets Integration Serviceに流れます。 サービスは、一致するアセットマッピングをすべてAdobe Commerce Optimizerに同期します。
前提条件
統合を設定する前に、次のことを確認してください。
- 製品ビジュアルの使用権限を持つアクティブなAdobe Commerce Optimizer インスタンス、またはDynamic Mediaを持つ任意のAEM Assets ライセンス。
- AEM Assets as a Cloud Serviceへのアクセス。
- Commerce OptimizerとAEM Assetsの両方が同じAdobe IMS組織内にあります。
- AEM Assets環境でOpenAPIを有効にしたDynamic Media。
オンボーディング
AEM Assets統合をCommerce Optimizerでオンボーディングするには、 サポートチケットを作成する必要があります。
Adobe サポートは、チケット内の情報を使用して、Assets Integration Serviceにテナントを登録し、統合を設定します。
サポートチケットに次の情報を含めます。
- Adobe Commerce Optimizerテナント ID （インスタンス ID）がCommerce Optimizer URLまたはCommerce Cloud Manager UIに見つかりました。
- AEM プログラム ID。
- AEM Environment ID。
- 一致するルール: SKUまたは外部マッチャー（App Builder） によって一致します。
- Layer: テナントを登録するカタログ レイヤー名。 必要に応じて、カスタム名を指定します。 それ以外の場合は、デフォルトの
AEM-Assetsが使用されます。 - ロケール: テナントを登録するカタログ ソース ロケール （例：
en-US）。
Adobe サポートがチケットを処理すると、統合が設定され、テナントがAssets Integration Serviceに登録されます。
オンボーディングが完了したら：
-
Assets Integration Serviceへの登録：お客様のCommerce Optimizer テナントは、Adobe Commerce Optimizer テナント ID、AEM プログラム ID、AEM Environment ID、およびテナントを使用してAssets Integration Serviceに登録されています。
-
イベントサブスクリプション:Assets Integration Serviceのサブスクリプション：
- AEM Assets イベント（アセット承認済み、更新、削除）
- Commerce Optimizer個のカタログイベント（製品が作成、更新されました）
制限
Commerce Optimizer統合には次の制限があります。
- マーチャントごとに1つのレイヤー - AEM Assets統合では、マーチャントごとに1つのAEM-Assets レイヤー（テナントごとに1つのソース）がサポートされます。 現在、マーチャントごとに複数のレイヤーを設定することはサポートされていません。
- 画像のみ – 統合はビデオまたはその他のメディアタイプをサポートしていません。
- カテゴリ画像がありません- カテゴリ画像の同期は使用できません。 Assets セレクター（UI挿入）用のAEM Assetsのカテゴリ画像はサポートされていません。
- マルチサイトの区別がありません – 統合ではマルチサイトは処理されません。製品に関連付けられている画像は、すべてのチャネルとポリシーで同じように表示されます。
- 画像の位置/順序 – 画像の位置と順序はサポートされていません。
- 製品が存在する必要があります – 製品がCommerce Optimizerに存在しない場合、その製品アセットマッピング用にレイヤーは作成されません。
- レイヤーフィールドの上書き - レイヤー内の値がベースカタログを上書きします。 レイヤーペイロードでフィールドが送信されない場合は、空の値で上書きできます。 AEM Assets コンテンツに専用レイヤーを使用します。他の目的で既存のレイヤーを再利用すると、意図しないデータ損失が発生する可能性があります。
AEM Assetsの設定
Commerce OptimizerのAEM Assetsのインストールおよび設定プロセスは、Adobe Commerce as a Cloud Serviceの場合と同じです。 詳細な手順については、Commerce メタデータをサポートするようにAEM Assets プロジェクトを設定するを参照してください。
AEM Assetsを導入しました。
-
AEM Assets設定: Commerce メタデータプロファイルを設定します。 メタデータプロファイルの設定を参照してください。
-
Dynamic Mediaの有効化: AEM Assets環境でOpenAPI機能を使用したDynamic Mediaが有効になっていることを確認します。
AEM Assetsの設定
製品とアセットの同期を有効にするには、AEM Assets環境を設定します。
手順1:OpenAPIでDynamic Mediaを有効にする
AEM Assets環境でDynamic Media with OpenAPIを有効にする必要があります。 製品ビジュアルと新しいAEM Assets ライセンスを使用すると、Cloud Managerを介してセルフサービス方式で有効にできます。 古いAEM Assets ライセンスを有効にするには、Adobe サポートが必要です。 イネーブルメント手順については、AEM Assets プロジェクトの設定を参照してください。
手順2：オプション。 Commerce メタデータプロファイルの設定
AEM Assetsでメタデータプロファイルを設定して、Commerce固有のメタデータを保存します。
詳しい手順については、 メタデータプロファイルの設定を参照してください。
手順3：アセットへのメタデータの適用
AEM AssetsでCommerceのメタデータを商品画像に追加しましょう。
フィールド定義についてはAEM Commerce パッケージの内容、設定手順については メタデータプロファイルの設定を参照してください。
トリガーにデータを同期するには、アセットが承認済み ステータスである必要があります。 メタデータのみを保存しても、イベントはトリガーされません。
AEM-Assets レイヤーを カタログビューに割り当てます。 レイヤーが割り当てられていない場合、製品画像データが予期せず上書きされる可能性があります。同期
設定が完了すると、統合によってproduct-asset マッピングが自動的に同期されます。
詳しくは、 カスタム自動一致を参照してください。
SKU ワークフローによる一致の例
既存のアセットを新製品に追加する際の一般的な流れ：
-
Commerce Optimizerで製品を作成します（APIまたはデータ取り込み経由）。 製品は、最初は画像なしで存在できます。
-
AEM Assetsで、商品にマッピングするアセットを開きます。
-
商品SKUをcommerce:skus メタデータに追加し、画像の役割を割り当てます（例：
thumbnail、image）。 -
アセットの配信を承認します。 これにより、Assets Integration Serviceが処理するイベントがトリガーされます。
-
Assets Integration Serviceは、product-image マッピングをCommerce Optimizerに送信します。 Commerce Optimizerの製品が、アセットの画像で更新されます。
-
画像が表示されていることを確認します。 同期が完了するまでの時間（通常は数分以内）を許可してから、Commerce Optimizer UI （データ同期やカタログビューなど）で商品を確認するか、ストアフロント API （カタログサービス、ライブサーチ、ストアフロントGraphQL API）をクエリして、画像が返されることを確認します。
画像の役割の処理
製品に同じ画像の役割を使用する複数のアセットがある場合（例えば、thumbnailの役割を持つ2つのアセット）、統合により、その役割を1つのアセットのみが保持され、Commerce Optimizer レイヤーでの役割の重複とストアフロントの予期しない動作が回避されます。
ビヘイビアー： AEM Assetsから更新が送信されると、最も新しく更新されたアセットに画像の役割（thumbnailなど）が割り当てられ、その役割は前のアセットから削除されます。 これにより、重複した画像の役割がストアフロントに表示されるのを防ぐことができます。