Amplitude: establecer propiedades de usuario

Utilice Amplitude: establecer propiedades de usuario para actualizar el perfil de usuario de Amplitude del viajero desde un paso del journey, a través de la operación $identify de la HTTP API V2, para que la segmentación y las cohortes en el lado de Amplitude vean los mismos datos que Pushwoosh.

Pushwoosh establece el insert_id de Amplitude por usted a partir del viajero y este paso. Esto significa que el mismo viajero que pasa por este punto exacto dos veces, por ejemplo, en una segunda vuelta de un journey en bucle, actualiza el mismo perfil de Amplitude en lugar de escribir un evento de identificación duplicado.

Usos típicos:

• Sincronizar etiquetas en segmentos de Amplitude: envíe el nivel del plan, el estado de prueba u otra etiqueta al perfil de Amplitude para que las cohortes de Amplitude coincidan con las audiencias de Pushwoosh.
• Mantener los perfiles actualizados sin un trabajo de sincronización separado: actualice el perfil en el paso exacto del journey donde la etiqueta cambió.
• Evitar llamadas de identificación duplicadas en un bucle: la deduplicación incorporada significa que un paso repetido por este punto actualiza el mismo perfil en lugar de escribir dos veces.

Configurar el punto

1. Arrastre Amplitude: establecer propiedades de usuario desde la sección Integraciones al lienzo.
2. Haga doble clic en el punto e introduzca un Nombre del paso.
3. En Clave API, introduzca la clave API del proyecto desde Amplitude: Configuración > Proyectos > su proyecto > General. Se almacena enmascarada, como una cabecera secreta de webhook. Pushwoosh nunca la muestra ni la devuelve una vez guardada, y nunca aparece en la solicitud almacenada del punto ni en el Registro de llamadas.

4. En Endpoint de Amplitude, elija la región en la que se creó el proyecto de Amplitude: api2.amplitude.com para un proyecto de EE. UU., api.eu.amplitude.com para uno de la UE. Una clave de una región es rechazada por la otra.

5. En Propiedades de usuario, añada una fila por cada propiedad a establecer en el perfil de Amplitude. Introduzca el nombre de la propiedad y el valor. Los nombres no deben estar vacíos y deben ser únicos. Un valor que es una única macro del viajero mantiene su propio tipo en Amplitude ({{tag:Age}} llega como un número, {{tag:Trial Ends}} como una fecha). Cualquier otro texto se envía como una cadena. Las macros utilizan la misma sintaxis que el cuerpo de un Webhook. O haga clic en Insertar valor dinámico para elegir un atributo que un paso anterior en este journey haya producido, por ejemplo, una respuesta de un LLM o un valor de Webhook mapeado.

Ejemplo

Establecer Propiedades de usuario en user_id con el ID del viajero ({{device:user_id}}) y plan con su nivel de plan ({{tag:Plan}}) establece esas dos propiedades en su perfil de Amplitude.

6. Haga clic en Guardar.

Respuesta

El viajero continúa hacia el paso que conecte a continuación en el lienzo.

Atributos después de que el paso se ejecute

Atributo	Lo que contiene
amplitude_events_ingested	El número de eventos que Amplitude ha ingerido

Cómo usarlo en pasos posteriores

El viajero ya ha continuado al siguiente paso independientemente de este atributo. Guárdelo en una Etiqueta con Actualizar perfil de usuario si necesita confirmar que la actualización fue ingerida o bifurcar en él con División por condición.

Fallos y respuestas inesperadas

Una solicitud fallida elimina al viajero del journey. Consulte Errores y solicitudes fallidas.

Escenario de ejemplo: Mantener sincronizado el perfil de Amplitude de un suscriptor

Un equipo quiere que el nivel del plan de un viajero se actualice en su perfil de Amplitude tan pronto como cambie en Pushwoosh.

1. Añada Amplitude: establecer propiedades de usuario justo después del paso donde cambia el nivel del plan. En Propiedades de usuario, establezca plan en {{tag:Plan}}.
2. Haga clic en Guardar.

Una vez que esto se ejecute, el perfil de Amplitude reflejará el cambio de plan sin un trabajo de sincronización separado.