Identyfikatory i warianty produktów#
Cel witryny sklepu musi identyfikować ten sam produkt co katalog sprzedawcy. Większość awarii integracji wynika z niezgodności między tymi dwiema wartościami.
Wybór stabilnego identyfikatora#
Użyj productCode wyświetlanego dla przygotowanego produktu. W poradniku Shopify jest to SKU wariantu. Pola żądań Product Import API są zdefiniowane w referencji importu; nie zastępuj tych nazw pól nazwami atrybutów witryny sklepu.
Zachowuj identyfikatory identyczne, w tym wielkość liter. Nie generuj ich ze zmiennych nazw wyświetlanych ani nie zakładaj, że wewnętrzny identyfikator produktu platformy jest równy SKU.
Mapowanie wybranego wariantu#
| Stan witryny sklepu | Zachowanie celu |
|---|---|
| Wybrano przygotowany wariant | Ustaw jego dokładny productCode |
| Wybór się zmienia | Zaktualizuj cel i wyczyść przestarzały stan SDK zgodnie z przewodnikiem integracji |
| Brak SKU lub odpowiadającego produktu | Utrzymuj przycisk utworzony przez autora ukryty lub nieaktywny |
| Karta produktu wskazuje na wariant domyślny | Spójnie używaj identyfikatora tego wariantu |
Dla Shopify podłącz pomocniczą funkcję synchronizacji z poradnika do rzeczywistego wywołania zwrotnego zmiany wariantu w motywie. Dla innych witryn sklepu postępuj zgodnie z stronami dynamicznymi.
Walidacja mapowania#
Wybierz dwa warianty z wyraźnie różnymi produktami. Zarejestruj ich kody katalogowe, sprawdź każdy wyrenderowany data-product-code w narzędziach developerskich przeglądarki, a następnie otwórz Viewer dla każdego. Powtórz po nawigacji bez pełnego przeładowania strony.
Gdy identyfikator zmieni się w systemie źródłowym, skoordynuj import katalogu z wdrożeniem witryny sklepu. Pomyślna odpowiedź HTTP na import oznacza jedynie przyjęcie żądania; sprawdź status zadania oraz błędy poszczególnych produktów, zanim zaczniesz polegać na nowym kodzie.