WooCommerce Checkoutの製品属性をマッピングする

概要 

WooCommerceの製品属性（色、サイズ、その他のカスタマイズなど）をZonos拡張機能でマッピングして、注文がZonosからWooCommerceストアに正しい属性でインポートされるようにします。

ステップ1: 製品属性を見つける

1. WordPress管理の製品タブに移動します。

2. 左側のナビゲーションから属性をクリックして、グローバル製品属性を表示または管理します。属性は新しい製品を追加する際にも設定できます。

カスタム属性のためにサードパーティアプリ（例: Product Add-Ons for WooCommerce）を使用している場合は、アプリのドキュメントの指示に従って属性を見つけてください。

ステップ2: Zonosから属性パスを特定する

Zonos拡張機能で属性をマッピングするには、最初にそれらがZonosにどのように渡されるかを理解する必要があります。このデータを見つけるには：

1. マッピングしたい属性を持つ製品のテスト注文を作成します。
2. Zonos Checkoutを進み、サービスレベルを選択します。これによりlanded costの見積もりが生成されます。(注文を完了する必要はありません。)
3. ダッシュボードに移動し、見積もりを選択します。
4. テスト注文の見積もりを見つけて、見積もり詳細をクリックします。
5. 右側のAPI詳細セクションで、ルートレベルのドロップダウンを展開し、次を展開します：
   • items
   • metadata

このメタデータブロックは、製品属性がAPIリクエストでWooCommerceからZonosにどのように渡されるかを示しています。

ステップ3: Zonos拡張機能で属性をマッピングする

メタデータJSONで属性を見つけたら、WooCommerce拡張機能のZonosマッピング設定に戻ります。

1. 属性フィールドの下で、カスタム属性を選択します。
2. エイリアスフィールドに、説明的なラベル（例：Color、Size、またはCustom Engraving）を入力します。
3. カートアイテムパスフィールドに、メタデータで観察した構造に基づいて属性の値へのパスを入力します。

カスタム属性のマッピングの例

カスタム彫刻、色、サイズのカスタム属性を持つ製品をマッピングする方法を見てみましょう。

WooCommerceのProduct Add-onsプラグインを使用している場合、属性は時々addonsキーの下の配列内に渡されます。以下のJSONブロックは、Zonosに渡された属性を示しています。

例のJSONブロック：

{
  "addons": [
    {
      "name": "Custom Engraving",
      "value": "Built to last",
      "price": 0,
      "field_name": "1226-1748963436",
      "field_type": "custom_text",
      "id": 1748963436,
      "price_type": "flat_fee"
    }
  ],
  "variation": {
    "attribute_pa_color": "blue",
    "attribute_size": "Large"
  }
}

マッピング設定の属性の下で、これらの属性は次のようにマッピングされるべきです：

注意: パス形式addons.0.valueは次のように機能します：

• addonsはシステムにaddons配列を探すように指示します
• .0はその配列の最初のオブジェクトを指します
• .valueはそのオブジェクトの値フィールドから値を返します
• attribute_pa_colorとattribute_sizeは配列に含まれないオブジェクトであり、直接マッピングできます。

製品属性マッピングのテスト

属性をマッピングしたら、Zonos Checkoutで完全なテスト注文を行います。注文が処理されたら、WooCommerceで注文の詳細を確認して、製品属性が正しくインポートされたことを確認します。