Linkly y Stripe

Los recuentos de clics te dicen que un enlace era popular. No te dicen que haya generado dinero.

Instala la aplicación Linkly desde el Stripe App Marketplace y cada pago que llegue a través de un enlace Linkly rastreado se registrará contra ese enlace. Luego puedes comparar correos electrónicos, anuncios, creadores y campañas por ingresos, no solo por clics. Las renovaciones de suscripciones se acreditan al enlace que primero consiguió el cliente, y los reembolsos se restan.

Lo que necesitas

• Una cuenta Linkly. El plan gratuito funciona.
• Una cuenta Stripe. La aplicación es gratuita y solo lee: nunca crea cargos ni cambia nada en Stripe.

Instalar y conectar

1. 1
   Instala Linkly Conversion Tracking desde el Stripe App Marketplace. Después de instalar, llegarás a la página de configuración de la aplicación.
2. 2
   Haz clic en Connect to Linkly. Se abrirá una nueva pestaña en Linkly.
3. 3
   Inicia sesión en Linkly, elige el espacio de trabajo al que pertenece esta cuenta de Stripe y haz clic en Connect Stripe.
4. 4
   De vuelta en Stripe, haz clic en Check again. La página muestra el espacio de trabajo que conectaste.

Hasta que se conecte un espacio de trabajo, nada se registra.

Rastrear Stripe Payment Links (sin código)

1. 1
   En Linkly, crea un enlace que apunte a tu Stripe Payment Link, por ejemplo https://buy.stripe.com/abc123, o edita uno que ya tengas.
2. 2
   En las opciones Tracking & analytics del enlace, activa Conversion tracking.

Esa es toda la configuración. Comparte el enlace corto como de costumbre. Cuando alguien hace clic en él, Linkly añade un identificador aleatorio corto para ese clic a la dirección de Payment Link como client_reference_id. Stripe lo devuelve cuando se completa el pago, y Linkly relaciona el pago con el clic.

Si tu Payment Link ya usa client_reference_id para tu propia conciliación, Linkly deja tu valor intacto y los pagos de ese enlace no pueden ser relacionados. Usa el método de metadatos a continuación en su lugar.

Rastrear tu propio checkout

Si creas Checkout Sessions en tu propio código, pasa el identificador de clic tú mismo. Añade el script de Linkly a tu sitio:

<script src="https://cdn.linklyhq.com/linkly.js" async></script>

Lee el identificador en el navegador con linkly('id'), envíalo a tu servidor con el pedido y establécelo cuando crees la sesión:

const session = await stripe.checkout.sessions.create({
  client_reference_id: linklyClickId,
  // ...el resto de tu sesión
});

Si client_reference_id ya está en uso, colócalo en los metadatos en su lugar, como linkly_cid, en la Checkout Session o en el Customer:

await stripe.customers.create({
  email: user.email,
  metadata: { linkly_cid: linklyClickId },
});

Un cliente creado con un identificador de clic se registra como un lead, y cada pago que ese cliente realice después se acredita al mismo enlace.

Qué se registra

Algunas cosas que vale la pena saber:

• Solo cuentan los enlaces rastreados. Los pagos que no llegaron a través de un enlace Linkly con conversion tracking activado se ignoran. Linkly nunca ve el resto de tus ventas.
• Una suscripción cuenta una vez por pago. Stripe reporta el primer pago de una suscripción dos veces, como un checkout y como una factura. Linkly lo registra una vez.
• Métodos de pago retrasados. Para débitos bancarios y vales, la venta se registra cuando llega el dinero, no cuando se completa el checkout.
• El modo de prueba funciona. Los pagos realizados en el modo de prueba de Stripe o en una sandbox también se registran, que es la forma más fácil de verificar tu configuración. Se marcan como pagos de prueba.
• El identificador nombra un clic, no una persona. Es aleatorio y no lleva información personal.

En el Panel de Stripe

Abre cualquier pago en Stripe y el panel de Linkly muestra cuál es el enlace corto del que provino, con un enlace a la analítica de ese enlace en Linkly. Para una renovación, muestra el enlace que primero trajo al cliente.

Desconectar

Abre la configuración de la aplicación en Stripe y haz clic en Disconnect, o desinstala la aplicación. Cualquiera de los dos detiene el registro inmediatamente. Las conversiones ya registradas permanecen en tus informes.

Solución de problemas

Los pagos no están apareciendo. Verifica que el conversion tracking esté activado para el enlace, luego haz clic en el enlace corto tú mismo y confirma que la dirección de Stripe contiene client_reference_id=linkly_. Si muestra tu propio valor en su lugar, usa el método de metadatos.

El panel dice "Connect your Linkly workspace". La aplicación está instalada pero ningún espacio de trabajo está conectado aún. Abre la configuración de la aplicación en Stripe y haz clic en Connect to Linkly.

Enlaces a una factura alojada. Un enlace que apunta a una página invoice.stripe.com no puede llevar un identificador de clic, por lo que esos pagos aún no se pueden relacionar.