s2Member (Modulo di iscrizione a WordPress) integration
s2Member è un plugin di WordPress per la gestione professionale delle iscrizioni su WordPress. L’integrazione è molto semplice, devi solamente inserire un codice in una sezione speciale di configurazione di s2Member.
Inserisci il codice di tracciamento
Il primo passaggio consiste nell’integrare il codice di tracciamento delle vendite nel tuo account di s2Member e di inserire il seguente codice nella sezione API / Monitoraggio di s2Member > Codici di Monitoraggio delle Iscrizioni:
<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 sale = PostAffTracker.createSale();
sale.setTotalCost('%%initial%%');
sale.setOrderID('%%subscr_id%%');
sale.setProductID('%%item_number%%');
PostAffTracker.register();
</script>
Nel caso tu abbia bisogno di tracciare anche altre informazioni, puoi vedere le varianti disponibili proprio sotto questa sezione (in s2Member).
Commissioni ricorrenti
Se vuoi pagare le commissioni ricorrenti ai tuoi affiliati, devi abilitare il plugin s2Member nel tuo account Post Affiliate Pro. Imposta una parola segreta e poi vai nel tuo account s2Member, su API / Notifiche > Notifiche di Pagamento e usa questo URL di notifica (imposta la parola segreta):
http://URL_TO_PostAffiliatePro/plugins/s2Member/s2member.php?secret=YOURSECRETCODE&order=%%subscr_id%%&total=%%amount%%&type=order
Per farlo funzionare correttamente, devi usare la funzionalità Commissioni Ricorrenti nel tuo account Post Affiliate Pro e averla impostata per lavorare con le API. Nella tua campagna, devi configurare le commissioni ricorrenti e impostare la periodicità su ‘varia’, il che significa che funzionerà con le notifiche di s2Member.
Registra gli affiliati
Come puoi vedere nella configurazione del plugin s2Member, c’è una casella di controllo per le registrazioni degli affiliati. Nel caso in cui tu voglia creare un account di affiliazione per ogni nuovo membro, devi selezionare la casella di controllo e poi, nella tua gestione s2Member vai a API / Notifiche > Notifiche di Iscrizione e imposta questo URL lì:
http://URL_TO_PostAffiliatePro/plugins/s2Member/s2member.php?secret=YOURSECRETCODE&fname=%%first_name%%&lname=%%last_name%%&email=%%payer_email%%&user_ip=%%user_ip%%&type=signup
Ecco fatto, salva il tuo lavoro e questo creerà un nuovo account da affiliato per ogni nuovo membro.
Affiliato capo
Nel caso in cui tu voglia tracciare anche un affiliato capo, devi creare un campo aggiuntivo (opzionale) nel tuo modulo di iscrizione s2Member (Opzioni generali> Registrazione/Campi del profilo) e chiamarlo ‘visitorID‘ (lo stesso per l’ID del campo unico).
Il prossimo passaggio consiste nell’impostare uno script personalizzato nella sezione Design del Piè di Pagina delle Opzioni Generali > Design del Login/Registrazione. Inserisci questo codice lì:
<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">PostAffTracker.setAccountId('Account_ID');
document.getElementById('ws-plugin--s2member-custom-reg-field-visitorid').type = 'hidden';
PostAffTracker.writeCookieToCustomField('ws-plugin--s2member-custom-reg-field-visitorid');
document.getElementById('ws-plugin--s2member-custom-reg-field-visitorid').parentNode.style.display='none';
</script>
Questo codice farà in modo che le informazioni sull’affiliato capo (un valore di cookie) siano memorizzate in questo campo, e che il campo stesso sia nascosto dal modulo.
L’ultimo passaggio consiste nell’aggiungere questa linea alla tua notifica d’iscrizione in s2Member:
&visitorID=%%visitorID%%Tracciamento dei rimborsi
Nel caso in cui tu voglia tracciare i rimborsi e segnare automaticamente la commissione come rimborsata quando questa viene rimborsata in s2Member, devi andare nel tuo admin s2Member, in API / Notifiche > Notifiche di rimborso/rimborso e usare questo URL di notifica (imposta la parola segreta lì):
http://URL_TO_PostAffiliatePro/plugins/s2Member/s2member.php?secret=YOURSECRETCODE&order=%%parent_txn_id%%&type=refund
Questo è tutto, ora salva il tuo lavoro.
s2member e PayPal – integrazione del modulo di checkout automatico
Se stai usando PayPal come gateway di pagamento in s2member allora è necessario un approccio diverso di integrazione.
Prima di tutto, nel campo notify_url di ogni pulsante ‘checkout’ (‘paypal-checkout-button.php’,’paypal-sp-checkout-button.php’, ecc.) che si trova a:
/wp-content/plugins/s2member/includes/templates/buttons/
devi aggiungere:
id="pap_ab78y5t4a" Esempio:
Se il codice predefinito del campo notify_url assomiglia a questo:
<input type="hidden" name="notify_url" value="%%notify_url%%" />allora cambialo con questo qui:
<input id="pap_ab78y5t4a" type="hidden" name="notify_url" value="%%notify_url%%" />In seguito, nel file di piè di pagina del tue tema attuale, quindi in
/wp-content/themes/Name_Of_Your_Current_Theme/footer.php
devi aggiungere il codice seguente:
<!-- PAP Integration snippet -->
<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">
PostAffTracker.setAccountId('default1');
PostAffTracker.writeCookieToCustomField('pap_ab78y5t4a', '', 'pap_custom');
</script>
<!-- /PAP Integration snippet -->
Nel caso in cui tu voglia rintracciare anche un ID del prodotto, aggiungi questo attributo al codice del tuo modulo di s2Member PayPal:
item_number="someProductID"s2member e PayPal – inoltra la notifica di pagamento istantaneo di PayPal a Post Affiliate Pro
L’ultimo passaggio dell’integrazione consiste nel cercare il seguente file:
/wp-content/plugins/s2member/includes/classes/paypal-notify-in.inc.php
e trovare la linea:
public static function paypal_notify() {
e inserire il seguente codice proprio l’ sotto:
/* Post Affiliate Pro integration snippet */
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'http://URL_TO_PostAffiliatePro/plugins/PayPal/paypal.php?pap_custom='.$_GET['pap_custom']);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $_POST);
curl_exec($ch);
/* /Post Affiliate Pro integration snippet */
E questo è tutto.
Ora, accedi al pannello commerciante di Post Affiliate Pro (Network), vai alla sezione “Plugin” e attiva il plugin “Gestione dell’IPN di PayPal“.
NOTA: Se desideri che il cliente pagante venga inserito automaticamente come affiliato, allora nel plugin ‘Gestione dell’IPN di PayPal’ attiva l’opzione “Registra un nuovo affiliato per ogni evento che si verifica”.
NOTA2: La ”Gestione dell’IPN di PayPal” gestisce automaticamente i rimborsi – se una transazione precedentemente tracciata (che ha portato ad una commissione) viene rimborsata in PayPal, allora verrà automaticamente rimborsata anche in Post Affiliate Pro (Network).
