JavaScript API & API po stronie serwera
JavaScript API
JavaScript API
Poniższy przewodnik przeprowadzi Cię przez proces konfiguracji i korzystania z JavaScript API. Jeśli planujesz pełną integrację e-commerce, zapoznaj się z tym przewodnikiem.
Uwaga
Aby korzystać z poniższych fragmentów Klaviyo, musisz zaktualizować symbol zastępczy API_KEY swoim publicznym kluczem API, który można znaleźć tutaj.
Dodawanie fragmentu kodu Klaviyo
Aby zacząć śledzić ludzi, dodaj poniższy fragment po prawej stronie w głównym szablonie swojej witryny, dzięki czemu zostanie on automatycznie dodany do każdej strony w Twojej witrynie. Jeśli masz programistę, który doda ten skrypt do Twojej witryny, możesz wysłać mu link do tego przewodnika.
Musisz dokonać jednej zmiany we fragmencie. Jeśli prowadzisz działalność e-commerce, usuń cztery linie z identyfikatorem "" . Jeśli jesteś stroną internetową lub aplikacją internetową, do której logują się użytkownicy, zastąp {{ email }} na odpowiedni znacznik szablonu, który zawiera adres e-mail logującego się użytkownika.
Sugerujemy umieszczenie kodu Klaviyo na dole lub w pobliżu szablonu Twojej witryny. Jeśli korzystasz z danych analitycznych Google lub innych usług stron trzecich, możesz umieścić kod Klaviyo bezpośrednio nad lub pod nimi.
Być może zastanawiasz się, "Jak korzystanie z Klaviyo wpływa na wydajność mojej witryny?" Odpowiedź brzmi: Klaviyo w ogóle nie wpływa na wydajność Twojej witryny. Nasz kod ładuje się dopiero po zakończeniu ładowania reszty Twojej witryny. Ponadto, Klaviyo nakazuje przeglądarkom buforowanie naszego JavaScriptu, więc Twoi odwiedzający często nie muszą nawet pobierać naszego JavaScriptu przy każdym przełączaniu stron.
Sprawdź swój skrypt
Po dodaniu skryptu JavaScript do witryny możesz sprawdzić, czy jest on poprawnie skonfigurowany, wprowadzając adres URL witryny po prawej stronie.
Gdy skrypt znajdzie się na Twojej stronie, Klaviyo rozpocznie śledzenie odwiedzin i sesji w Twojej witrynie w czasie rzeczywistym.
Podstawy API
Aby wywołać Klaviyo API i sklep z informacjami o ludziach, użyjesz obiektu _learnq, który jest automatycznie dodawany przez skrypt Klaviyo.
Aby wykonać wywołanie API, Klaviyo używa specjalnej składni, która pozwala Twoim wywołaniom API działać nawet wtedy, gdy nasz skrypt nie został jeszcze załadowany na stronie. Utworzysz tablicę, w której pierwsza wartość to nazwa metody, którą chcesz wywołać, a wszystkie kolejne wartości to argumenty, które należy przekazać do tej metody.
Identyfikacja osóbIdentyfikacja osób
Metoda identify pozwala na identyfikację i ustawienie właściwości danej osoby. Ta metoda akceptuje słownik lub skrót właściwości. Kiedy kogoś identyfikujesz, musisz podać albo jego adres e-mail, z kluczem $e-mail, albo unikalny identyfikator, taki jak identyfikator użytkownika, z kluczem $id.
Po uwzględnieniu co najmniej jednego z tych identyfikatorów możesz dodać dowolne niestandardowe właściwości. Właściwości niestandardowe są przydatne do śledzenia faktów dotyczących osób. W witrynie Klaviyo możesz następnie utworzyć segment osób na podstawie tych właściwości. Na przykład, możesz chcieć śledzić typ plan danej osoby lub datę Zarejestruj się. Klaviyo zrozumie również różne typy danych, których używasz, więc nie krępuj się używać liczb, wartości logicznych i dat.
Klaviyo ma kilka specjalnych właściwości, które są używane do wyświetlania informacji o ludziach. Są to: $first_name, $last_name, $phone_number, $title i $organization.
Oprócz właściwości, które śledzisz, Klaviyo automatycznie określi, z jakiej witryny każda osoba została najpierw skierowana do śledzenia atrybucji oraz lokalizację osoby na podstawie miejsca, w którym uzyskuje dostęp do Twojej witryny.
Przykładowy kod:
śledzenie wydarzeń i akcji
Metoda śledzenia umożliwia rejestrowanie zdarzeń i działań podejmowanych przez użytkowników w Twojej witrynie. Ta metoda akceptuje ciąg znaków, który jest nazwą, jaką nadasz temu zdarzeniu. Metoda ta akceptuje również opcjonalny słownik lub hash właściwości powiązanych z tym zdarzeniem.
Na przykład możesz śledzić, kiedy ktoś kupuje przedmiot i dołączać informacje o cenie zakupu oraz o tym, jakie przedmioty kupił. Jeśli masz aplikację, w której ludzie mają profil, możesz śledzić, kiedy ktoś wypełnia swój profil. Jeśli planujesz pełną integrację e-commerce, zapoznaj się z tym przewodnikiem.
KlaviyoŚledzenie zdarzeń i dane analityczne są bardzo elastyczne, dzięki czemu możesz dostosować je do śledzenia tego, co jest ważne dla Twojej firmy. Nasza metoda śledzenia rozumie również różne typy danych, więc możesz używać liczb, wartości logicznych i dat, a my stworzymy inteligentne wykresy na podstawie wysłanych przez Ciebie danych.
Przykładowy kod: