Conectar Kwai Ads (Píxel y Event API)

Con Kwai Ads conectado, el píxel de Kwai se dispara en el checkout y en la página de agradecimiento. Con el token de la Event API, Vipter también envía las ventas desde el servidor, incluso un PIX (el pago instantáneo de Brasil) pagado después de que el comprador cerró la página.

Kwai solo acepta desde el servidor los eventos de quien llegó desde uno de sus anuncios, identificado por el parámetro click_id en la dirección. Por eso la cuenta funciona como un postback: con el token, muestra Navegador + postback.

Antes de empezar, conviene leer cómo funciona el seguimiento de conversiones.

Paso 1: copiar el ID del píxel y generar el token en KwaiCopiar enlace de la sección

1. En Kwai for Business, abre Activos›Píxel y elige tu píxel.
2. Copia el ID del píxel, solo números, como 525567814242672725.
3. En la configuración del píxel, haz clic en Generar token de acceso y copia el token.

Paso 2: llevar el click_id hasta el checkoutCopiar enlace de la sección

Sin el click_id, nada sale desde el servidor. Prepara la URL de los anuncios antes de vender.

1. En la URL de destino del anuncio en Kwai, agrega click_id=__CALLBACK__. Kwai cambia la macro __CALLBACK__ por el identificador de cada clic.
2. Agrega también utm_source=kwai. El informe Origen de las ventas solo pone la venta en el canal Kwai Ads cuando la utm_source contiene "kwai" o "snack" (de SnackVideo), porque otras redes también usan el nombre click_id.
3. Si el anuncio lleva a una página de ventas en otro dominio, pega en ella el script de UTMs. Lleva el click_id y las UTMs hasta el checkout.

Un destino listo queda así:

https://tutienda.com/oferta?utm_source=kwai&click_id=__CALLBACK__

Si la URL ya tiene un ?, une los parámetros nuevos con &.

Paso 3: conectar la cuenta en VipterCopiar enlace de la sección

1. En el panel de Vipter, abre General›Conversiones›Cuentas y haz clic en Conectar cuenta. Elige Kwai Ads.
2. Completa los campos numerados. El modo de prueba está en Avanzado: modo de prueba.

3. Haz clic en Conectar y verificar. Vipter guarda la cuenta y comprueba el formato del ID. El token no se prueba ahora: Kwai solo acepta eventos de quien llegó desde el anuncio con el click_id. El token se confirma en la primera venta que viene de un anuncio.
4. Haz clic en Continuar, marca los productos en los que el píxel debe dispararse y haz clic en Terminar. Activa Usar automáticamente en productos nuevos para incluir los productos creados después.

Paso 4: probarCopiar enlace de la sección

Kwai rechaza los eventos sin el clic en un anuncio, así que la cuenta no tiene el botón de evento de prueba. La verificación se completa sola:

1. Abre la cuenta en Cuentas, en la pestaña Conexión, y haz clic en Verificar ahora.
2. Cuando el primer comprador completa sus datos en el checkout, la lista muestra el primer evento recibido.
3. Después de la primera venta que viene de un anuncio de Kwai, la lista muestra la primera venta enviada desde el servidor. En General›Conversiones›Actividad, la compra aparece en el canal Servidor como EVENT_PURCHASE.

Qué envía Vipter a KwaiCopiar enlace de la sección

• Kwai no tiene eventos personalizados. El PIX generado va como pedido realizado (EVENT_PLACE_ORDER).
• Kwai no recibe Envío elegido, Renovación ni Reembolso / contracargo.
• Sin token, todos los eventos activados salen desde el navegador.
• Con token, Vista de página, Inicio del checkout y Pago iniciado siguen en el navegador. Lead (contacto completado), PIX generado, Compra y Suscripción iniciada pasan a salir solo desde el servidor, y solo para quien llegó con el click_id. Kwai no documenta cómo unir el evento del navegador con el del servidor, así que cada uno de esos eventos sale por un solo camino, para que la venta no cuente dos veces.
• Los eventos llevan valor, moneda, el producto, la cantidad y, desde el servidor, el ID del pedido.
• Kwai encuentra a quien hizo clic solo por el click_id. Por eso la cuenta no tiene la tarjeta Datos de coincidencia, y ningún dato del comprador va a Kwai.
• En Qué enviar, elige los eventos, el Valor de la conversión y la Moneda del valor. Consulta eventos y valores.

Con token, una venta de quien no vino de un anuncio de Kwai no llega a Kwai. Sin el click_id, Kwai tampoco podría vincular esa venta a un anuncio.

Problemas comunesCopiar enlace de la sección

• El envío desde el servidor solo ocurre cuando el anuncio trae el identificador del clic; sin él, un PIX pagado con la página cerrada no se cuenta.

  El anuncio no lleva click_id=__CALLBACK__ en la URL, o el click_id se pierde en la página de ventas. Revisa el paso 2 y pega el script de UTMs en la página de ventas.

• Las ventas de Kwai aparecen en Otras campañas (UTM) o Directo / sin origen en el informe

  La utm_source del anuncio no contiene "kwai" ni "snack". Agrega utm_source=kwai a la URL de destino. Las ventas anteriores siguen en el canal en el que entraron.

• Eventos con el estado Omitido y el motivo no_click_id

  El comprador no vino de un anuncio de Kwai, o llegó sin el click_id. Para quien no vino de un anuncio, es lo esperado.

• Los envíos del servidor fallan en la actividad

  Kwai responde {"result":1} cuando acepta el evento. Cualquier otra respuesta es un rechazo, y un rechazo no tiene nuevo intento automático. Las causas comunes son un token de otro píxel, un ID del píxel equivocado o un click_id que no vino de Kwai. Genera otro token, revisa el ID en Conexión y reenvía el evento en Actividad.

• Tu plan no permite otra cuenta con envío desde el servidor. Mejora el plan para conectar una más.

  El plan llegó al límite de cuentas con envío desde el servidor. Quita el token de una cuenta que ya no usas o cambia de plan en Plan Vipter.

Qué hacer despuésCopiar enlace de la sección

• Pega el script de UTMs en tu página de ventas para no perder el click_id del anuncio.
• Mira de dónde vienen las ventas en el informe Origen de las ventas.
• Conecta también TikTok Ads.