Jak zintegrować z OpenCart

Czego się dowiesz?

Dowiedz się, jak zintegrować OpenCart z Klaviyo. Po wykonaniu tych kroków będzie można personalizować i targetować e-maile na podstawie zakupów i aktywności każdego klienta na stronie. Integracja OpenCart synchronizuje się co godzinę.

Kilka słów na początek

Pamiętaj, że Klaviyo nie synchronizuje Twojego katalogu z OpenCart.

Dodaj integracje z OpenCart

Proces dodawania integracji OpenCart z Klaviyo składa się z wielu kroków i wymaga wykonania działań zarówno w OpenCart, jak i w Klaviyo.

Aby rozpocząć, Klaviyo obsługuje obecnie OpenCart 1.4.x i 1.5.x. Pobierz moduł Klaviyo dla OpenCart stąd: https://www.klaviyo.com/media/downloads/OpenCartKlaviyo-1.1.0.tgz.

1. Rozpakuj plik do katalogu głównego instalacji OpenCart.
2. Zaloguj się do panelu administracyjnego OpenCart i przejdź do strony Rozszerzenia > Moduły.
3. Zainstaluj moduł Klaviyo, a następnie kliknij Edytuj przy module Klaviyo.
4. Ostatnią rzeczą, którą należy zrobić w instalacji OpenCart, jest skopiowanie i wklejenie następującego kodu PHP na końcu pliku `upload/index.php`, tuż przed wierszem `$response->getOutput();`:

// [Klaviyo] Save customer cart if it exists.
if ($registry->get('cart')->hasProducts()) {
  $registry->get('load')->model('module/klaviyo');

  if ($registry->get('customer')->isLogged()) {
    $registry->get('model_module_klaviyo')->saveCustomerCart(
      session_id(),
      $registry->get('customer')->getId(),
      $session->data['cart']
    );
  } else if (array_key_exists('guest', $session->data)) {
    $registry->get('model_module_klaviyo')->saveGuestCart(
      session_id(),
      $session->data['guest'],
      $session->data['cart']
    );
  }
}

1. W Klaviyo wybierz kartę Integracje.
2. Kliknij Przeglądaj aplikacje i wyszukaj OpenCart, a następnie kliknij kartę. Następnie kliknij przycisk Zainstaluj.
3. Nastąpi przekierowanie na stronę Ustawienia integracji . Na stronie ustawień wpisz adres URL swojej witryny OpenCart i kliknij Połącz z OpenCart.
   

4. Na następnej stronie skopiuj klucz API w sekcji Klaviyo OpenCart Module i wklej go do ustawień modułu Klaviyo w OpenCart. Zapisz ustawienia modułu Klaviyo w panelu administracyjnym OpenCart.
   

5. Jeśli chcesz, zaznacz ustawienie Dodaj nowych klientów OpenCart do listy Klaviyo, a następnie wybierz listę z menu rozwijanego.
6. Po powrocie do Klaviyo kliknij Dokończ konfigurację , aby rozpocząć synchronizację danych.

Zainstaluj śledzenie aktywności na stronie przez Klaviyo

Aby śledzić aktywność na stronie w OpenCart, najpierw znajdź publiczny klucz API Klaviyo: zaloguj się do konta, kliknij nazwę konta w lewym dolnym rogu, a następnie przejdź do Ustawienia > Klucze API. Publiczny klucz ma sześć znaków. Możesz zainstalować dwa typy śledzenia na stronie:

• Aktywność na stronie
  Ta metryka jest śledzona za każdym razem, gdy możliwa do zidentyfikowania przeglądarka odwiedza Twoją witrynę
• Przeglądany produkt
  Ta metryka jest śledzona za każdym razem, gdy możliwa do zidentyfikowania przeglądarka wyświetli stronę produktu w Twojej witrynie

Dodaj śledzenie "Aktywni na stronie"

Ta metryka jest śledzona za każdym razem, gdy możliwa do zidentyfikowania przeglądarka odwiedza Twoją witrynę. Aby rozpocząć śledzenie aktywności Aktywność na stronie:

1. Dodaj poniższy fragment kodu do głównego szablonu sklepu, aby był uwzględniany na wszystkich stronach. Umieść ten fragment kodu albo razem z innymi skryptami analitycznymi, których używasz, albo tuż przed zamykającym znacznikiem </body>:
   

<script type="text/javascript" async="" src="https://static.klaviyo.com/onsite/js/PUBLIC_API_KEY/klaviyo.js></script>
<script type="text/javascript"> 
//Initialize Klaviyo object on page load
!function(){if(!window.klaviyo){window._klOnsite=window._klOnsite||[];try{window.klaviyo=new Proxy({},{get:function(n,i){return"push"===i?function(){var n;(n=window._klOnsite).push.apply(n,arguments)}:function(){for(var n=arguments.length,o=new Array(n),w=0;w<n;w++)o[w]=arguments[w];var t="function"==typeof o[o.length-1]?o.pop():void 0,e=new Promise((function(n){window._klOnsite.push([i].concat(o,[function(i){t&&t(i),n(i)}]))}));return e}}})}catch(n){window.klaviyo=window.klaviyo||[],window.klaviyo.push=function(){var n;(n=window._klOnsite).push.apply(n,arguments)}}}}(); </script>

1. Pamiętaj, aby zastąpić PUBLIC_API_KEY kluczem API publicznym konta Klaviyo.
2. Jeśli osoby odwiedzające lub klienci mogą tworzyć konta w sklepie, dodaj następujący fragment kodu bezpośrednio pod pierwszym fragmentem kodu:

<script type="text/javascript">
  var klaviyo = window.klaviyo || [];
  {% if user.is_logged_in %}
  klaviyo.identify({
    $email: '{{ user.email }}',
    $first_name: '{{ user.first_name }}',
    $last_name: '{{ user.last_name }}'
    });
  {% endif %}
</script>

1. W zależności od typów szablonów używanych w witrynie składnia {% if user.is_logged_in %} oraz {{ user.email }} prawdopodobnie się różni. Korzystając z dostępnego języka szablonów, sprawdź, czy osoba wyświetlająca bieżącą stronę jest zalogowana. Jeśli tak, wyświetl jej adres e-mail i imię, jeśli jest dostępne. Jeśli nie masz informacji o imieniu, usuń te dwa wiersze oraz końcowy przecinek po wierszu e-maila $email.

Dodaj śledzenie „Viewed Product”

Jeśli chcesz skonfigurować sekwencję porzuconego przeglądania lub tworzyć segmenty na podstawie danych o przeglądaniu produktów, dodaj śledzenie zdarzeń JavaScript dla metryki „Viewed Product”.

1. W szablonie strony produktu dodaj poniższy fragment kodu:

<script type="text/javascript">
    var klaviyo = window.klaviyo || [];
    klaviyo.track("Viewed Product", {
      Title: '{{ product.title }}',
      ItemId: {{ product.id }},
      Categories: {{ category in product.categories|json }}, // The list of categories is an array of strings. 
      ImageUrl: '{{ product.image_url }}',
      Url: '{{ product.url }}',
      Metadata: {
        Brand: '{{ product.brand }}',
        Price: {{ product.price }},
        CompareAtPrice: {{ product.compare_at_price }} // If you have a compare at price. You could also include this for a sale or special price.
      }
  });
</script>

1. Powyższy fragment kodu używa składni symbolu zastępczego {{ }}, która może się różnić w Twoim sklepie OpenCart. Ważne jest to, że pola produktu są renderowane dynamicznie w zależności od tego, którą stronę produktu aktualnie przeglądasz.
2. Po skonfigurowaniu śledzenia Viewed Product dla witryny dane Viewed Product powinny zacząć pojawiać się na koncie Klaviyo, gdy znani odwiedzający przeglądają strony produktów.

Jak działa śledzenie aktywności na stronie

Po dodaniu do witryny funkcji śledzenia aktywności na stronie Klaviyo możemy śledzić tylko aktywność przeglądania „znanych przeglądarek” – tj. przeglądarek, które odwiedziły stronę i zaangażowały się co najmniej raz wcześniej. Istnieją dwa kluczowe sposoby, dzięki którym możemy zidentyfikować osobę odwiedzającą witrynę na potrzeby śledzenia aktywności na stronie:

• Jeśli w którymś momencie ktoś kliknął link w Klaviyo Email, aby przejść na Twoją stronę
• Jeśli w którymś momencie ktoś subskrybował lub wyraził zgodę za pomocą formularza Klaviyo

Klaviyo nie będzie śledzić anonimowych przeglądarek.

Monitoruj synchronizację Klaviyo

Czas potrzebny na zsynchronizowanie wszystkich historycznych danych klientów i zamówień ze sklepu OpenCart zależy od jego wielkości. Po zakończeniu tej synchronizacji historycznej zobaczysz zieloną obwódkę wokół integracje OpenCart w sekcji Włączone integracje.

Aby sprawdzić integrację:

1. Przejdź do karty Metryki na koncie, która znajduje się w sekcji Analityka. Tutaj możesz filtrować, aby wyświetlić wszystkie metryki OpenCart. Znajdź metrykę OpenCart Placed Order i kliknij ikonę Kanału aktywności. Jeśli Twoje integracje rozpoczęły synchronizację danych, zaczniesz tutaj widzieć pojawiające się zdarzenia Złożono zamówienie.
2. Automatycznie zsynchronizujemy wszystkie historyczne dane o zamówieniach. Aby to zweryfikować, można porównać liczbę zdarzeń w określonym dniu w Klaviyo z tym, co jest w interfejsie OpenCart, i potwierdzić, że są takie same.
3. Na przykład podczas analizowania metryki Placed Order możesz najechać kursorem na wczorajszy punkt danych lub sprawdzić tabelę danych poniżej wykresu, aby zobaczyć, ile zamówień zgłoszono wczoraj.
4. Porównaj tę liczbę z tą, która jest zapisana w OpenCart od wczoraj, i powinny się dokładnie zgadzać. Jeśli tak nie jest, problem najprawdopodobniej polega na tym, że strefa czasowa konta Klaviyo nie jest zgodna z ustawioną strefą czasową OpenCart.
5. Aby sprawdzić lub zaktualizować strefę czasową konta:
   • W lewym dolnym rogu kliknij nazwę swojej organizacji.
   • Wybierz Ustawienia.
   • Przejdź do karty Organizacja .

Dane zsynchronizowane z OpenCart

• Dane sprzedaży i zamówień
  Które produkty zostały zakupione, w tym szczegóły produktów i obrazy.
• Informacje o kliencie
  Imię, nazwisko, lokalizacja i grupa klientów.
• Rozpoczęto realizację zakupu
  Używane do wyzwalania e-maili dotyczących porzuconego koszyka zakupowego. Jest to włączane przez wycinek kodu źródłowego PHP dodany podczas integracji.
• Dane zrealizowanych zamówień
  Służą do śledzenia, kiedy zamówienia są wysyłane.
• Śledzenie na stronie
  Gdy ludzie odwiedzają Twoją witrynę

Aby przejść do metryk OpenCart, w Klaviyo przejdź do Analityka > Metryka , gdzie możesz filtrować według OpenCart.

Domyślnie Klaviyo synchronizuje następujące statusy dla metryk Placed Order i Fulfilled Order:

• Złożono zamówienie: Oczekujące, Zrealizowane, W trakcie realizacji, Wysłane, Zakończone
• Zrealizowane zamówienie: Wysłane, Zakończone