Benutzerdefinierte Objekte

Übersicht

Benutzerdefinierte Objekte sind Klaviyo Objekte, die ein beliebiges Schema akzeptieren und einen Fremdschlüsselverweis auf ein beliebiges Klaviyo Profilobjekt enthalten können. Während unsere anderen Datensatztypen (Profil, Veranstaltungen, Kampagne usw.) feste Schemata haben (z.B. hat ein Profil Vorname, Nachname, E-Mail, Ort, akzeptiert Marketing usw.), und während einige, wie Profil, benutzerdefinierte Felder (Lieblingsfarbe, Haustierart) akzeptieren können, gibt es eine begrenzte Flexibilität, um alternative Datenstrukturen zu akzeptieren. Benutzerdefinierte Objekte sind eine flexible Alternative.

Was ist ein Schema?

Ein Schema ist die Struktur, die eine Datenbanktabelle definiert. Du kannst dir ein Schema wie die Spaltenüberschriften in einer Excel-Tabelle vorstellen: Es sagt dir, wie die einzelnen Felder heißen und welche Art von Daten sie enthalten, z. B. Daten, String (Text), numerisch, boolesch (wahr/falsch) usw.

Das Folgende ist zum Beispiel ein Standard Profil Laden in Klaviyo.

Wenn wir uns ansehen, wie die Daten in Klaviyo geladen sind, können wir die Struktur (oder das Schema) im JSON-Format sehen.

{
 "created": "2018-07-10 13:28:25",
 "updated": "2018-07-10 13:28:26",
 "object": "person",
 "id": "Lwxf3r",
 "$email": "klaviyogreen@gmail.com", 
 "$first_name": "John",
 "$last_name": "Smith",
}

Was kannst du mit benutzerdefinierten Objekten tun?

Mit benutzerdefinierten Objekten kannst du ein Schema für ein neues Datenbankobjekt definieren. Dieses Objekt kann eine Fremdschlüsselbeziehung haben (d.h. es kann auf ein beliebiges anderes bestehendes Profilobjekt innerhalb von Klaviyo verweisen).

Dies ist hilfreich, wenn du ein Profil mit mehreren Bezugsdatensätzen hast, die alle das gleiche Schema haben. Wenn dein Geschäftsmodell zum Beispiel Geschenkkarten verwendet, kann ein einzelner Kunde null, eine oder hunderte von Geschenkkarten mit seinem Profil verknüpft haben.

Weitere Beispiele sind die folgenden:

• Umfrageantworten (wenn ein Kunde die gleiche Umfrage mehrmals ausfüllt
• Teilnahme an der Veranstaltung
• Gespräche mit deinen Kunden
• Produktbewertungen

Wie kannst du benutzerdefinierte Objektdaten in Klaviyo verwenden?

Benutzerdefinierte Objektdaten können verwendet werden, um Segmente innerhalb von Klaviyo zu erstellen und um Daten in eine E-Mail zu übertragen. 

Segment mit benutzerdefinierten Objektdaten

Die Segmentierung funktioniert derzeit nur bei Datumsfeldern (vor / nach / am / zwischen den Daten) und Zahlenfeldern (mehr als, weniger als, gleich, zwischen).

Angenommen, du hast ein benutzerdefiniertes Objekt erstellt, das Geschenkkarteninformationen für deinen Kunden lädt. Mit den Daten aus deinen benutzerdefinierten Objekten kannst du ein Segment erstellen, das alle Profile mit einer oder mehreren Geschenkkarten im Wert von weniger als 50$ oder mehr enthält.

Wenn du Datumsinformationen weitergibst, könntest du ein Segment erstellen, das alle Profile enthält, die zwischen dem 1. März 2018 und dem 31. März 2018 eine Veranstaltung besucht haben.

Übergabe von benutzerdefinierten Objektdaten in eine E-Mail

Jedes Feld innerhalb eines benutzerdefinierten Objekts kann in den Text einer E-Mail gezogen werden. Du kannst z.B. einen Vorlagen-Tag verwenden, um eine Variable einzufügen, die den Geschenkkartencode, den aktuellen Wert der Geschenkkarte und das Ablaufdatum anzeigt.

Das Tag kann eine Schleife über alle Datensätze bilden, die mit einem Profil verbunden sind, und die Werte aus allen Datensätzen anzeigen. Wenn ein Kunde acht verschiedene Geschenkkarten hat, kannst du alle Codes in einem Textblock anzeigen, mit dem aktuellen Wert daneben.

Das Tag kann Summen bilden oder andere grundlegende Operationen (Min, Max) für numerische Daten aus benutzerdefinierten Objektdatensätzen durchführen. Du kannst zum Beispiel den Wert aller acht Geschenkkarten zusammenzählen und ihn im Betreff deiner E-Mail anzeigen. Weitere Informationen findest du in unserem Leitfaden zu Vorlagen-Tags und Variablen-Syntax.

Wie richte ich es ein?

Nachdem du dich an unser Kunde Support-Team gewandt hast, ist dein erster Schritt, deine bestehende Datenquelle dem Schema-Framework zuzuordnen, um ein Klaviyo Custom-Objekt zu erstellen.

Im Folgenden siehst du ein Beispiel für die Daten eines einzelnen benutzerdefinierten Objekts in Klaviyo.

"config": {
   "602": {
       "desired_fields": [
           "custrecord_gc_shopify_gc_internal_id",
           "custrecord_gc_remaining_balance",
           "custrecord_gc_initial_balance",
           "custrecord_gc_disabled",
           "custrecord_gc_gift_card_type",
           "custrecord_gc_sales_order",
           "Kunde",
           "custrecord_gc_retrieve_balance",
           "custrecord_gc_gift_card_number"
        ],
       "desired_fields_mapping": {
            "custrecord_gc_gift_card_number": "code",
            "custrecord_gc_gift_card_type": "type",
            "custrecord_gc_remaining_balance": "value",
            "custrecord_gc_sales_order": "shopify_order_number"
        },
       "E-Mail": Kunde",
       "E-Mail": 1,
       "fields_to_display": [
           "custrecord_gc_sales_order",
           "created_external",
           "custrecord_gc_gift_card_type",
           "custrecord_gc_initial_balance",
           "custrecord_gc_remaining_balance"
        ],
       "index_on": [
           "custrecord_gc_gift_card_type",
            [
               "Kunde",
               "custrecord_gc_gift_card_number",
               "custrecord_gc_remaining_balance"
            ]
        ],
       "mapping: "gift_card",
       "Parsers": {
            "custrecord_gc_sales_order": [
                "Sales Order #",
                "after"
            ]
        }
    }
}

Wir können diese Beispieldaten verwenden, um das benutzerdefinierte Objektschema von Klaviyo aufzuschlüsseln.

"config": {
   "602": {
       "desired_fields": [],
       "desired_fields_mapping": {},
       "E-Mail": "Kunde",
       "E-Mail": 1,
       "fields_to_display": [],
       "index_on": [
           "custrecord_gc_gift_card_type",
            [
               "Kunde",
               "custrecord_gc_gift_card_number",
               "custrecord_gc_remaining_balance"
            ]
        ],
       "mapping": "gift_card",
        "Parsers": {
            "custrecord_gc_sales_order": [
                "Sales Order #",
                "after"
            ]
        }
    }
}

Sobald du dein Schema so definiert hast, dass es zu dem benutzerdefinierten Objekt-Framework von Klaviyo passt, arbeitest du mit den Klaviyo-Ingenieuren zusammen, um eine Methode zu implementieren, mit der du deine Daten an Klaviyo senden kannst.