Pokazuj swoje produkty i zakupy Shopify.

Shopify w Social Stream Ninja

Promuj publiczne produkty za pomocą obrazów, cen, czytelnych linków i kodów QR. Odbieraj podpisane powiadomienia o opłaconych zamówieniach jako purchase alerty w kanale aktywności, multi-alerts i Event Flow. Promocja produktów działa niezależnie od alertów płatności.

Połącz zakupy · Importuj produkty · Nakładki OBS · Testuj bezpiecznie · Limity i rozwiązywanie problemów

Dostępność: automatyczne alerty wymagają wdrożenia i włączenia odbiornika Shopify w API SSN. Jeśli jest niedostępny, Save setup zgłasza błąd i nie włącza Shopify. Import publicznych produktów i ręczna promocja działają niezależnie. Ten poradnik opisuje kod integracji; zanim będzie można uznać usługę za sprawdzoną na żywo, nadal potrzebny jest test z rzeczywistym sprzedawcą.

Połącz opłacone zakupy

1. W Shopify otwórz Settings → Notifications → Webhooks. Znajdź sekret podpisujący wyświetlany dla ręcznie utworzonych webhooków. To co innego niż token Storefront.
2. W SSN otwórz Monetization → Shopify purchases → Setup. Wpisz swoją stałą your-store.myshopify.com domenę i sekret podpisujący webhook. Włącz zakupy Shopify, a następnie kliknij Zapisz konfigurację.
3. Kliknij Kopiuj adres odbiornika. W Shopify utwórz webhook ze zdarzeniem Order payment, format JSONi tego adresu odbiornika. Wybierz obsługiwaną stabilną wersję API webhooków; tę integrację opracowano zgodnie z kontraktem zamówień 2026-07.
4. Zapisz webhook Shopify. Pozostaw SSN włączone, aby przetwarzać zakupy. Przed przyjęciem danych zamówienia odbiornik weryfikuje HMAC surowej treści żądania oraz zgodność sklepu.

Sekret podpisujący jest szyfrowany w odbiorniku SSN i po zapisaniu usuwany z pola. Oddzielny prywatny klucz odczytu pozostaje na tym urządzeniu. Żaden z nich nie trafia do linków OBS ani kodów QR dla widzów. Shopify używa własnego odbiornika; starszy przełącznik zdalnego sterowania przez API nie jest potrzebny.

Wygenerowany adres URL oznacza zapisanie konfiguracji, a nie dostarczenie czegokolwiek przez Shopify. Status rozróżnia oczekiwanie, zweryfikowany test, pominięte zdarzenie i otrzymany zakup. Zmiana sklepu wymaga wcześniejszego użycia Disconnect. Wyłączenie Shopify wstrzymuje lokalne przetwarzanie; Disconnect usuwa odbiornik i zdarzenia w kolejce. Przy rozłączaniu usuń odpowiadający mu webhook Shopify.

Shopify: ręczne tworzenie webhooków · Shopify: weryfikowanie dostarczeń

Importuj publiczny produkt

1. Wpisz swoją myshopify.com domenę w konfiguracji Shopify. Aby importować produkty, nie musisz włączać alertów zakupów ani wpisywać sekretu podpisującego.
2. Rozwiń Importuj produkt, wklej publiczny adres produktu i kliknij Wczytaj szczegóły produktu.
3. Jeśli dostęp bez tokenu nie udostępnia produktu, podaj publiczny token Storefront. Możesz go utworzyć w kanale Headless Shopify. Opublikuj produkt w tej witrynie sklepowej i w Online Store. Nie wklejaj tokenu Admin API ani prywatnego tokenu Storefront.
4. SSN otwiera istniejący Produkty i linki wsparcia edytor z tytułem, obrazem, ceną i kanonicznym publicznym linkiem zwróconymi przez Shopify. Sprawdź je, kliknij Dodaj produkt lub link, włącz katalog i Zapisz konfigurację.

Import odczytuje jeden produkt naraz przez Storefront API. Token jest opcjonalny, służy tylko do tego żądania, a następnie jest usuwany. Kanoniczny adres Online Store zwrócony przez Shopify staje się publicznym linkiem, również z własną domeną, jeśli Shopify ją zwróci. Niedostępne produkty i produkty bez publicznego linku Online Store są pomijane.

Cena jest uzupełniana tylko wtedy, gdy minimalna i maksymalna cena wariantów produktu są takie same. W przeciwnym razie pozostaje pusta; samodzielnie wybierz konkretną cenę tylko wtedy, gdy dokładnie opisuje ofertę. Importowane informacje są migawką, a nie ciągłą synchronizacją stanów magazynowych lub cen. Sprawdzaj je po zmianach w sklepie. Zawsze możesz zamiast tego wprowadzić produkt ręcznie.

Uwierzytelnianie Shopify Storefront · Zapytanie o produkt · Tworzenie publicznego tokenu za pomocą Headless

Użyj istniejących nakładek

W sekcji Link nakładki dla, wybierz Produkty i linki wsparcia. Użyj Tylko prezentacja produktów do obrazów, cen i kodów QR, Tylko karta wsparcia , aby pokazywać mały stały lub okresowy link do sklepu, albo Tylko alerty aktywności do zakupów. Skopiuj każdy wybrany link OBS do oddzielnego źródła przeglądarkowego, zaczynając od rozmiaru 800 × 600.

Ustaw opcjonalny filtr źródła alertów na shopify , aby w ogólnej nakładce monetyzacji pokazywać tylko aktywność Shopify. Włącz Products & support links dla tego ogólnego widoku. Istniejące multi-alerts i kanał aktywności odbierają zakupy Shopify niezależnie od katalogu produktów.

Karty produktów prowadzą do publicznych stron produktów. Użyj Kopiuj publiczny link , aby udostępnić klikalny adres na czacie, i przetestuj kod QR telefonem przy docelowym rozmiarze transmisji. Alert zakupu nigdy nie pobiera kodu QR ani obrazu z niezwiązanego produktu pokazywanego rotacyjnie. Webhooki zamówień nie dostarczają wiarygodnych adresów obrazów produktów, więc alerty zakupów używają tekstu; zaimportowane karty promocyjne mogą pokazywać obrazy.

W Event Flow wybierz Event Type purchase i filtruj źródło/typ według shopify. Porównaj meta.commerce.orderTotal do reguł wartości zamówień i sprawdź meta.commerce.currency przed porównaniem kwot. To zakupy: nie jest emitowane hasDonation lub donoValue , a cele wpłat nie rosną. Karta promocyjna z etykietą Gift nie zmienia klasyfikacji zdarzeń zamówień. Wysyłka do innej osoby nie jest dowodem prezentu dla twórcy.

Bezpieczny podgląd i testowanie

Podgląd przykładu otwiera odizolowaną przykładową nakładkę bez połączenia z sesją. Nigdy nie uruchamia Event Flow, nie zmienia sum ani nie weryfikuje płatności.

Zamówienia Shopify jawnie oznaczone jako test: true są potwierdzane i pokazywane jako testy w statusie odbiornika, bez alertów zakupów ani akcji. Brak flag testowych, zamówienia nieopłacone lub częściowo opłacone, anulowane, z zerową sumą oraz ze starymi lub nieprawidłowymi znacznikami czasu również są pomijane. Do testowania całego przebiegu użyj sklepu deweloperskiego. Przykładu z panelu administratora bez wiarygodnej flagi testowej nie należy wysyłać do aktywnego przepływu nagród; bezpiecznym sposobem sprawdzenia wyglądu jest podgląd SSN.

Co sprawdziliśmy bez sklepu

Testy w izolowanym środowisku obejmują rzeczywiste dostarczanie HTTP z podpisanym JSON-em Unicode, zmienione podpisy, powtórzone dostarczenia, izolację zamówień testowych, precyzję walut, zbyt duże żądania, usuwanie prywatnych danych klientów oraz odzyskiwanie po pracy offline przez rzeczywiste środowisko SSApp. Te sprawdzenia nie składają zamówień ani nie wymagają konta sprzedawcy.

Produkcyjny odbiornik Shopify pozostaje wyłączony do czasu testu dostarczenia z prawdziwego sklepu. Ręczna promocja produktów działa niezależnie. Przykładowe webhooki Shopify CLI mogą pomóc przetestować obsługę danych, ale nie weryfikują subskrypcji ani ponowień i nadal wymagają danych uwierzytelniających aplikacji. Zobacz Ograniczenia testowania webhooków w Shopify CLI.

Limity dostarczania i rozwiązywanie problemów

• Odbiornik niedostępny: operator API SSN musi wdrożyć i włączyć odbiornik Shopify. Zobacz konfiguracja serwera. Nie zastępuj go starszym, niepodpisanym adresem webhooka sesji.
• Oczekiwanie na zdarzenie: sprawdź Order payment, JSON, dokładny adres odbiornika, zgodność stałej domeny sklepu i sekret podpisujący tego webhooka. Webhook niestandardowej aplikacji używa sekretu podpisującego tej aplikacji, a nie sekretu ręcznych powiadomień Notifications.
• Podpisane zdarzenie pominięte: ta integracja wymaga w pełni opłaconego zamówienia o dodatniej wartości, test: false oraz podpisanej treści updated_at z ostatnich siedmiu dni (z tolerancją pięciu minut dla czasu w przyszłości). Integracja nie wnioskuje o płatności na podstawie utworzenia zamówienia, realizacji ani stanu magazynowego.
• SSN było offline: przyjęte zdarzenia są przechowywane w kolejce do siedmiu dni. Uruchom ponownie SSN, aby wznowić pracę. Status i oczekujące zadania przetrwają ponowne uruchomienie odbiornika. Usługa ma ograniczoną przestrzeń i prosi Shopify o ponowienie, gdy nie może trwale zapisać zadania w kolejce.
• Duplikaty: odbiornik usuwa duplikaty według sklepu i zamówienia, nawet jeśli identyfikatory dostarczeń Shopify są różne. Rekordy deduplikacji są przechowywane przez siedem dni. SSN trwale zapisuje obsłużone identyfikatory przed potwierdzeniem odbioru. Awaria między zewnętrzną akcją a tym zapisem nadal może spowodować powtórzenie akcji; przy automatyzacji o istotnych skutkach zastosuj własne zabezpieczenie idempotencji.
• Brak imienia kupującego: to celowe. SSN pomija imiona i nazwiska klientów, e-maile, adresy, notatki do zamówień, niestandardowe właściwości pozycji, adresy finalizacji zakupu oraz surowe identyfikatory zamówień. Publiczne tytuły produktów pozostają zwykłym tekstem.
• Zwroty lub zmiany zamówień: to kanał alertów na żywo, a nie system księgowy ani realizacji zamówień. Zwroty, anulowania i zmiany sum nie cofają wcześniejszych alertów. Nie obejmuje uzgadniania historii zamówień ani automatycznego usuwania produktów.

Zobacz Kontrakt zdarzeń Shopify i wspólny poradnik produktów i kodów QR.