Danych z poniższych systemów używamy do zbudowania naszego Master Modelu danych produktowych.
Systemy Analityczne
Google Analytics 4
Instrukcja video:
W głównym widoku na koncie Google Analytics 4 wchodzimy w pole Admin, które jest w lewym dolnym rogu.
Następnie wybieramy “Property access management”.
W prawym górnym rogu klikamy niebieski znak plus.
W polu Email addresses wpisujemy adres e-mail podany w wiadomości od zespołu Data Octopus, a następnie nadajemy mu dostęp na poziomie Viewer (Przeglądający). Na końcu klikamy guzik Add, aby nadać dostęp.
Kolejnym krokiem jest podanie numeru identyfikacyjnego usługi (Property Id). Należy pamiętać, że nie jest to numer konta Google Analytics ani identyfikator strumienia danych.
W celu sprawdzenia numeru usługi należy wejść w ustawienia (1), a następnie w sekcji ustawienia usługi kliknąć szczegóły usługi (2). Numer jest w prawym, górnym roku (3). Skopiowany identyfikator usługi należy podać w formularzu.
Systemy Reklamowe
Google Ads
W panelu głównym Google Ads w prawym, górnym rogu znajduje się numer konta reklamowego. Numer z kodem kraju, na który przeznaczone jest konto podajemy w formularzu.
Aby nadać nam dostęp do kont Google Ads podsyłamy unikalny adres konta serwisowego, które należy dodać do panelu z dostępem "Read only".
Aby to zrobić, należy wybrać po lewej stronie ekranu zakładkę Admin (1) > Access and security (2) > Users (3) i za pomocą niebieskiego przycisku plusa (4) nadać nam dostęp panelu na adres konta serwisowego z dostępem Read only.
Meta Ads
W głównym panelu Business Manager’a w lewej kolumnie wybieramy pole Accounts, a następnie klikamy zakładkę Ad Accounts. W tabeli w sekcji kolumnie Name znajdziemy nazwę konta reklamowego, a pod nią numer (ID) konta reklamowego.
Link do widoku w panelu Business Manager’a: https://business.facebook.com/latest/settings/ad_accounts
Drugim sposobem na odnalezienie numeru konta reklamowego jest skorzystanie z widoku panelu reklamowego. Aby zobaczyć numer konta reklamowego, należy w lewym, górnym rogu kliknąć w rozwijaną listę i skopiować numer widoczny pod nazwą konta.
Link do widoku w panelu reklamowym Meta Ads: https://adsmanager.facebook.com/adsmanager/manage/campaigns
Numer z kodem kraju, na który przeznaczone jest konto podajemy w formularzu.
Silniki Sklepów Internetowych
IdoSell API
Link do panelu nadawania dostępu: http://www.twojadomena.pl/panel/users-api.php (proszę podać swoją domenę).
W otwartym oknie proszę kliknąć: + Dodaj nowy klucz
Pojawi się okno, w którym konfigurujemy nowy klucz dostępu do API.
W otwartym widoku należy:
Wybrać pole Klucz API.
Wpisać nazwę Data Octopus.
Wpisać adres e-mail podany w formularza.
W polu aktywny Wybrać tak.
W polu PIM wybrać tylko odczyt.
W polu OMS wybrać tylko odczyt.
Kliknąć Dodaj.
Po utworzeniu nowego klucza wracamy na stronę http://www.twojadomena.pl/panel/users-api.php i klikamy edytuj.
W następnym kroku klikamy Pokaż klucz, kopiujemy go i wklejamy do formularza.
Shopify API
Aby zintegrować DataOctopus z Twoim sklepem na platformie Shopify, konieczne jest utworzenie dedykowanej aplikacji w panelu administracyjnym. Aplikacja ta zapewni nam bezpieczny dostęp do danych (tylko do odczytu) za pomocą klucza API. Postępuj zgodnie z poniższymi krokami, aby prawidłowo skonfigurować integrację.
Krok 1: Przejdź do ustawień aplikacji
W lewym dolnym rogu kliknij Settings (Ustawienia).
W menu ustawień wybierz sekcję Apps and sales channels (Aplikacje i kanały sprzedaży).
Krok 2: Otwórz panel deweloperski
W tej sekcji zarządzasz wszystkimi aplikacjami, w tym tymi tworzonymi na własne potrzeby.
W prawym górnym rogu kliknij przycisk Develop apps (Rozwijaj aplikacje).
Następnie kliknij Build apps in Dev Dashboard (Zbuduj aplikacje w panelu deweloperskim).
Krok 3: Utwórz i nazwij nową aplikację
Teraz utworzysz aplikację dedykowaną dla DataOctopus.
Kliknij przycisk Create app (Utwórz aplikację) w prawym górnym rogu.
W polu App name wpisz DataOctopus. Ułatwi to identyfikację, komu został udzielony dostęp. Następnie kliknij Create (Utwórz).
Krok 4: Skonfiguruj uprawnienia (API Scopes)
To najważniejszy krok, w którym nadasz aplikacji uprawnienia do odczytu danych.
Po utworzeniu aplikacji zostaniesz przeniesiony do jej panelu konfiguracyjnego. Przewiń w dół do sekcji Access (Dostęp).
W polu Scopes (Zakresy) wklej poniższą listę uprawnień. Zapewni to nam dostęp tylko do odczytu wymaganych danych.
read_analytics, read_gift_cards, read_customers, read_orders, read_products
Krok 5: Zapisz i zainstaluj aplikację
Teraz należy zapisać konfigurację i zainstalować aplikację w Twoim sklepie.
Po wklejeniu uprawnień kliknij przycisk Release (Wydaj) w prawym dolnym rogu.
W nowym oknie, które się pojawi, ponownie kliknij Release, nie wypełniając żadnych dodatkowych pól.
Zostaniesz przeniesiony na stronę główną aplikacji. W prawym górnym rogu kliknij Install app (Zainstaluj aplikację).
W kolejnym kroku potwierdź instalację, klikając przycisk Install.
Krok 6: Skopiuj klucz API oraz adres sklepu
Po instalacji musisz skopiować wygenerowany klucz dostępowy oraz adres URL Twojego sklepu i wkleić je do formularza rejestracyjnego DataOctopus.
Po zainstalowaniu aplikacji Shopify wyświetli Ci klucz API. Jeśli jednak zamknąłeś to okno, wróć do Settings > Apps and sales channels > Develop apps i wybierz z listy aplikację DataOctopus.
W pierwszej części Settings (Ustawień) będzie widoczna sekcja Credentials.
Skopiuj swój Admin API access token (token dostępu do API administratora). WAŻNE: Ten klucz jest unikalny i niezbędny do ukończenia integracji.
Wklej skopiowany token do odpowiedniego pola w formularzu rejestracyjnym DataOctopus.
Na koniec wróć do głównego menu Settings w Shopify. W sekcji Store details (Szczegóły sklepu) znajdziesz adres URL swojego sklepu w formacie nazwa-sklepu.myshopify.com.
Skopiuj ten adres i również wklej go do formularza rejestracyjnego DataOctopus.
Gotowe! Twoja integracja została pomyślnie skonfigurowana.
Shoper API
Integracja Data Octopus z platformą Shoper wymaga utworzenia w panelu administracyjnym Integracji Zewnętrznej, która zapewni nam dostęp do Twoich danych za pośrednictwem Tokenu API. Postępuj zgodnie z poniższymi krokami, aby to zrobić:
Krok 1: Rozpocznij dodawanie nowej integracji
Z panelu bocznego wybierz Dodatki i integracje (1).
Następnie kliknij Integracje zewnętrzne (2).
W prawym górnym rogu strony kliknij przycisk Dodaj integrację (3).
Krok 2: Uzupełnij Ustawienia Podstawowe
W sekcji PODSTAWOWE uzupełnij pola zgodnie z poniższymi wytycznymi:
Narzędzie: Wybierz opcję Inne (1).
Nazwa integracji: Wpisz DataOctopus Integration (2). Ułatwi to identyfikację, komu został udzielony dostęp.
Opis: Opcjonalnie (ale zalecane) dodaj opis, np.: Integracja danych DataOctopus <> Shoper (3).
Krok 3: Nadaj Uprawnienia Integracji (ODCZYT)
W sekcji UPRAWNIENIA INTEGRACJI musisz dodać uprawnienia typu ODCZYT dla wszystkich kategorii danych, które będą analizowane przez Data Octopus.
Dla każdej z poniższych pozycji:
Zamówienia,
Produkty,
Producenci,
Waluty,
Dostawy,
Kategorie,
Stany dostępności,
Statusy zamówień
wykonaj następujące czynności:
W polu Obszar sklepu (1) wybierz jedną z wyżej wymienionych pozycji (np. zamówienia).
W polu Zakres dostępu (2) zawsze wybierz odczyt.
Kliknij przycisk DODAJ UPRAWNIENIE (3).
Powtórz kroki 1-3, aż lista uprawnień będzie zawierała wszystkie 8 wymaganych pozycji z zakresem odczyt.
Krok 4: Zapisz i Utwórz Token
Po nadaniu wszystkich uprawnień z listy, przewiń na dół i kliknij przycisk:
ZAPISZ I UTWÓRZ TOKEN
Krok 5: Skopiuj i prześlij Token API
Na ekranie podsumowania zostaną wyświetlone wygenerowane dane dostępowe.
WAŻNE: Token API to najważniejszy element bezpieczeństwa. Musisz go skopiować natychmiast, ponieważ po zamknięciu tej strony nie będzie możliwości jego ponownego podejrzania.
Skopiuj Client ID i Token API.
Wklej oba te elementy do dedykowanego formularza wdrożeniowego Data Octopus.
Po skopiowaniu danych, kliknij przycisk ROZUMIEM (1).
Jeżeli strona zostanie zamknięta bez skopiowania Tokenu API, konieczne będzie utworzenie nowego Tokenu API.
PrestaShop API
Krok 1: Przejdź do ustawień aplikacji i włącz Webservice
Krok 2: Utwórz klucz dostępu do API
Otwórz stronę „Webservice” w menu „Advanced Parameters”, a następnie kliknij przycisk „Add new webservice key”.
W otwartym oknie:
Kliknij "Generuj" aby wygenerować nowy klucz - ten klucz wyślij w formularzu rejestracyjnym, który otrzymałeś od DataOctopus.
W opisie możesz wpisać informację, która pozwoli zidentyfikować kto korzysta z klucza API. Można tutaj wpisać krótką informację "Aplikacja DataOctopus".
Ustawiamy status na "YES", ta opcja włącza klucz.
W uprawnieniach wybieramy wszystkie metody w kolumnie "GET". Aplikacja DataOctopus nie wykonuje żadnych zmian w danych, jedynie pobiera dane i wykorzystuje je do dalszych analiz.
Inne Dane
Wiedza o marży
Aby poprawnie wyliczać:
Zysk 1 stopnia (Przychody pomniejszone o marżę)
Zysk 2 stopnia (Przychody pomniejszone o marżę oraz koszty reklamowe).
System wymaga wiedzy o marży. Najefektywniej jest otrzymać ją na poziomie ID produktu, ponieważ pozwala to liczyć, optymalizować pod zysk i rentowność już od poziomu produktu przez całe marki oraz kategorie.
Szablon marż produktowych wymaga uzupełnienia dwóch kolumn danymi.
1) ID - kolumna obowiązkowa, ponieważ to ona identyfikuje produkt, jest to id produktu i musi być zgodne z tym id, które jest wysyłane w pliku produktowym.
2) Jedna z kolumn, która definiuje marże, możemy skorzystać z wyrażenia marży w procentach, ułamku dziesiętnym, wartości kwotowej lub koszcie zakupu towaru.
| DESCRIPTION | EXAMPLE |
ID | numer identyfikacyjny produktu, który musi być zgodny z numerem, który jest wykorzystywany w pliku produktowym | 1234 |
MARGIN_PERCENTAGE | marża wyrażona w procentach | 10.00% |
MARGIN_NET_VALUE | marża wyrażona w wartości pieniężnej netto bez dodatku waluty | 10 |
MARGIN_NET_COST_OF_GOODS | koszt sprzedawanego produktu wyrażony w wartości pieniężnej netto bez dodatku waluty | 100 |
MARGIN_DECIMAL | marża wyrażona za pomocą ułamka dziesiętnego z wykorzystaniem kropki, nie przecinka | 0.1 |