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, creación de mensajes, segmentación, seguimiento y gestión de usuarios en todas sus aplicaciones.

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.

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. Aprenda más

Dónde encontrarlo

Panel de Control de Pushwoosh → API Access.

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. Aprenda más

Dónde encontrarlo

• En los registros del dispositivo. Aprenda más

• En User Explorer al buscar por User ID

• En el archivo CSV descargado de la lista de Segmentos

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 otorgan los permisos de push. Aprenda más

Dónde encontrarlo

• En los registros del dispositivo. Aprenda más

• En 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 push token.

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
13 – Internet Explorer
14 – Email
16 – Baidu Android
17 – Huawei
18 – SMS
20 – Web
21 – WhatsApp
22 – Line
23 – Kakao Talk
24 – Telegram
25 – Apple Wallet
26 – Google Wallet
27 – Viber

Un identificador personalizado asignado a un usuario, que permite la segmentación personalizada y entre dispositivos. Aprenda más

Dónde encontrarlo

Panel de Control de Pushwoosh → Audience → User Explorer

Un identificador único asignado a cada mensaje en 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: Navegue a Campaigns → One-time messages, luego abra las propiedades del mensaje deseado. El Código del Mensaje se mostrará allí.
• Respuesta de la API /createMessage: Al crear un nuevo mensaje a través de la API, el Código del Mensaje se incluye en la respuesta.

Correlaciona un mensaje con la solicitud HTTP que lo creó, permitiéndole rastrear un solo envío 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 Messaging API v2, incluyendo 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 un encabezado 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 el encabezado, 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 aplica, 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 → abra un mensaje → Message Details → Show all properties → Message settings → Request ID (con un botón de copiar).

Ejemplo: a1b2c3d4e5f64a7b8c9d0e1f2a3b4c5d

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

Panel de Control de Pushwoosh → Campaigns → Instant in-apps. En la lista, el código se muestra debajo del nombre de la campaña.

Ejemplo: AAAAA-BBBBB

Un identificador para un preset de mensaje guardado (por ejemplo, push o SMS). Aprenda más

Dónde encontrarlo

Panel de Control de Pushwoosh → Content → Presets.

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

• En la vista de lista, 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

Identificador para una plantilla de mensaje in-app. Aprenda más

Dónde encontrarlo

Panel de Control de Pushwoosh → Content → Rich media.

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

El código de contenido de correo electrónico es un identificador único para el contenido de correo electrónico guardado. Aprenda más

Dónde encontrarlo

Panel de Control de Pushwoosh → Content → Email content.

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

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 estadísticas relacionadas con la campaña en el Panel de Control de Pushwoosh. Para localizarlo, vaya a Statistics → Aggregated statistics, 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

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

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

Dónde encontrarlo

Panel de Control de Pushwoosh → Segments.

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 del segmento: XXXE9-XXX49

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

Dónde encontrarlo

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

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

Dónde encontrarlo

Panel de Control de Pushwoosh → Audience → Events.

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

Dónde encontrarlo

Panel de Control de Pushwoosh → Geozones.