ReCharge (Shopify)

A integração específica para ReCharge não é mais necessária. Use a integração regular do Shopify!

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

Para rastrear pagamentos recorrentes, você precisa do recurso Comissões Recorrentes ou do plugin Comissões Vitalícias ativado no seu Post Affiliate Pro!

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

Os clientes que instalaram a ReCharge após 2 de novembro de 2020 usam o Shopify Checkout e os clientes que instalaram a ReCharge antes de 2 de novembro de 2020 usam o ReCharge Checkout na Shopify. Você também pode confirmar o tipo de checkout da sua loja diretamente no painel de administração da 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ê precisa criar um token de API conforme descrito na etapa 1. e configurar o plugin de controle de webhook da ReCharge conforme descrito na etapa 2. Em seguida, prossiga para integrar sua loja da Shopify conforme descrito neste guia. Você não precisa fazer as etapas 3 e 4 abaixo.

Se sua loja usa o ReCharge Checkout na Shopify, você precisa seguir todas as quatro etapas descritas abaixo.

Criar token de API

Como primeiro passo, você precisará entrar em contato com a ReCharge para solicitar acesso à API. Clique aqui para mais detalhes.

Depois de receber acesso à API, você pode criar seu token de API. Para fazer isso, faça login no seu painel de administração da Shopify, vá para a seção Apps e clique em Faturamento Recorrente por ReCharge para chegar ao painel ReCharge.

Uma vez lá, clique na guia Integrações no menu superior; nesta seção clique em Integrações Habilitadas e depois em Tokens de API. Na borda direita da página. Depois, clique em Criar um token de API.

Nomeie o token da API como quiser, adicione um e-mail onde você será notificado se o webhook estiver falhando e, o mais importante, certifique-se de adicionar permissão de acesso de leitura aos pedidos. Se você também puder ver a permissão de Webhooks aqui, defina como acesso de leitura e gravação; no entanto, isso pode ter sido removido e, portanto, não é mais necessário definir.

Salve o token e copie sua chave de API.

Configurar o plugin de controle de webhook da ReCharge

O próximo passo é fazer login no painel do comerciante do Post Affiliate Pro; vá para Configuração -> Plugins e ative o plugin chamado controle de webhook da ReCharge. Assim que estiver ativo, clique no botão Configurar e adicione a chave de API da Recharge na página de configuração do plugin. Nesta página, você também pode configurar o que exatamente será rastreado como ID do produto e também pode escolher se deseja rastrear quaisquer dados adicionais do pedido nos campos de dados extras. Quando terminar, salve a configuração do plugin na parte inferior da página.

Edite sua página de agradecimento

Se sua loja usa o ReCharge Checkout na Shopify conforme descrito acima, faça login no painel de administração da Shopify, vá para a seção Apps e clique em Cobrança Recorrente por ReCharge para acessar o painel de administração da ReCharge. Uma vez lá, clique em Configurações (ícone de chave inglesa) no canto superior direito e vá para a seção Checkout. Role para baixo até a seção Página de Agradecimento e cole o código a seguir no campo Scripts e Rastreadores adicionais:

<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 você deseja salvar o nome ou e-mail do cliente, pode adicionar as seguintes linhas:

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

debaixo de:

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

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

Rastreamento de cliques

Faça login no seu painel de administração da Shopify, vá para a seção Loja online e clique em Temas. Nesta seção, clique no botão Ações na visualização do tema ao vivo e escolha Editar código no menu suspenso.

No diretório Layout, encontre um arquivo chamado tema/líquido. Insira o código de rastreamento de cliques do painel do comerciante do Post Affiliate Pro -> Ferramentas -> Integração -> Rastreamento de cliques logo acima da tag </BODY> neste arquivo e salve.