Guía de Integración de Keitaro

Para configurar el seguimiento de conversiones servidor a servidor (S2S) para la red Blockchain-Ads usando Keitaro, configurarás Blockchain-Ads para generar una URL de postback (donde Keitaro enviará los datos de conversión) y luego la integrarás como una fuente de tráfico personalizada en Keitaro. Esto garantiza que Keitaro capture el {clickid} del tráfico entrante y envíe postbacks de vuelta a Blockchain-Ads con IDs de clic coincidentes, ingresos y otros detalles.

Paso 1: Crear el Evento de Conversión S2S en Blockchain-Ads

1. Inicie sesión en su panel de control de Blockchain-Ads HUB.
2. Navegue a Advertising > Tracking > Create Conversion > Server to Server.
3. Siga las instrucciones en pantalla para configurar el evento:
   
   • Nombre el evento de conversión (por ejemplo, "Lead" o "Sale").
   • Especifique el tipo de evento (por ejemplo, lead, purchase) y cualquier campo de ingresos si aplica.
   • Esto generará un ID de rastreador único para su evento y una URL de postback en el formato

GET https://server.blockchain-ads.com/www/delivery/tracker-mobile.php?clickid={clickid}&trackerid=YOUR_TRACKERID&transaction_value={transaction_value}

• {clickid}: Marcador de posición para el ID de clic único (Blockchain-Ads lo comparará con el clic original).
• trackerid: Su ID de evento fijo (no lo cambie).
• {transaction_value}: Marcador de posición opciona para el monto de ingresos/pago (omita si no rastrea ingresos).

Copie esta URL de postback completa; la necesitará en Keitaro.

4. Guarde el evento. Nota: Al crear campañas en Blockchain-Ads, establezca su URL de destino en su URL de campaña de Keitaro (por ejemplo, https://su-dominio-keitaro.com/campaign123?clickid={clickid}). Blockchain-Ads agregará automáticamente el valor real del ID de clic.

Paso 2: Agregar Blockchain-Ads como Fuente de Tráfico Personalizada en Keitaro

1. Inicie sesión en su panel de control de Keitaro.
2. Vaya a Traffic Sources > Create.
3. En el campo "From template", busque "Blockchain-Ads". Si no existe plantilla, seleccione Custom o déjelo en blanco para construir manualmente.
4. Complete los detalles básicos:
   
   • Name: "Blockchain-Ads".
   • Parámetro Click ID: Establézcalo en clickid (esto le indica a Keitaro que capture el valor ?clickid=xxx entrante del tráfico de Blockchain-Ads y lo almacene internamente como el ID externo para postbacks).
5. En la sección de plantilla de parámetros (si se solicita):
   
   • Agregue una fila para el ID de clic:
     
     • Columna 1 (Alias): Déjela en blanco o establezca "External ID" para informes.
     • Columna 2 (Parameter name): clickid.
     • Columna 3 (Macro): Déjela en blanco (ya que Blockchain-Ads agrega el valor real directamente).
   • Agregue otros parámetros si es necesario (por ejemplo, para ID de campaña o subIDs de macros de Blockchain-Ads).
6. En el campo S2S Postback:
   
   • Pegue la URL de postback del Paso 1.
   • Reemplace los marcadores de posición de Blockchain-Ads con equivalentes de Keitaro:
     
     • {clickid} → {external_id} (devuelve el ID de clic capturado).
   • Ejemplo de URL transformada

https://server.blockchain-ads.com/www/delivery/tracker-mobile.php?clickid={external_id}&trackerid=YOUR_TRACKERID&transaction_value={revenue}

Si desea enviar solo estados de conversión específicos (por ejemplo, leads aprobados), use el menú desplegable "Send only statuses" para seleccionarlos (por ejemplo, "Lead", "Sale").

7. Haga clic en Create para guardar la fuente de tráfico.
8. (Opcional) Si tiene múltiples campañas, marque Update in campaigns para aplicar esto a las existentes.

Paso 3: Configurar una Campaña en Keitaro y Probar

1. Vaya a Campaigns > Create (o edite una existente).
2. Seleccione Blockchain-Ads como Traffic Source.
3. Construya su flujo: Agregue streams, landing pages y ofertas. Para conversiones:
   
   • Si usa ofertas de afiliados, configure postbacks desde la red de afiliados a Keitaro (bajo Affiliate Networks).
   • Defina reglas de conversión (por ejemplo, postback S2S de la oferta, activación de píxel o eventos personalizados).
4. Genere y copie su URL de campaña de Keitaro (se verá como https://su-dominio.com/abc?clickid={external_id}; pegue esto como destino en su campaña de Blockchain-Ads).
5. Pruebe:
   
   • Lance una campaña de prueba en Blockchain-Ads que apunte a la URL de Keitaro.
   • Simule un clic y conversión (por ejemplo, a través de una oferta de prueba).
   • Revise los informes de Keitaro (Reports > Conversions) para clics/conversiones capturados.
   • Verifique en el seguimiento de Blockchain-Ads que lleguen los postbacks (con IDs de clic e ingresos coincidentes).
   • Use herramientas como Postman para activar manualmente un postback de prueba si es necesario.

Consejos y Solución de Problemas

• Marcadores de posición en Keitaro: Use {external_id} para clickid, {revenue} para montos y {status} para tipos de eventos (por ejemplo, mapee "lead" a un estado). Para valores no codificados, use el prefijo _ (por ejemplo, {_external_id}).
• Ingresos/Moneda: Si las conversiones tienen diferentes monedas, use {revenue:USD} para convertir.
• Errores: Asegúrese de usar HTTPS para postbacks. Si no fluyen datos, verifique la codificación de URL, bloqueos de firewall o ID de rastreador no coincidente. Keitaro registra intentos de postback en Logs > Postbacks.
• Avanzado: Para múltiples eventos, cree eventos de conversión separados en Blockchain-Ads y agregue múltiples URLs de postback en Keitaro (una por estado).

Esta configuración permite una atribución precisa sin cookies. Para más detalles sobre Keitaro, consulte su documentación en docs.keitaro.io