Integración con RudderStack
RudderStack es una plataforma de datos de clientes que recopila eventos de sus aplicaciones, sitios web, servidores y almacenes de datos y los reenvía a otras herramientas. Con el destino Pushwoosh en RudderStack, los datos que ya recopila allí llegan a Pushwoosh sin código adicional en su aplicación:
- Los eventos track se convierten en eventos de Pushwoosh. Úselos para crear segmentos y para iniciar o ramificar customer journeys.
- Los identify traits se convierten en etiquetas específicas de usuario. Úselos para segmentar y personalizar notificaciones push, mensajes in-app y correos electrónicos.
Antes de empezar
Anchor link toEl destino vincula todos los datos por User ID, así que compruebe primero estos requisitos previos:
- El SDK de Pushwoosh está integrado en su aplicación.
- Su aplicación llama a
setUserIdcon el mismo valor que RudderStack envía comouserId. Pushwoosh vincula los eventos y traits entrantes a los usuarios mediante este valor. - El dispositivo de cada usuario está registrado con este User ID antes de que RudderStack envíe llamadas
identifypara ese usuario. Los traits de un User ID que Pushwoosh aún no conoce se descartan. - Tiene acceso a Settings → API Access en Pushwoosh para crear un token de API.
- Tiene un workspace de RudderStack con al menos una fuente que envía llamadas
trackoidentify.
Configurar el destino Pushwoosh en RudderStack
Anchor link toLa configuración tiene dos partes: obtiene dos valores en Pushwoosh y luego crea el destino en RudderStack.
Obtener el código de la aplicación y un Device API token
Anchor link toRudderStack necesita dos valores para enviar datos a su aplicación: su código de aplicación y un Device API token.
- En Pushwoosh, abra la aplicación a la que desea enviar datos.
- Copie el código de la aplicación. Se muestra debajo del nombre de la aplicación en la esquina superior izquierda y tiene el formato
XXXXX-XXXXX. - Vaya a Settings → API Access y haga clic en Generate New Token.
- En Token type, elija
device. - En Name, introduzca un nombre para el token, por ejemplo
RudderStack. - Haga clic en Generate.
- En la lista de tokens, haga clic en el menú de tres puntos junto al nuevo token y elija Edit token….
- En Applications, seleccione la aplicación del paso 1 y haga clic en Save.
- Copie el valor del token de la lista de tokens.
Un Device API token es suficiente para el destino. No necesita un Server API token.
Añadir el destino en RudderStack
Anchor link toEl destino Pushwoosh conecta sus fuentes de RudderStack con su aplicación de Pushwoosh.
- En el panel de RudderStack, vaya a Collect → Destinations.
- Haga clic en New destination.
- Seleccione Pushwoosh en la lista.
- Introduzca un nombre para el destino y haga clic en Continue.
- Seleccione las fuentes que desea enviar a Pushwoosh.
- En Application Code, pegue el código de la aplicación.
- En API Token, pegue el Device API token.
- Finalice la configuración para guardar el destino.
RudderStack envía los datos a Pushwoosh desde sus propios servidores (cloud mode), para cada tipo de fuente que admite el destino.
Para la parte de la configuración en RudderStack, consulte la guía del destino Pushwoosh en la documentación de RudderStack.
Qué datos envía RudderStack a Pushwoosh
Anchor link toEl destino admite dos tipos de llamadas, track e identify. RudderStack rechaza cualquier otro tipo de llamada, como page, screen, group o alias, para este destino.
Cada llamada debe tener un userId. RudderStack no envía llamadas sin él, porque Pushwoosh no puede atribuir una llamada anónima a un usuario.
Las llamadas track se convierten en eventos de Pushwoosh
Anchor link toCada llamada track se convierte en un evento de Pushwoosh con el mismo nombre que el evento de RudderStack:
| Campo de RudderStack | Pushwoosh |
|---|---|
event | Nombre del evento |
properties | Atributos del evento |
userId | User ID |
timestamp (o originalTimestamp) | Hora del evento |
context.device.id | Device ID, si existe |
context.device.type o context.os.name | Plataforma: android; ios para iOS, iPadOS, watchOS y tvOS; web para cualquier otro valor o si no hay valor |
Si el evento o un atributo todavía no existe en la aplicación, Pushwoosh lo crea automáticamente.
Pushwoosh descarta el evento completo en estos casos. No devuelve ningún error, por lo que RudderStack informa el evento como entregado:
- La llamada tiene más de 100 propiedades.
- El valor de una propiedad supera los 10 KB.
- El nombre del evento supera los 255 caracteres.
- El evento es nuevo y su nombre supera los 128 caracteres o contiene caracteres de control.
Un evento conserva hasta 100 atributos. Cuando un evento ya tiene 100 atributos conocidos, Pushwoosh sigue registrando las nuevas llamadas, pero los nuevos nombres de propiedades no se añaden como atributos.
Los objetos anidados en properties llegan como cadenas JSON, y las propiedades con valor null se descartan.
Las llamadas identify se convierten en etiquetas específicas de usuario
Anchor link toCada llamada identify establece sus traits como etiquetas del usuario con el userId indicado. Los traits se toman de traits, o de context.traits cuando traits está vacío.
- Solo se escriben etiquetas específicas de usuario. Si la creación automática de etiquetas está habilitada para su cuenta, un trait con un nombre nuevo crea una etiqueta específica de usuario. Si ya existe una etiqueta General con el mismo nombre, Pushwoosh omite ese trait sin error.
- El valor debe coincidir con el tipo de etiqueta. Si una etiqueta ya existe y el valor del trait no se ajusta a su tipo, como texto para una etiqueta Integer, Pushwoosh omite ese trait sin error.
- El usuario ya debe existir en Pushwoosh. Las etiquetas se aplican solo si el SDK de Pushwoosh ha registrado un dispositivo con
setUserIdestablecido en el mismouserId. Los traits de un usuario desconocido se descartan sin error. - Los traits de identidad y contacto no se copian a etiquetas.
email,phone,firstName,lastName,name,address,id,userIdyanonymousIdnunca se envían como etiquetas. Una llamadaidentifyque solo tiene estos traits falla conNo traits left to send as Pushwoosh tags. - Un valor vacío borra la etiqueta. Un trait con una cadena vacía o una lista vacía elimina el valor actual de esa etiqueta para el usuario.
- Los objetos anidados llegan como cadenas JSON. Los traits con valor
nullse descartan.
Lo que el destino no hace
Anchor link toEl destino solo envía datos de track e identify. Estas tareas quedan fuera de su alcance:
- No registra dispositivos ni direcciones de correo electrónico. Los dispositivos provienen del SDK de Pushwoosh.
- No elimina usuarios. Las solicitudes de eliminación de usuarios de RudderStack no son compatibles con este destino.
Comprobar que la integración funciona
Anchor link toDespués de guardar el destino, envíe una llamada track y una identify de prueba desde una fuente con un userId que ya tenga un dispositivo en Pushwoosh.
- Eventos: en Pushwoosh, vaya a Audience → Events, abra el evento y compruebe que se ha contabilizado.
- Etiquetas: vaya a Audience → User Explorer, busque al usuario por User ID y compruebe los valores de las etiquetas.
Los errores de entrega de cada llamada se muestran en la vista Live Events del destino en RudderStack.
Solución de problemas
Anchor link toBusque el mensaje de error que RudderStack muestra para el destino en Live Events para ver su causa y solución.
Las llamadas track fallan con unauthorized
Anchor link toEl token de API no coincide con el código de la aplicación. Compruebe que el token pertenece a la misma cuenta de Pushwoosh que la aplicación.
Las llamadas identify no comprueban el token, por lo que siguen funcionando con un token incorrecto. Use una llamada track para probar el token.
Las llamadas fallan con application not found o application code is not valid
Anchor link toEl código de la aplicación es incorrecto o la cuenta no está alojada en app.pushwoosh.com. Las llamadas track fallan con application not found y las llamadas identify fallan con application code is not valid. Compruebe el código en el Pushwoosh Control Panel. Si el código es correcto, comuníquese con su Customer Success Manager o con el soporte.
Las llamadas fallan con Missing required value from userId
Anchor link toLa llamada no tiene userId. Las llamadas anónimas no se envían a Pushwoosh. Llame a identify en su fuente de RudderStack después de que el usuario inicie sesión, para que las llamadas posteriores incluyan el userId.
Las llamadas fallan con Invalid enum value
Anchor link toEl tipo de llamada no es track ni identify. Pushwoosh solo acepta estos dos tipos. No conecte fuentes que solo envían llamadas page, screen, group o alias, o ignore estos errores.
Las llamadas identify fallan con No traits left to send as Pushwoosh tags
Anchor link toTodos los traits de la llamada son traits de identidad o contacto, como email o phone, que nunca se copian a etiquetas. Añada al menos otro trait u omita la llamada.
Las llamadas identify se completan, pero las etiquetas no aparecen
Anchor link toCompruebe lo siguiente en este orden:
- Hay un dispositivo con este User ID registrado en Pushwoosh. Busque al usuario en Audience → User Explorer.
- La aplicación llama a
setUserIdexactamente con el mismo valor que RudderStack envía comouserId. - La etiqueta con este nombre es User-specific. Un trait para una etiqueta General existente se omite. Cambie el ámbito de la etiqueta o renombre el trait.
- El valor del trait coincide con el tipo de la etiqueta existente.
- El trait no es uno de los traits de identidad o contacto que nunca se copian, como
emailophone.