Atribuir conversiones y ventas

Una conversión es una venta o un pago de mecenas que LinkHarbor puede atribuir a un clic en tu página. Así no solo ves con qué frecuencia se hizo clic en un enlace, sino también qué salió de ello. Este artículo es para creadores con tienda propia y para los desarrolladores que conectan la tienda. Puedes analizar conversiones y crear secretos de callback desde Creator Pro.

#De dónde vienen las conversiones

• Ventas que tu tienda o tu servidor notifican mediante un callback de venta
• Pagos de mecenas con Stripe; un reembolso vuelve a eliminar la conversión; consulta Pagos de mecenas con Stripe

Cada conversión hereda los datos del clic al que pertenece: página, enlace, país, dispositivo, referencia y parámetros UTM. Por eso aparece en las estadísticas exactamente donde se originó el clic.

#Cómo funciona la atribución

1. Un visitante hace clic en un enlace de tu página
2. LinkHarbor cuenta el clic y, al redirigir, añade a la URL de destino el parámetro lt_click_id con un ID de clic único
3. Tu página de destino (por ejemplo, la tienda) lee lt_click_id de la dirección y lo guarda hasta la compra
4. Tras la compra, tu servidor envía a LinkHarbor un callback de venta con este ID de clic
5. La conversión aparece en el panel y en las estadísticas de la página

El ID de clic solo se añade a destinos que empiezan por http:// o https://. Los enlaces a mailto: o tel: no lo reciben, porque el parámetro estropearía allí el asunto o el número de teléfono. Los clics de bots tampoco reciben ID de clic.

#Crear un secreto de callback

Un callback de venta tiene que identificarse con un secreto de callback. Los propietarios y admins gestionan los secretos desde Creator Pro en «Callback y API», en la sección de cuenta del menú.

1. Abre «Callback y API»
2. En la tarjeta «Secretos de callback», haz clic en «+ Crear nuevo secreto»
3. Si quieres, introduce un nombre, por ejemplo «Callback de la tienda»
4. Haz clic en «Crear secreto»
5. Copia el secreto enseguida: solo se muestra una vez

«Editar»

Cambia el nombre y el estado (Activo o Inactivo). Un secreto inactivo se rechaza.

«↺ Rotar»

Crea un secreto nuevo. El antiguo deja de funcionar al instante, así que introduce el nuevo en tu tienda enseguida.

«Eliminar»

Elimina el secreto tras una pregunta de confirmación.

«Último callback:»

Muestra cuándo se usó el secreto por última vez; si no, «Aún sin usar».

Puedes crear hasta 5 secretos de callback por espacio de trabajo.

#Enviar el callback de venta

Tu servidor envía una petición POST a la API de LinkHarbor. El secreto va en la cabecera X-Callback-Secret.

curl -X POST https://dock.at-harbor.com/v1/callbacks/sale \
  -H "Content-Type: application/json" \
  -H "X-Callback-Secret: YOUR_CALLBACK_SECRET" \
  -d '{
    "click_id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a23",
    "order_id": "B-10042",
    "amount": "49.90",
    "currency": "EUR"
  }'

click_id

Obligatorio. El ID de clic de lt_click_id (de 10 a 36 caracteres).

order_id

Obligatorio. Tu número de pedido (de 1 a 128 caracteres). Solo se cuenta una conversión por número de pedido, así que un callback repetido no crea una segunda.

amount

Obligatorio. El importe como número decimal.

currency

Obligatorio. Un código de moneda de 3 letras, por ejemplo EUR.

occurred_at, meta

Opcionales. El momento de la compra y hasta 50 claves propias (de 1 a 64 caracteres cada una) con información adicional. Un valor es un texto de 500 caracteres como máximo, un número, true/false o null; la API rechaza los objetos anidados.

Respuestas

Todos los campos y códigos de error para desarrolladores están en Enviar ventas y datos propios.

#Analizar las conversiones

• Panel: los recuadros «Conversiones» y «CVR» y la tarjeta «Conversiones» por fuente y medio UTM
• Estadísticas de página: la tarjeta «Conversiones» con «CVR total», «CVR único» y «Desglose»
• CVR total = conversiones divididas entre clics; CVR único = conversiones divididas entre clics únicos