Qué hace la API de Conversiones
Una API de Conversiones (CAPI) envía eventos de conversión desde el servidor de Storeep directamente a la plataforma publicitaria, sin pasar por el navegador del comprador. Al funcionar de servidor a servidor, no le afectan los bloqueadores de anuncios, la configuración de privacidad del navegador ni las limitaciones de seguimiento en iOS, y transmite datos de clientes cifrados para mejorar la calidad de coincidencia en Smart Bidding y audiencias similares. Para los píxeles del lado del cliente, consulta el artículo complementario Browser pixels.
Puedes ejecutar un píxel de navegador y una CAPI para la misma plataforma al mismo tiempo. Storeep marca ambos con un ID de evento compartido creado a partir del tipo de evento y el número de pedido, así la plataforma los deduplica en una sola conversión en vez de contar dos.
Qué plataformas ofrecen una CAPI
- Facebook / Meta Conversion API.
- TikTok Events API.
- Snapchat Conversions API.
X y Google Ads no tienen una API de Conversiones del lado del servidor en Storeep; solo funcionan del lado del navegador.
Qué se envía
En cada pedido que califica, Storeep envía el valor y la moneda del pedido, los productos comprados y las señales del comprador: correo electrónico cifrado, teléfono cifrado, un ID de cliente cifrado (external_id), la dirección IP, el user agent y, para Facebook y Snapchat, el país de mercado cifrado. También reenvía cualquier ID de clic de anuncio encontrado en las cookies del comprador (Facebook _fbc y _fbp, TikTok ttclid, Snapchat ScCid) para que la plataforma pueda atribuir la conversión al clic original.
Tipos de eventos de conversión
- Facebook: solo Lead o Purchase. La CAPI de Facebook no envía eventos de añadir al carrito ni de checkout.
- TikTok: Lead, Purchase, Place an order o Complete payment.
- Snapchat: Purchase o Reserve.
Moneda y pedidos de valor cero
Cada evento usa la moneda propia del pedido cuando la plataforma lo permite; si no, el valor se convierte a USD. La CAPI de Facebook omite cualquier pedido cuyo total sea 0, porque Meta rechaza conversiones sin valor, lo que la mantiene consistente con el píxel de navegador de Facebook.
Control de pedidos abandonados
Este es el comportamiento clave a entender. Un pedido completamente nuevo siempre activa el envío de la CAPI. Un pedido abandonado es diferente: solo se envía cuando activas el interruptor de Pedidos abandonados para esa entrada de CAPI, y solo en el momento en que el estado del pedido cambia de abandonado a cualquier otro estado.
- Con Pedidos abandonados desactivado, los pedidos abandonados recuperados nunca se envían a la plataforma.
- Si está activado, el evento se dispara cuando el pedido sale del estado de abandonado, ya sea que cambies el estado manualmente o que la app Automator lo cambie automáticamente.
- Si Automator no está instalada, deberás mover el pedido a otro estado tú mismo para que el evento se envíe.
- El interruptor es por entrada, así que puedes activar el seguimiento de pedidos abandonados para un Pixel ID y dejarlo desactivado para otro.
Instalar una CAPI y sus campos
- Abre Apps en el menú de la izquierda.
- Busca la app de Conversion API que quieras y haz clic en Install, luego confirma.
- Abre la app de nuevo y haz clic en Add new pixel para crear una entrada.
Cada entrada tiene estos campos:
- Activate: cuando está activado, los eventos de conversión se envían de servidor a servidor. Activado por defecto.
- Pedidos abandonados: el interruptor de control descrito arriba. Desactivado por defecto.
- Ad account name: una etiqueta solo para tu referencia.
- Pixel ID: tu Pixel ID de Meta, TikTok o Snapchat.
- Markets: los mercados de la tienda que cubre esta entrada. Selecciona uno o más.
- Conversion event type: las opciones de plataforma listadas arriba.
- Access token: el token de acceso de la API de Conversiones que generas en el administrador de eventos de la plataforma. Obligatorio.
- Activate test mode: cuando está activado, los eventos se envían como eventos de prueba.
- Test code: el código de evento de prueba de la plataforma, por ejemplo TEST_1234. Obligatorio cuando el modo de prueba está activado.
Modo de prueba
Con el modo de prueba activado, los eventos aparecen en la vista de eventos de prueba de la plataforma para que puedas confirmar la integración sin afectar los datos reales. Los eventos de prueba no alimentan la puja ni la optimización de anuncios, así que desactiva el modo de prueba antes de lanzar campañas reales.
Cómo los mercados segmentan una CAPI
Una entrada de CAPI solo se activa para pedidos realizados en los mercados que seleccionaste en ella. Un pedido en un mercado que no elegiste no activa esa entrada, así puedes usar un Pixel ID y token de acceso diferente por país desde la misma tienda.
Cosas a revisar
- Usa el mismo Pixel ID en tu píxel de navegador y en tu CAPI para que la plataforma deduplique ambos envíos en una sola conversión.
- Si los eventos dejan de aparecer en el administrador de eventos de la plataforma, puede que tu token de acceso haya expirado. Regénéralo y actualiza la entrada.
- Cada entrada es independiente. Puedes agregar varias entradas por plataforma, cada una con su propio Pixel ID, token de acceso, mercados, tipo de evento y configuración de pedidos abandonados.
- Recuerda desactivar el modo de prueba antes de lanzar campañas reales, o tus conversiones reales no se contarán.