Objects

Foundation #
Wahre Personalisierung ist nur möglich, wenn sie über jeden Touchpoint hinweg konsistent ist.
Die einheitliche Datenplattform von Clerk.io stellt sicher, dass alle Tools mit denselben Daten arbeiten, um ein nahtloses, personalisiertes Erlebnis zu bieten – egal ob Ihre Kund:innen chatten, suchen, browsen oder E-Mails erhalten.
Privacy #
Die Datenbasis von Clerk.io ist mit Blick auf Datenschutz entwickelt worden und ermöglicht großartige Personalisierung ohne Kompromisse bei der Datensicherheit. Wir sind standardmäßig cookieless und vollständig DSGVO-konform.
Der Kern der KI von Clerk.io arbeitet mit Bestell- und Produktdaten. Sie muss buchstäblich nur was gekauft wurde, zu welchem Zeitpunkt wissen, um die überwiegende Mehrheit der Ergebnisse anzuzeigen.
Durch die zusätzliche Übermittlung der E-Mail-Adresse der Kund:innen ermöglichen Sie echte Personalisierung auf Basis des individuellen Kaufverlaufs. Dies wird empfohlen, ist aber nicht erforderlich.
Layers #
Wenn die KI Ergebnisse anzeigt, geschieht dies in 4 Schichten:
Datenebene, die die Rohdaten wie Attribute für Produkte und Bestellungen enthält.
KI-Ebene, auf der die KI von Clerk.io mithilfe aller Verbindungen in den Daten Ergebnisse vorhersagt, basierend auf dem verwendeten Endpunkt.
Merchandising-Ebene, auf der Kampagnen die Ergebnisse beeinflussen können.
Produktebene, auf der die API von Clerk die finalen Ergebnisse ausgibt.
Unten erfahren Sie mehr über die verschiedenen Datenpunkte, die Clerk.io zur Unterstützung seiner KI nutzt.
Attributes #
Jedes Objekt muss die unten für seinen Typ aufgeführten Pflichtattribute enthalten. Sie können auch beliebige benutzerdefinierte Attribute hinzufügen, die Sie benötigen. Die anderen in diesem Artikel gezeigten Attribute sind empfohlene Beispiele, jedoch keine vollständige Liste aller möglichen Attribute.
Clerk.io unterstützt Ganzzahlen, Gleitkommazahlen, Zeichenketten, Booleans, Listen (JSON-Arrays) und Dictionaries (JSON-Objekte) als Attributwerte.
Benutzerdefinierte Attributlisten und -dictionaries müssen flach sein: Sie dürfen keine anderen Listen oder Dictionaries enthalten. Zum Beispiel ist {"material": "cotton", "weight": 0.5} zulässig, aber {"details": {"material": "cotton"}} nicht.
Products #
Diese stehen im Mittelpunkt der KI von Clerk.io. Sie werden verwendet, um die Struktur Ihres Katalogs zu verstehen und sind der wichtigste Antrieb hinter den zusätzlichen Conversions, die Sie mit Clerk.io erzielen.
Produkte benötigen eine Reihe von Pflichtattributen, damit Clerk.io korrekt funktioniert:
idnamedescriptionpriceimageurlcategoriescreated_at
Unten finden Sie ein Beispiel für ein Produktobjekt:
{
"id": 135,
"name": "Lightsaber",
"description": "Antike Rebell-Lichtschwert",
"price": 99995.95,
"profit": 39998.38,
"image": "https://galactic-empire-merch.com/images/a-r-lightsaber.jpg",
"url": "https://galactic-empire-merch.com/antique-rebel-lightsaber",
"created_at": 1622548800,
"brand": "Je’daii",
"categories": [987, 654],
"sizes": ["M", "L", "XL"],
"material": "Kyber Crystal",
"color": {
"name": "Emerald",
"converted_name": "Green",
"image": "https://galactic-empire-merch.com/images/a-r-lightsaber-emerald.jpg",
"color_code": "#7CFC00"
}
}
Die vollständige Spezifikation von Products finden Sie hier.
Sie können in Ihrem Feed auch ein optionales numerisches profit-Attribut pro Produkt angeben oder es mit AI Modifiers durch eine geschätzte Marge erstellen. Der Wert ist ein Geldbetrag pro Einheit. Siehe
Profit für die Berechnung und die bisherige Verhaltensweise.
Categories #
Diese werden verwendet, um Produkte zusammenzufassen. Sie sind zwar optional, werden aber dringend empfohlen, da sie der KI von Clerk.io helfen, zu verstehen, wie Ihre Produkte innerhalb Ihres Katalogs zusammenhängen.
Zum Beispiel verlässt sich unsere Alternativen-Logik stark auf Kategorien, um zu erkennen, welche Artikel am ähnlichsten sind, und alle kategorienbezogenen Logiken benötigen ihre Anwesenheit.
Kategorien werden genauso an Clerk.io übermittelt wie Produkte, haben aber eine andere Attributstruktur.
Sie können beliebig viele Kategorieattribute für Stylingzwecke senden (z. B. ein Bild, eine Beschreibung usw.), aber nur die Pflichtattribute werden von Clerk.io zur Ergebnisanzeige verwendet.
Die Pflichtattribute sind:
idnamesubcategoriesurl
Unten finden Sie ein Beispiel für ein Kategorieobjekt:
{
"id": 123,
"name": "Lightsabers",
"subcategories": [456, 789],
"url": "https://galactic-empire-merch.com/lightsabers"
}
Die vollständige Spezifikation von Categories finden Sie hier.
Orders #
Diese sind entscheidend, um die beste Performance mit Clerk.io zu erzielen, da die KI Bestelldaten verwendet, um zu verstehen, wie Kund:innen mit Ihren Produkten interagieren.
Sämtliche Logiken – von Suchergebnissen bis hin zu Audience-Vorhersagen – nutzen Bestelldaten, um Muster zu erkennen, was Kund:innen als Nächstes tun werden.
Die Pflichtattribute sind:
idproductstime
Außerdem empfehlen wir dringend, das Attribut email zu senden, das die E-Mail-Adresse des/der Kund:in enthält und so Personalisierung und Audience-Segmentierung ermöglicht.
Es ist außerdem möglich, den status einer Bestellung zu senden, einschließlich Informationen zu
Parcels, sodass Ihre Kund:innen beim Einsatz von Clerk.io
Chat nach ihren Paketen fragen können.
Unten finden Sie ein Beispiel für ein Bestellobjekt:
{
"id": 5434,
"products": [123, 456],
"time": 1622548800,
"email": "luke@skywalker.com",
"status": "DELIVERED"
}
Die vollständige Spezifikation von Orders finden Sie hier.
Parcels #
Parcels stehen für die Sendungsverfolgung Ihrer Bestellungen. Sie umfassen typischerweise einen tracking_code, einen Versand-status, optionale status_details und einen tracking_link.
Sie können Parcels in Data > Parcels durchsuchen und sie auf der Detailseite einer Bestellung im Bereich “Paketverfolgungsinformation” einsehen. So können Sie die gleichen Daten überprüfen, nach denen Ihre Kund:innen per Chat fragen können.
Erfahren Sie mehr über die Nutzung von Parcels im Interface auf der Parcels-Seite. Das Datenformat finden Sie in der Parcels API resource.
Pages #
Diese sind optional, werden aber sehr empfohlen, da sie es Clerk.io ermöglichen, mit Ihren Blogs, Artikeln und anderen Content-Seiten zu arbeiten.
Sie können in Suchergebnissen auftauchen, Empfehlungen auf ihren Seiten anzeigen und als relevanter Content-Banner erscheinen, wenn Kund:innen Produkte oder Kategorien durchstöbern.
Die Pflichtattribute sind:
idtypeurltitletext
Wir empfehlen außerdem, ein image-Attribut zu senden, um Ihre Page-Empfehlungen visuell ansprechender zu gestalten, was häufig zu mehr Klicks führt.
Sie können Pages direkt in Data > Pages verwalten.
Pages können sein:
- Synchronisierte Seiten: Seiten, die über Ihren Datenabgleich importiert wurden.
- Manuell hochgeladene Seiten: Seiten, die direkt in my.clerk.io hochgeladen wurden.
Wenn Sie eine synchronisierte Seite in my.clerk.io bearbeiten oder löschen, werden diese Änderungen beim nächsten Datenabgleich für Pages überschrieben.
Manuell hochgeladene Seiten gelten als geschützt und werden vom Datenabgleich nicht überschrieben oder gelöscht.
Unterstützte Upload-Dateiformate:
.docx.pdf.html.htm.md.txt
Unten finden Sie ein Beispiel für ein Page-Objekt:
{
"id": 123,
"type": "blog",
"url": "https://galactic-empire-merch.com/blog/lightsaber-history",
"title": "Die Geschichte der Lichtschwerter",
"text": "Lichtschwerter gibt es seit Jahrhunderten – erfahren Sie hier mehr über ihre Geschichte."
}
Die vollständige Spezifikation von Pages finden Sie hier.
Customers #
Diese sind optional, werden aber empfohlen, da Sie mit ihnen das Audience-Tool von Clerk.io als CDP nutzen können. Das Customer-Objekt enthält eine ID oder E-Mail-Adresse sowie beliebig viele Attribute, die Sie zur Segmentierung verwenden möchten.
Die ID oder E-Mail-Adresse wird genutzt, um die Customer-Daten mit bestehenden Bestellinformationen zu verbinden, in denen die ID oder E-Mail-Adresse bereits enthalten ist.
Wenn Sie die Objekte senden, erscheint in Audience automatisch eine neue Option namens Customer Data, mit der Sie auf diesen Attributen segmentieren können.
Das einzige Pflichtattribut für Customers ist:
idoderemail
Wir empfehlen, darüber hinaus alle für Ihr Marketing relevanten Datenpunkte wie gender, age, interests usw. zu senden.
Unten finden Sie ein Beispiel für ein Customer-Objekt:
{
"id": 255,
"email": "leia@royalty.com",
"name": "Leia Organa",
"gender": "Female",
"age": 28,
"interests": ["Rebellion", "Politics", "Leadership"]
}
Die vollständige Spezifikation von Customers finden Sie hier.
Diese Seite wurde von einer hilfreichen KI übersetzt, daher kann es zu Sprachfehlern kommen. Vielen Dank für Ihr Verständnis.