Resumen de Postbacks
Los postbacks permiten a los afiliados recibir notificaciones en tiempo real de servidor a servidor cuando ocurren eventos específicos de conversión, como registros o compras.
Al integrar los postbacks con su sistema de seguimiento, puede recibir automáticamente datos de conversión y relacionarlos con el clic original. Esto garantiza una atribución precisa y un reporte consistente tanto en su sistema como en el nuestro.
Cuando un usuario hace clic en su enlace de afiliado, registramos los parámetros que usted pasa (como click_id). Puede ver la lista completa de macros de parámetros compatibles en la tabla aquí: [Link].
Cuando ocurre una conversión, enviamos una solicitud de servidor a servidor a su URL de postback configurada, permitiendo que su sistema relacione la conversión con el clic original.
Tipos de Postbacks
Actualmente soportamos dos tipos de postbacks:
Postbacks Dinámicos (Recomendados)
- Soporta parámetros dinámicos en la URL del postback
- Compatible con las principales plataformas de seguimiento (por ejemplo, Voluum)
- Permite puntos finales URL separados por tipo de conversión (registros y compras)
- Proporciona mayor flexibilidad y reportes detallados
Postbacks Estáticos (Legado)
- No soporta parámetros dinámicos en la URL del postback
- Devuelve un conjunto limitado de datos predefinidos
Ambas opciones están completamente soportadas. No hay planes para descontinuar los Postbacks Estáticos.
Cómo Configurar Postbacks Dinámicos
- Navegue a:
https://chaturbate.com/affiliates/devkit/dynamic_postback/ - Seleccione “Agregar Nueva URL” bajo la pestaña Postbacks Dinámicos.
- Ingrese su URL de postback y agregue macros soportadas para recibir datos específicos. Por ejemplo:
https://example.com/postback?click_id={click_id}&payout={payout}&country={country} - Seleccione el Tipo de Transacción (Registro o Compra) si desea diferenciar eventos.
- (Opcional) Si su plataforma de seguimiento soporta validación checksum, ingrese una Sal para Validación para verificar la autenticidad del postback.
- Elija su método de entrega: GET (el más común) o POST.
Cómo Funcionan los Postbacks Dinámicos
- Un usuario hace clic en su enlace de afiliado.
-
Registramos su
click_idy cualquier parámetro adicional de URL que pase. - Cuando el usuario completa un registro, enviamos un postback de servidor a servidor a su URL especificada, incluyendo las macros que definió.
- Si el usuario realiza una compra futura, enviamos un postback de compra usando los mismos parámetros guardados en el registro, asegurando una atribución precisa.
Lista de Macros y Definiciones
Estas macros pueden usarse dentro de los Postbacks Dinámicos en el Programa de Afiliados.
Algunas macros son generadas por el sistema en el momento de la conversión (como {payout} o {currency}), mientras que otras son parámetros pasantes suministrados por el afiliado que provienen de su enlace de afiliado (como {click_id} o {track_id}).
Parámetros de Postback Dinámico
| Categoría | Macro | Descripción | Cómo se completa |
| Conversión | {click_id} |
ID único para cada clic de anuncio usado para rastrear la interacción específica del usuario que llevó a una conversión. Límite de caracteres: 1024 |
Parámetro pasante suministrado por el afiliado |
| Conversión | {source} |
Fuente de tráfico especificada en el enlace de afiliado Límite de caracteres: 255 |
Parámetro pasante suministrado por el afiliado |
| Seguimiento | {track} |
Usado para clasificar el tráfico por un conjunto reducido de fuentes de tráfico de su lado, por ejemplo "websiteA", "websiteB" Límite de caracteres: 255 |
Parámetro pasante suministrado por el afiliado |
| Identificación de Transacción | {transaction_id} | ID único del evento de conversión (registro, compra) | Generado por el sistema |
| Identificación de Campaña | {campaign_id} | ID único de la campaña | Generado por el sistema |
| Identificación de Oferta | {program_id} | ID único del programa/oferta | Generado por el sistema |
| Identificación de Oferta | {program_name} | Nombre del programa/oferta (por ejemplo, $1.00 Pago por Registro + $50.00 por Locutor + 5% Ingreso por Afiliado Referido, etc.) | Generado por el sistema |
| Identificación de Usuario | {user_id} | ID único del usuario referido | Generado por el sistema |
| Conversión | {type} |
El tipo de conversión que tuvo lugar. Valores posibles: tokens_signup-referral, tokens_broadcaster-referral, ppr_signup-referral, ppr_broadcaster-referral, revshare_signup-referral, revshare_broadcaster-referral, revshare_purchase, revshare_webmaster-commission, y revshare_payout-adjustment |
Generado por el sistema |
| Conversión | {payout} | Cantidad de dinero acreditada al afiliado por esta conversión (Negativo para devoluciones) | Generado por el sistema |
| Conversión | {currency} | La moneda en la que se realiza el pago | Generado por el sistema |
| Conversión | {amount} | La cantidad gastada por el usuario | Generado por el sistema |
| Conversión | {token} | Número de tokens acreditados al afiliado por esta conversión | Generado por el sistema |
| Acción de Usuario | {timestamp} | La marca de tiempo de cuando se realizó la conversión | Generado por el sistema |
| Acción de Usuario | {date} | La fecha en que se realizó la conversión | Generado por el sistema |
| Acción de Usuario | {time} | La hora en que se realizó la conversión | Generado por el sistema |
| Geolocalización | {country} | El país del usuario | Generado por el sistema |
| Dispositivo y Navegador | {device} | El dispositivo usado por el usuario (móvil, escritorio) | Generado por el sistema |
| Dispositivo y Navegador | {language} | La configuración de idioma del navegador del usuario | Generado por el sistema |
| Referencia | {referral} | La URL del referente | Generado por el sistema |
| Reintentos | {attempt} | El número de intentos que se hizo para enviar una solicitud antes de recibir una respuesta adecuada (hasta 6 intentos) | Generado por el sistema |
| Geolocalización | {region} | La región o estado del usuario | Generado por el sistema |