맞춤 필드: CheckoutOS 문서

맞춤 필드로 결제 중 고객의 추가 정보를 수집할 수 있어요. 데이터는 개인화, 주문 처리 요구 사항, 규정 준수 또는 마케팅에 사용할 수 있어요.

필요한 만큼만 사용하세요

필드를 추가할 때마다 결제 과정이 번거로워져요. 꼭 필요한 정보만 수집하세요. 필수 필드 하나마다 전환이 1~3% 낮아질 수 있어요.

사용 가능한 필드 유형

텍스트 필드

텍스트 입력 유형

한 줄 텍스트 — 짧은 응답
여러 줄 텍스트 영역 — 안내 사항 같은 긴 응답
이메일 — 유효성 검사 포함
전화번호 — 서식 적용
숫자 — 숫자만 입력 가능

선택 필드

선택 유형

드롭다운 — 목록에서 하나 선택
라디오 버튼 — 모든 옵션이 보이는 단일 선택
체크박스 — 여러 항목 선택 가능
전환 스위치 — 예/아니요 선택

특수 필드

특수 입력 유형

날짜 선택기 — 달력에서 선택
시간 선택기 — 시간 구간 선택
파일 업로드 — 문서와 이미지 업로드
서명 — 디지털 서명 수집

일반적인 활용 사례

배송 요청 사항

배송 요청 사항 필드

{
  "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 메타필드 — 구조화된 데이터 저장
웹훅 — 외부 시스템에 전송
이메일 — 주문 확인에 포함
주문 처리 앱 — 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"
  }
}

권장 방법

최적화 팁

필수 필드 최소화 — 필드마다 입력 부담이 늘어요
조건부 표시 사용 — 관련 필드만 표시하세요
명확한 라벨 제공 — 사용자가 정보를 요청하는 이유를 알 수 있어야 해요
적절한 필드 유형 사용 — 날짜에는 날짜 선택기, 고정 옵션에는 드롭다운을 사용하세요
합리적인 기본값 설정 — 가능하면 미리 입력해 두세요
모바일 테스트 — 터치 기기에서 필드가 잘 작동하는지 확인하세요

맞춤 필드