Benutzerdefinierte Felder: CheckoutOS-Doku

Mit benutzerdefinierten Feldern erfasst du zusätzliche Informationen während des Checkouts. Diese Daten können der Personalisierung, Bestellabwicklung, Einhaltung von Vorschriften oder dem Marketing dienen.

Sparsam einsetzen

Jedes zusätzliche Feld erschwert den Checkout etwas. Erfasse nur wirklich notwendige Informationen. Jedes Pflichtfeld kann die Conversion um 1–3 % senken.

Verfügbare Feldtypen

Textfelder

Texteingabetypen

Einzeiliger Text – Kurze Antworten
Mehrzeiliger Textbereich – Längere Antworten wie Anweisungen
E-Mail – Mit Validierung
Telefonnummer – Mit Formatierung
Zahl – Nur numerische Eingaben

Auswahlfelder

Auswahltypen

Dropdown-Liste – Eine Auswahl aus einer Liste
Optionsfelder – Eine Auswahl, alle Optionen sichtbar
Kontrollkästchen – Mehrfachauswahl möglich
Umschalter – Binäre Ja-Nein-Auswahl

Spezielle Felder

Spezielle Eingabetypen

Datumsauswahl – Auswahl im Kalender
Zeitauswahl – Auswahl eines Zeitfensters
Datei-Upload – Dokumente oder Bilder hochladen
Unterschrift – Digitale Unterschrift erfassen

Häufige Anwendungsfälle

Lieferanweisungen

Feld für Lieferanweisungen

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

Altersprüfung

Feld für Altersprüfung

{
  "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"
    }
  }
}

Unternehmens- und Steuerinformationen

Unternehmensfelder

{
  "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"]
      }
    }
  ]
}

Produktpersonalisierung

Personalisierungsfelder

{
  "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"]
    }
  }
}

Benutzerdefinierte Felder einrichten

Neues Feld erstellen

Gehe zu CheckoutOS → Checkout Extensions → Custom Fields → Add Field.

Feldtyp auswählen

Wähle den passenden Eingabetyp für deine Daten.

Eigenschaften konfigurieren

Lege Beschriftung, Platzhalter, Validierungsregeln und Anforderungen fest.

Bedingungen festlegen (optional)

Bestimme anhand des Warenkorbs oder Kunden, wann das Feld erscheint.

Platzierung wählen

Wähle, wo das Feld im Checkout erscheint.

Datenziel zuordnen

Konfiguriere, wo die erfassten Daten gespeichert und wohin sie gesendet werden.

Validierungsoptionen

Sichere die Datenqualität mit integrierter Validierung:

Validierungskonfiguration

{
  "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"
  }
}

Bedingte Anzeige

Zeige Felder nur, wenn die passenden Bedingungen erfüllt sind:

Bedingungslogik

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

Datenverarbeitung

Daten aus benutzerdefinierten Feldern können an mehrere Ziele gesendet werden:

Datenziele

Shopify-Bestellattribute – In der Bestellverwaltung sichtbar
Shopify-Bestellnotizen – Im Notizfeld zusammengefügt
Shopify-Metafelder – Strukturierte Datenspeicherung
Webhooks – An externe Systeme senden
E-Mail – In die Bestellbestätigung aufnehmen
Fulfillment-Apps – ShipStation usw.

Umgang mit personenbezogenen Informationen

Wenn du sensible persönliche Daten wie US-Sozialversicherungsnummern oder Gesundheitsdaten erfasst, muss die Verarbeitung den geltenden Vorschriften wie DSGVO, CCPA oder HIPAA entsprechen. Berücksichtige Verschlüsselung und Zugriffskontrollen.

Benutzerdefinierte Felder gestalten

Feldgestaltung

{
  "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"
  }
}

Bewährte Vorgehensweisen

Optimierungstipps

Pflichtfelder minimieren – Jedes Feld erhöht den Aufwand.
Bedingte Anzeige verwenden – Nur relevante Felder zeigen.
Klare Beschriftungen wählen – Nutzer sollten wissen, warum du fragst.
Passende Feldtypen verwenden – Datumsauswahl für Daten und Dropdowns für feste Optionen.
Sinnvolle Standards festlegen – Nach Möglichkeit vorausfüllen.
Auf Mobilgeräten testen – Felder müssen auf Touch-Geräten gut funktionieren.

Benutzerdefinierte Felder