ドキュメントCommerceOptimizer Connector

[PaaSのみ]{class="badge informative" title="Adobe Commerce on Cloud プロジェクト（Adobeで管理されるPaaS インフラストラクチャ）とオンプレミス プロジェクトにのみ適用されます。"}

コネクタフィードのフィールドマッピング

最終更新日： 2026年6月10日

作成対象：

  • {"id":"b5a62a22-46f7-4f0d-b151-3fc640bef588"}
  • {"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

このページでは、Adobe Commerce Optimizer ConnectorがAdobe Commerce カタログフィールドをCommerce Optimizer Catalog Data Ingestion APIで必要な形式に変換する方法について説明します。 サポートされているフィードとそのAPI エンドポイントの一覧については、​ コネクタ リファレンス ​を参照してください。

特定可能

products フィードは、製品エンドポイント ​にデータを送信します。

Adobe Commerce フィールド
Commerce Optimizer API フィールド
メモ
sku
sku
storeViewCode
source/locale
name
name
urlKey
slug
productId
externalIds[0].id
originが"AdobeCommerce"に修正されました
status
status
大文字。割り当てられた子がない複合製品の場合はDISABLEDに設定されます
description
description
shortDescription
shortDescription
visibility
visibleIn
コンマ区切りの値が分割され、マッピングされました：Catalog→CATALOG、Search→SEARCH、マッピングされていない値がドロップされました
metaTitle
metaTags/title
metaDescription
metaTags/description
metaKeyword
metaTags/keywords
配列に分割された改行区切り文字列
inStock, lowStock, weight, weightUnit
attributes[].code = "aco_ac_attributes"
JSON エンコードされたオブジェクト {inStock, lowStock, weight, weightType}。常に最初の属性エントリとして存在します
attributes[]
attributes[]
{code, values[], variantReferenceId}、inStock、lowStock、weight、weightTypeにマッピングされた各エントリは除外されます（aco_ac_attributesに入ります）
images[]
images[]
url, label；マッピングされた標準ロール：image→BASE, small_image→SMALL, thumbnail→THUMBNAIL, swatch_image→SWATCH；非標準ロールはcustomRoles[]に移動します
categoryData[].categoryPath
routes[].path
categoryData[].productPosition
routes[].position
links[].type + links[].sku
links[]
type個が大文字です。skuを含まないエントリは削除されました
parents[].productType + parents[].sku
links[]
マッピングされた型：configurable→VARIANT_OF、bundle/bundle_fixed→IN_BUNDLE
configurable options
configurations[]
id→attributeCode, label; swatchTypeが設定されている場合はオプションタイプ SWATCH、それ以外の場合はCONFIGURABLE、デフォルトのバリアントがisDefaultです。値はvariantReferenceId, label, colorHex, imageUrlです
bundle options
bundles[]
label→group; required; renderType checkbox/multi→multiSelect: true; isDefaultからの既定のSKU; アイテムにはsku、qty、userDefinedQty （qtyMutability）が含まれます

製品属性メタデータ

productAttributes フィードは、​ メタデータエンドポイント ​にデータを送信します。

Adobe Commerce フィールド
Commerce Optimizer API フィールド
メモ
attributeCode
code
storeViewCode
source/locale
label
label
dataType + frontendInput
dataType
以下の変換表を参照してください
visible
visibleIn: "PRODUCT_DETAIL"
trueの際に配列に追加されました
visibleInSearch
visibleIn: "SEARCH_RESULTS"
trueの際に配列に追加されました
visibleInListing
visibleIn: "PRODUCT_LISTING"
trueの際に配列に追加されました
visibleInCompareList
visibleIn: "PRODUCT_COMPARE"
trueの際に配列に追加されました
filterable
filterable
sortable
sortable
searchable
searchable
searchWeight
searchWeight
searchTypes
searchTypes

データタイプ変換

コネクターは、上記のマッピングテーブルのCommerce dataTypeおよびfrontendInput フィールドからAPI dataTypeを導き出します。 次の表に、コネクタが適用する変換ルールを示します。

Adobe Commerce dataType
Adobe Commerce frontendInput
Commerce Optimizer API dataType
int
boolean
BOOLEAN
int
textまたはselect
TEXT
int
その他
INTEGER
decimal
-
DECIMAL
text, varchar, static, datetime
-
TEXT
OBJECT
-
OBJECT
その他
-
TEXT
NOTE
属性のdataTypeがOBJECTに設定されている場合、製品APIは、属性値を平文の文字列ではなく構造化オブジェクトとして扱います。 クエリ時に、APIは格納された値をJSONとして解析しようとします。 解析が成功した場合、結果は応答のネストされたオブジェクトとして返されます。 この動作は、スカラー値として表せない構造化データやマルチフィールドデータを保持するなど、カスタム属性を動的に指定する場合に特に便利です。 手順については、製品属性を動的に追加するを参照してください。

プライスブック

priceBooks フィードは、価格表エンドポイント ​にデータを送信します。

他のコネクタフィードとは異なり、priceBooks フィードはAdobe CommerceのSaaS Data Export インデクサーによって収集されません。 コネクターは、管理者のweb サイトと顧客グループ設定からこのフィードを生成します。

Web サイトごとに1つの​ 基本価格表 ​が作成され、さらにweb サイトと顧客グループのペアごとに1つの​ 子価格表 ​が作成されます。

価格表ID式：

  • 基本 （通常価格）: priceBookId = websiteCode
  • 子 （顧客グループまたは共有カタログ）: priceBookId = websiteCode::sha1(customerGroupId) （sha1(customerGroupId)は顧客グループの整数IDのSHA-1 1 16進ダイジェスト）

価格フィードは、価格入力がどの価格表に属しているかを解決する際に、同じ式を使用します。 ストアフロントが顧客セッションのpriceBookIdを解決する方法については、​ ヘッドレスストアフロント統合を参照してください。

生成フィールド
Commerce Optimizer API フィールド
メモ
websiteCode, customerGroupId
priceBookId
web サイト名
name
ベースプライスブック：web サイト名。 子："Group Name (Website Name)"
websiteCode
parentId
子の価格表にのみ表示されます。基準価格表をポイントします
Web サイトのベース通貨
currency
基本価格台帳にのみ表示されます。子どもから継承されます

価格

prices フィードは、価格エンドポイント ​にデータを送信します。

Adobe Commerce フィールド
Commerce Optimizer API フィールド
メモ
sku
sku
websiteCode, customerGroupId
priceBookId
regular
regular
discounts[]
discounts[]
割引の例：特別価格、カタログルール価格、共有カタログ価格
tierPrices[]
tierPrices[]

カテゴリ

categories フィードは、​ カテゴリエンドポイント ​にデータを送信します。

空のurlPath （論理ルートカテゴリ）を持つ項目はスキップされ、送信されません。

Adobe Commerce フィールド
Commerce Optimizer API フィールド
メモ
storeViewCode
source/locale
name
name
urlPath
slug
description
description
metaTitle
metaTags/title
metaDescription
metaTags/description
metaKeywords
metaTags/keywords
配列に分割された改行区切り文字列
image
images[].url
単一要素の配列；roles: ["BASE"]
isActive + includeInMenu
families
trueと[]の両方が異なる場合は["top_menu"]
Related Articles
recommendation-more-help
commerce-help-aco-connector