Identyfikowanie użytkowników

Shayan TaslimZaktualizowano

Domyślnie widżet traktuje odwiedzających jako anonimowych. Wywołaj uj.identify, aby powiązać opinie, głosy, komentarze, powiadomienia i rozmowy z kontem klienta.

Podstawowa identyfikacja

JavaScript
uj.identify({
  user: {
    id: 'user-123',
    email: 'ada@example.com',
    firstName: 'Ada',
    lastName: 'Lovelace',
    avatar: 'https://example.com/avatar.jpg'
  }
});

user.id jest wymagane. Użyj stabilnego identyfikatora z bazy danych zamiast adresu e-mail lub nazwy wyświetlanej, które mogą się zmienić. email jest opcjonalne, ale zdecydowanie zalecane, aby UserJot mógł dopasować użytkownika w różnych tablicach, wiadomościach przekazywanych e-mailem i rozmowach. Przekazanie email powoduje powiązanie wyłącznie z istniejącym kontem UserJot, którego adres e-mail został potwierdzony.

Kiedy wywołać identify

Wywołaj uj.identify, gdy aplikacja rozpozna zalogowanego użytkownika. Ponowne wywołanie z dokładnie tym samym zestawem danych, gdy sesja jest nadal aktywna, nie powoduje żadnych zmian. Po wygaśnięciu sesji lub zmianie dowolnego pola (w tym adresu e-mail lub cech) SDK wysyła nowe żądanie. Przekazanie innego użytkownika natychmiast przełącza sesję.

Gdy użytkownik wyloguje się z aplikacji, wywołaj uj.logout():

JavaScript
if (user) {
  uj.identify({
    user: {
      id: user.id,
      email: user.email,
      firstName: user.firstName,
      lastName: user.lastName
    }
  });
} else {
  uj.logout();
}

Dodawanie cech

Cechy to niestandardowe atrybuty przypisane do profilu użytkownika, widoczne obok jego zgłoszeń i rozmów w panelu.

JavaScript
uj.identify({
  user: {
    id: 'user-123',
    email: 'ada@example.com',
    traits: {
      plan: 'pro',
      seats: 12,
      trialing: false
    }
  }
});

Wartości cech mogą być ciągami znaków, liczbami, wartościami logicznymi lub null (monthlySpend, jeśli jest przesyłany, musi być liczbą nieujemną). Zarezerwowane klucze (takie jak id, email, role lub companies) są ignorowane, a informacja o nich jest zwracana w result.warnings. Pełną listę znajdziesz w dokumentacji SDK.

Dodawanie firm

W przypadku produktów B2B przypisz użytkownikowi co najmniej jedną firmę:

JavaScript
uj.identify({
  user: { id: 'user-123', email: 'ada@example.com' },
  companies: [
    {
      id: 'acme',
      name: 'ACME Inc.',
      domain: 'acme.com',
      logo: 'https://acme.com/logo.png',
      traits: { plan: 'enterprise', arr: 24000 }
    }
  ]
});

id jest wymagane dla każdej firmy. name, domain, logo (adres URL HTTPS) i traits są opcjonalne. Jeśli włączono opcję Wymagaj podpisanych tokenów w Ustawieniach → Logowanie, firmy przekazane poza podpisanym JWT są ignorowane i wyświetlane jest ostrzeżenie UNSIGNED_COMPANY_IGNORED.

Co zwraca identify

Po załadowaniu skryptu SDK uj.identify zwraca obietnicę:

JavaScript
const result = await uj.identify({
  user: { id: 'user-123', email: 'ada@example.com' }
});

result.viewer;        // the identified user, or null
result.identityTrust; // 'signed' or 'unsigned'
result.warnings;      // fields the server ignored or adjusted

Limity żądań i błędy

  • Limit szybkości i ograniczanie liczby ponowień po stronie klienta: Liczba żądań identyfikacji jest ograniczona do 30 na minutę i 300 na godzinę dla każdego adresu IP i obszaru roboczego. Przekroczenie limitu godzinowego powoduje blokadę na 1 godzinę. Po otrzymaniu HTTP 429 SDK wprowadza lokalny okres oczekiwania (uwzględniając Retry-After, ograniczony do przedziału od 1 sekundy do 1 godziny, domyślnie 60 sekund), dzięki czemu pętle ponawiania żądań kończą się lokalnie i nie przeciążają API.

  • Odrzucone wywołania: Jeśli serwer odrzuci wywołanie identyfikacji (na przykład z powodu nieprawidłowego tokenu, włączonej opcji Wymagaj podpisanych tokenów bez tokenu, konfliktu adresu e-mail skutkującego 409 lub członka usuniętego zgodnie z RODO, dla którego zwracane jest 403 / member_erased), obietnica zostanie odrzucona z błędem IDENTIFY_FAILED, a odwiedzający pozostanie anonimowy.

Tożsamość a konwersacje

Gdy funkcja Rozmowy jest włączona:

  • Zidentyfikowani użytkownicy nie widzą prośby o podanie danych i otrzymują odpowiedzi zespołu na adres e-mail przypisany do ich konta.

  • Anonimowi odwiedzający mogą prowadzić rozmowy jako goście, przypisane do przeglądarki. W zależności od ustawień widżetu można też opcjonalnie zbierać ich dane kontaktowe.

W widżecie anonimowi odwiedzający mogą przesyłać opinie i reagować na aktualizacje, natomiast głosowanie na opinie, dodawanie komentarzy i otwieranie dzwonka powiadomień wymaga wywołania uj.identify. Edytowanie lub usuwanie własnych postów i komentarzy w widżecie wymaga podpisanej tożsamości.

Jeśli w Ustawieniach → Logowanie włączono opcję Wymagaj podpisanych tokenów, niepodpisane wywołania identify są odrzucane z kodem HTTP 403, a odwiedzający pozostaje anonimowy. Użyj funkcji Podpisana tożsamość, aby weryfikować konta po stronie serwera.

Którą metodę uwierzytelniania wybrać?

Metoda

Gdzie działa

Zabezpieczenia

Plan

Przewodnik

Bez podpisu (uj.identify)

Widżet w aplikacji

Dostarczane przez przeglądarkę (można sfałszować)

Wszystkie plany

Ten artykuł

Podpisana tożsamość (JWT HS256)

Widżet w aplikacji (oraz linki do portalu publicznego, gdy włączono automatyczne logowanie)

JWT zweryfikowany przez serwer

Starter & Professional (wymagany w trybie ścisłym)

Podpisana tożsamość

Automatyczne logowanie

Portal publiczny i osadzenia w treści (?token=...)

JWT HS256 zweryfikowany przez serwer

Starter & Professional

Automatyczne logowanie

Logowanie jednokrotne (SSO)

Przekierowanie do logowania w portalu publicznym

JWT HS256 zweryfikowany przez serwer

Professional

Logowanie jednokrotne

SDK Swift (identify)

Aplikacje na iOS i macOS

Bez podpisu lub podpis HMAC-SHA256

Starter & Professional (wymaga automatycznego logowania)

Uwierzytelnianie przez SDK Swift

Następny krok

Weryfikuj tożsamość użytkowników w swoim backendzie za pomocą funkcji Podpisana tożsamość.

Czy ten artykuł odpowiedział na Twoje pytanie?