Descripción general
Flipkart no envía webhooks, así que AffClix funciona al revés: importa tus pedidos desde la API de Flipkart Affiliate cada hora. Cada enlace saliente a Flipkart lleva tu Tracking ID de Flipkart (affid) y el ID de clic de AffClix en uno de los parámetros de paso de Flipkart (affExtParam1 o affExtParam2). Flipkart devuelve ese ID de clic con cada pedido, y así se vincula el pedido con el partner y la campaña.
Después, los pedidos siguen el mismo proceso que cualquier otra tienda: atribución, deduplicación, tus filtros de pedidos, comisión y postbacks a los partners.
Por qué es importante esta integración
- Paga a los partners por ventas reales en Flipkart: la comisión se calcula a partir del valor del pedido que informa Flipkart.
- Cancelaciones gestionadas automáticamente: un pedido cancelado o devuelto revierte la comisión de forma automática.
- Sin webhooks que configurar: Flipkart solo necesita un Tracking ID y un token de API.
- Pedidos de varios artículos contados una vez: Flipkart informa de cada artículo por separado; AffClix los agrupa en un único pedido para comisionarlo una sola vez.
- Cambios de estado detectados: cada sincronización vuelve a leer los últimos siete días, así que un pedido que pasa de provisional a aprobado o cancelado se actualiza.
- Feed de productos incluido: Sync Products importa el catálogo de Flipkart para que los partners creen enlaces profundos.
Requisitos previos
- Un plan de AffClix que incluya E-commerce: el menú Integrations → E-commerce.
- Una cuenta aprobada de Flipkart Affiliate con acceso a la API.
- Tu Tracking ID y tu token de API de Flipkart (paso 1).
- Un anunciante en AffClix que sea propietario de la tienda: verá sus pedidos y comisiones en su propio portal.
- Una campaña cuya URL de destino apunte a Flipkart y lleve el ID de clic (paso 3).
Paso 1: Obtén tu Tracking ID y tu token de API en Flipkart
Inicia sesión en Flipkart Affiliate
Accede al panel de Flipkart Affiliate con la cuenta que recibe la comisión.
Copia el Tracking ID
Tu Tracking ID aparece en el panel. También es el valor de affid en tus enlaces de Flipkart.
Genera un token de API
Abre la sección API y genera (o copia) tu token. Mantenlo en privado: da acceso de lectura a tus informes de pedidos.
Paso 2: Añade la integración de Flipkart en AffClix
Abre las integraciones de e-commerce
Ve a Integrations → E-commerce, abre la pestaña Integrations y haz clic en Add Integration.
Elige Flipkart
Selecciona la tarjeta Flipkart. Flipkart funciona solo por importación, así que no hay tarjeta de webhook que completar.
Nombra la tienda y elige su propietario
Introduce un Integration Name como Flipkart – India y elige el anunciante en Store Owner.
Introduce las credenciales
Pega el Tracking ID y el API Token. En Click ID Parameter, elige qué parámetro de paso lleva el ID de clic de AffClix (affExtParam1 por defecto). El otro se lee como sub ID 1.
Revisa las reglas de pedidos y guarda
Comprueba la ventana de atribución, la moneda y los filtros de pedidos, y haz clic en Create Integration. En la página de edición de la tienda, Test Connection llama a la API de Flipkart para confirmar las credenciales.
Paso 3: Envía el tráfico de los partners con el ID de clic
La atribución depende de que cada enlace a Flipkart lleve tu Tracking ID y el ID de clic de AffClix. Configúralo una vez en la URL de destino de la campaña; los enlaces de seguimiento de los partners lo añaden automáticamente.
Define la URL de destino de la campaña
Usa la página de Flipkart como URL de destino y añade affid=TU_TRACKING_ID&affExtParam1={click_id}, por ejemplo https://www.flipkart.com/…?affid=tuid&affExtParam1={click_id}. Si en el paso 2 elegiste affExtParam2, usa ese.
Prueba un enlace
Abre el enlace de seguimiento de un partner y comprueba que la URL de Flipkart a la que llegas muestra un ID de clic real en lugar de {click_id}.
Flipkart solo devuelve lo que llevaba el enlace. Un pedido que viene de un enlace sin ID de clic no se puede vincular a un partner.
Paso 4: Sincroniza los pedidos y comprueba el resultado
Espera a la sincronización horaria o lanza una ahora
Los pedidos se importan cada hora. Para importarlos al momento, abre la tienda y haz clic en Sync Orders.
Revisa los pedidos
Abre la pestaña Orders de E-commerce. Cada pedido de Flipkart aparece una vez, con su valor, su estado y el partner al que se atribuyó.
Aprueba o deja correr el periodo de retención
Con Paid orders only activado (valor predeterminado), los pedidos provisionales esperan a que Flipkart los apruebe. Después, la comisión sigue tu configuración de aprobación.
Ejemplo real
Un editor de ofertas promociona la venta de electrónica de Flipkart a través de AffClix. La marca de la campaña paga a los partners el 4 % de cada pedido aprobado.
- Un comprador hace clic en el enlace de un partner y llega a Flipkart con
affid=dealsco&affExtParam1=seguido del ID de clic de AffClix. - El comprador pide unos auriculares y una funda en la misma compra, por ₹6.200. Flipkart informa de dos artículos con el mismo ID de pedido; AffClix los agrupa en un único pedido de ₹6.200.
- Al principio el pedido es provisional, así que espera. Cuando Flipkart lo aprueba, la siguiente sincronización registra una venta y una comisión de ₹248 para el partner.
- Una semana después el comprador devuelve los auriculares y Flipkart marca el pedido como cancelado. La siguiente sincronización revierte la comisión.
Resultado: el partner cobra por la venta que Flipkart confirmó, y la comisión desaparece cuando desaparece la venta, sin que nadie tenga que editar una hoja de cálculo.
Gestión y supervisión de la integración
- Última sincronización: la página de la tienda muestra cuándo se importaron los pedidos por última vez y el mensaje de error de Flipkart si la última importación falló.
- Sync Orders: importa ahora en lugar de esperar a la ejecución horaria; vuelve a leer la misma ventana de siete días.
- Test Connection: pide a Flipkart que confirme que el Tracking ID y el token siguen funcionando.
- Sync Products: importa el catálogo de Flipkart a tu feed de productos.
- Pausar: poner la integración como inactiva detiene la sincronización sin perder su configuración ni sus pedidos.
Cómo se tratan los estados de pedido de Flipkart
Flipkart informa de un estado por pedido. AffClix convierte cada uno en un evento de pedido:
| Estado en Flipkart | Qué hace AffClix |
|---|---|
| tentative | Registra el pedido como pendiente. Con Paid orders only activado, todavía no hay comisión. |
| approved | Registra el pedido como pagado y crea la comisión. |
| cancelled / returned | Registra un reembolso y revierte cualquier comisión ya creada. |
Solución de problemas
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| Test Connection falla | El Tracking ID o el token de API son incorrectos, o el token se regeneró. | Vuelve a copiar ambos desde Flipkart Affiliate y guarda. |
| Los pedidos llegan sin partner | El enlace no llevaba el ID de clic, o está seleccionado un Click ID Parameter incorrecto. | Revisa la URL de destino de la campaña (paso 3) y que el parámetro coincida con el de tus enlaces. |
| Un pedido aparece pero no genera comisión | Sigue provisional y Paid orders only está activado. | Espera a que Flipkart lo apruebe; la siguiente sincronización crea la comisión. |
| No se detectó un cambio de estado antiguo | El cambio se produjo más de siete días después del pedido. | Ejecuta Sync Orders; pide al soporte que amplíe el periodo de revisión para una recuperación puntual. |
Conclusión
Con Flipkart conectado, las ventas en el marketplace se siguen como las de cualquier otra tienda: cada pedido que lleva un ID de clic de AffClix se atribuye al partner correcto en menos de una hora, y las cancelaciones revierten la comisión automáticamente.
Flipkart solo informa de los pedidos procedentes de enlaces que llevaban tu Tracking ID. Asegúrate de que todas las campañas que apuntan a Flipkart usan la URL de destino del paso 3.
Relacionado: Amazon Associates · Shopify · Macros de seguimiento