Conecta tu plataforma con RevRake.
Una guía paso a paso para el desarrollador de un operador y para un afiliado. Tu plataforma hace dos cosas: conserva una etiqueta de la URL de destino e informa de los jugadores, con peticiones firmadas o con archivos diarios. Cada campo, límite y código de error está en la referencia de la API.
Cómo encaja todo
Un afiliado comparte un enlace de tracking. RevRake guarda el clic y envía al visitante a tu landing page con dos etiquetas. Tu plataforma conserva una etiqueta hasta que el jugador se registra, y entonces informa a RevRake del jugador y de su dinero. RevRake calcula la comisión, avisa al tracker del afiliado y cierra el mes en un pago.
- Afiliado Enlace de tracking
- Visitante track.revrake.com Clic guardado
- Tu landing page llega con
cidybtag - Tu plataforma conserva la etiqueta, registra al jugador
- RevRake app.revrake.com atribución, comisiones, libro mayor
- Tracker del afiliadopostbackPago mensualCSV
Tu plataforma → RevRake: Eventos firmados o archivos diarios
Para el desarrollador del operador
Los pasos, en el orden en que los vas a hacer.
1Crea tu programa
Regístrate en app.revrake.com/signup con tu email y confírmalo con el enlace que te enviamos. El enlace funciona una vez, durante 48 horas. Al confirmar se crea tu programa y entras como su admin. Es gratis y no necesita tarjeta.
Después verifica el sitio al que llevan tus enlaces. Abre la página Marca, elige "Verifica tu sitio" y publica lo que muestra: un registro DNS TXT revrake-verify=<token> en el host o en un dominio superior, o la etiqueta <meta name="revrake-verify" content="<token>"> en la landing page. Después pulsa la comprobación.
- Hasta que el sitio esté verificado, un visitante que abre uno de tus enlaces de tracking ve primero una página breve que dice adónde lleva el enlace.
2Obtén tu clave
Abre la página Integración de tu portal de operador. Muestra el endpoint, tu ID de clave (empieza por pb_) y el secreto. Solo un admin del workspace puede ver el secreto o rotar la clave.
Cada petición lleva tres cabeceras: el ID de clave, la hora Unix actual en segundos y el HMAC-SHA256 en hexadecimal de <timestamp>.<body> con el secreto. La referencia tiene la receta con ejemplos en curl, Node.js, Python, PHP y Go, y un vector de prueba para comprobar tu código.
- Rotar la clave crea una nueva y detiene la anterior al instante. Cambia tu plataforma a la clave nueva enseguida.
- Guarda el secreto en tu servidor. Nunca lo pongas en una página ni en una app.
3Conserva cid o btag en el registro
Un enlace de tracking redirige al visitante a tu landing page y añade dos parámetros:
https://track.revrake.com/c/<code>?utm_source=telegram&sub1=<tracker click id>
→ https://your-site.example/landing?cid=<click id>&btag=1001_1&utm_source=telegram Guarda uno de ellos con el visitante (una cookie o tu sesión) y grábalo en el jugador cuando se registre. Ese valor es lo que atribuye al jugador.
cides el click ID: 26 letras y dígitos. Trátalo como una cadena opaca y guárdalo como texto. Da la atribución más exacta.btages<número de afiliado>_<número de enlace>, solo dígitos, el formato que las plataformas de casino ya guardan en el jugador. Úsalo cuando tu plataforma tiene un campo btag y ningún lugar para un click ID.- Si la URL de destino de la configuración de tu marca contiene
{click_id}, el click ID se pone ahí en lugar de añadirse comocid. - Las etiquetas UTM del enlace de tracking se pasan a tu landing page.
4Informa de los registros
Cuando un jugador se registra, envía un evento registration con tu ID de jugador y el click_id, el btag o ambos. RevRake atribuye al jugador una sola vez, en ese momento, y la respuesta dice a qué afiliado y por qué.
{"type":"registration","player_id":"PLR-1001","click_id":"01K6QF3M8Z5T7W9XB2C4D6E8GH","btag":"1001_1"} {
"status": "accepted",
"event_type": "registration",
"event_id": "0199b2c4-6f1e-7a53-9d0c-2b8f4e1a7c33",
"attribution": {
"attributed": true,
"reason": "click",
"affiliate_number": 1001,
"link_number": 1,
"click_id": "01K6QF3M8Z5T7W9XB2C4D6E8GH",
"policy_version": 1,
"window_days": 30,
"model": "last_click"
}
} Un jugador se atribuye según la política de tu marca, definida en la página Integración: último clic (por defecto) o primer clic, dentro de una ventana de atribución de 1 a 365 días (30 por defecto). Primero se prueba el click ID, luego el btag, salvo que la política diga que gana el btag cuando los dos no coinciden. Envía todos los registros, también los que no llevan etiqueta: se registran como no atribuidos, y así se sabe que sus depósitos posteriores no son primeros depósitos de un jugador de un afiliado. Cuando la política dice que gana el código promocional, un código que coincide con un enlace se prueba antes que ambos, y uno que no coincide vuelve a ellos. Un acuerdo puede fijar su propia ventana, que sustituye a la de la política para los clics en los enlaces de sus afiliados.
- Envía
email_hasheipsi quieres que el control de autorreferencia trabaje con algo más que el clic. - Envía
country, el código de dos letras del país del jugador (ISO 3166-1 alpha-2, comoGB), si alguno de tus deals no paga por ciertos países. Sin él, se usa el país del clic que trajo al jugador. - Envía
tscuando informes con retraso, para que la ventana de atribución se mida desde la hora real del registro. - Envía
promo_codecuando el jugador escribió un código promocional al registrarse. Solo atribuye al jugador cuando ni el click ID ni el btag lo hacen (ver el paso siguiente). - Envía
email_domain, la parte del email del jugador después de la@, si activas la regla de correo desechable. Envía solo el dominio: si llega una dirección completa, solo se guarda el dominio en el jugador, pero el registro de entrada sigue mostrando la petición tal como llegó.
5Usa códigos promocionales
Un código promocional acredita a un jugador a un afiliado sin clic: el jugador lo escribe al registrarse. En la página Códigos promocionales, un admin añade un código para un afiliado aprobado, y el código se convierte en uno de los enlaces de ese afiliado, visible en su página Enlaces. Crea el mismo código en tu plataforma y envíalo con el registro como promo_code, o en la columna promo_code del archivo REG.
{"type":"registration","player_id":"PLR-1003","promo_code":"GARAGE50"} {
"status": "accepted",
"event_type": "registration",
"event_id": "0199b2c5-1d40-7e82-b3a1-6c0f2d9e4b17",
"attribution": {
"attributed": true,
"reason": "promo_code",
"affiliate_number": 1001,
"link_number": 7,
"policy_version": 1,
"window_days": 30,
"model": "last_click"
}
} - El click ID y el btag van primero. El código promocional solo atribuye al jugador cuando ninguno de los dos lo hace, y el motivo es entonces
promo_code. - Los códigos no distinguen mayúsculas de minúsculas:
GARAGE50ygarage50son el mismo código. Un código tiene de 2 a 40 letras, dígitos, guiones o guiones bajos. - Retirar un código hace que deje de acreditar jugadores nuevos; los jugadores que trajo se quedan con el afiliado. Un código retirado no se puede volver a usar nunca en el programa.
- Cuando no se envió nada más para atribuir al jugador, un código que RevRake no conoce recibe el motivo
unknown_promo_code, y uno retirado,promo_code_retired. Un código de un afiliado que no está aprobado daaffiliate_inactive.
6Informa de los depósitos
Envía un evento deposit por cada depósito, con tu ID de transacción en txn_id. El deal define si el mínimo para CPA se compara con el primer depósito o con los depósitos acumulados, descontados los chargebacks. La calificación crea una comisión CPA por jugador, en retención.
{"type":"deposit","player_id":"PLR-1001","txn_id":"TX-88213","amount":"25.00","currency":"KES","first":true} {
"status": "accepted",
"event_type": "deposit",
"event_id": "0199b2c9-03aa-7e10-b6d2-91c07f5e2a18",
"commission": {
"effect": "created",
"type": "cpa",
"amount_minor": 4000,
"status": "hold"
}
} - Envía
first: trueen el primer depósito del jugador si tu plataforma lo sabe. Sin él, un depósito cuenta como primero si RevRake no conoce ninguno anterior del jugador. - Envía la
currencypropia del depósito. Un depósito en una moneda distinta a la del deal se compara con el deal al tipo de cambio de ese día. - Un depósito puede llegar antes que su registro. Se guarda y se valora cuando llega el registro.
7Informa de los chargebacks
Envía un evento chargeback con su propio txn_id y el txn_id del depósito original en ref_txn_id. Revierte el depósito completo. En CPA acumulado, la comisión solo se retira si el total válido restante cae por debajo del mínimo: una comisión en retención se cancela; una aprobada o pagada recibe una fila de reversión.
{"type":"chargeback","txn_id":"CB-5001","ref_txn_id":"TX-88213"} - El depósito debe haberse comunicado antes. Un chargeback de un depósito desconocido se rechaza, no se guarda.
- Un depósito solo puede devolverse una vez.
8Informa de los ingresos netos de juego (NGR)
Para los deals de RevShare, envía un evento ngr por jugador y periodo: los ingresos netos de juego (NGR) del jugador en un día (YYYY-MM-DD) o en un mes (YYYY-MM), negativos cuando el jugador ganó. Generan el porcentaje fijado en el deal, en retención.
{"type":"ngr","player_id":"PLR-1001","period":"2026-10-03","amount":"118.40","currency":"KES"} - El jugador debe estar registrado antes; los ingresos de un jugador desconocido se rechazan.
- Si una cifra cambia, envía la cifra nueva para el mismo periodo. La diferencia se registra como un ajuste; no se reescribe nada.
- Elige días o meses y no cambies. Un mes y su primer día son periodos distintos:
2026-10no es2026-10-01. Un mes se valora con la versión del deal vigente en su último día y queda retenido desde entonces. - Si quieres, añade
ggr,bonuses,feesytaxes: cómo se llegó a los ingresos netos. El afiliado los ve junto a la comisión; la comisión siempre se calcula sobreamount.
9Elige entre eventos en tiempo real, lotes o el archivo diario
Las tres opciones alimentan el mismo libro mayor de comisiones. Los eventos en directo y los lotes informan transacciones individuales; los archivos SALES informan resúmenes diarios. Elige lo que tu plataforma pueda proporcionar.
POST https://app.revrake.com/v1/files?filename=sales-2026-10-03.csv - Eventos en tiempo real. Una petición firmada por evento, cuando ocurre. El afiliado ve al jugador en segundos. Úsalo si tu plataforma puede llamar a una URL en el registro y en el depósito.
- Lotes. Los mismos eventos como un array JSON de hasta 1.000 por petición, por ejemplo desde una tarea que se ejecuta cada pocos minutos o para una carga histórica. Cada evento se responde por separado.
- Archivos diarios. Los archivos CSV REG y SALES que tu plataforma ya exporta para un sistema de afiliados, subidos en la página Integración, enviados a
POST /v1/files, o descargados por RevRake desde una dirección donde tu plataforma los publica (paso siguiente). Una fila por jugador y día. Envía el archivo REG antes que el archivo SALES del mismo día: los ingresos de un jugador que aún no está registrado se rechazan. - Un resumen SALES cubre los depósitos y chargebacks del jugador para el día de actividad y la moneda, en la zona horaria de los archivos. Los postbacks cubiertos no se suman de nuevo, lleguen en el orden que lleguen; sus IDs siguen disponibles para chargebacks. Los totales contradictorios se rechazan. Los IDs de transacción distintos siguen representando depósitos distintos, aunque tengan el mismo importe.
- SALES exige
deposits(depósitos brutos del día, incluido FTD),first_deposit_amount(solo en el día del primer depósito, ya incluido en el bruto) ychargeback(importe separado de chargebacks de ese día). Son importes diarios, no totales históricos. Las celdas vacías equivalen a cero; los importes deben ser no negativos. Se guarda un resumen inmutable por marca, jugador y día: las reexportaciones iguales son replays; cambiar dinero o moneda genera conflicto. - El dinero recibido antes de REG se guarda y calcula cuando llega el registro; el NGR rechazado debe reenviarse después de REG. El dinero diario usa los tipos de su fecha de actividad. La falta de cambio o un chargeback ambiguo del primer depósito puede retener el pago. Revisa eventos rechazados y el registro de entrada; lee el contrato SALES completo antes de conectar tu exportación.
10Deja que RevRake descargue el archivo diario
Si tu plataforma publica el archivo de cada día en una dirección web, RevRake puede descargarlo por sí solo. En la página Integración, un admin añade una dirección de archivo: un nombre (como REG o SALES), la dirección, cómo iniciar sesión y la hora del día. Cada día a esa hora, en la zona horaria de tu workspace, RevRake descarga el archivo de ayer en pocos minutos y lo importa exactamente igual que una subida.
https://reports.your-platform.example/affiliates/reg-{date}.csv
→ GET https://reports.your-platform.example/affiliates/reg-2026-10-04.csv - En la dirección,
{date}se convierte en el día del archivo comoYYYY-MM-DD, y{yyyymmdd}enYYYYMMDD. Usa una dirección por archivo: una para REG y otra para SALES. - Inicio de sesión: ninguno, un nombre de usuario y una contraseña (HTTP Basic), o un token enviado como
Authorization: Bearer. Una contraseña o un token solo se envía a una direcciónhttps://. - Una descarga que no importa un archivo, por cualquier motivo (un
404o cualquier respuesta que no sea2xx, un error de red, un archivo demasiado grande o ilegible), se vuelve a intentar cada hora hasta la descarga del día siguiente. Cada dirección se descarga por separado, así que una que falla no retrasa a las demás. Cuando lleva 3 horas de retraso, los admins del workspace reciben un email, y la página Integración muestra el archivo como retrasado. - La descarga del día siguiente pasa al día siguiente. Para completar un día que faltó, o para probar la dirección, pulsa "Descargar ahora" y elige el día. Un archivo descargado dos veces no registra nada dos veces.
- Pon al archivo REG una hora anterior a la del archivo SALES: los ingresos de un jugador que aún no está registrado se rechazan.
- Un archivo puede tener hasta 32 MB. RevRake solo descarga desde direcciones públicas, verifica los certificados y abandona tras un minuto. Las últimas 30 descargas de cada dirección se listan con su resultado.
11Prueba antes de pasar a producción
La página Integración puede enviar un evento de prueba: pasa un registro por el camino real y muestra lo que ocurriría, sin guardar nada. Úsalo con un cid de un clic real en uno de tus enlaces de tracking.
Cada petición firmada con tu clave y cada fila de archivo importada o rechazada aparece en el registro de entrada de la misma página con su resultado, el motivo y el cuerpo tal como llegó. Muestra las últimas 50 de los últimos 7 días. La dirección IP de un cuerpo nunca se guarda, y un cuerpo largo se corta a los 4.000 caracteres.
- Comprueba tu código de firma con el vector de prueba antes de enviar nada.
- Enviar el mismo evento dos veces es seguro. La segunda respuesta es la primera con
"status":"duplicate".
12Elige tus reglas de fraude
En la página Alertas, pestaña Reglas, un admin activa y desactiva las reglas de fraude. Cada regla genera su propia alerta sobre un jugador que detecta. El jugador sigue atribuido, y sus comisiones esperan en retención hasta que alguien libera o confirma la alerta en la cola de revisión. La autorreferencia y las ráfagas de clics están activadas desde el principio; las reglas siguientes están desactivadas hasta que las actives.
- Clic de anuncio pagado. El clic que trajo al jugador llevaba el click ID de una red publicitaria (
gclid,wbraid,fbclid,msclkidottclid), lo que puede significar que el afiliado puja por el nombre de tu marca. - Correo desechable. El dominio del email del jugador está en una lista pública de dominios de correo desechables. Necesita
email_domainen el registro. - País distinto. El
countrydel registro es distinto del país del clic. - Registro justo después del clic. El jugador se registró dentro del número de segundos que defines (hasta 3.600) después del clic; un registro tan rápido parece automatizado.
- Cuenta de pago compartida. Un afiliado guarda datos de pago que otro afiliado del programa ya usa. Esta alerta no retiene ninguna comisión, pero mientras está abierta la línea de pago del afiliado queda retenida en el cierre mensual. El número de cuenta y el código de ruta deben coincidir, sin tener en cuenta mayúsculas, espacios ni puntuación; un número de cuenta con menos de cuatro letras o dígitos no se compara. Una dirección de monedero cripto o una cuenta de monedero electrónico cuenta como número de cuenta. Solo recibe la alerta el afiliado que guarda los datos.
- Las reglas de jugador se ejecutan una vez, en el registro, sobre jugadores atribuidos; las reglas de clic pagado, de país y de tiempo necesitan el clic que trajo al jugador. Una regla se aplica desde el momento en que se guarda, no a jugadores anteriores.
- Las alertas abiertas pueden decidirse solas tras un número de días que eliges (de 1 a 365; 0, el valor por defecto, significa nunca), liberadas o rechazadas. En la cola de revisión puedes liberar o confirmar hasta 200 alertas a la vez.
13Lista de comprobación para producción
- La landing page conserva
cidobtaghasta que el jugador se registra, también cuando vuelve más tarde en el mismo navegador. - Tu código de firma reproduce el vector de prueba, y el reloj de tu servidor está sincronizado (NTP).
- Un clic real, y después un registro de prueba con su
cid, muestra el afiliado correcto. - Se envían los registros de todos los jugadores, no solo de los que llevan etiqueta.
- Los depósitos llevan un
txn_idestable y su moneda. - Ante un tiempo de espera agotado o un
5xx, tu plataforma envía el evento de nuevo, con un timestamp nuevo. - Un
422se registra en tu lado y se revisa: un reintento no lo resolverá. - El registro de entrada muestra
acceptedpara cada tipo de evento que envías.
14Lleva los informes y las comisiones a tu back office
Tu backend puede leer lo que muestra el portal, con la misma clave y las mismas tres cabeceras: GET /v1/reports devuelve el informe de la página Informes, como JSON o como CSV, y GET /v1/commissions devuelve el libro mayor de comisiones página a página. Una lectura no tiene cuerpo, así que la firma cubre la ruta y la query exactamente como las envías. La referencia tiene cada parámetro y cada campo.
GET https://app.revrake.com/v1/reports?by=link&days=7 GET https://app.revrake.com/v1/commissions?from=2026-09-01&to=2026-10-01&per_page=500 - El estado de una comisión cambia después de escribirse la fila: en retención, luego aprobada, luego pagada, o rechazada. No te limites a traer las filas nuevas. Lee de nuevo un periodo, por ejemplo los últimos 60 días cada noche, y actualiza por su
idlas filas que ya tienes. - Los importes están en unidades menores, con la moneda al lado. Nunca sumes importes de monedas distintas; usa
reporting_minorpara los totales en tu moneda de informes. - Como máximo 120 lecturas por minuto y clave. Cada respuesta dice cuántas quedan en
X-RateLimit-Remaining. Ante un429, espera los segundos indicados enRetry-Aftery envía la petición de nuevo. - Nunca des tu clave a un afiliado: lee todo el programa y puede enviar eventos. Cada afiliado crea su propia clave, que solo lee sus propias cifras.
- Los mismos informes y el libro mayor también se pueden descargar como CSV en el portal.
15Entérate de los cambios en tus propios sistemas
Los webhooks envían lo que pasa en tu programa a tus propios sistemas (un CRM, un data warehouse, un canal de chat) en el momento en que pasa: solicitudes y decisiones sobre afiliados, jugadores registrados, comisiones cuando se crean, se aprueban, se rechazan, se pagan o se revierten, y pagos. En la página Integración, un admin pulsa "Añadir un endpoint", escribe la dirección de tu servidor y marca los eventos. El secreto de firma se muestra una sola vez: cópialo en ese momento.
{
"id": "0199b2c9-0a11-7c3e-9f20-7d4b1e6a2c58",
"type": "commission.created",
"created_at": "2026-10-05T09:12:44.318204Z",
"data": {
"player_id": "PLR-1001",
"occurred_at": "2026-10-05T09:12:40Z",
"attributed": true,
"affiliate_number": 1001,
"affiliate_name": "Odds Garage",
"commission_id": "0199b2c9-0a0f-7a51-8c3d-5e2f4a6b7c90",
"commission_type": "cpa",
"amount": "25.00",
"amount_currency": "USD",
"commission": "40.00",
"commission_currency": "USD"
}
} Cada evento es un POST JSON firmado con ese secreto, con un cuerpo como el de arriba. La referencia lista cada evento y campo, las cabeceras y el código de verificación en Node.js y Python.
- Verifica la firma sobre el cuerpo en bruto antes de interpretarlo, y responde con un
2xxen menos de 5 segundos. - Descarta las repeticiones por el
iddel cuerpo: un evento puede llegar más de una vez. - Pulsa "Enviar prueba" para comprobar tu endpoint. El registro de entregas de cada endpoint muestra lo que se envió y lo que respondió tu servidor.
- Una entrega fallida se reintenta durante un día y medio aproximadamente. Tras 20 intentos fallidos seguidos, el endpoint se desactiva; los eventos siguen en cola y se envían cuando lo vuelves a activar.
16Solución de problemas
bad_signature. Firma los bytes exactos que envías: la misma cadena, no una copia del JSON serializada de nuevo. El texto firmado es el timestamp, un punto y después el cuerpo. La firma va en hexadecimal en minúsculas. Comprueba que el secreto no tenga un espacio o un salto de línea al final.bad_timestamp. El timestamp debe estar en segundos Unix (no en milisegundos) y a menos de cinco minutos de la hora real. Sincroniza el reloj del servidor y firma cada reintento con un timestamp nuevo.unknown_key. El ID de clave está mal escrito, o la clave se rotó. La actual está en la página Integración.- Todo es duplicado. Los registros usan
player_id; los depósitos y chargebacks usantxn_id. Reutiliza un ID solo para un reintento idéntico. Cambiar el dinero del depósito o la referencia del chargeback genera conflicto. Usa un ID distinto para cada transacción real. - Los jugadores no se atribuyen. Mira el
reasonen la respuesta o en el registro de entrada.no_tag: la landing page perdió la etiqueta antes del registro.unknown_clickounknown_btag: el valor se cambió o se cortó por el camino.outside_window: el clic es más antiguo que la ventana de atribución.affiliate_inactive: el afiliado no está aprobado.unknown_promo_codeopromo_code_retired: el código promocional no es uno de los tuyos, o fue retirado. - Informo por las dos vías mientras cambio de integración. Un resumen SALES cubre postbacks del jugador, día de actividad y moneda en la zona de archivos. Los importes cuentan una vez, sin importar el orden de llegada, y los
txn_idreales siguen disponibles. Se rechaza un resumen inferior a las transacciones conocidas o pruebas contradictorias del primer depósito. Los IDs de postback distintos siguen contando como depósitos separados. - Un depósito llegó antes que su registro. La respuesta lleva
"waiting_for_player": true. No se pierde nada: envía el registro y el depósito se valora entonces. - Un depósito no generó nada. El
commission.reasondice por qué:unattributed,not_first,below_threshold,country_blocked,no_cpa_in_deal,already_earnedono_deal_version. - Una comisión está en retención con "a la espera de un tipo de cambio". El depósito está en una moneda para la que aún no hay tipo de cambio de ese día. Los tipos se actualizan cada hora; también puedes introducir un tipo para ese día en la página Tipos de cambio. La comisión se liquida en cuanto existe un tipo.
bad_signatureen una lectura. Para unGET, firma el timestamp, un punto y después la ruta y la query exactamente como se envían, en el mismo orden y con la misma codificación:/v1/reports?by=link&days=7. Sin query, firma solo la ruta.- Se rechaza un campo. Un campo que no está en la referencia se rechaza, así que una errata nunca se ignora en silencio. La respuesta indica el
fieldy dice qué corregir.
Para afiliados
Los enlaces y los postbacks se configuran en tu portal de afiliado y no necesitan ninguna clave. Solo necesitas una clave si quieres leer tus cifras por API.
Enlaces, sub-IDs y etiquetas UTM
Crea un enlace de tracking por campaña en la página Enlaces de seguimiento. Cada enlace tiene su propia dirección corta y su propio btag, y puede llevar a la página del sitio del programa que tú elijas.
https://track.revrake.com/c/a8Kq2Zx?sub1={clickid}&utm_source=telegram&utm_campaign=october Añade tus propios valores al enlace cuando lo coloques. Se guardan con cada clic:
sub1asub5: hasta 200 caracteres cada uno. Pon el click ID de tu tracker ensub1; vuelve en tus postbacks.utm_source,utm_medium,utm_campaign,utm_term,utm_content: se guardan con el clic y se pasan a la landing page.- Un valor fijado en el enlace desde el portal se usa salvo que la dirección que colocas lleve el suyo.
- Los bots, las previsualizaciones de enlaces y los clics repetidos se guardan y se marcan, y quedan fuera de tus recuentos de clics.
- Da a un enlace un nombre corto para decirlo en un stream o imprimirlo: también se abre en
track.revrake.com/go/<name>. Cada enlace tiene un código QR para descargar en PNG o SVG.
Envía las conversiones a tu tracker
En la página Postbacks, añade un destino: elige tu tracker, sustituye el host de la dirección por el de tu tracker y marca los eventos de los que quieres enterarte. Todo lo que va entre llaves es una macro, que se rellena en cada conversión.
El portal incluye estos presets. En cada uno, el click ID de tu tracker viaja en sub1, y {status} lleva las palabras que conoce ese tracker:
| Tracker | Pon en sub1 de tu enlace | Plantilla de dirección |
|---|---|---|
| Keitaro | {subid} | https://YOUR-TRACKER-DOMAIN/POSTBACK-KEY/postback?subid={sub1}&status={status}&payout={commission}¤cy={currency}&tid={conversion_id} |
| Binom | {clickid} | https://YOUR-TRACKER-DOMAIN/click?cnv_id={sub1}&payout={commission}&cnv_status={status}&cnv_currency={currency} |
| Voluum | {clickid} | https://YOUR-TRACKER-DOMAIN/postback?cid={sub1}&payout={commission}¤cy={currency}&txid={event_id}&et={event} |
| RedTrack | {clickid} | https://YOUR-TRACKER-DOMAIN/postback?clickid={sub1}&sum={commission}&status={status}&type={event}&rdtk_event_id={event_id} |
| BeMob | {clickId} | https://YOUR-TRACKER-DOMAIN/postback?cid={sub1}&payout={commission}&txid={conversion_id}&status={status} |
| PeerClick | {clickid} | https://YOUR-TRACKER-DOMAIN/postback?cid={sub1}&payout={commission}&txid={conversion_id}&status={status}¤cy={currency} |
| FunnelFlux Pro | {hit} | https://YOUR-TRACKER-DOMAIN/pb/?hit={sub1}&tx={conversion_id}&rev={commission}&status={status} |
Para cualquier otro tracker, elige "Otro / personalizado" y escribe la dirección con las macros que necesites.
Guías paso a paso por tracker: Keitaro, Binom, Voluum, RedTrack, BeMob, PeerClick, FunnelFlux Pro.
- Una cuenta puede tener hasta 10 destinos.
- Un registro no lleva dinero:
{commission}y{amount}van vacías en él. - Una macro que RevRake no conoce se envía tal cual, así que una errata se ve en el registro de entregas.
Pruébalo y lee el registro de entregas
Pulsa "Enviar prueba" en un destino: se envía al instante una conversión inventada y ves lo que respondió tu tracker. Cada postback real es una fila en el registro de entregas, con cada intento y la respuesta del tracker.
- Una entrega fallida se reintenta a 1 minuto, 5 minutos, 25 minutos, 2 horas, 10 horas y 24 horas. Tras el último intento se marca como abandonada, y puedes reenviarla a mano.
- Tras 5 y tras 15 fallos seguidos recibes un email. A los 20 el destino se desactiva; corrige la dirección y actívalo de nuevo, y se envía cada postback que se puso en cola mientras tanto. Un destino que desactivas tú mismo no recibe nada nuevo.
- Tu tracker debe ser accesible en una dirección pública y responder con un estado
2xxen 5 segundos.
Lee tus propias cifras por API
Si llevas tus propios informes, crea una clave en la pestaña API de tu portal de afiliado. Empieza por ak_. El secreto se muestra una sola vez, al crear la clave: cópialo en ese momento. Con ella puedes llamar a GET /v1/reports, /v1/commissions, /v1/affiliates, /v1/links y /v1/deals, firmando como describe la referencia, y obtienes tus propios clics, registros, primeros depósitos y comisiones, y nada de nadie más.
GET https://app.revrake.com/v1/reports?by=link&days=7 - Tu clave no puede enviar eventos ni leer a otros afiliados.
- Crear una clave nueva detiene la anterior al instante. También puedes revocar la clave y quedarte sin ninguna.
- La clave funciona mientras tu cuenta esté aprobada en el programa. Si no lo está, la respuesta es
403affiliate_inactive. - El estado de una comisión cambia después de escribirse la fila (en retención, aprobada, pagada o rechazada). Lee de nuevo un periodo en lugar de traer solo las filas nuevas.
- Nunca pidas al operador su clave, y nunca compartas la tuya. Sin clave, las mismas cifras están en tu portal, con descargas en CSV.
¿Listo para conectar? Crea tu programa y obtén tu clave.
Creas tu programa tú mismo: te registras, confirmas tu email y entras en pocos minutos. Gratis para operadores, para siempre. Sin tarjeta.
¿Preguntas? Escribe a hello@revrake.com