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

Czego się dowiesz

Zapoznaj się z często zadawanymi pytaniami dotyczącymi niestandardowych obiektów w Klaviyo. Jeśli nie widzisz swojego pytania w poniższych zasobach, prosimy o kontakt na naszym forum społecznościowym.

Ogólne pytania dotyczące obiektów

Czy do utworzenia obiektu potrzebny jest programista?

Tak, ta funkcja zależy od użycia API do wysyłania danych źródłowych i ostatecznie tworzenia obiektów.

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

Klaviyo Obecnie wymaga, aby konto tworzyło nowe niestandardowe obiekty, wysyłając nam dane za pośrednictwem API. 

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

Obiektów niestandardowych należy używać, gdy istnieje relacja wiele-do-jednego między kategorią reprezentowaną przez obiekt niestandardowy a profilem. Na przykład, jeśli chcesz przechowywać informacje o zwierzakach klienta, a klient może mieć więcej niż jednego zwierzaka, reprezentowanie ich jako niestandardowego obiektu działa znacznie lepiej niż właściwości profilu lub zdarzeń.

W przypadku śledzenia elementów takich jak status członkostwa, gdzie profil może mieć tylko jeden status na raz, właściwości profilu są lepszym rozwiązaniem. Jeśli jednak chcesz przechowywać również inne szczegóły dotyczące członkostwa w profilu, obiekt może działać lepiej. 

Kiedy śledzisz coś szerokiego, na przykład ile razy odbiorca otworzył wiadomość e-mail, zalecamy użycie zdarzeń.

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

Tak, zawsze możesz dodać dodatkowe, niewymagane właściwości do swojego niestandardowego obiektu. Aby dowiedzieć się więcej, przeczytaj o aktualizacji niestandardowego obiektu. 

Kiedy powinienem emitować zdarzenie zamiast aktualizować właściwości obiektu niestandardowego?

Zdarzenia mają na celu szybkie wyzwalanie sekwencji, umożliwiając wysyłanie aktualnych i odpowiednich wiadomości. Gdy status obiektu ulegnie zmianie i chcesz wywołać w związku z tym wiadomość, powinieneś zaktualizować obiekt o nowe informacje i wysłać nam zdarzenie, aby wywołać sekwencję.

Możesz spersonalizować szablon za pomocą informacji o obiekcie w sekwencji wyzwalanej zdarzeniem. Możesz to osiągnąć na dwa sposoby: 

1. Użyj znacznika {{ event }} znacznik, aby dodać odpowiednie właściwości w metadanych wydarzenia do wykorzystania w szablonie. Działa to dobrze, gdy ważna jest terminowość.
2. Uwzględnij identyfikator obiektu w metadanych zdarzenia, co pozwoli ci uzyskać obiekt w szablonie za pomocą {% customobject id={{ event.pet_id }} as pet %}. Jednak aktualizacja obiektu z najnowszymi właściwościami może zająć trochę czasu, więc możliwe jest, że sekwencja wyzwoliła wysłanie wiadomości, zanim obiekt został zaktualizowany.

Pytania dotyczące wysyłania obiektu Dane 

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

1. Utwórz nowe źródło danych , korzystając z naszej strony API.
2. Zdefiniuj strukturę danych (zobacz przykład JSON).
3. Wyślij swoje dane źródłowe do Klaviyo poprzez API.
4. Utwórz swój niestandardowy obiekt.
5. Utwórz relację między obiektem niestandardowym a profilem.

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

Po utworzeniu nowego źródła danych, Klaviyo zwróci unikalny identyfikator jako część odpowiedzi na twoje żądanie API. Pozwala to Klaviyo zidentyfikować źródła danych, szczególnie w przypadkach, gdy konto ma wiele źródeł danych (np. 1 dla każdej niestandardowej integracji, hurtowni danych lub niestandardowej integracji strony trzeciej, na której marka polega w swojej działalności).

Dzięki temu unikalnemu identyfikatorowi twój programista może następnie tworzyć rekordy źródłowe danych za pośrednictwem Klaviyo' API.

Jak sformatować dane?

Twój deweloper będzie musiał wysłać dane w formacie JSON do Klaviyo. Zalecamy wysyłanie danych w postaci tekstu z listą rozdzielaną przecinkami. Będziesz mógł użyć operatora "contains" segmentacji i filtru sekwencji, aby filtrować wartości w tym łańcuchu rozdzielanym przecinkami. Aby uzyskać więcej informacji na temat filtrowania, zapoznaj się z informacjami dotyczącymi warunków na stroniesegment .  

Obsługiwane typy danych w obiektach niestandardowych:

• Tekst
• Liczba całkowita
• Dziesiętny
• Data - wszystkie daty są konwertowane na UTC w naszym systemie. Na przykład, jeśli prześlesz "2025-04-03", zostanie on przekonwertowany na "2025-04-03 00:00:00". W przypadku klientów ze strefami czasowymi przesuniętymi o trzy godziny do przodu, data i godzina brzmiałyby "2025-04-02 21:00:00".
• Wartość logiczna

Typ listy danych nie jest obecnie obsługiwany. Aby zapoznać się z przykładowym ładunkiem dla rekordu źródłowego API dane, zobacz sekcję Zbiorcze tworzenie rekordów źródłowych dane.

Jakie są limity danych dla obiektów niestandardowych?

Możesz przesłać maksymalnie 2 KB na nieruchomość i 8 KB na cały rekord.

Czy mogę mapować za pomocą zagnieżdżonych danych?

Zalecamy zdefiniowanie obiektu JSON bez zagnieżdżania właściwości, których chcesz użyć dla swojego niestandardowego obiektu. Jeśli twoje dane źródłowe są głęboko zagnieżdżone lub używają listy, będziesz musiał ręcznie wprowadzić ścieżkę JSON do menedżera obiektów. W przypadku listy możesz mapować właściwość tylko na pozycję na liście (np. pierwszą lub drugą wartość).

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

Tak, jeśli chcesz użyć 2 lub więcej identyfikatorów profilu (np. e-mail i numer telefonu), aby powiązać rekordy obiektu niestandardowego z profilem, upewnij się, że uwzględniasz obie te właściwości w każdej synchronizacji, nawet jeśli wartość jednej z nich jest zerowa.  

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

Czy mogę użyć podziału wyzwalacza lub filtrów wyzwalacza dla sekwencji wyzwalanych datą?

W tej chwili tworzenie podziałów wyzwalaczy i filtrów wyzwalaczy dla sekwencji wyzwalanych datą nie jest dostępne.

Jeśli mój obiekt nie wywołał sekwencji i nie mam identyfikatora obiektu ze zdarzenia, czy nadal mogę spersonalizować moje wiadomości?

Tak, możesz użyć filtrów obiektów, aby znaleźć odpowiedni obiekt podczas personalizowania wiadomości. 

Czy mogę wyświetlić podgląd komunikatów sekwencji, gdy obiekt wyzwala sekwencję? 

W tej chwili nie jest możliwe korzystanie z funkcji podglądu w aplikacji, aby wyświetlić wiadomość, gdy używasz znacznika {{ object }} znacznik.

Aby przetestować wiadomość sekwencja:

1. Utwórz sekwencję wyzwalaną datą i ustaw ją jako aktywną.
2. Utwórz profil z obiektem o dacie, która zostanie wyzwolona w ciągu co najmniej 24 godzin.

Czy mogę aktualizować moje obiekty za pomocą akcji sekwencji, takich jak webhook i kod Klaviyo?

W tym momencie radzimy najpierw zaktualizować oryginalne źródło danych, a następnie wysłać poprawiony obiekt powrotu do Klaviyo w dozwolonym formacie. Jeśli te dwa systemy nie są zsynchronizowane, ryzykujesz wysłanie nieaktualnego rekordu powrotu do Klaviyo ze swojego systemu, przywracając go do pierwotnej wartości.