Data Octopus
Demo
Spis treści
Sklepy

Shopify

Zamówienia i ich pozycje, produkty, warianty oraz dane klientów zawarte w zamówieniach.

Opis integracji

Widoki danych — Silnik e-commerce

ProduktyMarkiKategorieZwroty

Obecna dokumentacja tych widoków opisuje dane i zasady raportów IdoSell.

Sklepy z kilkoma rynkami są ładowane jako osobne zestawy tabel per rynek (np. PL, DE, FR, IT).

Jak podłączyć integrację

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).

Przycisk Settings w panelu Shopify
Przycisk Settings w panelu Shopify

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

Sekcja Apps and sales channels w ustawieniach Shopify
Sekcja Apps and sales channels w ustawieniach Shopify

Krok 2: Otwórz panel deweloperski

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

Przycisk Develop apps w Shopify
Przycisk Develop apps w Shopify

Następnie kliknij Build apps in Dev Dashboard.

Przycisk Build apps in Dev Dashboard
Przycisk 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
Przycisk Create app w panelu deweloperskim Shopify

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

Pole App name z nazwą DataOctopus
Pole App name z nazwą DataOctopus

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
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
Przycisk Release w konfiguracji aplikacji Shopify

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

Okno potwierdzenia Release
Okno potwierdzenia Release

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

Przycisk Install app w Shopify
Przycisk Install app w Shopify

Potwierdź instalację, klikając Install.

Potwierdzenie instalacji aplikacji DataOctopus
Potwierdzenie instalacji aplikacji DataOctopus
Zainstalowana aplikacja DataOctopus w Shopify
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
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
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
Adres sklepu myshopify.com w Store details
Instrukcja nadawania dostępów: wszystkie źródła w jednym miejscu

Pobierane zasoby

Zamówienia
orders

Nagłówki zamówień z klientem, adresami, sumami, rabatami i źródłem ruchu.

Pozycje zamówień
orders_products

Produkty w każdym zamówieniu.

Produkty
products

Katalog produktów.

Warianty
product_variants

Rozmiary, kolory i inne warianty z ceną i stanem.

Zamówienia

  • Nazwa i id zamówienia, daty utworzenia, aktualizacji, przetworzenia, zamknięcia i anulowania, powód anulowania, flaga testowa.
  • Status: finansowy (opłacone, zwrócone…), realizacji, zwrotu.
  • Sumy (w walucie sklepu i prezentacji): suma częściowa, suma, podatek, rabaty, wysyłka, napiwki, zwrócone, otrzymane, do zapłaty.
  • Kody rabatowe, tagi, notatka, źródło zamówienia, metoda wysyłki (nazwa, kod, źródło).
  • Klient: id, imię i nazwisko, e-mail, liczba zamówień, wydana kwota, zgoda marketingowa.
  • Adres rozliczeniowy i dostawy (imię i nazwisko, firma, ulica, miasto, region, kraj, kod, telefon, współrzędne).
  • Źródło ruchu: strona wejścia, referrer, parametry UTM (source, medium, campaign, term, content), ostatnia wizyta.
  • Zwroty, spory, warunki płatności, bramki płatności.

Pozycje zamówień

  • Nazwa produktu i wariantu, SKU, ilość, ilość bieżąca i możliwa do zwrotu.
  • Cena jednostkowa, cena po rabacie, sumy, rabaty, pozycje podatkowe (stawka, nazwa).
  • Powiązanie z produktem (id, handle, dostawca, typ, tagi), flagi karty podarunkowej i wymaganej wysyłki.

Produkty

  • Tytuł, handle, dostawca, typ produktu, tagi, opis, tytuł i opis SEO.
  • Opcje (np. rozmiar i kolor) i ich wartości.
  • Zakres cen, zakres cen przed obniżką, łączny stan, kategoria (pełna ścieżka w taksonomii Shopify).
  • Status i daty (utworzenia, aktualizacji, publikacji).

Warianty

  • Tytuł, SKU, kod kreskowy, cena, cena przed obniżką, dostępność do sprzedaży, stan i ilość możliwa do sprzedaży, pozycja.
  • Wybrane opcje, opodatkowanie i kod podatkowy, polityka stanów, waga, jednostka ceny, profil dostawy.
PoprzedniaShoperNastępnaPlik produktowy