s2Member (Módulo de associação do WordPress)

s2Member é um plugin WordPress para gerenciamento profissional de membros do WordPress. A integração é fácil; você só precisa colocar um código em uma seção especial de configuração do s2Member.

Coloque o código de rastreamento

O primeiro passo para integrar o código de acompanhamento de vendas em seu s2Member é colocar o seguinte código na seção de API do s2Member/Rastreamento > Códigos de Rastreamento de Inscrição:

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

Caso você precise acompanhar também alguns outros detalhes, você pode ver as variáveis disponíveis logo abaixo desta seção (em s2Member).

Comissões recorrentes

Se você quiser pagar comissões recorrentes para seus afiliados, você deve habilitar o plugin s2Member no seu Post Affiliate Pro. Defina uma palavra secreta lá e navegue até o administrador do s2Member, para API/Notificações > Notificações de Pagamento e use este URL de notificação (defina a palavra secreta lá):

http://URL_TO_PostAffiliatePro/plugins/s2Member/s2member.php?secret=YOURSECRETCODE&order=%%subscr_id%%&total=%%amount%%&type=order

Para que isso funcione corretamente, você precisa usar o recurso Comissões Recorrentes no seu Post Affiliate Pro e configurá-lo para funcionar com a API. Em sua campanha, você deve configurar as comissões recorrentes e definir a recorrência como “variada”, o que significa que cooperará com as notificações do s2Member.

Registrar afiliados

Como você pode ver na configuração do plugin s2Member, há uma caixa de seleção para registros de afiliados. Caso você queira criar uma conta de afiliado para cada novo membro, você deve marcar a caixa de seleção e, em seguida, na administração do s2Member, navegue até API/Notificações > Notificações de Inscrição e defina esta URL:

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

É isso, salve seu trabalho e isso criará um novo afiliado para cada novo membro.

Afiliado principal

Caso você queira rastrear também um afiliado principal, você deve criar um campo adicional (opcional) em seu formulário de inscrição s2Member (Opções Gerais > Campos de Registro/Perfil) e nomear para “visitorID” (o mesmo para ID de campo exclusivo).

A próxima etapa é definir um script personalizado na seção Design de Rodapé de Opções Gerais > Design de Login/Registro. Por favor, insira este código 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>

Esse código garantirá que as informações do afiliado principal (um valor de cookie) sejam armazenadas nesse campo e que o próprio campo fique oculto no formulário.

A última etapa é adicionar esta linha à sua notificação de inscrição no s2Member:

&visitorID=%%visitorID%%

Acompanhamento de reembolso

Caso você queira rastrear reembolsos e marcar automaticamente a comissão como reembolsada quando for reembolsada no s2Member, você deve navegar até o administrador do s2Member, então para API/Notificações > Notificações de Reembolso/Reversão e usar este URL de notificação (defina a palavra secreta lá) :

http://URL_TO_PostAffiliatePro/plugins/s2Member/s2member.php?secret=YOURSECRETCODE&order=%%parent_txn_id%%&type=refund

É isso, salve seu trabalho.

s2member e PayPal – integração do formulário de checkout dinâmico

Se você estiver usando o PayPal como um gateway de pagamento no s2member, será necessária uma abordagem diferente de integração.

Em primeiro lugar, no campo notify_url de cada botão “checkout” (“paypal-checkout-button.php”,”paypal-sp-checkout-button.php”, etc.) encontrado em:

/wp-content/plugins/s2member/includes/templates/buttons/

você tem que adicionar:

id="pap_ab78y5t4a" 

Exemplo:

Se o código do campo notify_url padrão for assim:

 <input type="hidden" name="notify_url" value="%%notify_url%%" />

então mude para este:

 <input id="pap_ab78y5t4a" type="hidden" name="notify_url" value="%%notify_url%%" />

Depois, no arquivo de rodapé do seu tema atual, então em

/wp-content/themes/Name_Of_Your_Current_Theme/footer.php

você deve adicionar o seguinte código:

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

Caso você também queira rastrear um ID de produto, adicione este atributo ao seu código de formulário s2Member do PayPal:

item_number="someProductID"

s2member e PayPal – encaminhando a notificação de pagamento instantâneo do PayPal para o Post Affiliate Pro

A última etapa da integração é procurar o seguinte arquivo:

/wp-content/plugins/s2member/includes/classes/paypal-notify-in.inc.php

e encontre a linha:

public static function paypal_notify() {

e coloque o seguinte código logo abaixo dele:

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

É isso.

Agora, faça login no painel do comerciante do Post Affiliate Pro (Network), navegue até a seção “Plugins” e ative o plugin “Controle de IPN do PayPal“.

OBSERVAÇÃO: Se você deseja que o cliente pagante seja criado automaticamente como um afiliado, no plugin “Controle de IPN do PayPal”, ative a opção “Registrar novo afiliado a cada evento ocorrido”.

OBSERVAÇÃO 2: O “Controle de IPN do PayPal” lida automaticamente com os reembolsos – se uma transação rastreada anteriormente (que resultou em uma comissão) for reembolsada no PayPal, ela também será reembolsada automaticamente no Post Affiliate Pro (Network).