Paso de parámetros y postback
Una fuente conecta la plataforma y Qubix en ambas direcciones:
- Del enlace hacia Qubix — cuando un visitante hace clic en un anuncio, Qubix toma del enlace los parámetros necesarios (el identificador del anuncio, el pixel, etc.) y los vincula a la visita.
- De Qubix hacia la plataforma — cuando ocurre un evento (registro, depósito), Qubix envía un postback a la plataforma para que conozca el resultado.
Los ajustes de ambas direcciones se establecen en la fuente — véase Crear una fuente.
Parámetros en el enlace del anuncio
Qué valores tomar del enlace lo define la tabla Parámetros de la fuente. Para cada parámetro se indica:
- Clave URL — bajo qué clave llega el valor en el enlace;
- Placeholder — qué sustituirá la plataforma en el valor (su propio macro o un valor fijo).
Ejemplo de enlace para un anuncio de Facebook:
https://your-domain/?pixel=123456789&ad_id={{ad.id}}
Aquí {{ad.id}} es un macro de Facebook: al mostrar el anuncio, la plataforma lo reemplaza por el identificador real por su cuenta. El enlace listo para su fuente lo arma Qubix en el bloque URL de ejemplo para un anuncio del formulario de la fuente — se puede copiar y pegar en el campo URL del anuncio en la plataforma.
El parámetro Ad ID es necesario para vincular los clics con los anuncios y ver estadísticas por ellos. Sin él la fuente seguirá funcionando, pero el desglose por anuncio no estará disponible.
Sobre los parámetros del lado del enlace de campaña — Enlace de campaña y parámetros.
Postback S2S: notificar a la plataforma
Un postback (server-to-server, S2S) es una petición que Qubix envía a la plataforma cuando ocurre un evento. La plantilla de la petición se establece en el campo Postback S2S de la fuente. En la plantilla se insertan macros — Qubix sustituirá en ellos los valores reales antes de enviar:
| Macro | Valor |
|---|---|
{external_id} | El identificador de la visita/lead del lado de la plataforma. |
{status} | El estado del evento (por ejemplo, registro, depósito, rechazo). |
{revenue} | Los ingresos del evento. |
{payout} | El pago del evento. |
{currency} | La moneda. |
{sub_id_N} | Marcas adicionales (sub_id_1, sub_id_2, etc.). |
{tid} | El identificador de la transacción. |
Ejemplo de plantilla de postback:
https://source.com/postback?subid={external_id}&status={status}&payout={revenue}
Facebook: Conversions API en lugar de un postback
Para una fuente con la plantilla facebook, no se usa el postback normal. En su lugar, Qubix envía los eventos directamente a la Facebook Conversions API. Usted solo configura el mapeo de eventos: qué evento de Qubix corresponde a qué evento de Facebook (por ejemplo, depósito → Purchase). El identificador del pixel se toma del enlace del clic, y el token de acceso — del registro de píxeles.
Más información — Facebook Conversions API y Píxeles.