Dokumentacja dla programistów›Budowa aplikacji›Najlepsze praktyki dotyczące zdarzenia osiągnięcia wartości
Dokumentacja dla programistów

Najlepsze praktyki dotyczące zdarzenia osiągnięcia wartości

Budowa aplikacjiAplikacje monday.com
Aktualizacja 2025-10-23

Możesz raportować zdarzenia osiągnięcia wartości, aby mierzyć czas, jaki upływa od zainstalowania aplikacji przez użytkownika do chwili, gdy zacznie czerpać z niej wartość. Zdarzenie oznacza moment, w którym użytkownik wykonuje w aplikacji przydatną czynność. Wybierz je na podstawie logiki działania aplikacji.

📘

Pełna informacja: po wywołaniu tej metody nie zobaczysz od razu żadnych zmian. Potrzebujemy Twojej pomocy we wdrożeniu tej funkcji, aby móc analizować, ile czasu zajmuje użytkownikom uzyskanie wartości z naszych aplikacji. Planujemy w przyszłości udostępnić twórcom aplikacji te informacje i dodać więcej danych o korzystaniu z aplikacji.

Śledzenie czasu od instalacji do wystąpienia zdarzenia osiągnięcia wartości dostarcza unikalnych informacji, które pomogą Ci lepiej poznać użytkowników i zrozumieć, jaką wartość czerpią z Twojej aplikacji. W przyszłości planujemy udostępniać twórcom informacje o ich aplikacjach. Ta funkcja ostatecznie pomoże poprawić komfort użytkowników, zwiększyć korzystanie z aplikacji i skrócić czas między instalacją a rozpoczęciem korzystania z aplikacji.

Dzięki tej funkcji możemy też mierzyć sukces każdej aplikacji po jej zainstalowaniu oraz łączny sukces wszystkich aplikacji w marketplace. Wykorzystamy te informacje, aby uprościć proces od instalacji do rozpoczęcia korzystania z aplikacji, a tym samym poprawić komfort użytkowników i twórców!

Wybieranie zdarzenia osiągnięcia wartości

Wybierz zdarzenie osiągnięcia wartości na podstawie funkcji swojej aplikacji. Zdarzenia będą się różnić w zależności od aplikacji, jej funkcji, stopnia interakcji z użytkownikami oraz kroków, które użytkownik musi wykonać, aby z niej korzystać. Przykładowe zdarzenia mogą rejestrować, kiedy użytkownik:

  • Wyświetla widok (szczególnie jeśli aplikacja nie wchodzi w interakcję z użytkownikami)
  • Tworzy element
  • Definiuje coś
  • Wyświetla okno
  • Rysuje coś na tablicy
  • Widzi obraz

To nie jest pełna lista, ale powinna pokazać Ci, jaką wartość użytkownik może uzyskać z Twojej aplikacji. W przyszłości planujemy przygotować listę zdarzeń do wyboru, opartą na najczęściej definiowanych zdarzeniach.

Zalecamy wywoływać tę metodę za każdym razem, gdy wystąpi zdarzenie osiągnięcia wartości, abyśmy mogli z czasem mierzyć rzeczywiste korzystanie z aplikacji. Możesz też wywoływać ją osobno dla każdej funkcji, takiej jak widoki tablic, widoki elementów czy widżety pulpitu. Każda z tych funkcji może osobno wywołać zdarzenie osiągnięcia wartości.

Zalecamy również wywoływać tę metodę za każdym razem, gdy wystąpi zdarzenie - nie tylko przy pierwszym wystąpieniu ani tylko dla konkretnego użytkownika lub konta. Dzięki temu możemy śledzić wdrażanie aplikacji na całym koncie i dokładnie oceniać wartość każdej z nich.

Tworzenie zdarzenia osiągnięcia wartości

Po wybraniu zdarzenia osiągnięcia wartości możesz wywołać metodę monday.execute() z typem valueCreatedForUser za każdym razem, gdy wystąpi to zdarzenie. Ta metoda nie przyjmuje parametrów, a funkcja zwraca obietnicę, która zostaje spełniona po pomyślnym wykonaniu. Metoda nie zwraca żadnej wartości. Metodę valueCreatedForUser znajdziesz w SDK.

monday.execute('valueCreatedForUser')

📘 Dołącz do naszej społeczności deweloperów!

Stworzyliśmy społeczność specjalnie dla naszych deweloperów. Możesz tam przeszukiwać wcześniejsze tematy, aby znaleźć rozwiązania, zadawać pytania, dowiadywać się o nowych funkcjach i aktualizacjach oraz poznawać wskazówki od innych deweloperów. Dołącz do nas! 😎