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, creación de mensajes, segmentación, seguimiento y 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 requerido 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 configuraciones 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 el User Explorer al buscar por ID de Usuario
En el archivo CSV descargado de la lista de Segmentos

Token Push

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

Dónde encontrarlo

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

Tipo de dispositivo

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

Valores soportados:

1 – iOS
3 – Android
7 – macOS
8 – Windows
9 – Amazon
10 – Safari
11 – Chrome
12 – Firefox
14 – Email
17 – Huawei
18 – SMS
21 – WhatsApp
22 – Line

Identificadores de usuario

ID de Usuario

Un identificador personalizado asignado a un usuario, que permite la segmentación personalizada y entre dispositivos. 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:

Rastrear 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: Navegue 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.

Identificadores de contenido

Código de preajuste (Preset)

Un identificador para un preajuste 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 preajuste en dos lugares:

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

Ejemplo:

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

Código de preajuste: 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 seguimiento y análisis.

Dónde encontrarlo

El código de la campaña aparece en la URL al ver 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 análisis del rendimiento.

Dónde encontrarlo

El ID de Journey aparece en la URL del lienzo de la campaña en el Panel de Control de Pushwoosh.

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 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

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.