ReCharge (Shopify)

Integrazione ReCharge (Shopify)

Non è più necessaria un’integrazione specifica per ReCharge. Usa invece la normale integrazione Shopify !

La piattaforma ReCharge consente di aggiungere prodotti in abbonamento ricorrente al tuo negozio Shopify. Questa guida spiega come integrare ReCharge con Post Affiliate Pro per tracciare questi pagamenti ricorrenti.

Per tracciare i pagamenti ricorrenti devi abilitare la funzione Commissioni Ricorrenti oppure attivare il plugin Lifetime Commissions in Post Affiliate Pro!

Il processo di integrazione dipende dal fatto che il negozio utilizzi ReCharge Checkout su Shopify o Shopify Checkout.

I clienti che hanno installato ReCharge dopo il 2 novembre 2020 usano Shopify Checkout, mentre chi ha installato ReCharge prima di questa data usa ReCharge Checkout su Shopify. Puoi confermare il tipo di checkout del tuo negozio anche direttamente dal pannello amministratore di ReCharge nel tuo store - > Impostazioni (icona chiave inglese) -> Store (Il mio account) -> Stato account. Clicca qui per ulteriori dettagli.

Se il tuo negozio usa Shopify Checkout devi creare un token API come descritto nel passaggio 1 e configurare il plugin per la gestione del webhook di ReCharge come descritto nel passaggio 2. Prosegui poi con l’integrazione del tuo store Shopify come descritto in questa guida. Non è necessario effettuare i passaggi 3 e 4 seguenti.

Se il tuo negozio usa ReCharge Checkout su Shopify devi seguire tutti e quattro i passaggi descritti di seguito.

Crea il token API

Come primo passo, dovrai contattare ReCharge per richiedere l’accesso alle API. Clicca qui per maggiori dettagli.

Una volta ottenuto l’accesso alle API, puoi creare il tuo token API. Per farlo, accedi al pannello di amministrazione Shopify, vai nella sezione App e clicca su Recurring Billing di ReCharge per accedere al pannello ReCharge.

Da lì, clicca sulla scheda Integrazioni nel menu superiore, in questa sezione clicca su Integrazioni attive, quindi su Token API. Sulla destra della pagina. Successivamente, clicca su Crea un token API.

Assegna al token API il nome che preferisci, inserisci un’email dove sarai notificato in caso di errori del webhook e, soprattutto, assicurati di aggiungere il permesso di accesso in sola lettura agli Ordini. Se visualizzi anche il permesso Webhooks, impostalo su Lettura e Scrittura, tuttavia questa opzione potrebbe essere stata rimossa e quindi non è più necessario impostarla.

Salva il token e copia la sua chiave API.

Configura il plugin webhook di ReCharge

Il passo successivo è accedere al pannello merchant di Post Affiliate Pro , andare su Configurazione -> Plugin e attivare il plugin chiamato Gestione webhook di ReCharge. Una volta attivo, clicca sul pulsante Configura e inserisci la chiave API di Recharge nella pagina di configurazione del plugin. In questa pagina puoi anche configurare cosa verrà tracciato esattamente come Product ID , e puoi scegliere se tracciare dati aggiuntivi dell’ordine nei campi dati extra. Quando hai finito, salva la configurazione del plugin in fondo alla pagina.

Modifica la tua pagina di ringraziamento

Se il tuo negozio utilizza ReCharge Checkout su Shopify come descritto sopra, accedi al pannello di amministrazione Shopify, vai nella sezione App e clicca su Recurring Billing by ReCharge per entrare nel pannello amministratore di ReCharge. Da lì, clicca sull’icona delle Impostazioni (chiave inglese) in alto a destra e vai nella sezione Checkout. Scorri fino alla sezione Thank you page e incolla il seguente codice nel campo Additional & scripts e tracker:

<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>

Se desideri salvare nome o email del cliente puoi aggiungere le seguenti righe:

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

sotto la riga:

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

Puoi trovare altre variabili disponibili nella knowledgebase di ReCharge .

Tracciamento dei click

Accedi al pannello di amministrazione Shopify, vai nella sezione Negozio online e clicca su Temi. In questa sezione clicca sul pulsante Azioni nell’anteprima del tema Live e scegli Modifica codice dal menu a tendina.

Nella directory Layout, trova il file chiamato theme/liquid. Inserisci il codice di tracciamento dei click dal tuo pannello merchant di Post Affiliate Pro - > Strumenti -> Integrazione -> Tracciamento click subito sopra il tag </BODY> in questo file e salvalo.