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?
Tak, ta funkcje zależy od użycia API do wysyłania źródeł danych i ostatecznie tworzenia obiektów.
Czy mogę tworzyć obiekty niestandardowe za pomocą formularzy Klaviyo lub przesyłania plików CSV?
Obecnie Klaviyo wymaga, aby konta tworzyły nowe obiekty niestandardowe przez przesyłanie nam danych przez API.
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.
Podczas śledzenia elementów, takich jak status członkostwa, gdzie profil może mieć tylko jeden status naraz, lepszym rozwiązaniem są właściwości profilu. Jeśli jednak chcesz też przechowywać inne szczegóły dotyczące członkostwa profilu, obiekt może sprawdzić się lepiej.
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, zawsze można dodać dodatkowe, niewymagane właściwości do niestandardowego obiektu. Więcej informacji w artykule aktualizowanie niestandardowego obiektu.
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ąć:
- Użyj znacznika
{{ event }}, aby dodać odpowiednie właściwości w metadanych zdarzenia do wykorzystania w szablonie. To sprawdza się dobrze, gdy liczy się terminowość. - Uwzględnij identyfikator obiektu w metadanych zdarzenia, co pozwala pobrać obiekt w szablonie za pomocą
{% customobject id={{ event.pet_id }} as pet %}. Może jednak minąć trochę czasu, zanim obiekt zostanie zaktualizowany o najnowsze właściwości, więc możliwe, że sekwencja uruchomiła wysyłkę wiadomości, zanim obiekt został zaktualizowany.
Pytania dotyczące wysyłania danych obiektów
Jak zacząć wysyłać swoje dane dla obiektów niestandardowych?
- Utwórz nowe źródło danych za pomocą naszego interfejsu API.
- Zdefiniuj strukturę danych (zobacz przykładowy JSON).
- Wyślij rekordy źródła danych do Klaviyo za pomocą API.
- Utwórz obiekt niestandardowy.
- Utwórz relację między obiektem niestandardowym a profilami.
Jak tworzone i wykorzystywane są źródła danych?
Obiekty niestandardowe są tworzone na podstawie źródeł danych. Twój programista musi utworzyć nowe źródło danych za pomocą naszego API obiektów niestandardowych.
Po utworzeniu nowego źródła danych Klaviyo zwróci unikatowy identyfikator jako część odpowiedzi na Twoje żądanie API. Dzięki temu Klaviyo może identyfikować źródła danych, szczególnie w przypadkach, gdy konto ma wiele źródeł danych (np. po 1 dla każdej niestandardowej integracji, hurtowni danych lub niestandardowej integracji zewnętrznej, na której marka opiera swoją działalność).
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. Zalecamy wysyłanie danych jako tekstu z listą rozdzielaną przecinkami. Będzie można użyć segmentacji i operatora „zawiera” w filtrze sekwencji, aby filtrować wartości w tym ciągu rozdzielanym przecinkami. Więcej informacji na temat filtrowania znajdziesz w odniesieniu do warunków segmentu.
Obsługiwane typy danych w obiektach niestandardowych:
- Tekst
- Liczba całkowita
- Dziesiętny
- Data – Wszystkie daty i godziny są w naszym systemie konwertowane na UTC. Na przykład, jeśli prześlesz „2025-04-03”, zostanie on przekonwertowany na „2025-04-03 00:00:00”. Dla klientów w strefach czasowych o trzy godziny do przodu data i godzina będzie wyglądać tak: „2025-04-02 21:00:00”.
- Wartość logiczna
Typ danych listy nie jest obecnie obsługiwany. Przykładowy ładunek dla interfejsu API rekordów źródła danych znajdziesz w artykule Zbiorcze tworzenie rekordów źródła danych.
Podczas wysyłania numerów telefonów muszą one być w formacie E.164. Podczas wysyłania dat muszą one być w jednym z naszych akceptowalnych formatów znaczników czasu.
Jakie są limity danych dla obiektów niestandardowych?
Możesz przesłać maksymalnie 2 KB na właściwość i 8 KB na cały rekord.
Czy mogę mapować dane zagnieżdżone?
Zalecamy zdefiniowanie obiektu JSON bez zagnieżdżania właściwości, których chcesz używać w obiekcie niestandardowym. Jeśli dane źródłowe są mocno zagnieżdżone lub używają listy, trzeba ręcznie wprowadzić ścieżkę JSON w menedżerze obiektów. W przypadku list możesz mapować właściwość tylko do pozycji w tej liście (np. pierwszej lub drugiej wartości).
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ę?
Obecnie nie można użyć funkcji podglądu w aplikacji, aby wyświetlić wiadomość, gdy używasz znacznika {{ object }}.
Aby przetestować wiadomość w sekwencji:
- Utwórz sekwencję wyzwalaną datą i ustaw ją jako aktywną.
- Utwórz profil z obiektem zawierającym datę, która zostanie wyzwolona za co najmniej 24 godziny.
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.