Instrukcja nadawania dostępów | Dokumentacja Data Octopus

IdoSell API

Otwórz panel nadawania dostępu: twojadomena.pl/panel/users-api.php (podstaw swoją domenę) i kliknij „+ Dodaj nowy klucz”.

Przycisk „Dodaj nowy klucz” w panelu API IdoSell

Pojawi się okno konfiguracji nowego klucza dostępu do API. W otwartym widoku:

1Wybierz pole Klucz API.
2Wpisz nazwę Data Octopus.
3Wpisz adres e-mail podany w formularzu.
4W polu Aktywny wybierz Tak.
5W polu PIM wybierz Tylko odczyt.
6W polu OMS wybierz Tylko odczyt.
7Kliknij Dodaj.

Formularz nowego klucza API IdoSell z uprawnieniami tylko do odczytu

Po utworzeniu klucza wróć na stronę users-api.php i kliknij Edytuj.

Kliknij Pokaż klucz, skopiuj go i wklej do formularza.

Shopify API

Integracja Data Octopus ze sklepem Shopify wymaga utworzenia dedykowanej aplikacji w panelu administracyjnym. Zapewnia ona bezpieczny dostęp do danych tylko do odczytu za pomocą klucza API.

Krok 1: Przejdź do ustawień aplikacji

W lewym dolnym rogu kliknij Settings (Ustawienia).

W menu ustawień wybierz Apps and sales channels (Aplikacje i kanały sprzedaży).

Sekcja Apps and sales channels w ustawieniach Shopify

Krok 2: Otwórz panel deweloperski

W prawym górnym rogu kliknij Develop apps (Rozwijaj aplikacje).

Następnie kliknij Build apps in Dev Dashboard.

Krok 3: Utwórz i nazwij nową aplikację

Kliknij Create app (Utwórz aplikację) w prawym górnym rogu.

Przycisk Create app w panelu deweloperskim Shopify

W polu App name wpisz DataOctopus, żeby łatwo rozpoznać, komu nadano dostęp, i kliknij Create.

Krok 4: Skonfiguruj uprawnienia (API Scopes)

To najważniejszy krok. W panelu konfiguracji aplikacji przewiń do sekcji Access (Dostęp).

Sekcja Access w konfiguracji aplikacji Shopify

W polu Scopes wklej poniższą listę uprawnień – zapewnia dostęp tylko do odczytu wymaganych danych:

Scopes
read_analytics, read_gift_cards, read_customers, read_orders, read_products

Krok 5: Zapisz i zainstaluj aplikację

Po wklejeniu uprawnień kliknij Release w prawym dolnym rogu.

Przycisk Release w konfiguracji aplikacji Shopify

W nowym oknie ponownie kliknij Release, bez wypełniania dodatkowych pól.

Na stronie głównej aplikacji kliknij Install app w prawym górnym rogu.

Potwierdź instalację, klikając Install.

Potwierdzenie instalacji aplikacji DataOctopus

Zainstalowana aplikacja DataOctopus w Shopify

Krok 6: Skopiuj klucz API oraz adres sklepu

Po instalacji Shopify wyświetli klucz API. Jeśli zamkniesz to okno, wróć do Settings > Apps and sales channels > Develop apps i wybierz aplikację DataOctopus.

Aplikacja DataOctopus na liście aplikacji Shopify

W sekcji Credentials skopiuj Admin API access token i wklej go do formularza rejestracyjnego Data Octopus.

Admin API access token jest unikalny i niezbędny do ukończenia integracji.

Sekcja Credentials z Admin API access token

Na koniec w Settings > Store details znajdziesz adres sklepu w formacie nazwa-sklepu.myshopify.com. Skopiuj go i również wklej do formularza.

Adres sklepu myshopify.com w Store details

Shoper API

Integracja Data Octopus z Shoperem wymaga utworzenia w panelu Integracji Zewnętrznej, która zapewnia dostęp do danych za pomocą Tokenu API.

Krok 1: Rozpocznij dodawanie nowej integracji

1Z panelu bocznego wybierz Dodatki i integracje (1).
2Kliknij Integracje zewnętrzne (2).
3W prawym górnym rogu kliknij Dodaj integrację (3).

Integracje zewnętrzne i przycisk Dodaj integrację w Shoperze

Krok 2: Uzupełnij ustawienia podstawowe

1Narzędzie: wybierz Inne (1).
2Nazwa integracji: wpisz DataOctopus Integration (2), żeby łatwo rozpoznać, komu nadano dostęp.
3Opis: opcjonalnie (zalecane), np. „Integracja danych DataOctopus <> Shoper” (3).

Ustawienia podstawowe integracji w Shoperze

Krok 3: Nadaj uprawnienia integracji (odczyt)

W sekcji Uprawnienia integracji dodaj uprawnienie typu odczyt dla każdej z tych kategorii danych:

Zamówienia
Produkty
Producenci
Waluty
Dostawy
Kategorie
Stany dostępności
Statusy zamówień

1W polu Obszar sklepu (1) wybierz jedną z pozycji, np. zamówienia.
2W polu Zakres dostępu (2) zawsze wybierz odczyt.
3Kliknij Dodaj uprawnienie (3).
4Powtarzaj, aż lista zawiera wszystkie 8 pozycji z zakresem odczyt.

Lista uprawnień odczytu integracji w Shoperze

Krok 4: Zapisz i utwórz token

Po nadaniu wszystkich uprawnień przewiń na dół i kliknij Zapisz i utwórz token.

Krok 5: Skopiuj i prześlij Token API

Token API skopiuj natychmiast – po zamknięciu strony nie da się go ponownie podejrzeć. Jeśli zamkniesz ją bez kopiowania, trzeba utworzyć nowy token.

1Skopiuj Client ID i Token API.
2Wklej oba do formularza wdrożeniowego Data Octopus.
3Kliknij Rozumiem (1).

Podsumowanie z Client ID i Tokenem API w Shoperze

PrestaShop API

Krok 1: Przejdź do ustawień i włącz Webservice

Krok 2: Utwórz klucz dostępu do API

Otwórz stronę Webservice w menu Advanced Parameters i kliknij Add new webservice key. W otwartym oknie:

1Kliknij Generuj, aby wygenerować nowy klucz – wyślij go w formularzu rejestracyjnym od Data Octopus.
2W opisie wpisz informację, kto korzysta z klucza, np. „Aplikacja DataOctopus”.
3Ustaw status na YES – to włącza klucz.
4W uprawnieniach zaznacz wszystkie metody w kolumnie GET.

Aplikacja Data Octopus nie wprowadza żadnych zmian w danych – jedynie je pobiera i wykorzystuje do analiz.

Klucz Webservice w PrestaShop z uprawnieniami GET

Google Analytics 4

Aby dodać dane z Google Analytics 4 do aplikacji Data Octopus, po wejściu do panelu:

1Kliknij sklep, do którego chcesz dodać dane.
2Przejdź do sekcji Sources.
3Wybierz Google Analytics 4.

Sekcja Sources w aplikacji Data Octopus z kafelkiem Google Analytics 4

Po kliknięciu w Google Analytics 4 z prawej strony pojawi się pole, w którym należy wpisać identyfikator usługi Google Analytics – Property Id.

Pole Property Id w panelu dodawania Google Analytics 4

Aby sprawdzić numer usługi w Google Analytics 4, w panelu przejdź do sekcji Admin w lewym dolnym rogu.

Przycisk Admin w lewym dolnym rogu Google Analytics 4

Następnie wejdź w ustawienia (1), a w sekcji ustawień usługi kliknij szczegóły usługi (2). Numer jest w prawym górnym rogu (3). Skopiowany identyfikator usługi podaj w formularzu.

Szczegóły usługi w Google Analytics 4 z identyfikatorem usługi

Po uzupełnieniu identyfikatora kliknij Add i potwierdź dostęp kontem Google, które ma dostęp do usługi co najmniej na poziomie Viewer.

Okno logowania Google przy potwierdzaniu dostępu do Google Analytics 4

Zatwierdzając dostęp, zaznacz checkbox „See and download your Google Analytics data”.

Zgoda „See and download your Google Analytics data”

Google Ads

Aby dodać dane z Google Ads do aplikacji Data Octopus, po wejściu do panelu:

1Kliknij sklep, do którego chcesz dodać dane.
2Przejdź do sekcji Sources.
3Wybierz Google Ads.

Sekcja Sources w aplikacji Data Octopus z kafelkiem Google Ads

Po kliknięciu w Google Ads z prawej strony pojawi się miejsce, w którym należy wpisać:

Identyfikator konta Google Ads.
Identyfikator Managera Kont – tylko jeśli konto jest zarządzane przez Managera Kont. Jeśli autoryzujący ma bezpośredni dostęp do konta Google Ads, zostaw to pole puste.

Pola identyfikatora konta i Managera Kont w panelu Google Ads

Po uzupełnieniu identyfikatora kliknij Add i potwierdź dostęp kontem Google, które ma dostęp do konta co najmniej na poziomie Viewer.

Potwierdzenie dostępu do Google Ads kontem Google

Numer konta reklamowego znajdziesz w prawym górnym rogu panelu głównego Google Ads.

Meta Ads

W głównym panelu Business Managera w lewej kolumnie wybierz Accounts, a następnie zakładkę Ad Accounts. W kolumnie Name znajdziesz nazwę konta reklamowego, a pod nią jego numer (ID).

Widok kont reklamowych w Business Managerze

Lista kont reklamowych w Business Managerze z numerem ID

Drugi sposób to panel reklamowy: w lewym górnym rogu kliknij rozwijaną listę i skopiuj numer widoczny pod nazwą konta.

Panel reklamowy Meta Ads

Numer konta reklamowego w rozwijanej liście Meta Ads Managera

W wiadomości e-mail do Product Experta podaj numer konta razem z kodem kraju, na który przeznaczone jest konto.