ReCharge (Shopify)

Integração ReCharge (Shopify)

A integração específica para o ReCharge não é mais necessária. Por favor, utilize a integração padrão do Shopify !

A plataforma ReCharge permite adicionar produtos de assinatura recorrente à sua loja Shopify. Este guia explica como integrar o ReCharge ao Post Affiliate Pro para rastrear esses pagamentos recorrentes.

Para rastrear pagamentos recorrentes, você deve ativar o recurso Comissões Recorrentes ou o plugin Lifetime Commissions no seu Post Affiliate Pro!

O processo de integração depende se a loja utiliza o ReCharge Checkout no Shopify ou o Shopify Checkout.

Clientes que instalaram o ReCharge após 2 de novembro de 2020 utilizam o Shopify Checkout, e clientes que instalaram o ReCharge antes desta data usam o ReCharge Checkout no Shopify. Você pode confirmar o tipo de checkout da sua loja diretamente no painel de administração do ReCharge em sua loja - > Configurações (ícone de chave inglesa) -> Loja (Minha conta) -> Status da conta. Clique aqui para mais detalhes.

Se sua loja usa o Shopify Checkout você deve criar um token de API conforme descrito no passo 1 e configurar o plugin de manipulação de webhook do ReCharge conforme descrito no passo 2. Em seguida, prossiga para integrar sua loja Shopify conforme descrito neste guia. Não é necessário executar os passos 3 e 4 abaixo.

Se sua loja usa o ReCharge Checkout no Shopify você precisa seguir todos os quatro passos descritos abaixo.

Criar token de API

Como primeiro passo, será necessário entrar em contato com o ReCharge para solicitar acesso à API. Clique aqui para mais detalhes.

Após receber acesso à API, você poderá criar seu token de API. Para isso, acesse o painel de administração do Shopify, vá até a seção Apps e clique em Recurring Billing do ReCharge para acessar o painel do ReCharge.

Lá, clique na guia Integrações no menu superior, depois em Integrações habilitadas e em seguida em API tokens. No canto direito da página, clique em Criar um token de API.

Dê um nome ao token conforme desejar, adicione um e-mail para ser notificado caso o webhook falhe e, principalmente, certifique-se de adicionar permissão de leitura para Pedidos (Orders). Se você também visualizar a permissão de Webhooks, defina como Leitura e Escrita (Read and Write), porém isso pode ter sido removido e pode não ser mais necessário configurar.

Salve o token e copie sua chave de API.

Configurar o plugin de manipulação de webhook do ReCharge

O próximo passo é acessar o painel de comerciante do Post Affiliate Pro , ir em Configuração - > Plugins e ativar o plugin chamado ReCharge webhook handling. Uma vez ativo, clique no botão Configurar e adicione a chave de API do Recharge na página de configuração do plugin. Nesta página, você também pode configurar exatamente o que será rastreado como ID do Produto, além de escolher se deseja rastrear dados adicionais do pedido nos campos de dados extras. Quando terminar, salve a configuração do plugin no final da página.

Editar sua página de agradecimento

Se sua loja utiliza o ReCharge Checkout no Shopify conforme descrito acima, acesse o painel de administração do Shopify, vá até a seção Apps e clique em Recurring Billing by ReCharge para acessar o painel do ReCharge. Lá, clique em Configurações (ícone de chave inglesa) no canto superior direito e vá até a seção de Checkout. Role até a Seção da página de agradecimento e cole o código abaixo no campo Additional & scripts e rastreadores:

<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 desejar salvar o nome ou e-mail do cliente, adicione as seguintes linhas:

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

abaixo de:

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

Você pode encontrar mais variáveis disponíveis na base de conhecimento do ReCharge .

Rastreamento de cliques

Acesse o painel de administração do Shopify, vá até a seção Loja virtual e clique em Temas. Nessa seção, clique no botão Ações na visualização do tema ativo e escolha Editar código no menu suspenso.

No diretório Layout, localize o arquivo chamado theme/liquid. Insira o código de rastreamento de cliques do seu painel de comerciante do Post Affiliate Pro - > Ferramentas -> Integração -> Rastreamento de cliques logo acima da tag </BODY> neste arquivo e salve.