Poznaj różne webhooki dostępne w Klaviyo
Czego się dowiesz?
Poznaj różnice między rozwiązaniami webhook dostępnymi w Klaviyo i dowiedz się, kiedy używać każdego z nich.
Kilka słów na początek
Aby korzystać z webhooków w Zaawansowanej platformie danych klientów Klaviyo lub w Code, Twoje konto musi mieć dostęp do Zaawansowanej platformy danych klientów Klaviyo. Zaawansowana platforma danych klientów Klaviyo jest oddzielna od standardowej aplikacji marketingowej Klaviyo. Zobacz nasz przewodnik rozliczeń, aby dowiedzieć się, jak dodać ten plan.
Czym są webhooki?
Webhooki umożliwiają Klaviyo przekazywanie informacji lub „wywoływanie” innych aplikacji, narzędzi i serwerów za pośrednictwem żądań HTTP. Mogą wysyłać informacje o zdarzeniu, które miało miejsce (np. złożeniu zamówienia, subskrybowaniu przez nowego klienta itp.), lub powiadamiać Twoje systemy zewnętrzne o tym, że zdarzenie wystąpiło.
Webhook składa się z kilku kluczowych elementów:
- Temat
Zdarzenie, które powoduje uruchomienie webhooka. - Treść (lub „ładunek”)
Dane wysyłane przez webhook. - Nagłówki
Miejsce do przekazania dodatkowych informacji (takich jak uwierzytelnianie). - Docelowy adres URL
Punkt końcowy, który odbiera żądanie webhook.
Webhooki sekwencji
Możesz dodać webhooki w sekwencjach jako działanie. Gdy profil osiągnie skonfigurowane działanie webhooka ustawione na Live, Klaviyo wysyła żądanie POST na docelowy URL wraz z danymi, które uwzględnisz w ładunku. Może to obejmować szczegóły profilu oraz w sekwencji wyzwalanej metryką — dane ze zdarzenia, które uruchomiło sekwencję.
Możesz dodać webhooki sekwencji do sekwencji wyzwalanych przez metrykę, listę, segment lub właściwość daty. Zdarzenia związane z wiadomościami, takie jak Otrzymano e-mail, Kliknięto e-mail lub Oznaczono e-mail jako spam, nie mogą być używane jako wyzwalacze sekwencji.
Wycofanie subskrypcji marketingu e-mailowego może wyzwolić sekwencję i jej działanie webhook. To zdarzenie rejestruje utratę zgody na marketing e-mailowy i jest oddzielne od kliknięcia łącza do wycofania subskrypcji w e-mailu.
Przykładowe przypadki użycia webhooków sekwencji
Oto kilka przykładowych zastosowań, w których webhooki sekwencji będą najskuteczniejsze:
- Wyślij wiadomość lub żądanie POST, które uruchamia się na podstawie dodania subskrybenta do segmentu lub listy.
- Zautomatyzuj ograniczenia, gdy profil wejdzie do segmentu niezaangażowanych.
- Wyślij spersonalizowaną wiadomość z podziękowaniem przez usługę taką jak WhatsApp lub Facebook Messenger, gdy klienci dokonają zakupu.
Webhooki w Zaawansowanej platformie danych klientów Klaviyo
Aby korzystać z tych webhooków, potrzebujesz dostępu do Zaawansowanej platformy danych klientów Klaviyo. Zobacz nasz przewodnik po rozliczaniu, aby dowiedzieć się, jak dodać ten plan lub zacząć korzystać jako nowy klient.
webhook w Zaawansowanej platformie danych klientów Klaviyo powiadamiają zewnętrzne systemy w odpowiedzi na zdarzenia, niezależnie od kroków sekwencji. Klaviyo tworzy treść żądania za Ciebie. Użyj tych webhooków, gdy chcesz wysłać wstępnie zbudowany ładunek zdarzenia do zewnętrznego systemu. Ten system musi mieć punkt końcowy, który może odbierać i przetwarzać żądania.
Webhooki Zaawansowanej platformy danych klientów Klaviyo obsługują szerszy zakres tematów niż webhooki sekwencji, w tym zdarzenia związane z wiadomościami dostępne przez Get Events API. Wybierz pojedyncze metryki jako tematy podczas konfigurowania webhooka.
Przykłady:
- Zdarzenia e-mail (np. Otrzymano e-mail, Kliknięto e-mail, Oznaczono e-mail jako spam)
- Zdarzenia SMS (np. Wysłano SMS, Otrzymano SMS)
- Zdarzenia powiadomień push (np. Otrzymano powiadomienie push, Odbite powiadomienie push)
- Zdarzenia z integracji (tzn. zdarzenia z integracji własnych utworzonych przez Klaviyo)
- Zdarzenia API (np. zdarzenia zsynchronizowane za pomocą API Klaviyo)
Obejmuje to zdarzenia związane z wiadomościami, takie jak starsze zdarzenie Wycofać subskrypcję (kliknięcie łącza do wycofania subskrypcji w wiadomości e-mail), Otrzymano wiadomość e-mail lub Kliknięto wiadomość e-mail, których nie można używać jako wyzwalaczy sekwencji. Wycofać subskrypcję marketingu e-mailowego to osobne zdarzenie, które może uruchomić sekwencję.
Dodatkowo webhooki Zaawansowanej platformy danych klientów Klaviyo pozwalają subskrybować wiele wyzwalaczy naraz, w przeciwieństwie do webhooków sekwencji, które zależą od sekwencji z pojedynczym wyzwalaczem.
Docelowe adresy URL dla webhooków Zaawansowanej platformy danych klientów Klaviyo muszą być publicznie dostępne punktami końcowymi HTTPS, które mogą odbierać żądania webhook od Klaviyo.
Przykładowe przypadki użycia webhooków Zaawansowanej platformy danych klientów Klaviyo
- Synchronizuj zdarzenia wycofania subskrypcji z marketingu e-mailowego klientów z systemami zewnętrznymi.
- Raportuj zdarzenia Received Email do oprogramowania help desk, aby agenci mogli zobaczyć historię e-maili i lepiej obsługiwać klientów.
- Synchronizuj wszystkie wysyłki, otwarcia i kliknięcia e-maili do hurtowni danych, która nie jest obsługiwana przez synchronizację z hurtownią danych w Klaviyo.
Kod
Kod jest zawarty w Zaawansowanej platformie danych klientów Klaviyo. Twoje konto potrzebuje dostępu do Zaawansowanej platformy danych klientów Klaviyo, aby korzystać z tych funkcji wyzwalanych zdarzeniami. Zobacz nasz przewodnik po rozliczaniu, aby dowiedzieć się, jak dodać ten plan lub zacząć korzystać z Klaviyo jako nowy klient.
Code używa webhooków do uruchamiania niestandardowych funkcji w odpowiedzi na wyzwalacz zdarzenia. Możesz pisać w języku Python lub JavaScript bezpośrednio w edytorze Klaviyo, a Klaviyo zarządza wykonywaniem kodu, monitorowaniem i rejestrowaniem zdarzeń.
Użyj kodu, gdy masz zasoby deweloperskie, aby pisać niestandardowe funkcje uruchamiane w odpowiedzi na zdarzenia. Klaviyo hostuje funkcje, więc nie musisz hostować własnego punktu końcowego, aby odbierać wyzwalający webhook. Aby wysyłać dane do innego systemu, twój kod musi łączyć się z API lub usługą tego systemu.
Zarówno Code, jak i webhooki Zaawansowanej platformy danych klientów Klaviyo pozwalają wybierać poszczególne metryki jako wyzwalacze.
Pamiętaj, że Code nie obsługuje następujących zdarzeń jako tematów:
- Otwarto e-mail
- Otrzymany e-mail
Przypadki użycia przykładowego kodu
- Użyj bibliotek Pythona do odczytu danych zdarzeń i wyodrębnienia wartości, takich jak miasto rezerwacji, aby wykorzystać je w logice niestandardowej.
- Ustaw niestandardowe właściwości profilu na podstawie metadanych zdarzeń za pomocą API Klaviyo.
- Wywołaj usługę AI, aby utworzyć niestandardową wiadomość dla każdego porzuconego koszyka zakupowego na podstawie profilu i produktów w koszyku.
Dodatkowe źródła
- Jak działają webhooki w sekwencjach
Dowiedz się więcej o webhookach w sekwencjach i o tym, jak wysyłają informacje z Klaviyo do narzędzi i aplikacji innych firm. Warto pamiętać, że konfigurowanie webhooków może być złożone. Zaleca się posiadanie wiedzy deweloperskiej lub zasobów deweloperskich, aby prawidłowo ukończyć tę konfigurację. Jeśli szukasz tych wskazówek dla programistów, dowiedz się, jak dodać działanie webhooka do sekwencji.
- Poznaj webhooki w Zaawansowanej platformie danych klientów Klaviyo
Dowiedz się więcej o webhook, oraz jak możesz ich używać do wysyłania informacji do aplikacji innych firm w odpowiedzi na zdarzenia zarejestrowane w Klaviyo. Aby uzyskać bardziej szczegółowe informacje o tym, jak odbierać systemowe webhook, przejdź do zasobów dla deweloperów dotyczących pracy z systemowymi webhook.
- Pierwsze kroki z Code
Dowiedz się więcej o Code i o tym, jak tworzyć niestandardowe funkcje wykonywane bezpośrednio przez Klaviyo.