Pierwsze kroki z obiektami niestandardowymi

Poznasz obiekty niestandardowe, które umożliwiają przechowywanie i kojarzenie wielu właściwości z pojedynczym „obiektem”.  Obiekty niestandardowe umożliwiają mapowanie do Klaviyo różnorodnych, multirelacyjnych pojęć dotyczących danych, których nie można przechowywać za pomocą właściwości profilu. Następnie możesz używać obiektów niestandardowych w swoich wiadomościach, segmentach i nie tylko.

Czym obiekty niestandardowe różnią się od właściwości profilu?

Pomagają w zapisywaniu prostych informacji. Na przykład jeśli masz ulubioną właściwość koloru, możesz zapisać ulubiony kolor każdego klienta.

Ale co zrobić, jeśli potrzebujesz więcej danych lub wielu wersji tej właściwości? Świetnym przykładem są zwierzęta domowe. Przypominamy, że do przechowywania danych takich jak imię i nazwisko, wiek czy rasa można wykorzystać tylko jeden raz dla każdego profilu.

Jeśli ktoś ma kilka zwierząt, możesz użyć obiektów niestandardowych. Dzięki temu dog niemiecki puszysty będzie miał własną cyfrową kartę identyfikacyjną na swoje imię, wiek, wagę itp., a chomik policzek ma te same informacje, ale odpowiedzi (bardzo) różnią się od siebie. 

Przykładowe przypadki użycia

Poniżej znajdziesz kilka przykładów demonstrujących elastyczność obiektów niestandardowych w danych, które można przechowywać w Klaviyo.

Wizyta

Jeśli Twoja firma może planować spotkania, do przechowywania danych dotyczących profilu możesz użyć obiektu Spotkanie. 

W każdym rekordzie obiektu dla obiektu Spotkanie można znaleźć kilka przykładów danych, które warto uwzględnić:

• Identyfikator spotkania
• Data spotkania
• Wyznaczona osoba (np. konkretny lekarz, instruktor itp.)
• Lokalizacja spotkania
• Typ spotkania

profil może mieć wiele rekordów obiektu, jeśli ma wiele spotkań. Te dane obiektu można wykorzystać do tworzenia segmentów oraz wysyłania spersonalizowanych wiadomości i sekwencji.

Subskrypcja

Jeśli Twoja firma jest firmą, w której klienci i klientki mogą rejestrować się na subskrypcje, do przechowywania danych subskrypcji dla profilu możesz użyć obiektu subskrypcji. 

W każdym rekordzie obiektu dla subskrypcji można znaleźć kilka przykładów danych, które warto uwzględnić:

• Identyfikator subskrypcji
• Produkt objęty subskrypcją
• Cena subskrypcji
• Status subskrypcji
• Data następnego rozliczenia

profil może mieć wiele rekordów obiektów, jeśli ma wiele subskrypcji. Te dane obiektu można wykorzystać do tworzenia segmentów oraz wysyłania spersonalizowanych wiadomości i sekwencji.

Rezerwacja

Jeśli Twoja firma może dokonywać rezerwacji, do przechowywania danych rezerwacji dla profilu możesz użyć obiektu Rezerwacja. 

W każdym rekordzie obiektu dla obiektu Reservation można znaleźć kilka przykładów danych, które warto uwzględnić:

• Identyfikator rezerwacji
• Data rezerwacji
• Lokalizacja rezerwacji
• Możliwość rezerwacji
• Liczba gości w rezerwacji

profil może mieć wiele rekordów obiektu, jeśli ma wiele rezerwacji. Możesz użyć tych danych obiektu do tworzenia segmentów oraz wysyłania spersonalizowanych wiadomości i sekwencji.

Zwierzę domowe

Jeśli Twoja firma obsługuje właścicieli zwierząt domowych, do przechowywania danych o profilach zwierząt możesz użyć obiektu Zwierzaki. 

W każdym rekordzie obiektu dla obiektu Zwierzaki przykłady danych, które warto uwzględnić, to:

• Identyfikator mikroprocesora zwierzaka
• Imię zwierzaka
• Typ zwierzaka (np. pies lub kot)
• Rasa zwierzęcia
• Urodziny zwierzaka

profil może mieć wiele rekordów obiektów, jeśli ma wiele zwierząt domowych. Te dane obiektu można wykorzystać do tworzenia segmentów oraz wysyłania spersonalizowanych wiadomości i sekwencji.

Limity na koncie

Obiekty niestandardowe mają 3 zestawy limitów kont:

• Limit obiektów
  Całkowita liczba obiektów, które może mieć konto.
• Limity
  właściwości obiektu Liczba właściwości, jakie konto może mieć na obiekt.
• Limity rekordów obiektu
  Liczba rekordów obiektów dozwolonych dla konta.

Liczba dostępnych obiektów i rekordów obiektów opiera się na łącznej liczbie profili aktywni na całym koncie. Limity rekordów są wspólne dla wszystkich kont, natomiast dla każdego konta limity obiektów z osobna.

Na przykład, jeśli masz rodzinę z 5 kont dzieci, gdzie na każde konto przypada 100 000 profili aktywni, Twój całkowity profil aktywni wyniesie 500 000. Jak pokazano na poniższym wykresie, mnożnik rekordu obiektu dla konta dla konta z ponad 400 000 profili wynosi 10. Oznacza to, że łącznie na kontach tych można przechowywać maksymalnie 5 milionów rekordów (500 000 x 10). Oznacza to, że można mieć 1 konto z 3 milionami rekordów, pod warunkiem, że pozostałe 4 konta mają łącznie mniej niż 2 miliony rekordów obiektów. Ponieważ łączna liczba profili przekracza 400 000, na każde konto może przypadać maksymalnie 5 obiektów.

Ponadto wszystkie konta mają następujące limity:

• Maksymalnie 500 rekordów na profil na obiekt.
• Rozmiar każdego obiektu niestandardowego nie może przekraczać 8 KB.
• Każdy rekord obiektu niestandardowego nie może przekraczać 2 KB.

Utwórz obiekt

Aby rozpocząć tworzenie obiektu w Klaviyo, przejdź do Treść > Obiekty. i kliknij przycisk Utwórz obiekt.

Tutaj możesz utworzyć obiekt od zera lub wybrać zalecany szablon obiektu. Aby utworzyć obiekt od zera, wybierz przycisk Utwórz własny.

Pierwsza część organizacji pracy tworzącej obiekt wymaga, aby ustawić następujące informacje dotyczące obiektu:

• Nazwa
  Nazwa identyfikująca obiekt
• Opis (opcjonalnie)
  Opis danych, które reprezentuje Twój obiekt
• Źródło danych
  Źródło danych, w którym znajdują się dane obiektu.

Aby utworzyć nowe źródło danych, kliknij listę rozwijaną Wybierz źródło danych, a następnie wybierz opcję Utwórz nowe źródło danych.

Utworzenie źródła danych wymaga ustawienia następujących informacji:

• Nazwa
  Unikalna nazwa identyfikująca źródło danych obiektu.
• Opis (opcjonalnie)
  Opis źródła danych.

Ustaw identyfikator obiektu

Gdy nadasz nazwę obiektowi i wybierzesz źródło danych, kolejnym krokiem jest ustawienie identyfikatora obiektu i mapowanie wybranych właściwości obiektu. W tym kroku będzie można podejrzeć dane powiązane ze źródłem danych, które zostały wysłane do Klaviyo za pośrednictwem niestandardowego API obiektów.

Ustawienie identyfikatora obiektu jest niezbędne do rozróżniania rekordów obiektów od siebie. Trzeba będzie określić właściwość źródła danych, która będzie używana dla unikalnego identyfikatora obiektu.

Identyfikator obiektu powinien być unikalną właściwością źródła danych, która może być używana do identyfikowania konkretnych wystąpień rekordu obiektu. Na przykład w przypadku obiektu karty podarunkowej można użyć unikalnego kodu rabatowego jako identyfikatora obiektu. Jest on unikalny dla każdej instancji źródła danych i będzie istnieć dla każdego rekordu obiektu.

Za każdym razem, gdy Klaviyo otrzymuje z Twojego źródła danych dane z tym samym identyfikatorem obiektu, powiązany rekord obiektu zostanie zaktualizowany. Z tego powodu ważne jest, aby identyfikator obiektu był unikalny, aby zaktualizować odpowiedni rekord.

Wyślij dane obiektu

Podczas aktualizacji istniejącego rekordu obiektu zastępowany jest cały rekord. Z tego powodu niezwykle ważne jest, aby wysłać cały rekord obiektu, nawet jeśli chcesz zaktualizować tylko 1 właściwość.

Załóżmy na przykład, że chcesz zaktualizować w rekordzie tylko 1 z 5 właściwości. Jeśli wyślesz zaktualizowane dane z identyfikatorem i tylko jedną właściwością, którą chcesz zaktualizować, pozostałe 4 właściwości zostaną ustawione na null. Jeśli w relacji profilu użyto jednego z nowo zerowych pól (np. identyfikator profilu taki jak adres e-mail), obiekt nie będzie już powiązany z tym profilem.

Mapuj właściwości obiektu

Mapowanie właściwości obiektu pozwala wybrać, które informacje ze źródła danych będą dostępne w obiekcie Klaviyo.

Z tego powodu zalecamy jednak przesyłanie danych obiektów za pośrednictwem interfejsu API do pozyskiwania obiektów w standaryzowanych formatach daty i znacznika czasu. Jeśli wartość dla konkretnej właściwości nie jest znana, możesz ustawić dla niej wartość null.

Aby zmapować właściwości obiektu:

1. W kolumnie Właściwość źródła danych wybierz właściwość źródła danych, którą chcesz uwzględnić w obiekcie.
2. W kolumnie Zmapowana właściwość wpisz nazwę, którą chcesz nadać właściwości źródła danych w obiekcie.
3. W kolumnie Typ danych wybierz odpowiedni typ danych dla właściwości źródła danych.
4. W kolumnie Wymagane zaznacz pole wyboru, jeśli chcesz, aby ta właściwość była wymagana w obiekcie.
5. Wybierz przycisk Dodaj mapowanie, jeśli chcesz zmapować dodatkowe właściwości obiektu.

Zagnieżdżone dane w mapowaniu

Domyślnie interfejs menedżera obiektów obsługuje 1 poziom zagnieżdżenia. Aby uzyskać dostęp do szczegółowych danych, należy ręcznie wprowadzić wybraną ścieżkę.

Jako przykład spójrz na poniższe źródło danych.

text Copy

{
  "type": "data-source-record",
  "attributes": {
    "record": {
      "child": {
        "child_id": "d64b8458",
        "name": {
          "first": "Theodore",
          "last": "Customer"
        },
        "birth_date": "2022-04-12",
        "email": "jon.customer@klaviyo.com",
        "phone_numbers": [
              "+11234567899",
              "+13456789123"
        ]
      }
    }      
  }
}

Aby uzyskać dostęp do danych dotyczących imienia dziecka, możesz wprowadzić poniższą ścieżkę, ponieważ w przeciwnym razie dane są zbyt mocno zagnieżdżone, aby interfejs mógł uzyskać do nich dostęp.

Jeśli w danych źródłowych znajduje się tablica, właściwości do mapowania według pozycji można znaleźć. Możesz na przykład dodać pierwszy numer telefonu z tablicy number_numbers,dodając [0] na końcu ścieżki.

Dodaj relację

Po ustawieniu identyfikatora obiektu i zmapowaniu właściwości obiektu następnym krokiem jest dodanie relacji do obiektu.

Relacje łączą Twój obiekt z odpowiednim profilem. Aby utworzyć relację, zdefiniuj następujące informacje:

• Nazwa związku
  Ustaw nazwę dla swojego związku. Na przykład, jeśli masz obiekt zwierzaka, możesz ustawić nazwę relacji na coś w stylu „Właściciel zwierzaka”.
• Dane źródłowe
  Wybierz właściwości źródła danych, które chcesz powiązać z profilem.
• Identyfikator profilu
  Ustaw identyfikator profilu (np. adres e-mail, numer telefonu itp.). Musi to być uwzględnione w źródle danych, aby obiekt został powiązany z profilem. Użyj przycisku Połącz inną właściwość , aby dodać dodatkowe pary właściwości i identyfikatora.

Potwierdź mapowania i utwórz obiekt

Po zakończeniu mapowania właściwości obiektu i ustawienia relacji potwierdź mapowania w oknie modalnym potwierdzenia i wybierz przycisk Utwórz obiekt. Pamiętaj, że po utworzeniu obiektu nie można edytować istniejących mapowań, a synchronizacja danych rozpocznie się natychmiast.

Zobaczysz obiekt na stronie Obiekty w Klaviyo wraz z następującymi informacjami:

• Nazwa obiektu
• Data utworzenia
• Data ostatniej aktualizacji
• Status

Stany statusu obiektów niestandardowych

W przypadku publikowania obiektów niestandardowych dostępne są trzy statusy:

• Wersja
  robocza Obiekt jest nadal dostępny do edycji i nie został opublikowany ani aktywny.
• Publikowanie
  Obiekt tworzy niestandardowe rekordy obiektów na podstawie danych wysłanych do źródła danych.  Jeśli wysłano ze źródła danych kilka tysięcy rekordów, obiekt zostanie opublikowany natychmiast. Jeśli wysłano kilka milionów rekordów, publikacja może potrwać kilka godzin. Po zakończeniu status zmieni się na Aktywni.
• 
  Ten obiekt jest opublikowany i aktywny. Wszystkie rekordy niestandardowych obiektów zostały utworzone na podstawie danych przesłanych z Twojego źródła danych. Wszelkie nowe dane przesłane dla tego obiektu wygenerują dodatkowe rekordy obiektu niestandardowego powiązane z Twoim profilem.

Obiekty na stronach profilu

Odpowiednie obiekty będą również wyświetlane na stronie profilu, dzięki czemu można wyświetlić rekordy obiektów dotyczące profilu. Aby wyświetlić rekordy obiektów, przejdź do zakładki Obiekty na stronie profilu. Między obiektami można przełączać się za pomocą menu rozwijanego nad kartami obiektów.

Aby wyświetlić pełny rekord obiektu, wybierz menu z 3 kropkami i kliknij Widok. Pojawi się boczny panel zawierający pełny rekord obiektu.

Aktualizowanie obiektu

Jeśli chcesz rozpocząć wysyłanie nowych danych dla obiektu, dodaj dodatkowe właściwości obiektu do źródła danych, a następnie edytuj mapowanie obiektu, aby uwzględnić tę nową właściwość. Ponieważ dane te nie są dostępne, wszystkie utworzone wcześniej obiekty będą zwracać wartość NULL dla tej właściwości. W przyszłości obiekty będą tworzone i aktualizowane przy użyciu tej właściwości.

W przypadku wysyłania nowych właściwości obiektu, które nie zostały jeszcze zmapowane do obiektu, można zaktualizować swój obiekt niestandardowy, aby go uwzględnić. Wszystkie rekordy obiektów niestandardowych są następnie ponownie przetwarzane w celu uwzględnienia tych danych.

Aby zaktualizować obiekt:

1. Na pasku bocznym Klaviyo kliknij Treść > Obiekty.
2. Wybierz nazwę obiektu, który chcesz edytować.
3. Kliknij Dalej w prawym górnym rogu.
4. W sekcji Właściwości obiektu mapy kliknij Dodaj mapowanie.

1. W kolumnie Właściwość źródła danych wybierz właściwość źródła danych, którą chcesz uwzględnić w obiekcie.
2. W kolumnie Zmapowana właściwość wpisz nazwę, którą chcesz nadać właściwości źródła danych w obiekcie.
3. W kolumnie Data type wybierz odpowiedni typ danych dla właściwości źródła danych.

1. Kliknij Dalej w prawym górnym rogu.
2. Kliknij Dalej w prawym górnym rogu. Wprowadzanie zmian w relacjach nie będzie konieczne.
3. Kliknij Opublikuj zmiany.

Po zakończeniu tego procesu wszystkie rekordy z Twojego źródła danych zostaną ponownie przetworzone, a istniejące rekordy obiektów niestandardowych zostaną odpowiednio zaktualizowane.

Usuń obiekt

Aby usunąć obiekt:

1. Na pasku bocznym Klaviyo kliknij Treść > Obiekty.
2. W menu po prawej stronie obiektu kliknij Usuń.
   

3. Kliknij Usuń ponownie, aby potwierdzić usunięcie obiektu.
4. Obiekt i wszystkie powiązane rekordy obiektów niestandardowych zostaną usunięte.

Jeśli utworzysz nowy obiekt niestandardowy przy użyciu źródła danych poprzedniego obiektu, nowe rekordy obiektów niestandardowych zostaną wygenerowane przy użyciu już zsynchronizowanych danych. Chociaż wykorzystuje te same dane, jest uważany za nowy obiekt z nowymi rekordami, dlatego wszystkie segmenty, sekwencja, kampanie oraz kampanie muszą zostać zaktualizowane, aby można było używać tego nowego obiektu.