Często zadawane pytania dotyczące obiektów niestandardowych

Czego się dowiesz?

Poznaj często zadawane pytania związane z obiektami niestandardowymi w Klaviyo. Jeśli nie widzisz swojego pytania w poniższym zasobie, skontaktuj się z nami na naszym forum Społeczności.

Ogólne pytania dotyczące obiektów

Czy do utworzenia obiektu potrzebny jest programista?

Potrzebujesz programisty, aby wysyłać niestandardowe dane przez API. Możesz utworzyć źródło danych i skonfigurować obiekt w Klaviyo.

Czy mogę tworzyć obiekty niestandardowe za pomocą formularzy Klaviyo lub przesyłania plików CSV?

Formularze Klaviyo i przesyłania plików CSV nie wysyłają rekordów obiektów niestandardowych. Użyj API, aby wysłać swoje dane niestandardowe, a następnie zmapuj je do obiektu w Klaviyo.

Kiedy należy użyć obiektu niestandardowego zamiast właściwości profilu lub zdarzenia?

Niestandardowych obiektów należy używać, gdy między kategorią reprezentowaną przez niestandardowy obiekt a profilami zachodzi relacja wiele do jednego. Na przykład jeśli chcesz zachować informacje o zwierzętach domowych klienta, a klient może mieć więcej niż jedno zwierzę, przedstawienie ich jako obiektu niestandardowego działa znacznie lepiej niż właściwości profilu lub zdarzenia.

Gdy śledzisz elementy takie jak status członkostwa, gdzie profil może mieć tylko jeden status naraz, lepiej sprawdzą się właściwości profilu. Jeśli jednak chcesz też przechowywać inne szczegóły dotyczące członkostwa profilu, lepszym rozwiązaniem może być obiekt.

Gdy śledzisz coś ogólnego, np. ile razy odbiorca otworzył e-mail, zalecamy korzystanie ze zdarzeń.

Czy mogę zaktualizować mój obiekt niestandardowy po utworzeniu?

Tak, możesz dodać niewymagane właściwości do limitu właściwości obiektów na Twoim koncie. Aby dowiedzieć się więcej, przeczytaj o aktualizowaniu obiektu niestandardowego.

Kiedy należy emitować zdarzenie, a kiedy aktualizować właściwości obiektu niestandardowego?

Zdarzenia mają na celu szybkie wyzwalanie sekwencji, umożliwiając wysyłanie terminowych i odpowiednich komunikatów. Gdy status obiektu się zmieni i chcesz w wyniku tego wyzwolić wiadomość, zaktualizuj obiekt, dodając nowe informacje, i wyślij nam zdarzenie, aby wyzwolić sekwencję.

Możesz personalizować szablony za pomocą informacji o obiekcie w sekwencji wyzwalanej zdarzeniem. Są dwa sposoby, aby to osiągnąć:

1. Uwzględnij właściwości, których potrzebujesz w danych zdarzenia, a następnie odwołaj się do nich w swoim szablonie. Na przykład, jeśli zdarzenie zawiera właściwość pet_name, użyj {{ event.pet_name }}. To sprawdza się świetnie, gdy liczy się czas.
2. Uwzględnij identyfikator obiektu w danych zdarzenia, a następnie pobierz obiekt w szablonie. W przypadku obiektu o nazwie Pet z właściwością Name i właściwością zdarzenia o nazwie pet_id użyj {% customobject event.pet_id object_type_title="Pet" as pet %}{{ pet.Name }}{% endcustomobject %}. Zastąp te nazwy własnymi nazwami obiektu, właściwości i pola zdarzenia. Może minąć trochę czasu, zanim aktualizacje obiektu staną się dostępne, więc wiadomość w sekwencji może zostać wysłana, zanim obiekt będzie mieć najnowsze wartości.

Pytania dotyczące wysyłania danych obiektów

Jak zacząć wysyłać swoje dane dla obiektów niestandardowych?

1. Utwórz nowe źródło danych za pomocą naszego interfejsu API.
2. Zdefiniuj strukturę danych, korzystając z przykładowego pliku JSON w Zbiorcze tworzenie rekordów źródła danych.
3. Wyślij rekordy źródła danych do Klaviyo za pomocą API.
4. Utwórz swój obiekt niestandardowy, korzystając z tego źródła danych. Wybierz unikalny identyfikator obiektu i zmapuj właściwości, których chcesz używać.
5. Utwórz relację między Twoim obiektem niestandardowym a Twoimi profilami, mapując identyfikatory profilu w swoich danych, na przykład adres e-mail lub numer telefonu.
6. Sprawdź swoje mapowania, kliknij Utwórz obiekt, a następnie kliknij ponownie Utwórz obiekt, aby potwierdzić.

Jak tworzone i wykorzystywane są źródła danych?

Gdy tworzysz źródło danych przez API, Klaviyo zwraca unikalny identyfikator jako część odpowiedzi na Twoje żądanie API. Dzięki temu Klaviyo może identyfikować źródła danych, zwłaszcza w przypadkach, gdy konto ma wiele źródeł danych (np. po 1 dla każdej niestandardowej integracje, hurtowni danych lub niestandardowej integracje zewnętrznej, na której marka polega w swojej działalności).

Dzięki temu unikatowemu identyfikatorowi deweloper może następnie tworzyć rekordy źródła danych za pomocą API Klaviyo.

Jak sformatować dane?

Twój programista będzie musiał przesłać do Klaviyo dane w formacie JSON. W przypadku właściwości z wieloma wartościami tekstowymi prześlij tablicę ciągów znaków i zmapuj ją jako Lista (tekst). Możesz filtrować te wartości w segmentach i sekwencjach. Więcej informacji o filtrowaniu znajdziesz w dokumentacji warunków segmentu.

Obsługiwane typy danych w obiektach niestandardowych:

• Tekst
• Liczba (całkowita)
• Liczba (dziesiętna)
• Znacznik czasu: Daty i godziny są przechowywane w UTC. Wartość bez strefy czasowej, np. 2025-04-03, jest traktowana jako 2025-04-03 00:00:00 UTC. Wartość z przesunięciem, np. 2025-04-03T00:00:00+03:00, jest konwertowana na 2025-04-02 21:00:00 UTC.
• Wartość logiczna
• Lista (tekstowa)

Lista (tekst) obsługuje tablice ciągów znaków, takie jak ["dog", "cat"]. Nie obsługuje tablic liczb, list zagnieżdżonych ani obiektów. Aby zobaczyć przykładowy ładunek dla interfejsu API rekordu źródła danych, zobacz Zbiorcze tworzenie rekordów źródła danych.

Jakie są limity danych dla obiektów niestandardowych?

Każda zmapowana właściwość obiektu niestandardowego może zawierać do 2 KB, a każdy zmapowany rekord obiektu niestandardowego może zawierać do 8 KB.

Czy mogę mapować dane zagnieżdżone?

Zalecamy zdefiniowanie obiektu JSON bez zagnieżdżania właściwości, których chcesz użyć w obiekcie niestandardowym. W przypadku danych zagnieżdżonych wybierz właściwość z listy rozwijanej Właściwość źródła danych lub wpisz ręcznie jej ścieżkę JSON. W przypadku listy wartości tekstowych zmapuj samą listę jako Lista (tekst). Aby zmapować pojedynczy element z tablicy, użyj jego pozycji, np. [0] dla 1. elementu lub [1] dla 2. elementu.

Czy mogę powiązać wiele identyfikatorów z profilem?

Tak — jeśli chcesz używać co najmniej 2 identyfikatorów profilu (np. adresu e-mail i numeru telefonu), aby powiązać rekordy niestandardowych obiektów z profilem, upewnij się, że w każdej synchronizacji uwzględniasz obie te właściwości, nawet jeśli wartość jednej z nich ma wartość null. 

Pytania dotyczące używania obiektów z sekwencja

Jeśli mój obiekt nie uruchomił sekwencji i nie mam identyfikatora obiektu z wydarzenia, czy nadal mogę personalizować wiadomości?

Tak, możesz używać filtrów obiektów, aby znaleźć właściwy obiekt podczas personalizowania wiadomości.

Czy mogę wyświetlić podgląd wiadomości sekwencji, gdy obiekt uruchamia sekwencję?

Tak. Możesz podejrzeć wiadomości, które wykorzystują dane {{ object }} w sekwencji wyzwalanej datą na podstawie obiektu niestandardowego, zanim uruchomisz sekwencję na żywo.

Aby wyświetlić podgląd wiadomości e-mail:

1. Otwórz e-mail w sekwencji wyzwalanej datą na podstawie obiektu niestandardowego, a następnie kliknij Podgląd w edytorze e-maili.
2. Wybierz profil powiązany z rekordem dla tego obiektu, a następnie przejrzyj spersonalizowaną wiadomość.

Podgląd wykorzystuje przykładowy obiekt powiązany z wybranym profilem. Jeśli żaden nie jest dostępny, wykorzystuje przykładowy rekord tego samego typu obiektu. Sprawdź wyświetlane wartości: podgląd nie potwierdza, który rekord uruchomi sekwencję. Jeśli żadne rekordy nie są dostępne, nie ma danych obiektu do wyświetlenia w podglądzie.

Czy mogę aktualizować moje obiekty za pomocą działań sekwencji, takich jak webhook i kod Klaviyo?

W tej chwili zalecamy najpierw zaktualizować pierwotne źródło danych, a następnie odesłać zmieniony obiekt z powrotem do Klaviyo w dozwolonym formacie. Jeśli te dwa systemy przestaną być zsynchronizowane, ryzykujesz wysłanie z systemu zdezaktualizowanego rekordu z powrotem do Klaviyo, co spowoduje przywrócenie pierwotnej wartości.