Integracje

• API 1koszyk
• Cloudflare Turnstile - Instalacja widgetu dla własnej domeny sprzedawcy
• Facebook/Meta - weryfikacja domeny
• Facebook/Meta - konfiguracja Pixel ID
• Facebook/Meta - konfiguracja API konwersji
• Google Tag (Google Analytics 4, Google Ads)
• Google - raportowanie zdarzeń (Google Analytics 4, Google Ads)
• Jak zainstalować widget na stronie?
• Czy instalacja widgetu jest konieczna, aby móc sprzedawać produkt?
• Jak zintegrować 1koszyk z Wix

API 1koszyk

Dokumentacja API dostępna jest pod adresem:
https://www.1koszyk.pl/api/index.html

Klucz API generowany jest w panelu administracyjnym, w zakładce "Konfiguracja" > "Klucze API"

Cloudflare Turnstile - Instalacja widgetu dla własnej domeny sprzedawcy

1. Otwórz stronę https://dash.cloudflare.com/sign-up i utwórz konto wybierając jedną z dostępnych opcji.

2. Na kolejnych 2 ekranach możesz wybrać Twój profil użytkowania usługi lub pominąć ten krok

3. W panelu usługi Cloudflare, w lewym menu wybierz „Aplication security” > „Turnstile”
   

4. Wprowadź dowolną własną nazwę widgetu

5. Przyciśnij „Add Hostnames”

   
   

    

6. W polu „Add a custom hostname” wprisz nazwę domeny ustawionej jako domyślna domena sklepu 1koszyk
   Znajdziesz ją w zakładce "Konfiguracja" > "Opcje koszyka" Panelu administracyjnego 1koszyk.
   Następnie przyciśnij „Add” oraz zatwierdź ponownie przyciskiem „Add” u dołu formularza
   

7. Stwórz widget Turnstile naciskając „Create” u dołu formularza

8. Skopiuj wartości wyświetlone w polach „Site Key” i „Secret Key” 
   
   

9. Wklej je w odpowiadające im pola w zakładce "Konfiguracja" > "Integracje" panelu 1koszyk

   

Facebook/Meta - weryfikacja domeny

1. W Menedżerze firmy facebook https://business.facebook.com/ opcję "Ustawienia"
   
   
   
   

2. przejdź do zakładki „Bezpieczeństwo marki” > „Domeny”

3. W prawym górnym rogu kliknij „Dodaj”
   
   
    

4. Kliknij polecenie „Utwórz domenę”
   
   
   
   

5. Wpisz domenę Twojego serwisu 1koszyk, jak np. „test.1ct.eu”. Pamiętaj, aby wpisać samą domenę, bez prefiksu „https://”

6. Kliknij "Dodaj"
   
   
   
   

7. Z dostępnych opcji weryfikacji, wybierz „1. Skopiuj ten meta-znacznik”

8. Skopiuj sam kod znacznika zawarty w cudzysłowiu content=”kodznacznika”
   
   
   
   

9. Przejdź do panelu 1koszyk, do zakładki „Konfiguracja” > „Integracje”

10. W sekcji „Facebook Pixel” wklej skopiowany znacznik do pola „Facebook: Kod weryfikacyjny domeny”

11. Zapisz zmiany przyciskiem w prawym dolnym rogu formularza
    
    
    
    

12. Wróć do Managera firmy Facebook i przyciśnij przycisk „Zweryfikuj domenę” znajdujący się u dołu strony.
    
    
    

Facebook/Meta - konfiguracja Pixel ID

1. W Menedżerze firmy facebook https://business.facebook.com/ przejdź do zakładki „Źródła danych” > „Zestawy danych i pixele”

2. W prawym górnym rogu kliknij „Dodaj”
   
   
   

3. Wprowadź nazwę zestawu danych, np. "1koszyk-pixel" 
4. Kliknij "Utwórz" 
   
   
   
   
5. W na stronie szczegółów pixela przejdź do zakładki "Ustawienia"
6. Skopiuj identyfikator zestawu danych
   
   
   

7. Przejdź do panelu 1koszyk, do zakładki „konfiguracja” > „Integracje”

8. W sekcji „Facebook Pixel” wklej skopiowany znacznik do pola „Facebook: Pixel ID”

9. Zapisz zmiany przyciskiem w prawym dolnym rogu formularza
   
   
   

Facebook/Meta - konfiguracja API konwersji

1.  Po zakończeniu konfiguracji Pixel ID pojawia się następująca warstwa strony umożliwiająca przejście do menedżera zdarzeń, możesz opcjonalnie wybrać opcję w menu lub przejść bezpośrednio na stronę: https://business.facebook.com/events_manager2/
   
   
   
   
2. W menedżerze zdarzeń wybierz "Zestawy danych", wskaż konfigurowany zestaw danych, a a następnie w sekcji "Prześlij zdarzenia z serwera" wybierz "Skonfiguruj API konwersji"
   
   
   
   
3. Wybierz ręczną konfigurację i kliknij "Dalej"
   
   
   
   
4. Wybierz opcję "API konwersji i piksel Meta" i kliknij "Dalej"
   
   
   
   
5. Wybierz "Rozpocznij konfigurację CAPI" i klioknij "Zakończ", jeżeli warstwa nie zamknie się automatycznie, zamknij ją klikając "x"
   
   
   
6. Przejdź kolejne kroki konfiguracji zdarzeń
   
   
   
   
   
7. Wybierz zdarzenia "Dodanie do koszyka", "Przejście do kasy" oraz "Zakup"
   
   
   
   
   
8. Dla powyższych zdarzeń wybierz dodatkowe parametry (ilustracja w pkt. 9 poniżej) klikając w link "Wybierz dodatkowe parametry zdarzenia". W przypadku zdarzenia "Zakup" część opcji może być zaznaczona domyślnie. 
   Zaznacz także opcje "Plik cookie identyfiaktora (fbc) .." i "Plik cookie identyfiaktora (fbp) .."
   
   
   
   
9. Wybierz dodatkowe parametry zdarzenia
   
   
   
   
10. Po skonfigurowaniu każdego z trzech zdarzeń, sprawdź poprawność konfiguracji i przyciśnij "Kontynuuj"
    
    
    
    
11.  Przyciśnij "Kontynuuj"
    
    
    
    
12. Wybierz "Skonfiguruj bez "Dataset Quality API" i kliknij "Wygeneruj token dostępu"
    
    
    
    
13. Skopiuj token
    
    
    
    
14. Przejdź do panelu administracyjnego 1koszyk, wybierz opcję "Konfiguracja" > "Integracje".
    W sekcji "Facebook Pixel" wklej token. Następnie zapisz formularz przyciskiem w prawym dolnym rogu.
    
    
    
    

Google Tag (Google Analytics 4, Google Ads)

1. Jeżeli nie posiadasz konta Google Analytics załóż je na stronie: Analytics Tools & Solutions for Your Business - Google Analytics, w przeciwnym razie dodaj do swojego konta kolejną usługę lub użyj istniejącej.
   
   
2. Skopiuj identyfikator Google Tag. Znajdziesz go na głównym ekranie nowo utworzonej usługi 
   
   
   
   lub kliknij w ikonkę koła zębatego (Administracja) w lewym dolnym rogu, a następnie w zakładkę "Strumienie Danych" 
   
   
   
   
3. Kliknij w wybrany strumień danych. Identyfikator znajdziesz w sekcji "Szczegóły strumienia" po prawej stronie
   
   
   
   
4. Wklej skopiowany identyfikator w panelu administracyjnym platformy 1koszyk w zakładce "Konfiguracja" > "Integracje" w polu "Identyfikator źródła danych" i zapisz formularz
   
   
   

Google - raportowanie zdarzeń (Google Analytics 4, Google Ads)

Raportowanie zdarzeń pozwala mierzyć efektywność sprzedaży Twojego sklepu 1koszyk oraz optymalizować kampanie reklamowe. Aby przekazywać do Google informacje o zdarzeniach wykonaj następujące kroki:

1. W swojej usłudze Google Analytics  kliknij w ikonkę koła zębatego (Administracja) w lewym dolnym rogu, a następnie w zakładkę "Strumienie Danych"
   
   
   
   
2. Kliknij w wybrany strumień danych.
   
   
3. Kliknij w zakłądkę "Tajne klucze API platformy Measurement Protocol"
   
   
   
   
4. Przeczytaj i potwierdź warunki
   
   
   
   
5. Utwórz klucz
   
   
   
   
6. Nadaj mu swoją nazwę / pseudonim
   
   
   
   
7. Skopiuj wartość klucza
   
   
   
   
8. Wklej skopiowaną wartość w panelu administracyjnym platformy 1koszyk w zakładce "Konfiguracja" > "Integracje" w polu "Identyfikator źródła danych" i zapisz formularz
9. Zapisz formularz

Jak zainstalować widget na stronie?

Aby dodać widget 1koszyk, należy w panelu administratora wybrać zakładkę "Konfiguracja" > "Integracje".

W sekscji "Widget koszyka" znajduje się skrypt, który należy skopiować i wkleić w kodzie HTML strony/bloga.

Opcjonalnie można tzw. wklejkę zamieścić poprzez usługę Google Tag Manager. Skutkuje ona wyświetleniem się widgetu, czyli rozwijającego się okienka koszyka z dodanymi produktami.

Gdy nie korzystamy z Google Tag Managera - tylko wklejamy kod HTML ręcznie - należy wkleić go przed tagiem </body>

Czy instalacja widgetu jest konieczna, aby móc sprzedawać produkt?

Widget jest opcjonalny. Aby sprzedawać produkt, wystarczy na stronie umieścić link sprzedażowy pobrany z panelu 1koszyk.

W przypadku linku na stronie bez widgetu jego kliknięcie spowoduje otwarcie nowej strony z koszykiem zawierającym wybrany produkt.

Zastosowanie widgetu

Jak zintegrować 1koszyk z Wix

1koszyk umożliwia sprzedaż poprzez linki. Wystarczy pobrać wygenerowany w panelu administracyjnym link do sprzedaży i umieścić go w stronie Wix. Link może zostać podpięty w dowolny sposób, jako przycisk, URL obrazka czy jako fragment tekstu. 

Film instruktażowy - Wix - Sprzedaż przez 1koszyk bez widgetu


W wersji płatnej Wix umożliwia osadzanie skryptów, dzięki czemu można na stronie wyświetlić widget koszyka.
Krótki kod jak ten (Konfiguracja/Opcje koszyka):  <script id="onecart" src="https://identyfikatorkoszyka.1ct.eu/assets/front/embeded.bundle.js" async></script>należy wkleić w źródło swojej strony (gdzie identyfiaktorkoszyka to Twój unikalny ID). 

Miejsce wklejenia niestandardowego kodu z widgetem w panelu administracyjnym Wix

Pełną instrukcję Wix dot własnego kodu można znaleźć tutaj: https://support.wix.com/en/article/embedding-custom-code-on-your-site.

Film instruktażowy - Wix - Sprzedaż przez 1koszyk z widgetem