Pierwsze kroki z niestandardowymi obiektami

Czego się dowiesz

Dowiedz się więcej o niestandardowych obiektach, w tym o tym, jak skonfigurować obiekt i jak używać obiektów w Klaviyo.

Kilka słów na początek

Aby korzystać z tej funkcji, musisz mieć dostęp do niestandardowych obiektów. 

Czym są obiekty niestandardowe?

Obiekty niestandardowe są rodzajem struktury danych w Klaviyo, która włącza mapowanie różnorodnych, wielorelacyjnych koncepcji danych w Klaviyo, których nie można sklep przy użyciu właściwości profilu. Na przykład, powiedzmy, że chcesz sklep dane o zwierzętach klienta w Klaviyo. Każde zwierzę ma wiele atrybutów (np. imię, wiek, rasę). itp.), co utrudnia przechowywanie tych informacji z właściwościami profilu, gdy profil ma wiele zwierząt domowych. 

Następnie możesz użyć tego obiektu w sekwencji, szablonie i segmencie na stronie Klaviyo, aby lepiej spersonalizować swój marketing. 

Przykładowe przypadki użycia

Poniżej znajduje się kilka przykładów, które pokazują, jak niestandardowe obiekty są elastyczne w danych, które możesz sklepować w Klaviyo. 

Wizyta

Jeśli prowadzisz firmę, w której klient może planować spotkania, możesz użyć obiektu Appointment do przechowywania danych spotkań dla profilu.  

W ramach każdego rekordu obiektu dla obiektu Appointment, niektóre przykłady danych, które możesz chcieć uwzględnić to:

• Identyfikator spotkania 
• Data wyznaczenia
• Osoba wyznaczona (np. konkretny lekarz, instruktor itp.)
• Miejsce spotkania
• Typ spotkania 

Profil może mieć wiele rekordów obiektu, jeśli ma wiele spotkań, i możesz użyć tego obiektu dane do tworzenia segmentów i wysyłania spersonalizowanych wiadomości i sekwencji. 

Subskrypcja 

Jeśli jesteś firmą, w której klient może Zarejestruj się dla subskrypcji, możesz użyć obiektu Subskrypcja , aby sklep subskrypcji dane dla profilu.  

W ramach każdego rekordu obiektu dla obiektu Subscription, niektóre przykłady danych, które możesz chcieć dołączyć to:

• Identyfikator subskrypcji 
• Produkt subskrypcyjny
• Cena subskrypcji
• Status subskrypcji 
• Następna data rozliczenia

Profil może mieć wiele rekordów obiektu, jeśli ma wiele subskrypcji, i możesz użyć tego obiektu dane do tworzenia segmentów i wysyłania spersonalizowanych wiadomości i sekwencji. 

Rezerwacja

Jeśli jesteś firmą, w której klient może zarezerwować rezerwacje, możesz użyć obiektu Reservation , aby przechowywać dane rezerwacji dla profilu.  

W ramach każdego rekordu obiektu dla obiektu Reservation, niektóre przykłady danych, które możesz chcieć zawrzeć to:

• Identyfikator rezerwacji
• Data rezerwacji
• Miejsce rezerwacji
• Okazja do rezerwacji 
• Liczba gości rezerwacji 

Profil może mieć wiele rekordów obiektu, jeśli ma wiele rezerwacji, i możesz użyć tego obiektu dane do tworzenia segmentów i wysyłania spersonalizowanych wiadomości i sekwencji. 

Zwierzę domowe

Jeśli jesteś firmą, która obsługuje właścicieli zwierząt domowych, możesz użyć obiektu Pet , aby sklep dane o profilu zwierząt domowych.  

W ramach każdego rekordu obiektu dla obiektu Pet, niektóre przykłady danych, które możesz chcieć uwzględnić to:

• Identyfikator mikroczipa zwierzęcia
• Imię zwierzęcia 
• Typ zwierzęcia (np. pies lub kot)
• Rasa zwierząt domowych
• Urodziny zwierzaka 

Profil może mieć wiele rekordów obiektu, jeśli ma wiele zwierząt domowych, i możesz użyć tego obiektu dane do tworzenia segmentów i wysyłania spersonalizowanych wiadomości i sekwencji. 

limity konta 

Obiekty niestandardowe mają 3 zestawy limitów konta: 

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

Liczba dostępnych obiektów i rekordów obiektów jest oparta na całkowitej liczbie aktywnych profili na całym Twoim koncie. Limity rekordów są wspólne dla wszystkich kont, podczas gdy limity obiektów mają zastosowanie do każdego konta osobno. 

Na przykład, jeśli masz rodzinę z 5 kontami dziecięcymi, gdzie każde konto ma 100 000 aktywnych profili, Twój całkowity aktywny profil wynosi 500 000. Jak pokazano na poniższym wykresie, konta z ponad 400 000 profilami mają mnożnik rekordu obiektu wynoszący 10. W rezultacie konto to może przechowywać łącznie maksymalnie 5 milionów rekordów (500 000 x 10). Oznacza to, że możesz mieć 1 konto z 3 milionami rekordów, o ile pozostałe 4 konta mają łącznie mniej niż 2 miliony rekordów obiektów. Jeśli chodzi o liczbę obiektów na konto, ponieważ łączna liczba profili wynosi ponad 400 000, każde konto może mieć do 5 obiektów.

Dodatkowo, wszystkie konta mają następujące limity: 

• Maksymalnie 500 rekordów na profil na obiekt.
• Każdy niestandardowy obiekt nie może mieć więcej niż 8 KB.
• Każdy rekord obiektu niestandardowego nie może mieć więcej niż 2 KB.

Utwórz obiekt 

Aby rozpocząć tworzenie obiektu w Klaviyo, przejdź do sekcji Zawartość > Obiekty. 

Postępuj zgodnie z instrukcjami, aby utworzyć i zsynchronizować źródło danych dla obiektu niestandardowego. Po wykonaniu tych kroków wybierz przycisk Utwórz obiekt niestandardowy , aby utworzyć obiekt. 

W tym miejscu możesz utworzyć obiekt od podstaw lub wybrać zalecany szablon obiektu. Aby utworzyć obiekt od podstaw, wybierz przycisk Zbuduj własny.

Pierwsza część tworzenia obiektu Organizacja pracy wymaga ustawienia następujących informacji dla Twojego obiektu:

• Nazwa
  Nazwa identyfikująca twój obiekt
• Opis (opcjonalnie)
  Opis psa, którego reprezentuje twój obiekt
• źródło danych
  Źródło danych do pobrania danych obiektu. Co najmniej 1 rekord musi zostać wysłany do Klaviyo przy użyciu interfejsu API obiektu niestandardowego, aby pojawił się jako opcja na liście rozwijanej. 

Ustaw identyfikator obiektu

Po ustawieniu nazwy obiektu i wybraniu źródła danych, następnym krokiem jest ustawienie identyfikatora obiektu i zmapowanie żądanych właściwości obiektu. Podczas tego kroku będziesz mógł wyświetlić podgląd danych powiązanych ze źródłem danych, które zostało wysłane do Klaviyo za pośrednictwem niestandardowego obiektu API.

Ustawienie ID obiektu jest niezbędne do odróżnienia rekordów obiektów od siebie. Musisz określić właściwość dane source, która będzie używana jako unikalny identyfikator obiektu. 

Identyfikator obiektu powinien być unikalną właściwością źródła danych, którą można wykorzystać do identyfikacji konkretnych wystąpień rekordu obiektu. Na przykład w przypadku obiektu karty podarunkowej jako identyfikator obiektu można użyć unikalnego kodu rabatowego. Jest to unikalne dla każdego wystąpienia źródła danych i będzie istnieć dla każdego rekordu obiektu. 

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

Wyślij dane obiektu

Gdy aktualizujesz istniejący rekord obiektu, zastępowany jest cały obiekt. Dlatego bardzo ważne jest, aby za każdym razem wysyłać cały obiekt, nawet jeśli chcesz zaktualizować tylko 1 rekord. 

Na przykład, powiedzmy, że chcesz zaktualizować tylko 1 z 5 rekordów w obiekcie. Jeśli wyślesz aktualizację danych z ID i tylko 1 rekordem, który chcesz zaktualizować, pozostałe 4 rekordy zostaną ustawione na wartość null. Jeśli jedno z nowych pól null było używane w Twojej relacji profilu (np. identyfikator profilu, taki jak adres e-mail), obiekt nie będzie już powiązany z tym profilem.

Właściwości obiektu mapy 

Mapując właściwości obiektu, możesz wybrać, które informacje ze źródła danych będą dostępne w obiekcie w Klaviyo.

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

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

1. W kolumnie właściwości źródła danych wybierz właściwość źródła danych, którą chcesz dołączyć do swojego obiektu. 
2. W kolumnie Mapped property wprowadź nazwę, którą chcesz nadać właściwości dane source 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 pomaga na 1 poziomie zagnieżdżenia. Aby uzyskać dostęp do głębszych danych, musisz ręcznie wprowadzić wybraną ścieżkę.

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

{
  "typ": "data-source-record",
  "atrybuty": {
    "record": {
      "child": {
        "child_id": "d64b8458",
        "name": {
          "first": "Theodore",
          "last": "Customer"
        },
        "birth_date": "2022-04-12",
        "email": "jon.customer@klaviyo.com",
        "numery telefonów": [
              "+11234567899",
              "+13456789123"
        ]
      }
    }      
  }
}

Aby uzyskać dostęp do danych dotyczących imienia dziecka, możesz wprowadzić następującą ścieżkę, ponieważ w przeciwnym razie dane są zagnieżdżone zbyt daleko, aby uzyskać do nich dostęp za pomocą interfejsu.

Jeśli masz tablicę w danych źródłowych, możesz znaleźć właściwości do mapowania według pozycji. Na przykład, możesz pobrać pierwszy numer telefonu z tablicy phone_numbers , dołączając [0] na końcu ścieżki. 

Dodaj relację 

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

Relacje łączą twój obiekt z odpowiednim profilem. Zdefiniuj następujące informacje, aby ustawić relację: 

• Nazwa relacji
  Ustaw nazwę dla relacji. Na przykład, jeśli masz obiekt zwierzaka, możesz ustawić nazwę relacji na coś w rodzaju "Właściciel zwierzaka ".
• Źródło danych
  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 on być zawarty w źródle danych, aby obiekt mógł być 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 ustawiania relacji, potwierdź mapowania w oknie dialogowym potwierdzenia i wybierz przycisk Utwórz obiekt. Pamiętaj, że istniejące mapowania nie mogą być edytowane po utworzeniu obiektu, a dane zaczną być synchronizowane natychmiast. 

Zobaczysz swój obiekt wymieniony na stronie Obiekty w Klaviyo, wraz z następującymi informacjami: 

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

Niestandardowe stany obiektów

 Podczas publikowania obiektów niestandardowych dostępne są trzy stany: 

• Draft
  Obiekt jest nadal edytowalny, ale nie jest opublikowany ani aktywny .
• Publikacja
  Obiekt tworzy niestandardowe rekordy obiektu na podstawie danych przesłanych do źródła danych. Jeśli wysłano kilka tysięcy rekordów ze źródła danych, obiekt zostanie opublikowany natychmiast. Jeśli wysłano kilka milionów rekordów, publikacja może potrwać kilka godzin. Po zakończeniu status zostanie zmieniony na Aktywny.
• Active
  Obiekt jest opublikowany i aktywny. Wszystkie niestandardowe rekordy obiektu zostały utworzone zgodnie z danymi przesłanymi z Państwa źródła danych. Wszelkie nowe dane przesłane dla tego obiektu wygenerują dodatkowe niestandardowe rekordy obiektów powiązane z Państwa profilami.

Obiekty na stronach profilowych

Odpowiednie obiekty pojawią się również na stronie profilu, dzięki czemu możesz przeglądać rekordy obiektów odnoszące się do profilu. Aby wyświetlić rekordy obiektów, przejdź do karty Obiekty na stronie profilu. Możesz przełączać się między obiektami za pomocą menu rozwijanego nad kartami obiektów. 

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

aktualizacja 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ść. Wszystkie wcześniej utworzone obiekty zwrócą wartość null dla tej właściwości, ponieważ nie jest ona dostępna, ale w przyszłości obiekty będą tworzone i aktualizowane z tą właściwością.

Jeśli wyślesz nowe właściwości obiektu, które nie zostały jeszcze zmapowane do obiektu, możesz 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. Kliknij Treść > Obiekty na pasku bocznym Klaviyo.
2. Wybierz nazwę obiektu, który chcesz edytować. 
3. Kliknij przycisk Dalej w prawym górnym rogu.
4. W sekcji Właściwości obiektu mapy kliknij Dodaj mapowanie.

   Ta opcja jest dostępna tylko wtedy, gdy twój obiekt ma dodatkowe właściwości, które można dodać.

5. W kolumnie właściwości źródła danych wybierz właściwość źródła danych, którą chcesz dołączyć do swojego obiektu. 
6. W kolumnie Mapped property wprowadź nazwę, którą chcesz nadać właściwości dane source w obiekcie. 
7. W kolumnie typ danych wybierz odpowiedni typ danych dla właściwości źródła danych.

   Nowo zmapowane właściwości nie mogą być oznaczone jako wymagane.

   
8. Kliknij przycisk Dalej w prawym górnym rogu. 
9. Kliknij przycisk Dalej w prawym górnym rogu. Nie będziesz musiał wprowadzać zmian w swoich relacjach.
10. Kliknij przycisk 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. Kliknij Treść > Obiekty na pasku bocznym Klaviyo.
2. W menu po prawej stronie obiektu kliknij opcję Usuń. 
   
3. Kliknij ponownie przycisk Usuń , aby potwierdzić usunięcie obiektu. 
4. Obiekt i wszystkie powiązane rekordy obiektów niestandardowych są usuwane. 

Jeśli utworzysz nowy obiekt niestandardowy przy użyciu źródła danych poprzedniego obiektu, nowe rekordy obiektu niestandardowego zostaną wygenerowane przy użyciu danych, które zostały już zsynchronizowane. Chociaż używa on tych samych danych, jest uważany za nowy obiekt z nowymi rekordami, więc wszystkie segmenty, sekwencja, szablon i kampanie muszą zostać zaktualizowane, aby korzystać z tego nowego obiektu.

Dodatkowe źródła 

Jak używać niestandardowych obiektów w szablonie

Jak używać niestandardowych obiektów w segmencie

Jak używać obiektów niestandardowych w sekwencji

Przegląd interfejsu API obiektów niestandardowych