Jak spersonalizować treści w witrynie za pomocą interfejsu API członkostwa w grupie Klaviyo?

Czego się dowiesz

Dowiedz się, jak używać metody Klaviyo JavaScript obiektu getGroupMembership, której można użyć do wdrożenia personalizacji w witrynie. Wymaga to załadowania obiektu Klaviyo i przekazanie tablicy listy lub segmentu do sprawdzenia, co zwróci dane wyjściowe, które możesz wykorzystać do personalizacji na miejscu.

Zanim zaczniesz

Po dodaniu śledzenia na stronie Klaviyo do Twojej witryny, śledzona jest tylko aktywność przeglądania "znanych przeglądarek" (tj. przeglądarek, które odwiedziły, zaangażowały się i zostały zidentyfikowane lub "cookied"). KlaviyoStrona śledzenie nie śledzi anonimowych przeglądarek. Istnieją 3 kluczowe sposoby, w jakie Klaviyo zidentyfikuje odwiedzającego witrynę w celu śledzenia na miejscu:

• Jeśli ktoś kliknął link w wiadomości e-mail Klaviyo, aby przejść do Państwa witryny internetowej
• Jeśli ktoś zapisał się za pomocą formularza Klaviyo
• Jeśli ktoś zalogował się do Państwa witryny, a Państwo mają zainstalowane narzędzie do śledzenia

Zobacz nasz film Klaviyo na temat korzystania z interfejsu API członkostwa w grupie.

Zainstaluj Klaviyo.js i załaduj obiekt Klaviyo

Najpierw należy zainstalować Klaviyo.js, jeśli jeszcze tego nie zrobiono. Klaviyo.js, znany również jako Klaviyo’s Active on Site JavaScript, automatycznie obsługuje obiekt klaviyo. Jeśli włączyli Państwo integrację z kontem Klaviyo lub ręcznie zainstalowali Klaviyo.js, będą Państwo mogli zainicjować obiekt klaviyo, aby nasłuchiwał odpowiednich wywołań.

Aby użyć obiektu Klaviyo natychmiast po załadowaniu strony, zalecamy ręczne zainstalowanie poniższego fragmentu na swojej stronie (oprócz instalacji Klaviyo.js, jak wspomniano powyżej). Obiekt Klaviyo musi zostać załadowany tylko raz na stronę.

Aby załadować Klaviyo obiekt:

Aby użyć metody Klaviyo metody getGroupMembership obiektu JavaScript do personalizacji w witrynie:

1. W kodzie wybierz listę lub segment ID, dla których chcesz sprawdzić członkostwo. Limit wynosi 50 list lub segmentów.
2. Zidentyfikuj użytkowników w swojej witrynie za pomocą formularza Klaviyo lub w inny sposób.
3. Wykonaj wywołanie w następującym formacie, z tablicą identyfikatorów listy lub segment, dla których chcesz sprawdzić członkostwo:

Klaviyo.getGroupMembership(['listID1', 'listID2', 'listID3'])

Dostarczone dane wyjściowe będą tablicą identyfikatorów lista/segment, do których należy zidentyfikowany użytkownik, biorąc pod uwagę, że identyfikatory te znajdowały się w tablicy wejściowej. Jeśli zwrócona zostanie pusta tablica, oznacza to, że przekazałeś zbyt wiele identyfikatorów lub że użytkownik nie należy do żadnej z podanych list lub segmentów.

Możesz użyć zwróconych danych segment i listy członków, aby dostosować swoją witrynę do odpowiednich produktów, treści i nie tylko w oparciu o segment klientów z Klaviyo.

Przykład kodu

Oto przykład pokazujący, jak wywołać interfejs API getGroupMembership z wieloma identyfikatorami segmentów.

const customerSegments = await Klaviyo.getGroupMembership([
  VIPSegmentID,
 UnEngagedSegmentID,
 DogLoversSegmentID
]);

Wpływ na wydajność witryny

Interfejs API członkostwa w grupie ma minimalny wpływ na wydajność Twojej witryny. Plik Javascript (tj. web_personalization.js) ładowany przez Klaviyo w Twojej witrynie ma tylko około 1,2 KB, a żądanie wiązki dla tego pliku nie blokuje głównego wątku, więc nie wpływa na użyteczność żadnych stron.

Dane, które są ładowane w celu dostosowania witryny na podstawie profilu klienta, są buforowane w przeglądarce po pierwszym żądaniu, więc dodatkowe żądania nie wymagają wywołań zaplecza API.

Rezultat

Możesz teraz używać obiektu Klaviyo JavaScript z narzędziami do personalizacji stron internetowych oraz do personalizacji treści w witrynie na podstawie segment lub członkostwa na liście.

Dodatkowe źródła

Wprowadzenie do obiektu Klaviyo

Klaviyomodel Dane

Słowniczek popularnych terminów API

Użyj interfejsu API członkostwa w grupie Klaviyo