first commit

wp-content/plugins/wirtualna-polska-pixel/readme.txt

@@ -0,0 +1,134 @@
+=== Wirtualna Polska Pixel ===
+Contributors: wppixel
+Tags: track, wppixel, pixel
+Requires at least: 4.7
+Tested up to: 6.1
+Requires PHP: 7.0
+Stable tag: 1.0.1
+License: GPLv2 or later
+License URI: https://www.gnu.org/licenses/gpl-2.0.html
+
+Narzędzie do pomiaru działań podejmowanych przez użytkowników odwiedzających witrynę i zwiększania skuteczności reklam w Sieci Reklamowej WP.
+
+== Description ==
+
+
+
+## Pixel - informacje
+WPH Pixel jest wykorzystywany do analizy działania użytkowników odwiedzających witrynę (analizy konwersji). Zebrane informacje można użyć np. do analizy skuteczności ścieżki konwersji oraz budowy lejka sprzedażowego.
+
+
+
+Dane z kodów WP wykorzystywane są do:
+- Zwiększania liczby konwersji za pomocą pozyskanych z kodu informacji, WP ma możliwość optymalizowania wyświetlanych produktów tak, żeby Partner uzyskał jak największą liczbę konwersji i sprzedaży.
+- Określenie zaangażowania użytkowników: Badamy stopień przywiązania użytkowników w treści na stronie klienta. Segmentujemy user'ów w grupy m. in. „porzucone koszyki”, „porzucone produkty”
+- Personalizowanie ofert produktowych dla użytkowników: Narzędzia stworzone przez WP dopasowują wyświetlanie produktów do właściwych użytkowników, którzy odwiedzili stronę partnera lub podjęli oczekiwane działanie w witrynie. Dzięki temu produkty Partnera mogą skutecznie konkurować z innymi sklepami w ramach mechanizmów personalizujących.
+
+
+## Jak działa skrypt WPH Pixel?
+
+Skrypt WP Pixel to kod zapisany w języku JavaScript, który rejestruje na stronie następujące akcje użytkownika :
+- `ViewContent` – Na stronie głównej, na stronach z kategoriach produktowych oraz na stronach z konkretnymi produktami (kart produktu).
+- `Purchase` – wywoływany na stronie z potwierdzeniem zakupu (ostatni krok na ścieżce zakupowej). Kod można osadzić po zakończeniu płatności, na tzw. ThankYouPage’u zaraz po powrocie od dostawcy płatności lub na stronie z potwierdzeniem zamówienia.
+- `AddToCart` – Na stronie/zdarzeniu dodania produktów do koszyka (np. kliknięcie, wyświetlenie strony docelowej po kliknięciu przycisku \"Dodaj do koszyka\")
+
+
+
+## Parametry
+
+
+
+Parametry są obiektami przekazywanymi w formacie JSON. Pozwalają one na dostarczenie dodatkowych informacji o działaniach użytkowników odwiedzających witrynę.
+
+
+
+W celu dodania do obiektu parametrów sformatuj dane jako obiekt za pomocą JSON, a następnie dołącz jako trzeci parametr funkcji podczas wywoływania `wph(\'track\')`.
+
+ 
+
+
+### Lista dostępnych parametrów
+
+|Nazwa parametru|Typ danych|Opis|
+|----|---|---|
+|value|`number`|Wartość zamówienia.
+ `przykład: 104.99`|
+|currency|`string`|Domyślna wartość jest ustawiona w PLN, jeżeli transakcja odbyła się w innej walucie można dodać informację w jakiej.
+`przykład: \'EUR\'`
+|name|`string`|Nazwa produktu.
+`przykład: \'coca-cola\'`|
+|content_category|`string`|Nazwa kategorii. 
+`przykład: \'napój\'`|
+|content_ids|`string[]`|Tablica identyfikatorów produktów przekazanych w feedzie produktowym.
+ `przykład: [\'ID\', \'ID\', \'ID\']`|
+|transaction_id|`string`|unikalny identyfikator zamówienia. 
+`przykład: \'ID\'`|
+|mvalue|`string`|marża na danym przekliku. 
+`przykład: \'15.50\'`|
+|in_stock|`bolean`|Informacja czy produkt jest dostępny.
+`przykład: true`|
+|price|`number`|Cena pojedynczego produktu.
+`przykład: 123.90`
+|sizes|`string[]`|Tablica rozmiarów przypisana do produktu.
+`przykład: [\'s\', \'m\', \'l\', \'xl\']`|
+|shipping_cost|`number`|Koszt przesyłki.
+`przykład: 22.55`|
+|id|`string`|Unikalny identyfikator produktu.
+`przykład: \'asd123asd321z2xc\'`|
+|ean|`string`|Unikalny identyfikator ean.
+`przykład: \'1zxc123p\'`|
+|discount_code|`string`|Kod rabatu.
+`przykład: \'QWERTY123\'`|
+|quantity|`number`|Ilość jednostek.
+`przykład: 3`|
+|content_type|`string`|Typ zawartości.
+`przykład: \'product\'`|
+|content_category_id|`string`|Unikalny identyfikator kategorii.
+`przykład: \'ID_KATEGORII\'`|
+|contents|`CustomProduct[]`|Lista produktów zawierających identyfikatory powiązanych z feedem produktowym oraz dodatkowe informacje.|
+| ||`przykład:`| 
+|||`[{`|
+|||`id: \'ID_PRODUKTU\',`|
+|||`name: \'NAZWA_PRODUKTU\',`|
+|||`price: 20.15,`|
+|||`quantity: 2,`|
+|||`ean: \'eanId\',`|
+|||`in_stock: true,`|
+|||`sizes: [\'SX\', \'L\']`|
+|||`}]`||
+
+ 
+
+## Zarządzanie piksela
+Po zainstalowaniu piksela na witrynie internetowej otwórz dowolną stronę witryny, w której znajduje się piksel. Jeśli piksel zainstalowany jest prawidłowo, wyśle informacje do systemów analitycznych.
+
+== Installation ==
+1. W panelu admina WP, kliknij \"Wtyczki\" -> \"Dodaj nową\".
+1. W wyszukiwarce wtyczek, napisz \"Wirtualna Polska Pixel\".
+1. Wybierz wtyczkę \"WordPress WP Pixel\" plugin (autora \"Wirtualna Polska Media S.A.\"), i kliknij \"Install\".
+1. Aktywuj plugin.
+1. Przejdź do Ustawień wtyczki i uzupełnij WP Pixel ID.
+
+LUB...
+
+1. Pobierz wtyczkę z tej strony.
+1. W panelu admina WP, kliknij \"Wtyczki\" -> \"Dodaj nową\".
+1. Kliknij \"Wyślij wtyczkę na serwer\" następnie wybierz plik .zip z wtyczką, i kliknij \"Install\".
+1. Aktywuj plugin.
+1. Przejdź do Ustawień wtyczki i uzupełnij WP Pixel ID.
+
+LUB...
+
+1. Pobierz wtyczkę z tej strony.
+1. Wypakuj wtyczką na Twój komputer.
+1. Użyj klienta FTP w celu wysłania plików wtyczki na serwer.
+1. Wyślij folder \"wirtualnapolska-pixel\" do folderu `wp-content/plugins`
+1. W panelu admina WP, kliknij \"Wtyczki\" a następnie aktywuj wtyczkę \"WordPress WP Pixel\"
+1. Przejdź do Ustawień wtyczki i uzupełnij WP Pixel ID.
+
+== Screenshots ==
+1. Konfiguracja wtyczki Wirtualna Polska Pixel
+
+== Changelog ==
+= Wirtualna Polska Pixel 1.0 =
+* Powstanie nowej wtyczki: Pozwala zarządzać kodem piksela \"Wirtualna Polska Pixel\" jednym kliknięciem!