Obiekty niestandardowe

Przegląd

Obiekty niestandardowe to obiekty Klaviyo, które mogą akceptować dowolny schemat i które mogą zawierać odniesienie klucza obcego do dowolnego obiektu profilu Klaviyo. Podczas gdy inne typy rekordów (profil, wydarzenia, kampanie itp.) mają ustalone schematy (np. profil ma imię, nazwisko, e-mail, lokalizację, akceptuje marketing itp.), a niektóre, podobnie jak profil, mogą akceptować niestandardowe pola (ulubiony kolor, typ zwierzaka), istnieje ograniczona elastyczność w akceptowaniu alternatywnych struktur danych. Obiekty niestandardowe są elastyczną alternatywą.

Co to jest schemat?

Schemat to struktura, która definiuje tabelę bazy danych. Możesz myśleć o schemacie jak o nagłówkach kolumn w arkuszu kalkulacyjnym Excel: mówi on, jak nazywa się każde pole i jakiego rodzaju dane będzie przechowywać, takie jak daty, ciąg znaków (tekst), numeryczne, logiczne (prawda/fałsz) itp.

Na przykład, poniżej znajduje się standardowy profil sklepu w Klaviyo.

Jeśli spojrzymy, jak dane są przechowywane w sklepie Klaviyo, możemy zobaczyć strukturę (lub schemat) w formacie JSON.

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

Na co pozwalają Ci obiekty niestandardowe?

Obiekty niestandardowe umożliwiają zdefiniowanie schematu dla nowego obiektu bazy danych. Obiekt ten może mieć relację klucza obcego (tzn. może wskazywać na) dowolny inny istniejący obiekt profilu w ramach Klaviyo.

Jest to przydatne, gdy masz profil z wieloma powiązanymi rekordami, które mają ten sam schemat. Na przykład, jeśli Twój model biznesowy wykorzystuje karty podarunkowe, pojedynczy klient może mieć zero, jedną lub setki kart podarunkowych powiązanych ze swoim profilem.

Inne przykłady są następujące:

• Odpowiedzi na ankietę (gdy klient wypełnia tę samą ankietę kilka razy
• Uczestnictwo w wydarzeniu
• Rozmowy z twoimi klientami
• Recenzje produktów

Jak możesz użyć Custom Object Dane w Klaviyo?

Niestandardowy obiekt dane może być używany do tworzenia segmentów w ramach Klaviyo i przekazywania danych do wiadomości e-mail. 

segment z niestandardowym obiektem dane

Segmentacja działa obecnie tylko dla pól daty (przed / po / na / pomiędzy datami) i pól liczbowych (więcej niż, mniej niż, równe, pomiędzy).

Załóżmy, że utworzyłeś niestandardowy obiekt, który przechowuje informacje o karcie podarunkowej dla twojego klienta. Korzystając z danych z niestandardowych obiektów, możesz utworzyć stronę segment, która zawiera wszystkie profile z jedną lub kilkoma kartami podarunkowymi o wartości mniejszej niż 50 USD lub większej.

Jeśli przekazujesz informacje o datach, możesz utworzyć stronę segment, która zawiera wszystkie profile, które uczestniczyły w wydarzeniu między 1 marca 2018 r. a 31 marca 2018 r.

Przekazywanie danych obiektu niestandardowego do wiadomości e-mail

Dowolne pole w obiekcie niestandardowym może zostać przeciągnięte do treści wiadomości e-mail. Na przykład możesz użyć znacznika szablonu, aby wstawić zmienną, która pokazuje kod karty podarunkowej, aktualną wartość karty podarunkowej i datę wygaśnięcia.

Znacznik może zapętlić wszystkie rekordy związane z profilem i wyświetlić wartości z nich wszystkich. Jeśli klient posiada osiem różnych kart podarunkowych, możesz wyświetlić wszystkie ich kody w bloku tekstowym, z aktualną wartością obok nich.

Znacznik może sumować lub wykonywać inne podstawowe operacje (min, max) na danych liczbowych z rekordów obiektów niestandardowych. Możesz na przykład zsumować wartość wszystkich ośmiu kart podarunkowych i wyświetlić ją w temacie wiadomości e-mail. Aby uzyskać więcej informacji, zapoznaj się z naszym przewodnikiem po znaczniku szablonu i składni zmiennej.

Jak to skonfigurować?

Po skontaktowaniu się z naszym zespołem ds. pomocy, Twoim pierwszym krokiem jest zmapowanie istniejącego źródła danych do struktury schematu w celu utworzenia obiektu Klaviyo Custom.

Poniżej znajduje się przykład danych z pojedynczego niestandardowego obiektu wewnątrz 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",
 " custrecord_gc_customer",
 " 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"
        },
 " email_field": "custrecord_gc_customer",
 " emails_separate": 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",
 [
 " klaviyo_customer_id",
 " custrecord_gc_gift_card_number",
 " custrecord_gc_remaining_balance"
 ]
       ],
 " mapowanie": "gift_card",
 " parsery": {
            "custrecord_gc_sales_order": [
                "Sales Order #",
                "after"
            ]
        }
    }
}

Możemy użyć tego przykładu danych do rozbicia Klaviyo niestandardowego schematu obiektu.

"config": {
 " 602": {
 " desired_fields": [],
 " desired_fields_mapping": {},
 " email_field": "custrecord_gc_customer",
 " emails_separate": 1,
 " fields_to_display": [],
 " index_on": [
 " custrecord_gc_gift_card_type",
 [
 " klaviyo_customer_id",
 " custrecord_gc_gift_card_number",
 custrecord_gc_remaining_balance"
 ]
       ],
 " mapowanie": "gift_card",
 " parsery": {
            "custrecord_gc_sales_order": [
                "Sales Order #",
                "after"
            ]
        }
    }
}

Po zdefiniowaniu schematu pasującego do niestandardowej struktury obiektów Klaviyo, będziesz współpracować z inżynierami Klaviyo, aby zaimplementować metodę wysyłania danych do Klaviyo.