ReCharge (Shopify)

Integracja ReCharge (Shopify)

Specjalna integracja dla ReCharge nie jest już wymagana. Zamiast tego użyj standardowej integracji Shopify !

Platforma ReCharge pozwala dodawać do Twojego sklepu Shopify produkty subskrypcyjne z cyklicznymi płatnościami. Ten przewodnik wyjaśnia, jak zintegrować ReCharge z Post Affiliate Pro, aby śledzić te płatności.

Aby śledzić cykliczne płatności, musisz mieć włączoną funkcję Cykliczne Prowizje lub aktywną wtyczkę Lifetime Commissions w Post Affiliate Pro!

Proces integracji zależy od tego, czy sklep korzysta z ReCharge Checkout na Shopify, czy z Shopify Checkout.

Klienci, którzy zainstalowali ReCharge po 2 listopada 2020, korzystają z Shopify Checkout, a ci, którzy zrobili to wcześniej — z ReCharge Checkout na Shopify. Typ checkoutu możesz potwierdzić bezpośrednio w panelu administracyjnym ReCharge w sklepie –> Ustawienia (ikona klucza) –> Sklep (Moje konto) –> Status konta. Kliknij tutaj po więcej szczegółów.

Jeśli Twój sklep korzysta z Shopify Checkout, musisz utworzyć token API zgodnie z krokiem 1. i skonfigurować wtyczkę obsługi webhooków ReCharge jak w kroku 2. Następnie przejdź do integracji sklepu Shopify zgodnie z tym przewodnikiem. Nie musisz realizować kroków 3. i 4. poniżej.

Jeśli Twój sklep korzysta z ReCharge Checkout na Shopify, musisz przeprowadzić wszystkie cztery kroki opisane poniżej.

Utwórz token API

Pierwszym krokiem jest kontakt z ReCharge w celu uzyskania dostępu do API. Kliknij tutaj po więcej szczegółów.

Po uzyskaniu dostępu do API możesz utworzyć swój token API. W tym celu zaloguj się do panelu administracyjnego Shopify, przejdź do sekcji Aplikacje i kliknij na Recurring Billing od ReCharge, aby przejść do panelu ReCharge.

Następnie kliknij zakładkę Integrations w górnym menu, w tej sekcji kliknij na Enabled integrations, a potem na API tokens po prawej stronie strony. Następnie kliknij Create an API token.

Nazwij token API dowolnie, podaj adres e‑mail, na który będą wysyłane powiadomienia w razie problemów z webhookiem i – co najważniejsze – upewnij się, że dodasz uprawnienie Read access do zamówień (Orders). Jeśli widzisz również uprawnienie Webhooks, ustaw je na Read and Write access, choć mogło ono zostać usunięte i nie zawsze jest wymagane.

Zapisz token i skopiuj jego klucz API.

Skonfiguruj wtyczkę obsługi webhooków ReCharge

Kolejny krok to zalogowanie się do panelu sprzedawcy Post Affiliate Pro i przejście do Konfiguracja –> Wtyczki, gdzie należy aktywować wtyczkę o nazwie ReCharge webhook handling. Po aktywacji kliknij przycisk Konfiguruj i wprowadź klucz API ReCharge na stronie konfiguracji wtyczki. Tutaj możesz także ustalić, co dokładnie będzie śledzone jako Product ID oraz wybrać, czy chcesz śledzić dodatkowe dane zamówienia w polach extra data. Po zakończeniu konfiguracji, zapisz ustawienia na dole strony.

Edytuj stronę podziękowania

Jeśli Twój sklep korzysta z ReCharge Checkout na Shopify, zaloguj się do panelu administracyjnego Shopify, przejdź do sekcji Aplikacje i kliknij na Recurring Billing by ReCharge, aby wejść do panelu ReCharge. Następnie kliknij ikonę klucza (Settings) w prawym górnym rogu i przejdź do sekcji Checkout. Przewiń do sekcji Thank you page i wklej poniższy kod do pola Additional & scripts oraz trackers:

<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">
PostAffTracker.setAccountId('Account_ID');
var discountMultiplier = 1 - {{total_discounts}} / ({{subtotal_price}} + {{total_discounts}});
{% for item in line_items %}
var itemPrice = {{item.price}} * {{item.quantity}};
  var sale{{ loop.index }} = PostAffTracker.createSale();
  sale{{ loop.index }}.setTotalCost(itemPrice * discountMultiplier);
  var subscriptionId = '{{item.subscription_id}}';
  if (subscriptionId  != '') {
    sale{{ loop.index }}.setOrderID(subscriptionId);
  } else {
    sale{{ loop.index }}.setOrderID('{{id}}({{ loop.index }})');
  }
  sale{{ loop.index }}.setProductID('{{item.product_id}}');
  sale{{ loop.index }}.setCoupon('{{discount_code}}');
{% endfor %}
PostAffTracker.register();
</script>

Jeśli chcesz zapisać imię, nazwisko lub e‑mail klienta, możesz dodać poniższe linie:

  sale{{ loop.index }}.setData1('{{email}}');
  sale{{ loop.index }}.setData2('{{first_name}} {{last_name}}');

pod:

sale{{ loop.index }}.setCoupon('{{discount_code}}');

Więcej dostępnych zmiennych znajdziesz w bazie wiedzy ReCharge .

Śledzenie kliknięć

Zaloguj się do panelu administracyjnego Shopify, przejdź do sekcji Sklep online (Online store) i kliknij na Motywy (Themes). W tym miejscu kliknij przycisk Akcje (Actions) przy podglądzie aktywnego motywu i wybierz Edytuj kod z menu rozwijanego.

W katalogu Layout znajdź plik theme/liquid. Wklej kod śledzenia kliknięć z Twojego panelu sprzedawcy Post Affiliate Pro –> Narzędzia –> Integracja –> Śledzenie kliknięć tuż nad tagiem </BODY> w tym pliku i zapisz zmiany.