Atrybuty to jeden z kluczowych elementów budujących Positive User. Pomagają zbierać, organizować i wykorzystywać dane o kontaktach, firmach, produktach oraz innych obiektach w workspace. Zrozumienie sposobu działania atrybutów pozwala tworzyć trafniejsze kampanie, automatyzować komunikację i lepiej analizować dane.
Atrybut to informacja opisująca konkretną cechę obiektu w platformie Positive User. Atrybuty porządkują dane w ustrukturyzowane profile – na przykład „Email" kontaktu, „Branża" firmy czy „Cena" produktu.
Atrybuty mogą występować dla różnych typów obiektów, w tym:
Atrybuty kontaktu
Atrybuty firmy
Atrybuty produktu
Atrybuty szansy sprzedaży
Atrybuty zadania
Atrybuty zdarzenia
Atrybuty zgłoszenia
Atrybuty kuponu
Atrybuty kampanii [LINK]
Każdy typ obiektu można opisać przy użyciu jego atrybutów. Na przykład kontakt może mieć atrybuty takie jak „Imię", „Email" czy „Lifetime value", a produkt – „Nazwa", „Cena" czy „URL produktu".
Atrybuty pomagają tworzyć precyzyjnie targetowane kampanie marketingowe oraz zwiększać personalizację, dzięki czemu każdy kontakt otrzymuje wiadomości dopasowane do swoich zainteresowań i zachowań.
W Positive User wyróżniamy dwie kategorie atrybutów: standardowe oraz niestandardowe.
Podczas tworzenia workspace dla każdego obiektu dostępny jest domyślny zestaw atrybutów standardowych. To podstawowe pola danych, które można wypełnić poprzez import, API lub skrypty śledzące.
Przykłady standardowych atrybutów kontaktu:
Imię (string)
Nazwisko (string)
Email (string)
Numer telefonu (string)
Język przeglądarki (string)
First seen (datetime)
Last seen (datetime)
…
Sprawdź pełną listę standardowych atrybutów tutaj.
Możesz tworzyć atrybuty niestandardowe, aby zapisywać dodatkowe informacje dopasowane do potrzeb Twojego biznesu. Pozwalają one rozszerzyć strukturę danych poza standardowe parametry.
Przykłady niestandardowych atrybutów kontaktu:
Zgoda marketingowa (boolean)
Źródło UTM (string)
Data ostatniego zakupu (datetime)
Data urodzin (date)
Atrybuty niestandardowe dają elastyczność w śledzeniu i analizowaniu unikalnych danych, które wpływają na decyzje biznesowe. Sprawdź instrukcję dotyczącą tworzenia atrybutów niestandardowych tutaj.
Tworząc atrybut, musisz zdefiniować jego nazwę oraz wybrać typ. Atrybuty można podzielić według różnych typów danych, a każdy z nich służy konkretnemu celowi w precyzyjnym zapisywaniu i prezentowaniu informacji.
Pamiętaj, aby utworzyć atrybut i zdefiniować jego typ, zanim zaczniesz przesyłać dane do aplikacji.
Typ | Opis | Przykład |
Boolean | Reprezentuje opcje binarne (true/false). | Atrybut „Zgoda marketingowa", wartość „True" |
Date | Pole do przechowywania informacji o konkretnej dacie. | Atrybut „Data urodzin", wartość „1996-01-20" |
Datetime | Pole do przechowywania danych z dokładnym czasem, takich jak rejestracja czy ostatnia aktywność. Wymaga formatu ISO 8601. | Atrybut „Last seen", wartość „2016-08-03 12:00:00+00:00" |
Fixed choice | Zestaw możliwych opcji ograniczający wartości dla danego pola. Tego typu atrybuty mogą również mieć wariant „Allow multiple choices". | Atrybut „Preferowany język", wartość „Angielski", „Polski", „Hiszpański" |
Floating-point number | Dane liczbowe obsługujące wartości dziesiętne, odpowiednie do reprezentowania cen lub miar statystycznych. | Atrybut „Lifetime value", wartość „1000,59" |
Integer | Dane liczbowe obejmujące wyłącznie liczby całkowite. | Atrybut „Łączna liczba zamówień", wartość „9" |
Format pliku JSON | Sprawdza się przy dłuższych wartościach, których nie da się umieścić w innych formatach danych. | Atrybut „Dodatkowe informacje o zamówieniu", wartość (poprawny obiekt JSON): „key": „value" |
Number | To pole używane jest w szczególności dla atrybutów zdarzeń. Obejmuje zarówno liczby całkowite, jak i zmiennoprzecinkowe. | Atrybut „Zebrane punkty", wartość „15" |
String | Dowolny ciąg znaków o długości do 255 elementów. Idealny dla informacji tekstowych, takich jak imiona, adresy e-mail czy inne dane tekstowe. | Atrybut „Plan subskrypcji", wartość „Standard" |
Atrybuty w Positive User można tworzyć i aktualizować na kilka sposobów. Możesz wybrać jedną lub kilka metod pracy z danymi:
Import CSV: Prześlij pliki CSV, aby tworzyć lub aktualizować obiekty wraz z danymi atrybutów. (Możesz zarówno wypełniać puste atrybuty, jak i nadpisywać istniejące wartości). Więcej o imporcie CSV przeczytasz tutaj.
Automatyzacje: Wykorzystaj moduły automatyzacji, takie jak „Update Company Attribute", aby dynamicznie modyfikować wartości w ramach scenariuszy. [LINK]
REST API: Przesyłaj i aktualizuj dane atrybutów za pomocą API Positive User. Oto link do dokumentacji API Positive User.
JavaScript: Przesyłaj dane bezpośrednio ze swojej strony lub aplikacji za pomocą FrontEnd. Sprawdź dokumentację.
Integracje: Możesz korzystać z niestandardowych integracji z usługami zewnętrznymi, aby przesyłać i aktualizować dane w Positive User.
Zawsze twórz atrybuty w aplikacji przed wysłaniem danych. Dzięki temu możesz właściwie zdefiniować typy atrybutów i zachować spójne nazewnictwo.
Atrybuty spotkasz w całej aplikacji, dlatego warto zrozumieć, jakie korzyści mogą Ci przynieść i jakie są ich najpopularniejsze zastosowania.
W każdej sekcji danych (np. „Kontakty", „Firmy") możesz dostosować widoczne kolumny, aby wyświetlać wybrane atrybuty. Skorzystaj z opcji „Kolumny" i wybierz te, które chcesz widzieć od razu po wejściu. Ustawienia te są indywidualne dla każdego członka zespołu, dzięki czemu możesz priorytetyzować dane najistotniejsze dla Twojej codziennej pracy.

Po prawej stronie każdej sekcji „Dane" znajdziesz ikonę „Filtry", która otwiera panel filtrowania zawierający wszystkie atrybuty i inne parametry powiązane z obiektem (kontakty/firmy/szanse sprzedaży itp.).
Używaj filtrów, aby segmentować dane na podstawie wartości atrybutów. Na przykład możesz wyświetlać tylko kontakty z „Zgoda marketingowa = true" lub produkty z „Cena > 100". W zależności od typu danych w atrybucie dostępne są różne opcje filtrowania, co pozwala precyzyjnie zawężać wyszukiwanie i skutecznie porządkować dane.

Atrybuty mają kluczowe znaczenie w automatyzacjach. Możesz:
Uruchamiać scenariusze na podstawie wartości atrybutu lub jego zmiany.
Filtrować moduły automatyzacji na podstawie wartości atrybutów.
Porównywać atrybuty (dotyczy wartości liczbowych).
Aktualizować atrybuty lub dynamicznie modyfikować wartości liczbowe (zwiększanie/zmniejszanie).
Istnieją moduły oparte bezpośrednio na atrybutach.

Atrybuty pozwalają personalizować wiadomości w kanałach e-mail, SMS i innych. Wykorzystaj snippety tagów (zmienne), aby wstawiać wartości specyficzne dla danego kontaktu bezpośrednio w treści – na przykład witać każdy kontakt jego imieniem lub wyświetlać ostatnio oglądane produkty ze strony.
Ten poziom personalizacji nie tylko zwiększa zaangażowanie klientów, lecz także znacząco podnosi skuteczność kampanii marketingowych, dostarczając treści bezpośrednio istotne dla każdego odbiorcy.
Więcej informacji o snippetach tagów znajdziesz w tym artykule.
Aby zobaczyć pełną listę opcji snippetów tagów, przejdź do sekcji „Studio" → „Dynamic Content".
Choć większości atrybutów można przypisać puste wartości, „user_id" nigdy nie może być pusty. To on jednoznacznie identyfikuje każdy kontakt w bazie danych. W integracjach JavaScript możesz przypisać nową wartość do „user_id" za pomocą UE.resetAuth(data), ale nigdy nie ustawiaj jej jako pustej – spowoduje to błąd 400 i uniemożliwi śledzenie pageHit.
Jak zarządzać dostępem do atrybutów [LINK]
Przewodnik po atrybutach JSON [LINK]