Pierwsze kroki z SQL w Composer i serwerze MCP Klaviyo
Czego się dowiesz?
Dowiedz się, jak zadawać pytania analityczne o Twoje dane w Klaviyo prostym językiem, używając Composer lub serwera Klaviyo Model Context Protocol (MCP). SQL Platformy danych Klaviyo łączy profile, grupy odbiorców, kampanie, produkty i zdarzenia, aby odpowiadać na pytania obejmujące wiele zestawów danych. Nie musisz pisać SQL.
SQL jest obecnie w wersji beta i jest dostępny dla wszystkich klientów.
Kilka słów na początek
Wybierz, gdzie chcesz zadać swoje pytania:
- Użyj Composer, aby pracować na czacie w Klaviyo. Nie ma potrzeby dodatkowej konfiguracji SQL.
- Użyj serwera Klaviyo MCP, aby pracować w połączonym kliencie AI, takim jak Claude lub ChatGPT. Jeśli masz już połączone Klaviyo, nie musisz instalować kolejnego narzędzia, choć może być konieczne odświeżenie listy narzędzi klienta.
Obie opcje korzystają z tych samych danych i obsługują te same rodzaje pytań analitycznych. SQL jest zaprojektowany do analizy. W przypadku zbiorczego eksportu danych użyj innych narzędzi Klaviyo, takich jak raporty niestandardowe.
Dane są zwykle opóźnione o około 30 minut w porównaniu z aktywnością na Twoim koncie. W przypadku bardzo niedawnego zamówienia, wysyłki lub zmiany członkostwa sprawdź to bezpośrednio w Klaviyo.
Zadaj swoje pierwsze pytanie dotyczące analityki
Korzystaj z Composer
- Otwórz Composer w Klaviyo. Jeśli potrzebujesz pomocy w znalezieniu go, zobacz Pierwsze kroki z Composerem.
- Zadaj pytanie analityczne prostym językiem. Uwzględnij metrykę, zakres dat oraz wszelkie szczegóły dotyczące grupy odbiorców lub produktu. Na przykład: „Jakie jest moje pięć najlepszych produktów według liczby sprzedanych sztuk w ciągu ostatnich 90 dni?”
- Przejrzyj odpowiedź, a potem zadaj dodatkowe pytania w tej samej rozmowie, żeby lepiej ją zgłębić.
Composer decyduje, kiedy użyć SQL. Nie musisz nazywać narzędzia ani zmieniać ustawienia.
Użyj serwera MCP Klaviyo
Aby połączyć klienta AI, potrzebujesz roli właściciela, administratora lub zarządcy w koncie Klaviyo, którego chcesz użyć. Gdy Twoje połączenie korzysta z klucza API, klucz musi mieć dostęp do zestawów danych związanych z Twoim pytaniem. Na przykład pytanie o zamówienia i segmenty wymaga dostępu do zdarzeń i segmentów.
- Połącz Klaviyo, korzystając z przewodnika dla swojego klienta lub konfiguracji:
- Dokumentacja dla deweloperów serwera MCP Klaviyo dotycząca połączeń z terminalem i serwerem zdalnym
- FAQ aplikacji Klaviyo dla Claude
- Jak korzystać z aplikacji Klaviyo dla ChatGPT
- Przewodnik po serwerze MCP Klaviyo dla agencji do pracy w różnych kontach klientów
- Zadaj szczegółowe pytanie analityczne w połączonym kliencie. Nie musisz podawać nazwy narzędzia ask_analytics_question. Twój klient wybiera je, gdy jest to odpowiednie dla danego pytania.
- Przejrzyj odpowiedź i kontynuuj, zadając kolejne pytania. Jeśli narzędzie nie jest dostępne, odśwież listę narzędzi Klaviyo u klienta, korzystając z poniższych kroków rozwiązywania problemów.
Jeśli łączysz się przez OAuth, postępuj zgodnie z przewodnikiem klienta, aby przejrzeć i przyznać wymagane uprawnienia.
Rozwiń odpowiedź i sprawdź obliczenie
SQL jest przydatny, gdy odpowiedź na pytanie wymaga informacji z wielu zbiorów danych. Na przykład liczba zamówień staje się bardziej szczegółową analizą odbiorców, gdy dodasz dane o klientach, członkostwie w segmentach i kraju.
Zacznij od pytania, a potem rozwiń odpowiedź w tej samej rozmowie:
- „Ile zamówień zrealizowaliśmy w zeszłym miesiącu?”
- „Ilu klientów złożyło te zamówienia”?
- „Podziel te zamówienia według segmentów, do których klienci obecnie należą.”
- „Podziel wyniki według segmentu i kraju oraz uwzględnij przychód dla każdej grupy.”
- „W przypadku kupujących po raz pierwszy, ile przeglądania produktów miało miejsce w ciągu 10 dni przed ich pierwszym zamówieniem?”
Zanim udostępnisz ważną liczbę lub wykorzystasz ją do podjęcia decyzji, zapytaj, jak obliczono odpowiedź. Na przykład:
- „Których zestawów danych użyłeś?”
- „Jaki zakres dat i filtry zastosowałeś(-aś)?”
- „Jak zdefiniowałeś(-aś) przychód w tych obliczeniach”?
- „Przeprowadź mnie przez to, jak to obliczyłeś.”
Skorzystaj z wyjaśnienia, aby sprawdzić, czy odpowiedź pasuje do pytania, które chcesz zadać. Jeśli nie, doprecyzuj metrykę, daty lub filtry i zapytaj ponownie.
O jakie dane możesz zapytać
SQL może odpowiadać na pytania dotyczące tych zestawów danych, w zależności od uprawnień na Twoim połączeniu.
Zestaw danych | Co możesz analizować |
|---|---|
Profile | Atrybuty klienta, identyfikatory, przewidywana wartość życiowa, zaangażowanie w kanał, niestandardowe właściwości profilu oraz zgody marketingowe na e-mail i SMS |
Segmenty | Dynamiczne grupy odbiorców z przeliczanym członkostwem na podstawie zapisanych warunków; analiza wykorzystuje bieżące członkostwo |
Listy | Odbiorcy, których bieżące członkostwo możesz połączyć z profilami i zdarzeniami |
Kampanie | Jednorazowe wysyłki, wiadomości, warianty, w tym testy A/B, oraz segmenty wysyłki |
Katalog | Produkty zsynchronizowane z Twojej platformy e-commerce, w tym kategorie produktów i warianty |
Zdarzenia | Aktywność związana z handlem, wiadomościami, zgodami, sekwencją, recenzjami, kuponami, pomocą techniczną, Klaviyo Customer Hub i integracjami oraz liczby i wskaźniki marketingowe |
Zdarzenia i szczegóły w zdarzeniach
Dostępne dane zdarzeń obejmują:
- Aktywność związana z handlem, taka jak dodawanie produktów do koszyka, składanie lub anulowanie zamówień, zwroty środków oraz wyświetlenia produktów
- Aktywność e-mail, w tym dostarczenia, otwarcia, kliknięcia, odbicia, odrzucenia i wycofania subskrypcji
- Aktywność w SMS i WhatsApp, w tym otrzymania, kliknięcia, niepowodzenia, zgody i wycofania subskrypcji
- Aktywność push, w tym otrzymania, otwarcia i odbicia
- Zmiany zgody i ograniczeń, w tym subskrypcje, wycofania subskrypcji, dodanie lub usunięcie ograniczeń oraz aktualizacje preferencji
- Aktywność sekwencji, w tym dodania, usunięcia, realizację, pominięcia i uruchomienia
- Scalanie profili
- Przesyłanie opinii i ocen, edycje, usuwanie oraz gotowość do weryfikacji
- Przypisania i wykorzystania kuponów
- Aktywność rozmów z pomocą techniczną, w tym rozpoczęcia, odebrane lub wysłane wiadomości, eskalacje, rozwiązania oraz utworzenie lub zamknięcie zgłoszenia
- Aktywność w Klaviyo Customer Hub, taka jak logowania, ulubione, kliknięcia produktów lub kuponów oraz wyświetlenia bloków treści
- Zdarzenia integracji ze źródeł takich jak twoje API, Shopify i Lightspeed, w tym aktywność związana z realizacją zakupu, przesłania formularzy, rejestracje w programie lojalnościowym, wyszukiwania i wysyłki
- Metryki marketingowe, w tym liczby i wskaźniki dotyczące dostarczenia, odbiorców, otwarć, kliknięć, odbić, wycofania subskrypcji, zgłoszeń spamu oraz zaangażowania użytkowników
Niektóre zdarzenia zawierają zagnieżdżone wartości: grupy powiązanych szczegółów w ramach zdarzenia. Na przykład zamówienie może zawierać listę produktów, a każdy z nich — SKU, ilość i cenę. SQL potrafi odczytać te szczegóły, więc możesz zapytać, ile zamówień obejmowało konkretny SKU albo jaka była średnia liczba produktów na zamówienie.
Połącz zestawy danych
SQL może łączyć powiązane zbiory danych, aby odpowiedzieć na pytanie. Nazywa się to join, ale nie musisz wyraźnie prosić o join. Na przykład możesz:
- Połącz wiadomości kampanii z nazwami kampanii i danymi o zaangażowaniu, aby porównywać nazwane kampanie.
- Połącz bieżące członkostwo na liście lub w segmencie z profilami i zamówieniami, aby analizować aktywność zakupową odbiorców.
- Podziel odbiorców według kraju, statusu zgody lub przewidywanej wartości klienta.
- Połącz produkty z kategoriami lub warianty z produktami nadrzędnymi, aby analizować wyniki produktu lub kategorii.
- Połącz przypisania kuponów z użyciami kuponów, aby obliczyć liczbę realizacji i zidentyfikować niewykorzystane kupony.
Przykładowe pytania
Dostosuj daty, produkty, segmenty i szczegóły kampanii do Twojego konta.
Cel | Przykładowe pytanie |
|---|---|
Porównaj zamówienia w czasie | „Ile zamówień zrealizowaliśmy w Q2 2025, Q1 2026 i Q2 2026?” |
Przeanalizuj szczegóły zamówienia | „Ile zamówień z ostatnich 90 dni zawierało SKU FACEBUND01?” |
Podsumuj przychody i zwroty | „Podsumuj zamówienia z czerwca: łączna liczba zamówień, łączne przychody, liczba zwróconych zamówień oraz łączna kwota zwrotów”. |
Zrozum powtórne zakupy | „Jaki odsetek klientów złożył tylko 1 zamówienie?” |
Mierz czas między zakupami | „Jaka jest średnia liczba dni między pierwszym a drugim zakupem klienta?” |
Porównaj wartość klienta | „Porównaj wartość życiową klientów zaangażowanych w e-maile z klientami, którzy się nie angażują”. |
Znajdź najpopularniejsze produkty | „Jakie jest moich pięć najlepszych produktów pod względem liczby sprzedanych sztuk w ciągu ostatnich 90 dni?” |
Porównaj zaangażowanie kampanii | „Który dzień tygodnia ma najlepsze wskaźniki wyświetleń wiadomości w kampaniach?” |
Sprawdź skuteczność e-maili | „Które 10 moich e-maili miało najwięcej otwarć, z wyłączeniem kampanii wyprzedażowych?” |
Analizuj urządzenia | „Jaki jest podział otwarć moich e-maili na urządzeniach mobilnych i komputerach stacjonarnych?” |
Przejrzyj aktywność sekwencji | „Jakie sekwencje wysłały wiadomości w ciągu ostatniego roku?” |
Porównaj skuteczność SMS | „Jaki był mój wskaźnik kliknięć i wskaźnik wycofywania subskrypcji dla SMS w kwietniu, maju i czerwcu?” |
Sprawdź odbicia | „Mój newsletter z 2 lipca miał 5 514 odbić. Czy pochodziły od jednego dostawcy poczty elektronicznej? Jakie były typy odbić?” |
Sprawdź częstotliwość wysyłania | „Ile profili otrzymało dwa lub więcej e-maili w ciągu jednego dnia?” |
Poznaj limity
Dane niedostępne
SQL obecnie nie obsługuje:
- Członkostwo na liście lub w segmencie w określonym momencie w przeszłości
- Formularze rejestracyjne lub ich skuteczność
- Obiekty niestandardowe
- Szablony e-maili lub SMS
Zdarzenia integracji mogą obejmować przesłania formularzy, ale to nie znaczy, że SQL obsługuje analizę formularzy rejestracyjnych ani ich skuteczności. Jeśli Twoje pytanie zależy od niedostępnych danych, odpowiedź może być niepełna lub klient może nie być w stanie odpowiedzieć.
Aktualność danych i różnice względem raportów Klaviyo
Dane są zazwyczaj opóźnione o około 30 minut względem Twojego konta. Ostatnia aktywność może nie pojawić się od razu.
Liczby powinny być na ogół spójne z Klaviyo, ale mogą występować niewielkie różnice ze względu na różnice w definicjach, optymalizacje zapytań lub aktualność danych. SQL korzysta z innego źródła danych niż inne sposoby uzyskiwania dostępu do danych Klaviyo. Klaviyo sprawdziło te dane i potwierdziło, że są one spójne w 99% w ciągu ostatnich 3 lat.
Gdy liczba różni się od tej w raporcie, poproś o informacje o sposobie obliczeń, zakresie dat i filtrach. To wyjaśnienie może pomóc Ci ustalić, czy porównujesz tę samą metrykę i ten sam okres.
Wygenerowane zapytania i limity czasu
SQL generuje zapytanie na podstawie Twojego pytania. Obecnie nie ma punktu końcowego, w którym możesz przesłać własne zapytanie SQL i otrzymać gwarantowany, powtarzalny wynik. Inne sformułowanie może skutkować innymi zapytaniami i nieco innymi wynikami. Sprawdź obliczenia dla ważnych liczb.
Klient MCP może przestać czekać na odpowiedź wcześniej niż Composer. Claude ma na przykład 60-sekundowe okno limitu czasu. Jeśli upłynie limit czasu na pytanie, zawęź zakres dat, zmniejsz liczbę podziałów lub podziel analizę na mniejsze pytania.
Rozwiązywanie problemów
Narzędzie analityczne nie jest dostępne
Jeśli nie widzisz ask_analytics_question w swoim kliencie AI, upewnij się, że SQL jest włączony dla Twojego konta, i odśwież listę narzędzi Klaviyo w kliencie.
W Claude:
- Przejdź do Dostosuj > Konektory > Klaviyo.
- Otwórz menu z trzema kropkami w prawym górnym rogu.
- Kliknij Odśwież listę narzędzi, a potem spróbuj zadać pytanie ponownie.
SQL nie może zwrócić danych, o których wiesz, że znajdują się na Twoim koncie
Sprawdź, czy zestaw danych jest obsługiwany, i uwzględnij typowe 30-minutowe opóźnienie. Jeśli twoje połączenie używa klucza API, sprawdź, czy ma dostęp do każdego zestawu danych, którego to dotyczy, np. profili, segmentów, list, kampanii, katalogów lub zdarzeń. Zaktualizuj brakujące uprawnienia w Klaviyo, odśwież listę narzędzi Klaviyo klienta i ponów próbę zadania pytania.
W przypadku połączenia OAuth zapoznaj się z uprawnieniami w przewodniku połączenia klienta.
Upłynął limit czasu na odpowiedź na pytanie
Wypróbuj krótszy zakres dat lub mniej podziałów albo podziel pytanie na mniejsze pytania. Ponów próbę z węższym pytaniem, a potem rozwijaj wynik za pomocą pytań uzupełniających.
Numer nie pasuje do Klaviyo
Zapytaj, jak SQL wyliczył tę liczbę, w tym jakich zestawów danych użył, jaki był zakres dat i jakie zastosowano filtry. Sprawdź, czy definicje metryk i świeżość danych wyjaśniają tę różnicę. Jeśli różnica jest duża, skontaktuj się z pomocą techniczną Klaviyo i podaj pytanie, zwróconą liczbę oraz liczbę, której się spodziewałeś.
Composer odrzuca pytanie
Sparafrazuj pytanie, podając konkretną metrykę, zakres dat i grupę odbiorców. Sprawdź, czy korzysta z jednego z obsługiwanych zestawów danych, a potem spróbuj ponownie.