Identificadores clave de la API

Este post enumera los identificadores esenciales utilizados en las solicitudes de la API de Pushwoosh. Estos identificadores son necesarios para la autenticación, la creación de mensajes, la segmentación, el seguimiento y la gestión de usuarios en sus aplicaciones.

Identificadores generales

Código de aplicación

Un identificador único asignado a cada aplicación en su cuenta de Pushwoosh. Es necesario en la mayoría de las llamadas a la API para especificar la aplicación de destino.

¿Dónde encontrarlo?

Panel de Control de Pushwoosh → Debajo del nombre de la aplicación.

Token de acceso a la API

Un token único asignado a una cuenta de Pushwoosh, utilizado para autenticar las solicitudes de la API. Permite el acceso para gestionar proyectos, enviar mensajes, modificar la configuración y recuperar datos. Cada cuenta tiene al menos un token creado por defecto. Más información

¿Dónde encontrarlo?

Panel de Control de Pushwoosh → Acceso a la API.

Identificadores de dispositivo

Hardware ID

Un identificador único asignado a un dispositivo por el SDK de Pushwoosh. Se establece automáticamente por el SDK o se pasa durante el registro del dispositivo. Más información

¿Dónde encontrarlo?

En los registros del dispositivo. Más información
En User Explorer al buscar por User ID
En el archivo CSV descargado de la lista de Segmentos

Push token

Un token emitido por los proveedores de la plataforma que identifica un par aplicación-dispositivo para la entrega de notificaciones push. Recopilado automáticamente por el SDK cuando se conceden los permisos de push. Más información

¿Dónde encontrarlo?

En los registros del dispositivo. Más información
En User Explorer, introduzca el HWID en el campo de búsqueda para encontrar el dispositivo asociado, luego abra los detalles del dispositivo para ver el push token.

Tipo de dispositivo

Indica la plataforma del dispositivo de destino mediante un código numérico. Establecido automáticamente por el SDK.

Valores admitidos:

1 – iOS
3 – Android
7 – macOS
8 – Windows
9 – Amazon
10 – Safari
11 – Chrome
12 – Firefox
13 – Internet Explorer
14 – Email
17 – Huawei
18 – SMS
20 – Web
21 – WhatsApp
22 – Line
23 – Kakao Talk
24 – Telegram
25 – Apple Wallet
26 – Google Wallet
27 – Viber

Identificadores de usuario

User ID

Un identificador personalizado asignado a un usuario, que permite la segmentación multidispositivo y personalizada. Más información

¿Dónde encontrarlo?

Panel de Control de Pushwoosh → Audiencia → User Explorer

Identificadores de mensajería

Código de mensaje

Un identificador único asignado a cada mensaje en el momento de su creación. Sigue un formato específico: XXXX-XXXXXXXX-XXXXXXXX.

Este código es esencial para:

Seguir el estado y la entrega de un mensaje específico
Cancelar (o eliminar) un mensaje enviado previamente
Obtener estadísticas del mensaje

¿Dónde encontrarlo?

Panel de Control de Pushwoosh: Vaya a Campañas → Mensajes únicos, luego abra las propiedades del mensaje deseado. El Código de Mensaje se mostrará allí.
Respuesta de la API /createMessage: Al crear un nuevo mensaje a través de la API, el Código de Mensaje se incluye en la respuesta.

Request ID

Correlaciona un mensaje con la solicitud HTTP que lo creó, permitiéndole rastrear un envío único de principio a fin, desde la llamada HTTP a través de la capa de enrutamiento de Pushwoosh hasta el mensaje resultante.

Presente en cualquier mensaje creado por una llamada HTTP a /createMessage o a la API de Mensajería v2, incluidos los mensajes enviados desde el Panel de Control. Los mensajes creados por Journeys, envíos cron u otros disparadores internos no HTTP no tienen Request ID.

Establecer su propio valor

Pase una cabecera X-Request-ID con la solicitud. Si el valor tiene entre 8 y 128 caracteres y contiene solo letras latinas, dígitos, puntos, guiones bajos y guiones, Pushwoosh lo reutiliza; de lo contrario, o si se omite la cabecera, Pushwoosh genera uno para usted. Un valor no válido se reemplaza silenciosamente, por lo que la solicitud nunca falla por ello. La unicidad no se exige, así que utilice un valor que sea realmente único por solicitud si depende de él para el rastreo.

¿Dónde encontrarlo?

Panel de Control de Pushwoosh → abra un mensaje → Detalles del mensaje → Mostrar todas las propiedades → Configuración del mensaje → Request ID (con un botón de copiar).

Ejemplo: a1b2c3d4e5f64a7b8c9d0e1f2a3b4c5d

Código de in-app

Un código único que identifica una campaña de in-app instantánea. ¿Dónde encontrarlo?

Panel de Control de Pushwoosh → Campañas → In-apps instantáneas. En la lista, el código se muestra debajo del nombre de la campaña.

Ejemplo: AAAAA-BBBBB

Identificadores de contenido

Código de preset

Un identificador para un preset de mensaje guardado (por ejemplo, push o SMS). Más información

¿Dónde encontrarlo?

Panel de Control de Pushwoosh → Contenido → Presets.

Puede encontrar el código del preset en dos lugares:

En la vista de lista, que se muestra debajo del nombre del preset.
En la URL al editar o crear un preset (es la última parte de la URL).

Ejemplo:

URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/sms-presets/edit/AAAAA-BBBBB

Código de preset: AAAAA-BBBBB

Código de Rich Media

Identificador para una plantilla de mensaje in-app. Más información

¿Dónde encontrarlo?

Panel de Control de Pushwoosh → Contenido → Rich media.

Ejemplo: URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/rich-media/AAAAA-BBBBB/statistics Código de Rich Media: AAAAA-BBBBB

Código de contenido de email

El código de contenido de email es un identificador único para el contenido de email guardado. Más información

¿Dónde encontrarlo?

Panel de Control de Pushwoosh → Contenido → Contenido de email.

El código es la última parte de la URL.

Ejemplo:

URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/email-content/edit/AAAAA-BBBBB Código de contenido de email: AAAAA-BBBBB

Identificadores de campaña

Código de campaña

Un identificador único utilizado para hacer referencia a una campaña específica para el seguimiento y el análisis.

¿Dónde encontrarlo?

El código de la campaña aparece en la URL cuando se ven las estadísticas relacionadas con la campaña en el Panel de Control de Pushwoosh. Para localizarlo, vaya a Estadísticas → Estadísticas agregadas, haga clic en la campaña deseada y copie el código que se encuentra al final de la URL.

Ejemplo:

URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/statistics/aggregated-message?campaignCode=YYYYY-YYYYY

Código de campaña: YYYYY-YYYYY

Journey ID

Un identificador único utilizado para asociar mensajes con campañas de marketing específicas para el seguimiento y el análisis del rendimiento.

¿Dónde encontrarlo?

En la URL del lienzo de la campaña en el Panel de Control de Pushwoosh.
Seleccione un punto en el lienzo y presione Ctrl+I (Cmd+I) — copia <journey UUID>/<point UUID> al portapapeles; el Journey ID es la parte antes de la barra.

Ejemplo: URL: https://app.pushwoosh.com/journeys/XXXXX-XXXXX/1/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

Journey ID: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

Identificadores de segmentación y targeting

Nombre de Segmento / Filtro

El nombre de un segmento de usuario predefinido creado en Pushwoosh para la segmentación de la audiencia. Más información

¿Dónde encontrarlo?

Panel de Control de Pushwoosh → Segmentos.

Código de Segmento / Filtro

Un código único en el formato XXXXX-XXXXX que identifica un segmento (también llamado filtro) en Pushwoosh. Este código se utiliza en llamadas a la API, lógica de automatización y reglas de segmentación dinámica.

¿Dónde encontrarlo?

A través del método de la API /listFilters.
En la barra de direcciones al ver un segmento en el Panel de Control de Pushwoosh:

Ejemplo:

URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/segments/XXXE9-XXX49/detail Código de segmento: XXXE9-XXX49

Tag

Un atributo personalizado asignado a usuarios o dispositivos. Se utiliza para la segmentación dinámica y la personalización. Más información

¿Dónde encontrarlo?

Panel de Control de Pushwoosh → Tags o a través de la API /getTags.

Identificadores de eventos

Nombre del evento

El nombre de un evento rastreado (p. ej., purchase, login, subscription). Se utiliza para activar flujos de trabajo automatizados o para análisis. Más información

¿Dónde encontrarlo?

Panel de Control de Pushwoosh → Audiencia → Eventos.

Identificadores de geolocalización

Geozone ID

Identifica un área geocercada utilizada para activar notificaciones basadas en la ubicación. Más información

¿Dónde encontrarlo?

Panel de Control de Pushwoosh → Geozones.