ReCharge (Shopify)

Integración de ReCharge (Shopify)

Ya no es necesaria una integración específica para ReCharge. Por favor, utiliza la integración regular de Shopify en su lugar.

La plataforma ReCharge te permite añadir productos de suscripción recurrente a tu tienda Shopify. Esta guía explica cómo integrar ReCharge con Post Affiliate Pro para rastrear estos pagos recurrentes.

Para rastrear pagos recurrentes necesitas tener activada la función de Comisiones Recurrentes o el plugin de Comisiones de por Vida en tu Post Affiliate Pro.

El proceso de integración depende de si la tienda usa ReCharge Checkout en Shopify o Shopify Checkout.

Los clientes que instalaron ReCharge después del 2 de noviembre de 2020 usan Shopify Checkout, y los que lo hicieron antes de esa fecha usan ReCharge Checkout en Shopify. Puedes confirmar el tipo de checkout de tu tienda directamente en el panel de administración de ReCharge en tu tienda -> Configuración (icono de llave inglesa) -> Tienda (Mi cuenta) -> Estado de la cuenta. Haz clic aquí para más detalles.

Si tu tienda usa Shopify Checkout debes crear un token de API como se describe en el paso 1 y configurar el plugin de gestión de webhooks de ReCharge como se describe en el paso 2. Luego procede a integrar tu tienda Shopify como se indica en esta guía. No es necesario realizar los pasos 3 y 4 a continuación.

Si tu tienda usa ReCharge Checkout en Shopify debes seguir los cuatro pasos que se describen a continuación.

Crear token de API

Como primer paso, deberás contactar a ReCharge para solicitar acceso a la API. Haz clic aquí para más información.

Una vez que te concedan acceso a la API, puedes crear tu token de API. Para ello, inicia sesión en el panel de administración de Shopify, ve a la sección de Apps y haz clic en Recurring Billing de ReCharge para acceder al panel de ReCharge.

Una vez allí, haz clic en la pestaña Integrations en el menú superior, en esta sección haz clic en Enabled integrations y luego en API tokens. En el borde derecho de la página, haz clic en Create an API token.

Ponle el nombre que desees al token de API, agrega un correo electrónico donde recibirás notificación en caso de que el webhook falle, y lo más importante, asegúrate de dar permiso de solo lectura a Pedidos. Si también ves el permiso de Webhooks, configúralo en lectura y escritura; sin embargo, este permiso podría haber sido eliminado y, por lo tanto, ya no es necesario configurarlo.

Guarda el token y copia su clave API.

Configurar el plugin de gestión de webhooks de ReCharge

El siguiente paso es iniciar sesión en tu panel de comerciante de Post Affiliate Pro , ir a Configuración -> Plugins y activar el plugin llamado ReCharge webhook handling. Una vez activo, haz clic en el botón Configurar y agrega la clave API de ReCharge en la página de configuración del plugin. En esta página también puedes configurar qué se rastreará exactamente como ID de producto, y también puedes elegir si deseas rastrear datos adicionales del pedido en los campos de datos extra. Cuando termines, guarda la configuración del plugin en la parte inferior de la página.

Editar tu página de agradecimiento

Si tu tienda usa ReCharge Checkout en Shopify como se describió anteriormente, inicia sesión en el panel de administración de Shopify, ve a la sección de Apps y haz clic en Recurring Billing by ReCharge para acceder al panel de administración de ReCharge. Una vez allí, haz clic en el icono de llave inglesa (Configuración) en la esquina superior derecha y ve a la sección de Checkout. Desplázate hacia abajo hasta la sección de página de agradecimiento y pega el siguiente código en el campo Additional & scripts y trackers:

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

Si deseas guardar el nombre o correo electrónico del cliente, puedes agregar las siguientes líneas:

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

debajo de:

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

Puedes encontrar más variables disponibles en la base de conocimientos de ReCharge .

Seguimiento de clics

Inicia sesión en tu panel de administración de Shopify, ve a la sección de Tienda online y haz clic en Temas. En esta sección haz clic en el botón Acciones de tu tema en vivo y elige Editar código en el menú desplegable.

En el directorio Layout, busca un archivo llamado theme/liquid. Inserta el código de seguimiento de clics desde tu panel de comerciante de Post Affiliate Pro -> Herramientas -> Integración -> Seguimiento de clics justo encima de la etiqueta </BODY> en este archivo y guárdalo.