Identificadores clave de la API

Este artículo 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, el targeting, la segmentación, el seguimiento y la gestión de usuarios en todas 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

ID de hardware (HWID)

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 ID de Usuario
En el archivo CSV descargado de la lista de Segmentos

Token de push

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 token de push.

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

ID de usuario

Un identificador personalizado asignado a un usuario, que permite el targeting multidispositivo y personalizado. 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.

ID de solicitud (Request ID)

Correlaciona un mensaje con la solicitud HTTP que lo creó, permitiéndole rastrear un envío único de extremo a extremo, 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 ID de solicitud.

Establecer tu 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. No se exige la unicidad, así que use un valor que sea realmente único por solicitud si depende de él para el rastreo.

¿Dónde encontrarlo?

Panel de Control de Pushwoosh → abrir un mensaje → Detalles del mensaje → Mostrar todas las propiedades → Configuración del mensaje → ID de solicitud (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 de 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 correo electrónico

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

¿Dónde encontrarlo?

Panel de Control de Pushwoosh → Contenido → Contenido de correo electrónico.

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 correo electrónico: 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 su seguimiento y análisis.

¿Dónde encontrarlo?

El código de la campaña aparece en la URL cuando se visualizan 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

ID de Journey

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 <UUID del journey>/<UUID del punto> al portapapeles; el ID del Journey es la parte antes de la barra.

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

ID de Journey: 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 el targeting 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 las llamadas a la API, la lógica de automatización y las 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

Etiqueta (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 → Etiquetas 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

ID de geozona

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 → Geozonas.