カスタムフィールド｜CheckoutOSドキュメント

カスタムフィールドで、チェックアウト中に顧客から追加情報を収集できます。データはパーソナライズ、注文処理の要件、規制への準拠、マーケティングなどに活用できます。

追加は控えめに

項目を追加するたびにチェックアウトの手間が増えます。本当に必要な情報だけを収集してください。必須項目が1つ増えると、コンバージョンが1～3%下がる可能性があります。

利用できるフィールドの種類

テキストフィールド

テキスト入力の種類

1行テキスト — 短い回答
複数行のテキストエリア — 指示など長い回答
メール — 検証付き
電話番号 — 書式設定付き
数値 — 数字のみ入力可能

選択フィールド

選択の種類

ドロップダウン — 一覧から1つ選択
ラジオボタン — すべての選択肢を表示して1つ選択
チェックボックス — 複数選択可能
切り替えスイッチ — はい・いいえの二択

特殊なフィールド

特殊な入力の種類

日付選択 — カレンダーから選択
時間選択 — 時間枠を選択
ファイルアップロード — 文書や画像をアップロード
署名 — 電子署名を取得

よくある用途

配送指示

配送指示フィールド

{
  "field": {
    "id": "delivery_instructions",
    "type": "textarea",
    "label": "Delivery Instructions",
    "placeholder": "Gate code, leave at door, etc.",
    "required": false,
    "max_length": 200,
    "placement": "shipping_address"
  }
}

年齢確認

年齢確認フィールド

{
  "field": {
    "id": "age_verification",
    "type": "date",
    "label": "Date of Birth",
    "required": true,
    "validation": {
      "min_age": 21,
      "error_message": "You must be 21 or older to purchase this product"
    },
    "conditional": {
      "show_when": "cart_contains_tag",
      "tag": "age-restricted"
    }
  }
}

企業・税務情報

企業情報フィールド

{
  "fields": [
    {
      "id": "company_name",
      "type": "text",
      "label": "Company Name",
      "required": false
    },
    {
      "id": "vat_number",
      "type": "text",
      "label": "VAT Number",
      "required": false,
      "validation": "vat",
      "conditional": {
        "show_when": "country_in",
        "countries": ["DE", "FR", "IT", "ES", "NL"]
      }
    }
  ]
}

商品のパーソナライズ

パーソナライズ用フィールド

{
  "field": {
    "id": "engraving_text",
    "type": "text",
    "label": "Engraving Text",
    "placeholder": "Enter text to engrave (max 20 characters)",
    "required": true,
    "max_length": 20,
    "conditional": {
      "show_when": "cart_contains_product",
      "product_ids": ["ring-001", "bracelet-002"]
    }
  }
}

カスタムフィールドの設定

新しいフィールドを作成する

CheckoutOS → Checkout Extensions → Custom Fields → Add Fieldに移動します。

フィールドの種類を選ぶ

データに適した入力形式を選びます。

プロパティを設定する

ラベル、入力例、検証ルール、必須条件を設定します。

条件を設定する（任意）

カートや顧客に基づいて表示条件を定義します。

配置を選ぶ

チェックアウト内の表示位置を選びます。

データの保存・送信先を指定する

収集したデータの保存先と送信先を設定します。

検証オプション

組み込みの検証でデータ品質を確保します。

検証設定

{
  "validation": {
    "required": true,
    "min_length": 2,
    "max_length": 100,
    "pattern": "^[A-Za-z ]+$",
    "pattern_message": "Only letters and spaces allowed",
    "custom_validator": "validate_phone_number",
    "validate_on": "blur"
  }
}

条件付き表示

関連する条件を満たすときだけフィールドを表示します。

条件ロジック

{
  "conditions": {
    "logic": "AND",
    "rules": [
      {
        "type": "cart_total",
        "operator": "greater_than",
        "value": 100
      },
      {
        "type": "shipping_country",
        "operator": "in",
        "value": ["US", "CA"]
      }
    ]
  }
}

データの扱い

カスタムフィールドのデータは複数の場所に送信できます。

データの送信先

Shopify注文属性 — 注文管理画面に表示
Shopify注文メモ — メモ欄に連結
Shopifyメタフィールド — 構造化されたデータ保存
Webhook — 外部システムに送信
メール — 注文確認に含める
注文処理アプリ — ShipStationなど

個人情報の扱い

米国の社会保障番号（SSN）や健康データなどの機微な個人情報を収集する場合、GDPR、CCPA、HIPAAなど適用される規制に従ってデータを扱ってください。暗号化やアクセス制御を検討してください。

カスタムフィールドのスタイル

フィールドのスタイル

{
  "styling": {
    "label_position": "above",
    "label_size": "small",
    "input_style": "outlined",
    "error_style": "inline",
    "help_text_position": "below",
    "required_indicator": "*",
    "group_fields": true,
    "group_title": "Additional Information"
  }
}

効果的な使い方

最適化のヒント

必須項目を最小限にする — 項目ごとに手間が増える
条件付き表示を使う — 関連する項目だけを表示
明確なラベルを付ける — 尋ねる理由を利用者が理解できるようにする
適した入力形式を使う — 日付には日付選択、固定の選択肢にはドロップダウン
妥当な既定値を設定する — 可能な場合は事前入力
モバイルでテストする — タッチ端末で問題なく使えることを確認

カスタムフィールド