Hemos expuesto el argumento estratégico en otro lugar: la era del envío masivo ha terminado, y las notificaciones activadas por el comportamiento son lo que las plataformas recompensan y los suscriptores toleran. Esta guía es la otra mitad: cómo activar notificaciones push desde eventos de la aplicación en iOS, desde la instrumentación hasta la entrega al equipo de marketing. Está escrita para el desarrollador que realiza la conexión, con el código que enviará y las convenciones que lo mantendrán mantenible.
La arquitectura en un párrafo
Su aplicación dispara eventos con nombre y propiedades tipificadas. PushEngage compara esos eventos con reglas de activación configuradas en el panel, y las campañas se envían — inmediatamente, con retraso o como una secuencia de varios pasos con condiciones de salida. La división del trabajo es el punto: ingeniería instrumenta cada evento *una vez*; marketing crea, edita y elimina campañas contra esos eventos para siempre, sin otra compilación. Su instrumentación es una API para su equipo de marketing.
trackEvent: la señal de propósito general
El SDK de iOS 1.0 introdujo trackEvent, el caballo de batalla para señales conductuales personalizadas:
PushEngage.trackEvent(name: "product_viewed",
properties: [
"sku": "WCJ-1042",
"category": "outerwear",
"price": 189.00,
"in_stock": true
],
profileId: currentUserId, // ties the event to an identified subscriber
provider: nil,
eventType: nil) { success, error in
if !success { log(error) }
}Tres reglas que el SDK aplica, así que diséñelas desde el principio:
- Los valores de las propiedades deben ser cadenas, números o booleanos. Las matrices, diccionarios y fechas se rechazan en el lado del cliente; aplane antes de enviar.
- Los nombres de eventos y las claves de propiedad no deben estar vacíos. El controlador de finalización le indica cuándo falla la validación; regístrelo en compilaciones de depuración.
- Los controladores de finalización llegan en una cola en segundo plano. Despache al hilo principal antes de tocar la interfaz de usuario.
Pase profileId siempre que se identifique al usuario; es lo que permite que una campaña siga a un cliente entre dispositivos en lugar de seguir un dispositivo.
sendTriggerEvent: conectando campañas de activación clásicas
Para las campañas creadas en el generador de activadores del panel — abandono de carrito, abandono de navegación, flujos personalizados — la aplicación dispara sendTriggerEvent con los nombres de campaña y evento que el comercial configuró, más los tokens de datos que la plantilla de notificación renderizará:
let trigger = TriggerCampaign(campaignName: "cart_abandonment",
eventName: "add_to_cart",
data: [
"productname": "Waxed Canvas Jacket",
"price": "$189",
"cartlink": "myapp://cart"
])
PushEngage.sendTriggerEvent(triggerCampaign: trigger) { success, error in
// background queue — dispatch before UI work
}Los tokens de data fluyen hacia el texto de la notificación; así es como “Tu chaqueta de lona encerada te está esperando” se personaliza sin que el comercial toque el código. Recorrimos la secuencia completa de recuperación de carrito en el manual de abandono de carrito de la aplicación móvil; esta llamada es su motor.
addAlert: bajada de precio y reposición de stock, integrados
Los dos activadores de comercio de mayor intención ni siquiera necesitan campañas personalizadas; son ciudadanos de primera clase del SDK. Cuando un usuario observa un producto, registre la alerta:
let alert = TriggerAlert(type: .priceDrop, // or .inventory
productId: "WCJ-1042",
link: "myapp://product/WCJ-1042",
price: 189.00,
data: ["size": "M"])
PushEngage.addAlert(triggerAlert: alert) { success, error in }PushEngage se encarga de la observación, la coincidencia y el envío cuando el precio baja o el stock regresa. Si ha leído nuestra guía de notificaciones de bajada de precio, este es el registro del lado de la aplicación que hace que esas campañas se activen.
Una taxonomía de eventos que escala
La deuda de instrumentación es real: seis meses después, nadie recuerda si el evento es addToCart, cart_add o CartUpdated. Elijan convenciones desde el primer día — nombres en snake_case, orden object_action, claves de propiedad singulares — y cubran el conjunto principal de comercio:
| Evento | Propiedades clave | Campañas que potencia |
|---|---|---|
product_viewed | sku, categoría, precio | Abandono de navegación, personalización |
product_saved | sku, precio | Caída de precio, vuelta a stock, ganchos de recuperación |
cart_updated | valor_carrito, recuento_artículos, artículo_principal | Abandono de carrito |
purchase_completed | valor_pedido, recuento_artículos | Condiciones de salida, post-compra, objetivos |
search_performed | consulta, recuento_resultados | Recuperación de cero resultados, segmentos de interés |
onboarding_step | paso, completado | Ramificación de la serie de incorporación |
Seis eventos, instrumentados una vez, potencian la serie de incorporación, la recuperación del carrito, los ganchos de recuperación y cada segmento que su equipo de marketing solicitará este año.
Prueba el bucle antes de entregarlo
Establece PushEngage.enableLogging = true en las compilaciones de depuración y observa cómo los eventos salen del dispositivo. Dispara cada evento desde una compilación de prueba, confirma que llega a la vista de eventos del panel y envía una campaña de prueba de extremo a extremo por disparador. Las aplicaciones de ejemplo del repositorio de SDK incluyen una pantalla de disparadores funcional de la que puedes copiar el flujo. Quince minutos de verificación aquí ahorran la investigación de "¿por qué no se disparó la campaña?" más tarde, que suele ser un nombre de evento escrito incorrectamente en un lado del contrato.
La entrega: qué posee marketing a partir de aquí
Una vez que los eventos fluyen, tu parte ha terminado. Marketing crea reglas de disparadores, escribe copias, establece retrasos y condiciones de salida, prueba variantes A/B y adjunta seguimiento de objetivos para la atribución de ingresos, todo en el panel, todo sin un ticket. Publica la tabla de taxonomía de eventos en la wiki de tu equipo como contrato entre las dos partes. Luego, observa cómo la cola de solicitudes de tickets de "¿puedes enviar un push?" va silenciosamente a cero, que era el objetivo desde el principio. Para la estrategia que deben seguir esas campañas, entrega a tu equipo de marketing la guía de marketing de push para aplicaciones.
