Podczas konfigurowania nowej aplikacji użytkownika będziesz pracować z kilkoma kluczowymi konfiguracjami, które określają, w jaki sposób Twoja zewnętrzna aplikacja integruje się z platformą. Przyjrzyjmy się każdemu istotnemu komponentowi.

Zacznij od kliknięcia przycisku na liście aplikacji użytkownika . W wyświetlonym formularzu konfiguracji wykonaj następujące kroki:

1. Ustaw adres URL

Podaj adres URL swojej aplikacji — adres, pod którym hostowana jest Twoja aplikacja. Stanowi on podstawę integracji.

Ważne!

• Upewnij się, że adres URL jest prawidłowy, wykorzystuje połączenie HTTPS, prowadzi do zaufanego zasobu i nie zawiera więcej niż 1000 znaków.
• Upewnij się, że aplikacja ma włączoną opcję iFrame, w przeciwnym razie nie będziesz mógł jej otworzyć w interfejsie platformy.

2. Skonfiguruj podstawowe parametry

Aby spersonalizować swoją aplikację, możesz uwzględnić różne parametry w adresie URL. Możesz ręcznie dodać parametry w polu adresu URL lub skorzystać z jednej z naszych sugestii: język, identyfikator użytkownika lub strefa czasowa. Kliknij sugestię parametru, aby dodać ją na końcu adresu URL. Rozwiń poniższy opis, aby dowiedzieć się więcej o sugerowanych parametrach i przykładach.

Zrozumienie sugerowanych parametrów adresu URL

Sugerujemy kilka podstawowych parametrów personalizacji

1. ?locale={locale_code}
   Parametr języka, który automatycznie dopasowuje się do języka platformy użytkownika.
   • Przykład:https://your-app.com/dashboard?locale=en
2. ?user_id={user_identifier}
   Parametr kontekstu użytkownika, który przekazuje tożsamość użytkownika w celu filtrowania spersonalizowanych informacji.
   • Przykład:https://your-app.com/dashboard?user_id=12345
3. ?timezone={timezone}
   Parametr czasu, który automatycznie dopasowuje się do strefy czasowej platformy użytkownika.
   • Przykład:https://your-app.com/dashboard?timezone=UTC+1

Możesz edytować proponowaną nazwę parametru lub określić dla niej konkretną wartość.

Przetestuj swoją konfigurację, aby upewnić się, że aplikacja ładuje się poprawnie. Kliknij aby wyświetlić podgląd.

3. Dostosuj wygląd

Utwórz rozpoznawalną tożsamość dla swojej aplikacji, aby ułatwić do niej dostęp. Poniższe ustawienia pomogą Ci to zrobić:

• Etykieta – Dodaj unikalną, opisową nazwę dla swojej aplikacji (do 24 znaków). Zostanie ona wyświetlona na pasku bocznym platformy.
• Opis – Dodaj krótkie wyjaśnienie ze szczegółami dotyczącymi funkcjonalności aplikacji lub wyróżnij ważne informacje (do 50 znaków). Informacyjny opis pomoże użytkownikom lepiej zrozumieć cel aplikacji.
• Ikona – Wybierz ikonę reprezentującą funkcję Twojej aplikacji, aby uzyskać jeszcze bardziej natywną nawigację.

4. Wybierz metodę wyświetlania

Zdecyduj, w jaki sposób będzie otwierana Twoja aplikacja, wybierając jedną z dwóch opcji z listy rozwijanej Otwórz w :

• Wbudowane – aplikacja pojawia się w interfejsie platformy
• Nowa karta – aplikacja otwiera się w osobnej karcie przeglądarki

Nasza platforma używa iFrame do osadzania. Ponieważ nie wszystkie adresy URL mogą być pomyślnie przetworzone za pomocą tej technologii, upewnij się, że wyświetlisz podgląd wyniku osadzania. Jeśli napotkasz jakiekolwiek problemy z tą metodą wyświetlania, rozważ użycie Nowej karty .

5. Skonfiguruj uwierzytelnianie (opcjonalnie)

Skonfiguruj uwierzytelnianie, jeśli Twoja aplikacja opiera się na API platformy. W takim przypadku platforma dostarczy dane uwierzytelniające bezpośrednio do aplikacji po jej otwarciu, eliminując potrzebę implementacji dodatkowej funkcjonalności logowania po stronie aplikacji.
Możesz wybrać jedną z dwóch metod uwierzytelniania:

• Klucz API
  • Ta metoda jest przeznaczona dla aplikacji, w których nie jest wymagane zarządzanie rolami lub uprawnieniami użytkowników.
  • Klucz API odpowiada poziomowi dostępu właściciela konta. Oznacza to, że udostępnienie zwykłemu użytkownikowi klucza API może przyznać mu dostęp do wszystkich danych dostępnych dla głównego użytkownika.
    Na przykład, jeśli Twoja aplikacja działa z trackerami, do których użytkownik ma ograniczone prawa lub nie ma żadnego dostępu, użycie klucza API nadal ujawni wszystkie trackery z głównego konta.
• Klucz sesji
  • Tę metodę zaleca się w przypadkach, gdy w grę wchodzi zarządzanie rolami.
  • Przesyła aktualny klucz sesji użytkownika do aplikacji.

Wybranie metody klucza API automatycznie wyłączy metodę klucza sesji i odwrotnie. Można używać tylko jednej metody na raz.

Po włączeniu uwierzytelniania platforma dołącza ?session_key=parametr do adresu URL Twojej aplikacji.

• Jeśli wybrano klucz API , wartość parametru będzie zawierać ten klucz.
• Jeżeli wybrano opcję Klucz sesji , wartość parametru będzie zawierać klucz bieżącej sesji użytkownika, z której uzyskiwany jest dostęp do aplikacji.

Upewnij się, że aplikacja jest w stanie odczytać i wykorzystać ten parametr.

6. Zapisz nową aplikację

Kliknij przycisk Zapisz . Twoja aplikacja pojawi się na liście aplikacji użytkownika i pasku bocznym platformy. Włączone aplikacje automatycznie staną się dostępne dla użytkowników konta.

Szybkie wskazówki dotyczące rozwiązywania problemów

Jeśli Twoja aplikacja nie wyświetla się prawidłowo po osadzeniu, spróbuj:

• Zamiast tego otwórz go w nowej karcie
• Weryfikacja poprawności i dostępności adresu URL
• Sprawdzanie, czy wszystkie parametry są poprawnie sformatowane

Utworzone aplikacje pozostają w pełni konfigurowalne po ich zapisaniu. Możesz dostosować ich parametry i wygląd w dowolnym momencie. Aby dowiedzieć się więcej o zarządzaniu aplikacjami, zobacz: