SDK Pixel

SDK Pixel to komponent integracyjny umożliwiający zbieranie zdarzeń użytkowników z aplikacji mobilnych (Android / iOS) i przesyłanie ich do systemów analitycznych i reklamowych. Pełni on funkcję „pomostu” między aplikacją a platformą danych – WP Data Platform.

Podstawowe funkcje SDK Pixel

Zbieranie zdarzeń (eventów) – m.in. otwarcia aplikacji, kliknięcia, widoki ekranów, transakcje,
Obsługa identyfikatorów – m.in. WPCLID (do celów atrybucyjnych), session ID- budowanie sesji,
Obsługa dynamicznych parametrów – przekazywanie parametrów kampanijnych (UTM, referer, custom eventów),
Wsparcie dla deeplinków i atrybucji instalacji,
Modułowa konfiguracja i rozszerzalność – możliwość dostosowania do potrzeb partnera,
Możliwość pobierania geolokalizacji (opcjonalnie) – z uwzględnieniem zgodności z RODO.

Dlaczego warto wdrożyć SDK Pixel?

Lepsza jakość danych analitycznych i marketingowych – dane pochodzące z SDK są bardziej wiarygodne i stabilne niż dane webowe czy z zewnętrznych SDK,
Ułatwienie personalizacji i retargetingu – precyzyjniejsze kierowanie kampanii reklamowych,
Możliwość niezależnego monitorowania integracji (Metrix) – identyfikacja potencjalnych błędów po stronie aplikacji.

Zakres danych zbieranych przez SDK Pixel

SDK Pixel zbiera zarówno dane techniczne jak i kontekstowe, które mogą obejmować:

Parametry techniczne urządzenia i aplikacji

Parametr	Opis	Przykład
`c_make`	producent urządzenia	np. `"Apple"`
`c_make`	model urządzenia	np. `"iPhone"`
`c_os`	system operacyjny	np. `"iOS"`
`c_osv`	wersja systemu	np. `"18.2.1"`
`an`	nazwa aplikacji	np. `"demo"`
`ap`	unikalny identyfikator aplikacji	np. `"com.developer.demo"`
`av`	wersja aplikacji	np. `"6.12.0"`
`ab`	build aplikacji	np. `"1"`
`tz`	strefa czasowa użytkownika	np. `"Warszawa"`
`ua`	user agent – typ i wersja urządzenia oraz systemu

Identyfikatory i sesje

Parametr	Opis
`wph_st`	identyfikator sesji
`wph_a`	identyfikator użytkownika
`ltid`	long term user ID
`fpuid`	fingerprint ID urządzenia
`wph_clid`	identyfikator kliknięcia (click ID)
`dtid`, `atid`	identyfikatory przekliku (w zależności od źródła kampanii)

Parametry kampanijne (UTM)

c_utm_source, c_utm_medium, c_utm_campaign, c_utm_content, c_utm_term, c_utm_id, c_utm_gclid, c_utm_device, c_utm_channel, itd.
r – referer (strona odsyłająca),
h – host strony,
v – wersja skryptu.

Parametry eventu i produktowe

e – typ eventu (np. ViewContent, Purchase),
c_contents – lista produktów (id, name, category, price, currency, quantity, colour, size, ean, brand, itd.),
c_value, c_value_gross – wartość transakcji,
c_discount_code, c_discount_value – kod i wartość rabatu,
c_transaction_id – identyfikator transakcji,
c_shipping_cost – koszt dostawy,
c_item_ids, c_content_ids – ID produktów,
c_content_category, c_content_name, c_content_type – opis zawartości eventu.

Parametry geolokalizacyjne (opcjonalne)

c_glat – szerokość geograficzna,
c_glon – długość geograficzna,
c_gcac – dokładność pozycji,
c_galt – wysokość n.p.m.,
c_gaac – dokładność wysokości,
c_gspe – prędkość urządzenia.

Wymagania i integracja

SDK dostępne jest dla platform Android i iOS,
Dystrybucja: repozytorium WP lub bezpośrednio (GitHub / Nexus),
Wymagana konfiguracja początkowa (dokumentacja techniczna dostarczana przez zespół WP),
Możliwość dostosowania konfiguracji pod konkretne potrzeby klienta,
Wsparcie zespołu integracyjnego WP na etapie onboardingu.

Do implementacji SDK potrzeba wsparcia technicznego i indywidulanych dostępów do repozytorium skryptu, zatem w przypadku decyzji o implemenatcji SDK prosimy o kontakt na adres e-mail: sdkpixel@grupawp.pl

Najczęściej zadawane pytania (FAQ)

Czy SDK Pixel śledzi dane osobowe?

Tak, SDK zbiera dane osobowe. Przesyłane dane mogą zawierać identyfikatory użytkownika oraz techniczne (np. WPCLID), które identyfikują konkretną osobą.

Czy mogę wyłączyć niektóre funkcje SDK?

Tak, SDK ma budowę modułową. Można włączyć tylko te komponenty, które są wymagane w danym wdrożeniu.

Czy SDK wpływa na wydajność aplikacji?

SDK działa asynchronicznie i jest zoptymalizowane pod kątem wydajności – nie wpływa na działanie aplikacji.

Czy SDK wymaga zgody użytkownika?

Tylko w przypadku włączenia geolokalizacji. Domyślnie SDK działa zgodnie z zasadami prywatności aplikacji i nie wymusza pobierania danych wymagających zgody.