コネクタフィードのフィールドマッピング
このページでは、Adobe Commerce Optimizer ConnectorがAdobe Commerce カタログフィールドをCommerce Optimizer Catalog Data Ingestion APIで必要な形式に変換する方法について説明します。 サポートされているフィードとそのAPI エンドポイントの一覧については、 コネクタ リファレンス を参照してください。
特定可能
products フィードは、製品エンドポイント にデータを送信します。
skuskustoreViewCodesource/localenamenameurlKeyslugproductIdexternalIds[0].idoriginを"AdobeCommerce"に設定statusstatusDISABLEDを使用します。descriptiondescriptionshortDescriptionshortDescriptionvisibilityvisibleInCatalogをCATALOGに、SearchをSEARCHにマッピングします。 他の値をドロップします。metaTitlemetaTags/titlemetaDescriptionmetaTags/descriptionmetaKeywordmetaTags/keywordsinStock, lowStock, weight, weightUnitattributes[].code = "aco_ac_attributes"aco_ac_attributes エントリを最初の属性として追加します。 そのJSON値には、inStockとlowStockが文字列として含まれます。 これらの値が使用可能な場合は、weightとweightTypeが含まれます。attributes[]attributes[]inStock、lowStock、categories、weight、weightTypeをスキップします。 在庫関連の値はaco_ac_attributesに含まれています。 カテゴリはルートとしてエクスポートされます。images[]images[]url、label （欠落している場合は空）、sortOrder （整数、デフォルトは0）を書き出します。画像を
sortOrder順に昇順で並べ替えます。標準の役割：
image ～ BASE、small_image ～ SMALL、thumbnail ～ THUMBNAIL、およびswatch_image ～ SWATCHをマッピングします。 他の役割をcustomRoles[]として書き出します。categoryData[].categoryPathroutes[].pathcategoryData[].productPositionroutes[].position0を使用します。links[].type + links[].skulinks[]type個が大文字です。skuを含まないエントリは削除されましたparents[].productType + parents[].skulinks[]configurableをVARIANT_OFに、bundleまたはbundle_fixedをIN_BUNDLEにマップします。 他の製品タイプを大文字に変換します。 SKUなしで親をスキップします。configurable optionsconfigurations[]idをattributeCodeにマップします。 swatchTypeが存在する場合はtypeをSWATCHに、それ以外の場合はCONFIGURABLEに設定します。デフォルト値のIDを
defaultVariantReferenceIdとして使用します。各値を
variantReferenceId、label、colorHex、およびimageUrlにマッピングします。bundle optionsbundles[]オプションラベルを
groupとして使用します。ラベルが空の場合はBundle groupとして使用します。 requiredを出力にコピーします。レンダータイプ
checkboxとmultiに対してmultiSelectをtrueに設定します。デフォルトのSKUを
defaultItemSkusに一覧表示します。 各項目には、sku、qty （デフォルトは0）およびuserDefinedQty （qtyMutabilityからデフォルトはfalse）が含まれます。製品属性メタデータ
productAttributes フィードは、 メタデータエンドポイント にデータを送信します。
attributeCodecodestoreViewCodesource/localelabellabeldataType + frontendInputdataTypedataTypeとfrontendInputdataTypevisible, visibleInSearch, visibleInListing, visibleInCompareListvisibleIn[]trueの場合、対応する値が追加されます：visible → PRODUCT_DETAILvisibleInSearch → SEARCH_RESULTSvisibleInListing → PRODUCT_LISTINGvisibleInCompareList → PRODUCT_COMPAREfilterablefilterablesortablesortablesearchablesearchablesearchWeightsearchWeightsearchTypessearchTypesデータタイプ変換
dataTypeがintの場合、コネクタはfrontendInputを確認します。 その他のデータ型の場合、frontendInputは変換に影響しません。
dataTypefrontendInputdataTypeintbooleanBOOLEANinttextまたはselectTEXTintINTEGERdecimalDECIMALtext, varchar, static, datetimeTEXTOBJECTOBJECTTEXTOBJECT データタイプを使用すると、Products APIは、その格納された値をJSONとして解析しようとします。 解析が成功した場合、APIは値をネストされたオブジェクトとして返します。 単一の値として表せない構造化属性データにOBJECTを使用します。 手順については、製品属性を動的に追加するを参照してください。プライスブック
priceBooks フィードは、価格表エンドポイント にデータを送信します。
他のコネクタフィードとは異なり、priceBooks フィードはAdobe CommerceのSaaS Data Export インデクサーによって収集されません。 コネクターは、管理者のweb サイトと顧客グループ設定からこのフィードを生成します。
各web サイトについて、コネクターは顧客グループごとに1つの基本価格表と1つの子価格表を作成します。
priceBookIdに次の数式を使用します。
- 通常価格の基本価格帳：
priceBookId = websiteCode。 - 顧客グループの子価格表：
priceBookId = websiteCode::sha1(customerGroupId)。sha1(customerGroupId)は、顧客グループの整数IDのSHA-1 1 16進ダイジェストです。
価格フィードでは、同じ数式を使用して、各価格入力を価格表に割り当てます。 ストアフロントが顧客セッションのpriceBookIdを解決する方法について詳しくは、 ヘッドレスストアフロント統合を参照してください。
websiteCodeparentIdnameCustomer group name (Website name)を使用します。websiteCodeparentIdcurrency価格
prices フィードはAdobe Commerce データを価格エンドポイント に送信します。
skuskuwebsiteCode, customerGroupCodepriceBookIdwebsiteCodeをcustomerGroupCodeの顧客グループ IDのSHA-1 ハッシュと組み合わせます。 customerGroupCodeが0の場合、websiteCodeのみを使用します。regularregulardiscounts[]discounts[]nullの場合、空の配列が書き出されます。値が
0から100の間の場合、codeがspecial_priceとpercentageに設定されているエントリでは、percentageから100 - percentageに設定されます。 その範囲内または範囲外の0に設定します。価格ベースの特別価格を含むその他のエントリを変更せずに渡します。
tierPrices[]tierPrices[]nullの場合は、空の配列を使用します。カテゴリ
categories フィードはAdobe Commerce データを カテゴリーエンドポイント に送信します。
コネクターは、カテゴリーフィードレコードをURL パスとストアビューコードで識別します。
-
- カテゴリがカテゴリ ツリー内の別の親に移動すると、同期はそのカテゴリとその子孫に対して新しいパスを送信し、以前のパスをAdobe Commerce Optimizerから削除します。
- 空の
urlPath（論理ルートカテゴリ）を持つ項目はスキップされ、送信されません。
storeViewCodesource/localenamenameurlPathslugdescriptiondescriptionpositionpositionmetaTitlemetaTags/titlemetaDescriptionmetaTags/descriptionmetaKeywordsmetaTags/keywordsimageimages[].urlroles: ["BASE"]isActive + includeInMenufamiliestrueと[]の両方が異なる場合は["top_menu"]| metaKeywords | metaTags/keywords |改行区切りのキーワードを配列に分割し、空白をトリミングします。 |
| image | images[].url | imageが存在する場合、BASEの役割を持つ1つの画像を書き出します。 画像が空または見つからない場合は、空の配列を書き出します。 |
| isActive + includeInMenu | families |両方の値がtrueの場合にのみtop_menuを追加します。 それ以外の場合は、空の配列を書き出します。 |
| attributes[] | attributes[] |空でないattributeCodeを含むエントリを{code, values[]}としてエクスポートします。 値を文字列に変換します。 対象となるエントリが存在しない場合、attributesを省略します。 |