Narzędzia profilu Customer Agent
Czego się dowiesz?
Czym są narzędzia do tworzenia profili Customer Agent, do czego służą i jak je wykorzystywać? Narzędzia te pozwalają agentowi odczytywać i zapisywać na profilu Klaviyo kupującego podczas konwersacji. Pozwala to personalizować odpowiedzi i odpowiadać na pytania „What's my…” i zbierać nowe dane z powrotem do profilu.
Pięć narzędzi profilowania
Customer Agent zawiera pięć wbudowanych narzędzi, które odczytują lub zapisują dane w profilu uwierzytelnionego kupującego. Nie konfigurujesz ich – można je powiązać z dowolną umiejętnością.
Narzędzie | Co to robi |
Uzyskaj profil | Pobiera właściwości profilu aktualnie uwierzytelnionego kupującego. |
Pobierz zdarzenia profilowe | Pobiera ostatnią aktywność profilu — zamówienia, zaangażowanie w e-maile, przesłania formularzy, subskrypcje oraz aktywność w witrynie. |
Pobieranie list i segmentów profili | Pobiera aktywne listy, segmenty lub oba te elementy dla uwierzytelnionego klienta. |
Uzyskaj podsumowanie prognozy profilu | Zwraca analitykę predykcyjną Klaviyo dla kupującego — wartość życiową klienta, wskaźnik rezygnacji, przewidywania zakupów i kondycję klienta. |
Aktualizuj właściwość profilu | Aktualizuje pojedynczą niestandardową właściwość w profilu uwierzytelnionego kupującego. |
Cała piątka automatycznie rozpoznaje klienta na podstawie kontekstu konwersacji (jego adresu e-mail, telefonu lub identyfikatora profilu). Działają one tylko w przypadku zidentyfikowanych kupujących.
Wszystkie pięć umiejętności można znaleźć na stronie Narzędzia w Customer Agent i powiązać je z dowolną umiejętnością z edytora umiejętności.
Kiedy używać każdego z nich
Uzyskaj profil
Użyj, gdy agent musi wiedzieć, z kim się kontaktuje – czyli z właściwościami takimi jak imię i nazwisko, preferencje e-mailowe, ostatni adres wysyłki lub dowolna niestandardowa właściwość, którą przechowujesz.
Przykład: „Cześć Sarah! Twoje ostatnie zamówienie zostało wysłane na adres kończący się na 1234. Czy mamy użyć tego jeszcze raz?
Funkcja Get Profile zwraca też informacje o tym, gdzie znajduje się kupujący: kraj wykryty przez Customer Agent na potrzeby rozmowy oraz lokalizację na jego profilu. Użyj tego, aby inaczej obsłużyć to samo żądanie w zależności od kraju.
Przykład: „Wywołaj Get Profile, aby sprawdzić kraj kupującego.” Jeśli kraj to Kanada, wyjaśnij, że zamówienia są wysyłane z naszego magazynu w Toronto.”
Aby ograniczyć całą umiejętność lub fragment treści do wybranych krajów, zamiast tego użyj regionów. Zobacz Jak skonfigurować Customer Agent dla wielu krajów i regionów.
Pobierz zdarzenia profilowe
Użyj, gdy agent musi wiedzieć, co zrobił kupujący. Zamówienia, otwarcia e-maili, przesłania formularzy, wyświetlenia stron, subskrypcje – wszystko, co jest śledzone na profilu jako zdarzenie.
Przykłady:
- Kupujący pyta: „Kiedy było moje ostatnie zamówienie?” Umiejętność dołącza Get Profile Events z Typ zdarzenia =
Placed Orderi odpowiada datą. - Klient pyta: „Co było w moim koszyku?” Umiejętność dołącza zdarzenia Get Profile Events z Typ zdarzenia =
Added to Carti wyświetla z powrotem listę produktów.
Typ zdarzenia i inne ustawienia wybierasz na pasku bocznym narzędzia podczas dołączania narzędzia – zobacz Konfigurowanie dołączanego narzędzia poniżej.
Pobieranie list i segmentów profili
Użyj, gdy zachowanie agenta powinno zależeć od grupy odbiorców, do której kupujący się zalicza. klient VIP? Znajdujesz się już na liście produktów „znów dostępne”? Wykluczyć Cię z promocyjnych e-maili?
Przykład: jeśli kupujący należy do segmentu VIP, agent przy zwrocie oferuje bezpłatną zmianę planu na wyższy.
Uzyskaj podsumowanie prognozy profilu
Użyj opcji kupującego lub umiejętności Klaviyo, która potrzebuje predykcyjnej wartości życiowej, ryzyka, oczekiwanego kolejnego zakupu lub wskaźnika kondycji klienta.
Przykład: Zanim zaoferują Ci rabat, osoby kupujące wysokiego ryzyka sprawdzają wskaźnik A, że klientki wysokiego ryzyka otrzymują korzystniejszą ofertę.
Aktualizuj właściwość profilu
Używaj, gdy agent powinien odpowiedzieć do profilu kupującego podczas konwersacji – odpowiedzi na quiz, preferencje, opinie i wszystko, co w przeciwnym razie można zapisać w formularzu.
Przykłady:
- Kupujący odpowiada na quiz: „Wolę ziemiste zapachy.” → Agent zapisuje
scent_preference: earthy. - Klient przekazuje opinię podczas zwrotu: „Nie pasowało, było za małe”. → Agent zapisuje
last_return_reason: sizing.
Po pojawieniu się właściwości w profilu każda inna część Klaviyo może z niej korzystać – sekwencja, segmenty, kampanie, a także przyszłe konwersacje z Customer Agentem.
Jak wykorzystać te narzędzia w umiejętności
- Otwórz umiejętność, którą chcesz zaktualizować (lub utwórz nową).
- W edytorze umiejętności dołącz potrzebne narzędzia do profili.
- Jeśli narzędzie ma dane wejściowe konfiguracji, wypełnij je (patrz poniżej).
- W sekcji Jak odpowiadać poinformuj umiejętności, kiedy i jak używać poszczególnych narzędzi. Bądź konkretny:
- Kiedy agent powinien wywołać narzędzie
- Co to zrobić z wynikiem?
- W przypadku aktualizacji profilu: którą właściwość należy zapisywać, jaki format powinna mieć wartość i kiedy nie należy jej zapisywać;
Konfigurowanie narzędzia podczas jego dołączania
Niektóre narzędzia profilowe zawierają dane wejściowe, które można wstępnie wypełnić na poziomie umiejętności. Wstępne wypełnianie blokuje wartość dla każdego wywołania umiejętności, co zapewnia lepszą kontrolę i pozwala uniknąć konieczności zastanawiania się przez agenta w czasie wykonywania.
Głównym przykładem są zdarzeniapobierania profilu. Po powiązaniu go z umiejętnością będzie można skonfigurować:
- Typ zdarzenia (wymagane) — którą metrykę pobrać (np.
Placed Order,Checkout Started,Added to Cart,Opened Email,Viewed Product). - Limit – liczba ostatnich zdarzeń do zwrócenia. Wpisz 1, jeśli potrzebujesz tylko najnowszych.
- Kolejność sortowania – od najnowszych lub od najstarszych.
- Oknopodsumowania – jak daleko wstecz do wyszukiwania. Domyślnie 90 dni.
Umiejętność, która na przykład musi analizować najnowszy koszyk kupującego, może dołączyć opcję Get Profile Events z Event type = Checkout Started, Limit = 1, Sort order = Newest first, Lookback window = 30 days. Dzięki temu agent nie musi myśleć o tych wyborach — są już wbudowane.
Przykładowy wycinek kodu źródłowego „Jak odpowiadać” (aktualizacja właściwości profilu):
Gdy klient poda preferowany zapach, wywołaj funkcję Update Profile Property, aby zapisać go we właściwościscent_preference, używając jednego z:floral,earthy,citrus,fresh. Pisz tylko wtedy, gdy klient wyraźnie to potwierdzi. Potwierdź zapis klientowi w jednym zdaniu.
Przykładowy fragment kodu „Jak odpowiadać” (Pobierz profil + Pobierz zdarzenia profilu):
Gdy kupujący zapyta o swoje ostatnie zamówienia, wywołaj funkcję Pobierz zdarzenia profilowe, aby pobrać historię zamówień. Podsumuj wyniki podając datę, liczbę produktów i bieżący status. Jeśli kupujący zapyta, kim jest lub co znajduje się w archiwum, użyj funkcji Uzyskaj profil.
(Dołącz Get Profile Events z Event type =Placed Order, Limit =3, Sort order.)
Rejestruj niestandardowe zdarzenia ze skillu
Użyj osobnego narzędzia Send Event, aby przekształcić szczegóły zebrane w rozmowie w zdarzenie na profilu Klaviyo kupującego. Na przykład umiejętność dotycząca gwarancji może rejestrować zdarzenie Warranty Claim Started wraz z produktem i zgłoszonym problemem. Możesz używać metryki i jej właściwości zdarzenia w segmentach, sekwencjach i raportowaniu. Update Profile Property zmienia wartość profilu; Send Event rejestruje aktywność z właściwościami dla danego wystąpienia.
Funkcja Send Event jest w wersji beta i musi być dostępna na twoim koncie. Wymaga uwierzytelnionego klienta oraz istniejącej, aktywnej metryki w Klaviyo. Selektor metryk wyświetla istniejące metryki; nie tworzy nowej. W czacie online samo wpisanie adresu e-mail w wiadomości nie uwierzytelnia kupującego.
Skonfiguruj zdarzenie wysyłania
- Otwórz lub utwórz umiejętność w Customer Agent > Umiejętności. W sekcji Jak odpowiadać wpisz / i wstaw opcję Wyślij zdarzenie w miejscu, w którym zdarzenie powinno zostać zarejestrowane. Powiedz agentowi, jakie szczegóły ma zebrać, zanim uruchomi narzędzie, oraz kiedy nie powinien rejestrować zdarzenia.
- Wybierz wstawione narzędzie, aby otworzyć jego konfigurację. W sekcji Metryka wybierz istniejącą metrykę, względem której będą rejestrowane zdarzenia.
- W sekcji Właściwości zdarzenia wybierz Dodaj właściwość dla każdego szczegółu, który chcesz zapisać. Wpisz nazwę właściwości i wybierz jej źródło. Zachowaj spójność nazw właściwości i formatów wartości z segmentami i sekwencjami, które będą z nich korzystać.
- Agent decyduje — wybierz typ wartości (tekst, liczba lub prawda/fałsz) i dodaj opis wyjaśniający, co agent ma wyodrębnić z rozmowy. Na przykład użyj issue_description jako tekstu i opisz go jako problem zgłoszony przez kupującego.
- Stała wartość — Wpisz Wartość do wysyłania za każdym razem, gdy to narzędzie zostanie uruchomione, na przykład source = Customer Agent.
- Profil klienta — wybierz obsługiwane pole profilu: identyfikator profilu Klaviyo, adres e-mail, numer telefonu, imię lub nazwisko. Ten selektor nie oferuje dowolnych niestandardowych właściwości profilu.
- Kliknij Zapisz na pasku bocznym narzędzia i zapisz wersję roboczą umiejętności. Przejrzyj instrukcje, aby upewnić się, że zdarzenie jest rejestrowane dopiero po uzyskaniu niezbędnych informacji.
Przykład: zarejestruj zgłoszenie gwarancyjne
Wybierz istniejącą metrykę Warranty Claim Started. Dodaj product_name i issue_description, ustawiając jako źródło The agent decides, a jako typ wartości Text. Dodaj source z ustawieniem A fixed value of Customer Agent. W instrukcjach umiejętności powiedz agentowi, aby zebrał informacje o produkcie i problemie, dopytał o brakujące szczegóły, a następnie uruchomił Send Event po tym, jak kupujący potwierdzi prośbę. Samo zarejestrowanie zdarzenia nie tworzy zgłoszenia ani nie wysyła zamiennika; te działania wymagają własnej organizacji pracy.
Przetestuj i zweryfikuj zdarzenie
Przetestuj umiejętność na testowym profilu klienta i sprawdź zarówno przypadki zakończone powodzeniem, jak i przypadki z brakującymi informacjami. Traktuj wywołanie Send Event jak rzeczywisty zapis: zarejestrowane zdarzenia mogą uruchamiać sekwencje. Podczas testowania użyj testowej metryki lub wyklucz testowy profil z działań produkcyjnych.
W Klaviyo przejdź do sekcji Analytics > Metrics i wyszukaj metrykę wybraną w narzędziu. Otwórz jego kanał aktywności albo otwórz dziennik aktywności w profilu testowego kupującego i sprawdź, czy zdarzenie oraz wartości właściwości są poprawne. Wyszukaj nazwę wybranej metryki; zdarzenia niestandardowe niekoniecznie zawierają w nazwie „Customer Agent”. Zweryfikuj zdarzenie, zanim udostępnisz umiejętność na żywo.
Jeśli nie pojawi się żadne zdarzenie, potwierdź, że opcja Send Event jest dostępna na twoim koncie, kupujący jest uwierzytelniony, wybrano prawidłową metrykę, a instrukcje umiejętności docierają do wstawionego narzędzia. Sprawdź wynik narzędzia przed ponowną próbą: każde udane wywołanie rejestruje nowe zdarzenie, więc powtórzenie wywołania może utworzyć duplikaty.
W przypadku wbudowanych zdarzeń, które Customer Agent rejestruje automatycznie, zobacz referencję danych zdarzeń Customer Agent.
Wskazówka
- Przeczytaj, zanim napiszesz. Jeśli personalizujesz odpowiedź, najpierw dołącz załącznik Uzyskaj profil lub Uzyskaj profil zdarzeń. Agent nie może odwoływać się do danych, których nie pobrał.
- Właściwość musi istnieć najpierw i musi być właściwością niestandardową. Aktualizują wyłącznie właściwości profilu firmy, które występują już na profilu Twojej firmy. Pola systemowe (Email, Imię, Numer telefonu, Lokalizacja) i pola pochodne (Created, First aktywni, $id) nie zawierają uprawnień do zapisu. Najpierw utwórz w Klaviyo właściwość niestandardową, a następnie wskaż ją umiejętnością według dokładnej nazwy.
- Ogranicz wartość ustawioną podczas zapisu. Przeliteruj wartości dozwolone w instrukcjach umiejętności („jedna z: kwiatowe, ziemiste, cytrusowe, świeże”). W przeciwnym razie agent przepisze dowolny tekst, a segmenty nie będą zgodne.
- Poinformuj agenta, kiedy ma nie pisać. „Zapisuj tylko wtedy, gdy kupujący wyraźnie potwierdzi” zapobiega przypadkowym nadpisaniu.
- Potwierdź zapisuje do kupującego. Krótki komunikat „Rozumiem, zapisałem to jako Twoje preferencje” zamyka pętlę.
- Dopasuj narzędzie do pytania. „Co udało mi się kupić?” → Zdarzenia profilowe. „Czy jestem VIP-em?” → Listy i segmenty. „Jakie jest prawdopodobieństwo, że wskaźnik zostanie użyty dla wskaźnika?” → Podsumowanie prognozy.
- Użyj Composer, aby to ze sobą połączyć. Opisz, czego chcesz, prostym językiem, a Composer dołączy odpowiednie narzędzia i przygotuje instrukcje umiejętności, które możesz przejrzeć i opublikować. Na przykład: "Chcę, aby moja umiejętność rekomendacji analizowała to, co było w koszyku kupującego, żeby polecić coś podobnego."
- Użyj regionów, zanim rozgałęzisz według kraju. Jeśli cała umiejętność dotyczy tylko niektórych krajów, ustaw regiony dla umiejętności. Użyj Get Profile, gdy jedna umiejętność wymaga niewielkiej różnicy w zależności od kraju.
Czego nie zapewniają te narzędzia
- Nie działają bezpośrednio w anonimowych konwersacjach. Jeśli agent chce wywołać jedno z tych narzędzi, a klient nie został zidentyfikowany, najpierw zostanie poproszony o zalogowanie się. Po ich zidentyfikowaniu narzędzie zostaje uruchomione.
- Aktualizacja właściwości profilu nie powoduje tworzenia nowych kupujących. Profil musi już istnieć.
- Aktualizuj właściwości profilu nie zapisuje zdarzeń. Aby zarejestrować zdarzenie niestandardowe podczas rozmowy z uwierzytelnionym kupującym, użyj osobnego narzędzia Wyślij zdarzenie w umiejętności Customer Agent. Wybierz metrykę, do której chcesz zapisać dane, i skonfiguruj właściwości zdarzenia, używając odpowiedzi modelu, wartości stałych lub danych profilu kupującego.
- Żadne z narzędzi do odczytu nie modyfikuje danych. Tylko się pobierają.
Najczęściej zadawane pytania
Czy za pomocą aktualizacji właściwości profilu mogę wysyłać wiadomości tekstowe do dowolnej właściwości?
Tylko niestandardowe właściwości profilu (te, które definiujesz w profilach, takie jak scent_preference lub isMom). Pola systemowe — Email, First Name, $phone_number, pola podrzędne lokalizacji, takie jak $locale_country, oraz pola list-patch, takie jak Viewed Items — nie są obecnie zapisywalne. Pola pochodne, które system oblicza za Ciebie (Created, First Active, $id), są na stałe tylko do odczytu.
Co się stanie, jeśli właściwość jeszcze nie istnieje?
Narzędzie odczytuje i zapisuje tylko właściwości, które istnieją już w profilu. Najpierw utwórz właściwość w Klaviyo (np. ustaw ją dla profilu testowego lub za pośrednictwem sekwencji), a następnie wskaż właściwość według nazwy.
Czy umiejętność może wywołać wiele narzędzi profilowych w jednej turze?
Tak. Umiejętność może oznaczać dowolną kombinację narzędzi profilowych w jednej odpowiedzi – na przykład Uzyskaj profil i Uzyskaj zdarzenia profilowe razem, aby stworzyć pełniejszy obraz przed udzieleniem odpowiedzi.
Co stanie się z anonimowymi kupującymi?
Jeśli agent spróbuje użyć jednego z tych narzędzi, a osoba kupująca nie zostanie zidentyfikowana, osoba kupująca zostanie poproszona o zalogowanie się. Po zidentyfikowaniu narzędzia uruchamia się, a konwersacja jest kontynuowana.
Czy narzędzia te podlegają tym samym regułom wyrażania zgody co reszta platformy Klaviyo?
Tak. Dane w sekwencji za pośrednictwem standardowego profilu profilu i modelu uzyskiwania zgody Klaviyo.
Kolejne kroki
- Poznaj narzędzia Customer Agent
- Poznajemy umiejętności
- Tworzenie w pełni niestandardowej umiejętności
Powiązane artykuły
Learn more about building and configuring Customer Agent skills.