Message engagement events
Use the search bar or the checkboxes below to find the events you need to use Currents effectively.
These schema consist of the Braze Events that are directly related to message sending.
Los esquemas de almacenamiento se aplican a los datos de eventos de archivos planos que enviamos a los socios de almacenamiento de almacén de datos (Google Cloud Storage, Amazon S3 y Microsoft Azure Blob Storage). Para los esquemas que se aplican a los demás socios, consulta nuestra lista de socios disponibles y comprueba sus respectivas páginas.
Póngase en contacto con su gestor de cuenta o abra un ticket de asistencia si necesita acceder a derechos de eventos adicionales. Si no encuentra lo que necesita en este artículo, consulte nuestra Biblioteca de eventos de comportamiento del cliente o nuestros ejemplos de datos de muestra Currents.
Explicación de la estructura de los eventos de compromiso de mensajes y de los valores de la plataforma
Estructura del evento
Este desglose de eventos muestra qué tipo de información se incluye generalmente en un evento de compromiso de mensajes. Con una sólida comprensión de sus componentes, tus desarrolladores y el equipo de estrategia de inteligencia empresarial pueden utilizar los datos de eventos Currents entrantes para elaborar informes y gráficos basados en datos, y aprovechar otras valiosas métricas de datos.
Los eventos de participación en mensajes se componen de propiedades específicas de usuario, propiedades de seguimiento de campaña/tela y propiedades específicas de evento.
Esquema de ID de usuario
Nota las convenciones de nomenclatura para los ID de usuario.
| Esquema Braze | Esquema Currents | Descripción |
|---|---|---|
braze_id |
"USER_ID" |
El identificador único que asigna automáticamente Braze. |
external_id |
"EXTERNAL_USER_ID" |
El identificador único del perfil de un usuario configurado por el cliente. |
Valores de la plataforma
Algunos eventos devuelven un valor platform que especifica la plataforma del dispositivo del usuario.
La siguiente tabla detalla los posibles valores devueltos:
| Dispositivo de usuario | Valor de la plataforma |
|---|---|
| iOS | ios |
| Android | android |
| FireTV | kindle |
| Kindle | kindle |
| Web | web |
| tvOS | tvos |
| Roku | roku |
important:
Currents eliminará los eventos con cargas útiles excesivamente grandes, superiores a 900 KB.
note:
Los objetos relacionados con el Flujo del Canvas tienen ID que pueden utilizarse para agruparlos y traducirse a nombres legibles por humanos mediante el punto final Exportar detalles del Canvas.
note:
Algunos campos pueden tardar más en mostrar su estado más reciente después de actualizar una campaña o Canvas. Estos campos son:
- "campaign_name"
- "canvas_name"
- "canvas_step_name"
- "conversion_behavior"
- "canvas_variation_name"
- "experiment_split_name"
- "message_variation_name"
Si se requiere una coherencia total, te recomendamos que esperes una hora desde la última actualización de estos campos antes de enviar la mensajería a tus usuarios.
Desinstalar eventos
Este evento se produce cuando un usuario desinstala una aplicación. Utiliza estos datos para saber cuándo los usuarios desinstalan una aplicación. Aunque actualmente se trata de un evento de compromiso de mensaje, en el futuro se cambiará a un evento de comportamiento del usuario.
important:
Este evento no se dispara cuando el usuario realmente desinstala la aplicación, ya que eso es imposible de rastrear con exactitud. Braze envía un push silencioso diario para determinar si la aplicación sigue existiendo en el dispositivo de tu usuario, y si obtenemos un error en ese push silencioso, se asume que la aplicación ha sido desinstalada.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
// Uninstall (users.behaviors.Uninstall)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
// Uninstall (users.behaviors.Uninstall)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"distinct_id" : "(required, string) [PII] External ID of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// Application Uninstalls (users.behaviors.Uninstall)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
// Application Uninstalled (users.behaviors.Uninstall)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"device_id" : "(optional, string) ID of the device on which the event occurred"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
// users.behaviors.Uninstall
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(required, string) API ID of the app on which this event occurred",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Eventos de cambio de estado de suscripción global
Este evento se produce cuando Braze recibe una solicitud para actualizar el estado de suscripción global del usuario, aunque la solicitud no altere el estado de suscripción actual del usuario.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// Global Subscription State Change (users.behaviors.subscription.GlobalStateChange)
{
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"email_address" : "(optional, string) [PII] Email address of the user",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"state_change_source" : "(optional, string) Source of the state change, e.g: REST API, SDK, Dashboard, etc.",
"subscription_status" : "(required, string) Subscription status: 'Subscribed', 'Unsubscribed' or 'Opted In'",
"timezone" : "(optional, string) Time zone of the user"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// Global Subscription State Change (users.behaviors.subscription.GlobalStateChange)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"distinct_id" : "(required, string) [PII] External ID of the user",
"email_address" : "(optional, string) [PII] Email address of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"state_change_source" : "(optional, string) Source of the state change, e.g: REST API, SDK, Dashboard, etc.",
"subscription_status" : "(required, string) Subscription status: 'Subscribed', 'Unsubscribed' or 'Opted In'",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
// Global Subscription State Changes (users.behaviors.subscription.GlobalStateChange)
{
"device_info" : { },
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event",
"state_change_source" : "(optional, string) Source of the state change, e.g: REST API, SDK, Dashboard, etc.",
"subscription_status" : "(required, string) Subscription status: 'Subscribed', 'Unsubscribed' or 'Opted In'"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user",
"email" : "(optional, string) [PII] Email address of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
// Global Subscription State Changed (users.behaviors.subscription.GlobalStateChange)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"email" : "(optional, string) [PII] Email address of the user"
},
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"state_change_source" : "(optional, string) Source of the state change, e.g: REST API, SDK, Dashboard, etc.",
"subscription_status" : "(required, string) Subscription status: 'Subscribed', 'Unsubscribed' or 'Opted In'"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
// users.behaviors.subscription.GlobalStateChange
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"channel" : "(optional, string) Channel this event belongs to",
"email_address" : "(optional, string) [PII] Email address of the user",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"send_id" : "(optional, string) Message send ID this message belongs to",
"state_change_source" : "(optional, string) Source of the state change, e.g: REST API, SDK, Dashboard, etc.",
"subscription_status" : "(required, string) Subscription status: 'Subscribed', 'Unsubscribed' or 'Opted In'",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Detalles de la propiedad
state_change_sourcedevolverá una cadena con el nombre completo de la fuente. Por ejemplo, la importación del CSV de origen devolverá la cadenaCSV Import. A continuación se enumeran las fuentes disponibles:
| Fuente | Descripción |
|---|---|
| SDK | Puntos finales del SDK |
| Dashboard | Cuando se actualiza el estado de suscripción de un usuario desde la página Perfil de usuario del panel de control |
| Página de suscripción | Cuando un usuario se da de baja a través de un enlace de correo electrónico que no es el centro de preferencias |
| API REST | Puntos finales de la API REST |
| Importación CSV | Importación de usuarios CSV |
| Centro de preferencias | Cuando se actualiza un usuario desde el centro de preferencias |
| Mensaje entrante | Cuando un usuario es actualizado por mensajes entrantes de usuarios finales a través de canales, como SMS |
| Migración | Cuando un usuario se actualiza mediante migraciones internas o scripts de mantenimiento |
| Fusión de usuarios | Cuando se actualiza un usuario mediante el proceso de fusión de usuarios |
| Paso de actualización de usuario del Canvas | Cuando se actualiza un usuario mediante el paso Actualización de usuarios de Canvas |
| Adhesión voluntaria automática por registro de token | Cuando un usuario se actualiza mediante el proceso de registro de token |
Eventos de cambio de estado del grupo de suscripción
Este evento se produce cuando cambia el estado de suscripción de un usuario en un grupo de suscripción.
important:
Por el momento, los grupos de suscripción sólo están disponibles para los canales de correo electrónico, SMS y WhatsApp.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
// Subscription Group State Change (users.behaviors.subscriptiongroup.StateChange)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"email_address" : "(optional, string) [PII] Email address of the user",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"state_change_source" : "(optional, string) Source of the state change, e.g: REST API, SDK, Dashboard, etc.",
"subscription_group_id" : "(required, string) Subscription group API ID",
"subscription_status" : "(required, string) Subscription status: 'Subscribed' or 'Unsubscribed'",
"timezone" : "(optional, string) Time zone of the user"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
// Subscription Group State Change (users.behaviors.subscriptiongroup.StateChange)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"distinct_id" : "(required, string) [PII] External ID of the user",
"email_address" : "(optional, string) [PII] Email address of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"state_change_source" : "(optional, string) Source of the state change, e.g: REST API, SDK, Dashboard, etc.",
"subscription_group_id" : "(required, string) Subscription group API ID",
"subscription_status" : "(required, string) Subscription status: 'Subscribed' or 'Unsubscribed'",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
// Subscription Group State Changes (users.behaviors.subscriptiongroup.StateChange)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event",
"state_change_source" : "(optional, string) Source of the state change, e.g: REST API, SDK, Dashboard, etc.",
"subscription_group_id" : "(required, string) Subscription group API ID",
"subscription_status" : "(required, string) Subscription status: 'Subscribed' or 'Unsubscribed'"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user",
"email" : "(optional, string) [PII] Email address of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
// Subscription Group State Changed (users.behaviors.subscriptiongroup.StateChange)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"email" : "(optional, string) [PII] Email address of the user"
},
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"state_change_source" : "(optional, string) Source of the state change, e.g: REST API, SDK, Dashboard, etc.",
"subscription_group_id" : "(required, string) Subscription group API ID",
"subscription_status" : "(required, string) Subscription status: 'Subscribed' or 'Unsubscribed'"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// users.behaviors.subscriptiongroup.StateChange
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"channel" : "(optional, string) Channel this event belongs to",
"email_address" : "(optional, string) [PII] Email address of the user",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"phone_number" : "(optional, string) [PII] Phone number of the user in e.164 format (for example +14155552671)",
"send_id" : "(optional, string) Message send ID this message belongs to",
"state_change_source" : "(optional, string) Source of the state change, e.g: REST API, SDK, Dashboard, etc.",
"subscription_group_id" : "(required, string) Subscription group API ID",
"subscription_status" : "(required, string) Subscription status: 'Subscribed' or 'Unsubscribed'",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Detalles de la propiedad
state_change_sourcedevolverá una cadena con el nombre completo de la fuente. Por ejemplo, la importación del CSV de origen devolverá la cadenaCSV Import. A continuación se enumeran las fuentes disponibles:
| Fuente | Descripción |
|---|---|
| SDK | Puntos finales del SDK |
| Dashboard | Cuando se actualiza el estado de suscripción de un usuario desde la página Perfil de usuario del Panel de control |
| Página de suscripción | Cuando un usuario se da de baja a través de un enlace de correo electrónico que no es el centro de preferencias |
| API REST | Puntos finales de la API REST |
| Importación CSV | Importación de usuarios CSV |
| Centro de preferencias | Cuando se actualiza un usuario desde el centro de preferencias |
| Mensaje entrante | Cuando un usuario se actualiza mediante mensajes entrantes de usuarios finales a través de canales como SMS |
| Migración | Cuando un usuario se actualiza mediante migraciones internas o scripts de mantenimiento |
| Fusión de usuarios | Cuando un usuario es actualizado por el proceso de fusión de usuarios |
| Paso de actualización de usuario del Canvas | Cuando un usuario es actualizado por el paso de actualización de usuarios de Canvas |
Campaña Eventos de conversión
Este evento se produce cuando un usuario realiza una acción que se ha establecido como evento de conversión en una campaña.
note:
dispatch_id está obsoleto y se eliminará en la próxima versión de Currents.
important:
Tenga en cuenta que el evento de conversión se codifica en el campo conversion_behavior, que incluye el tipo de evento de conversión, la ventana (marco temporal) e información adicional en función del tipo de evento de conversión. El campo conversion_behavior_index representa qué evento de conversión, como 0 = A, 1 = B, 2 = C, 3 = D.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
// Campaign Conversion (users.campaigns.Conversion)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"conversion_behavior" : "(optional, string) JSON-encoded string describing the conversion behavior",
"conversion_behavior_index" : "(optional, int) Index of the conversion behavior",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
// Campaign Conversion (users.campaigns.Conversion)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"conversion_behavior" : "(optional, string) JSON-encoded string describing the conversion behavior",
"conversion_behavior_index" : "(optional, int) Index of the conversion behavior",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
// Campaign Conversions (users.campaigns.Conversion)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"conversion_behavior" : "(optional, string) JSON-encoded string describing the conversion behavior",
"conversion_behavior_index" : "(optional, int) Index of the conversion behavior",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// Campaign Converted (users.campaigns.Conversion)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"conversion_behavior" : "(optional, string) JSON-encoded string describing the conversion behavior",
"conversion_behavior_index" : "(optional, int) Index of the conversion behavior",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
// users.campaigns.Conversion
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(required, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"conversion_behavior" : "(optional, string) JSON-encoded string describing the conversion behavior",
"conversion_behavior_index" : "(optional, int) Index of the conversion behavior",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Campaña Grupo de control Actos de inscripción
Este evento se produce cuando un usuario se inscribe en un conjunto de variantes de control en una campaña multivariante. Este evento se genera ya que no habrá ningún evento de envío de canal para este usuario.
note:
dispatch_id está obsoleto y se eliminará en la próxima versión de Currents.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
// Campaign Control Group Enrollment (users.campaigns.EnrollInControl)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
// Campaign Control Group Enrollment (users.campaigns.EnrollInControl)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
// Campaign Control Group Enrollments (users.campaigns.EnrollInControl)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
// Campaign Control Group Entered (users.campaigns.EnrollInControl)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
// users.campaigns.EnrollInControl
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(required, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Eventos de conversión en Canvas
Este evento se produce cuando un usuario realiza una acción que se ha establecido como evento de conversión en Canvas.
important:
Tenga en cuenta que el evento de conversión se codifica en el campo conversion_behavior, que incluye el tipo de evento de conversión, la ventana (marco temporal) e información adicional en función del tipo de evento de conversión. El campo conversion_behavior_index representa qué evento de conversión, como 0 = A, 1 = B, 2 = C, 3 = D.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
// Canvas Conversion (users.canvas.Conversion)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"conversion_behavior" : "(optional, string) JSON-encoded string describing the conversion behavior",
"conversion_behavior_index" : "(optional, int) Index of the conversion behavior"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
// Canvas Conversion (users.canvas.Conversion)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"conversion_behavior" : "(optional, string) JSON-encoded string describing the conversion behavior",
"conversion_behavior_index" : "(optional, int) Index of the conversion behavior",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"distinct_id" : "(required, string) [PII] External ID of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
// Canvas Conversions (users.canvas.Conversion)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"conversion_behavior" : "(optional, string) JSON-encoded string describing the conversion behavior",
"conversion_behavior_index" : "(optional, int) Index of the conversion behavior",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// Canvas Converted (users.canvas.Conversion)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"conversion_behavior" : "(optional, string) JSON-encoded string describing the conversion behavior",
"conversion_behavior_index" : "(optional, int) Index of the conversion behavior",
"device_id" : "(optional, string) ID of the device on which the event occurred"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
// users.canvas.Conversion
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"canvas_id" : "(required, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(required, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"conversion_behavior" : "(optional, string) JSON-encoded string describing the conversion behavior",
"conversion_behavior_index" : "(optional, int) Index of the conversion behavior",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Eventos de entrada en Canvas
Este evento se produce cuando un usuario entra en el Canvas. Este evento le indica en qué variante ha entrado el usuario.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
// Canvas Entry (users.canvas.Entry)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"in_control_group" : "(required, boolean) Whether the user was enrolled in the control group"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
// Canvas Entry (users.canvas.Entry)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"distinct_id" : "(required, string) [PII] External ID of the user",
"in_control_group" : "(required, boolean) Whether the user was enrolled in the control group",
"$insert_id" : "(required, string) Globally unique ID for this event",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
// Canvas Entries (users.canvas.Entry)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"in_control_group" : "(required, boolean) Whether the user was enrolled in the control group",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
// Canvas Entered (users.canvas.Entry)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"in_control_group" : "(required, boolean) Whether the user was enrolled in the control group"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
// users.canvas.Entry
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"canvas_id" : "(required, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(required, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"in_control_group" : "(required, boolean) Whether the user was enrolled in the control group",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Partida de salida Actos de la audiencia
Este evento se produce cuando un usuario ha salido de un Canvas al coincidir con una audiencia.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
// Exit Match Audience (users.canvas.exit.MatchedAudience)
{
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
// Exit Match Audience (users.canvas.exit.MatchedAudience)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"distinct_id" : "(required, string) [PII] External ID of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// Exit Matched Audiences (users.canvas.exit.MatchedAudience)
{
"device_info" : { },
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
// Exit Matched Audience (users.canvas.exit.MatchedAudience)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
// users.canvas.exit.MatchedAudience
{
"app_group_api_id" : "(optional, string) [DEPRECATED]",
"app_group_id" : "(required, string) API ID of the app group this user belongs to",
"canvas_api_id" : "(optional, string) [DEPRECATED]",
"canvas_id" : "(required, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_api_id" : "(optional, string) [DEPRECATED]",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_api_id" : "(optional, string) [DEPRECATED]",
"canvas_variation_id" : "(required, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Salir Rendimiento Eventos del evento
Este evento ocurre cuando un usuario ha salido de un Canvas realizando un evento.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
// Exit Perform Event (users.canvas.exit.PerformedEvent)
{
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
// Exit Perform Event (users.canvas.exit.PerformedEvent)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"distinct_id" : "(required, string) [PII] External ID of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// Exit Performed Events (users.canvas.exit.PerformedEvent)
{
"device_info" : { },
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
// Exit Performed Event (users.canvas.exit.PerformedEvent)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
// users.canvas.exit.PerformedEvent
{
"app_group_api_id" : "(optional, string) [DEPRECATED]",
"app_group_id" : "(required, string) API ID of the app group this user belongs to",
"canvas_api_id" : "(optional, string) [DEPRECATED]",
"canvas_id" : "(required, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_api_id" : "(optional, string) [DEPRECATED]",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_api_id" : "(optional, string) [DEPRECATED]",
"canvas_variation_id" : "(required, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Paso del experimento Eventos de conversión
Este evento se produce cuando un usuario convierte para un paso del experimento Canvas.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
// Experiment Step Conversion (users.canvas.experimentstep.Conversion)
{
"event_properties" : {
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"conversion_behavior" : "(optional, string) JSON-encoded string describing the conversion behavior",
"conversion_behavior_index" : "(optional, int) Index of the conversion behavior",
"experiment_split_id" : "(optional, string) API ID of the experiment split the user enrolled in",
"experiment_split_name" : "(optional, string) Name of the experiment split",
"experiment_step_id" : "(optional, string) API ID of the experiment step this event belongs to"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
// Experiment Step Conversion (users.canvas.experimentstep.Conversion)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"conversion_behavior" : "(optional, string) JSON-encoded string describing the conversion behavior",
"conversion_behavior_index" : "(optional, int) Index of the conversion behavior",
"distinct_id" : "(required, string) [PII] External ID of the user",
"experiment_split_id" : "(optional, string) API ID of the experiment split the user enrolled in",
"experiment_split_name" : "(optional, string) Name of the experiment split",
"experiment_step_id" : "(optional, string) API ID of the experiment step this event belongs to",
"$insert_id" : "(required, string) Globally unique ID for this event",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
// Experiment Step Conversions (users.canvas.experimentstep.Conversion)
{
"device_info" : { },
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"conversion_behavior" : "(optional, string) JSON-encoded string describing the conversion behavior",
"conversion_behavior_index" : "(optional, int) Index of the conversion behavior",
"experiment_split_id" : "(optional, string) API ID of the experiment split the user enrolled in",
"experiment_split_name" : "(optional, string) Name of the experiment split",
"experiment_step_id" : "(optional, string) API ID of the experiment step this event belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// Experiment Step Converted (users.canvas.experimentstep.Conversion)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"conversion_behavior" : "(optional, string) JSON-encoded string describing the conversion behavior",
"conversion_behavior_index" : "(optional, int) Index of the conversion behavior",
"experiment_split_id" : "(optional, string) API ID of the experiment split the user enrolled in",
"experiment_split_name" : "(optional, string) Name of the experiment split",
"experiment_step_id" : "(optional, string) API ID of the experiment step this event belongs to"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
// users.canvas.experimentstep.Conversion
{
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"conversion_behavior" : "(optional, string) JSON-encoded string describing the conversion behavior",
"conversion_behavior_index" : "(optional, int) Index of the conversion behavior",
"experiment_split_id" : "(optional, string) API ID of the experiment split the user enrolled in",
"experiment_split_name" : "(optional, string) Name of the experiment split",
"experiment_step_id" : "(optional, string) API ID of the experiment step this event belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Experimento Eventos de entrada dividida
Este evento se produce cuando un usuario entra en una ruta de pasos del experimento Canvas.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
// Experiment Split Entry (users.canvas.experimentstep.SplitEntry)
{
"event_properties" : {
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"experiment_split_id" : "(optional, string) API ID of the experiment split the user enrolled in",
"experiment_split_name" : "(optional, string) Name of the experiment split",
"experiment_step_id" : "(optional, string) API ID of the experiment step this event belongs to",
"in_control_group" : "(required, boolean) Whether the user was enrolled in the control group"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
// Experiment Split Entry (users.canvas.experimentstep.SplitEntry)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"distinct_id" : "(required, string) [PII] External ID of the user",
"experiment_split_id" : "(optional, string) API ID of the experiment split the user enrolled in",
"experiment_split_name" : "(optional, string) Name of the experiment split",
"experiment_step_id" : "(optional, string) API ID of the experiment step this event belongs to",
"in_control_group" : "(required, boolean) Whether the user was enrolled in the control group",
"$insert_id" : "(required, string) Globally unique ID for this event",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
// Experiment Split Entries (users.canvas.experimentstep.SplitEntry)
{
"device_info" : { },
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"experiment_split_id" : "(optional, string) API ID of the experiment split the user enrolled in",
"experiment_split_name" : "(optional, string) Name of the experiment split",
"experiment_step_id" : "(optional, string) API ID of the experiment step this event belongs to",
"in_control_group" : "(required, boolean) Whether the user was enrolled in the control group",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
// Experiment Split Entered (users.canvas.experimentstep.SplitEntry)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"experiment_split_id" : "(optional, string) API ID of the experiment split the user enrolled in",
"experiment_split_name" : "(optional, string) Name of the experiment split",
"experiment_step_id" : "(optional, string) API ID of the experiment step this event belongs to",
"in_control_group" : "(required, boolean) Whether the user was enrolled in the control group"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
// users.canvas.experimentstep.SplitEntry
{
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"experiment_split_id" : "(optional, string) API ID of the experiment split the user enrolled in",
"experiment_split_name" : "(optional, string) Name of the experiment split",
"experiment_step_id" : "(optional, string) API ID of the experiment step this event belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"in_control_group" : "(required, boolean) Whether the user was enrolled in the control group",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Eventos de progresión de pasos en Canvas
Este evento se produce cuando un usuario avanza por un paso en Canvas con algún resultado. Nota que este evento no se produce al entrar o salir de los pasos. Actualmente, sólo los pasos divididos (Rutas de audiencia, División de decisiones, Rutas de acción, Experimento) y los resultados de avance generan eventos de progresión de pasos.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
// Canvas Step Progression (users.canvasstep.Progression)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"canvas_entry_id" : "(required, string) Unique identifier for this instance of a user in a canvas",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"exit_reason" : "(optional, string) If this is an exit, the reason a user exited the canvas during the step",
"is_canvas_entry" : "(optional, boolean) Whether this is entry into a first step in a canvas",
"next_step_id" : "(optional, string) API ID of the next step in the canvas",
"progression_type" : "(required, string) What type of step progression event this is"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
// Canvas Step Progression (users.canvasstep.Progression)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"canvas_entry_id" : "(required, string) Unique identifier for this instance of a user in a canvas",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"distinct_id" : "(required, string) [PII] External ID of the user",
"exit_reason" : "(optional, string) If this is an exit, the reason a user exited the canvas during the step",
"$insert_id" : "(required, string) Globally unique ID for this event",
"is_canvas_entry" : "(optional, boolean) Whether this is entry into a first step in a canvas",
"next_step_id" : "(optional, string) API ID of the next step in the canvas",
"progression_type" : "(required, string) What type of step progression event this is",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
// Canvas Step Progressions (users.canvasstep.Progression)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"canvas_entry_id" : "(required, string) Unique identifier for this instance of a user in a canvas",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"exit_reason" : "(optional, string) If this is an exit, the reason a user exited the canvas during the step",
"is_canvas_entry" : "(optional, boolean) Whether this is entry into a first step in a canvas",
"next_step_id" : "(optional, string) API ID of the next step in the canvas",
"progression_type" : "(required, string) What type of step progression event this is",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
// Canvas Step Progression (users.canvasstep.Progression)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"canvas_entry_id" : "(required, string) Unique identifier for this instance of a user in a canvas",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"exit_reason" : "(optional, string) If this is an exit, the reason a user exited the canvas during the step",
"is_canvas_entry" : "(optional, boolean) Whether this is entry into a first step in a canvas",
"next_step_id" : "(optional, string) API ID of the next step in the canvas",
"progression_type" : "(required, string) What type of step progression event this is"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
// users.canvasstep.Progression
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"canvas_entry_id" : "(required, string) Unique identifier for this instance of a user in a canvas",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"exit_reason" : "(optional, string) If this is an exit, the reason a user exited the canvas during the step",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"is_canvas_entry" : "(optional, boolean) Whether this is entry into a first step in a canvas",
"next_step_id" : "(optional, string) API ID of the next step in the canvas",
"progression_type" : "(required, string) What type of step progression event this is",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Eventos de abortar tarjeta de contenido
Este evento se produce si se ha abortado un mensaje de la tarjeta de contenido en función de los abortos de Liquid, etc.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// Content Card Abort (users.messages.contentcard.Abort)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// Content Card Abort (users.messages.contentcard.Abort)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
// Content Card Aborts (users.messages.contentcard.Abort)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// Content Card Aborted (users.messages.contentcard.Abort)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
// users.messages.contentcard.Abort
{
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_message_variation_id" : "(optional, string) API ID of the Canvas step message variation this user received",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Eventos de clic en la tarjeta de contenido
Este evento se produce cuando un usuario hace clic en una Tarjeta de Contenido.
note:
dispatch_id está obsoleto y se eliminará en la próxima versión de Currents.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
// Content Card Click (users.messages.contentcard.Click)
{
"adid" : "(optional, string) [PII] Advertising identifier",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(required, string) ID of the card that generated this event",
"device_model" : "(optional, string) Model of the device",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"os_version" : "(optional, string) Version of the operating system of the device",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"idfa" : "(optional, string) [PII] Advertising identifier",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
// Content Card Click (users.messages.contentcard.Click)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(required, string) ID of the card that generated this event",
"$device" : "(optional, string) Model of the device",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"$os" : "(optional, string) Version of the operating system of the device",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
// Content Card Clicks (users.messages.contentcard.Click)
{
"device_info" : {
"android_advertising_id" : "(optional, string) [PII] Advertising identifier",
"device_model" : "(optional, string) Model of the device",
"ios_advertising_id" : "(optional, string) [PII] Advertising identifier",
"ios_idfv" : "(optional, string) ID of the device on which the event occurred",
"limit_ad_tracking" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"microsoft_advertising_id" : "(optional, string) [PII] Advertising identifier",
"platform" : "(optional, string) Platform of the device",
"roku_advertising_id" : "(optional, string) [PII] Advertising identifier"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(required, string) ID of the card that generated this event",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
// Content Card Clicked (users.messages.contentcard.Click)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : {
"model" : "(optional, string) Model of the device",
"type" : "(optional, string) Platform of the device"
}
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(required, string) ID of the card that generated this event",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
// users.messages.contentcard.Click
{
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(required, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"content_card_id" : "(required, string) ID of the card that generated this event",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"device_model" : "(optional, string) Model of the device",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"os_version" : "(optional, string) Version of the operating system of the device",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Detalles de la propiedad
- Para
ad_id,ad_id_type, yad_tracking_enabled, necesitas recopilar explícitamente el IDFA de publicidad de iOS y el ID de publicidad de Google de Android a través de los SDK nativos. Más información sobre esta configuración para iOS y Android. - Si utilizas Kafka para la ingesta de datos de Currents, ponte en contacto con tu administrador del éxito del cliente para habilitar el envío de
ad_id.
Tarjeta de contenido Descartar eventos
Este evento ocurre cuando un usuario descarta una Tarjeta de Contenido.
note:
dispatch_id está obsoleto y se eliminará en la próxima versión de Currents.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
// Content Card Dismiss (users.messages.contentcard.Dismiss)
{
"adid" : "(optional, string) [PII] Advertising identifier",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(required, string) ID of the card that generated this event",
"device_model" : "(optional, string) Model of the device",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"os_version" : "(optional, string) Version of the operating system of the device",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"idfa" : "(optional, string) [PII] Advertising identifier",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
// Content Card Dismiss (users.messages.contentcard.Dismiss)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(required, string) ID of the card that generated this event",
"$device" : "(optional, string) Model of the device",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"$os" : "(optional, string) Version of the operating system of the device",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
// Content Card Dismisses (users.messages.contentcard.Dismiss)
{
"device_info" : {
"android_advertising_id" : "(optional, string) [PII] Advertising identifier",
"device_model" : "(optional, string) Model of the device",
"ios_advertising_id" : "(optional, string) [PII] Advertising identifier",
"ios_idfv" : "(optional, string) ID of the device on which the event occurred",
"limit_ad_tracking" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"microsoft_advertising_id" : "(optional, string) [PII] Advertising identifier",
"platform" : "(optional, string) Platform of the device",
"roku_advertising_id" : "(optional, string) [PII] Advertising identifier"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(required, string) ID of the card that generated this event",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
// Content Card Dismissed (users.messages.contentcard.Dismiss)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : {
"model" : "(optional, string) Model of the device",
"type" : "(optional, string) Platform of the device"
}
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(required, string) ID of the card that generated this event",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
// users.messages.contentcard.Dismiss
{
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(required, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"content_card_id" : "(required, string) ID of the card that generated this event",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"device_model" : "(optional, string) Model of the device",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"os_version" : "(optional, string) Version of the operating system of the device",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Detalles de la propiedad
- Para
ad_id,ad_id_type, yad_tracking_enabled, necesitas recopilar explícitamente el IDFA de publicidad de iOS y el ID de publicidad de Google de Android a través de los SDK nativos. Más información sobre esta configuración para iOS y Android. - Si utilizas Kafka para la ingesta de datos de Currents, ponte en contacto con tu administrador del éxito del cliente para habilitar el envío de
ad_id.
Eventos de impresión de tarjetas de contenido
Este evento se produce cuando un usuario visualiza una Tarjeta de Contenido.
note:
dispatch_id está obsoleto y se eliminará en la próxima versión de Currents.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
// Content Card Impression (users.messages.contentcard.Impression)
{
"adid" : "(optional, string) [PII] Advertising identifier",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(required, string) ID of the card that generated this event",
"device_model" : "(optional, string) Model of the device",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"os_version" : "(optional, string) Version of the operating system of the device",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"idfa" : "(optional, string) [PII] Advertising identifier",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
// Content Card Impression (users.messages.contentcard.Impression)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(required, string) ID of the card that generated this event",
"$device" : "(optional, string) Model of the device",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"$os" : "(optional, string) Version of the operating system of the device",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
// Content Card Impressions (users.messages.contentcard.Impression)
{
"device_info" : {
"android_advertising_id" : "(optional, string) [PII] Advertising identifier",
"device_model" : "(optional, string) Model of the device",
"ios_advertising_id" : "(optional, string) [PII] Advertising identifier",
"ios_idfv" : "(optional, string) ID of the device on which the event occurred",
"limit_ad_tracking" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"microsoft_advertising_id" : "(optional, string) [PII] Advertising identifier",
"platform" : "(optional, string) Platform of the device",
"roku_advertising_id" : "(optional, string) [PII] Advertising identifier"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(required, string) ID of the card that generated this event",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
// Content Card Viewed (users.messages.contentcard.Impression)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : {
"model" : "(optional, string) Model of the device",
"type" : "(optional, string) Platform of the device"
}
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(required, string) ID of the card that generated this event",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
// users.messages.contentcard.Impression
{
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(required, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"content_card_id" : "(required, string) ID of the card that generated this event",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"device_model" : "(optional, string) Model of the device",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"os_version" : "(optional, string) Version of the operating system of the device",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Detalles de la propiedad
- Para
ad_id,ad_id_type, yad_tracking_enabled, necesitas recopilar explícitamente el IDFA de publicidad de iOS y el ID de publicidad de Google de Android a través de los SDK nativos. Más información sobre esta configuración para iOS y Android. - Si utilizas Kafka para la ingesta de datos de Currents, ponte en contacto con tu administrador del éxito del cliente para habilitar el envío de
ad_id.
Tarjeta de contenido Enviar eventos
Este evento se produce cuando se envía una Tarjeta de Contenido a un usuario.
note:
dispatch_id está obsoleto y se eliminará en la próxima versión de Currents.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// Content Card Send (users.messages.contentcard.Send)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(required, string) ID of the card that generated this event",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// Content Card Send (users.messages.contentcard.Send)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(required, string) ID of the card that generated this event",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
// Content Card Sends (users.messages.contentcard.Send)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(required, string) ID of the card that generated this event",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// Content Card Sent (users.messages.contentcard.Send)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(required, string) ID of the card that generated this event",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
// users.messages.contentcard.Send
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"content_card_id" : "(required, string) ID of the card that generated this event",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Detalles de la propiedad
message_extraste permiten anotar tus eventos de envío con datos dinámicos del Contenido conectado, atributos personalizados (como el idioma o el país) y propiedades de entrada del Canvas. Consulte los extras de los mensajes para obtener más información.
Correo electrónico Abortar eventos
Este evento se produce si se ha abortado un mensaje de correo electrónico debido a que Liquid lo ha abortado, etc.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
// Email Abort (users.messages.email.Abort)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"email_address" : "(required, string) [PII] Email address of the user",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
// Email Abort (users.messages.email.Abort)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"email_address" : "(required, string) [PII] Email address of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
// Email Aborts (users.messages.email.Abort)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user",
"email" : "(required, string) [PII] Email address of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
// Email Aborted (users.messages.email.Abort)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"email" : "(required, string) [PII] Email address of the user"
},
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// users.messages.email.Abort
{
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_message_variation_id" : "(optional, string) API ID of the Canvas step message variation this user received",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"email_address" : "(required, string) [PII] Email address of the user",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Eventos de rebotes de correo electrónico
Este evento se produce cuando un proveedor de servicios de Internet devuelve un rebote duro. Un rebote duro significa un fallo permanente en la capacidad de entrega.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
// Email Bounce (users.messages.email.Bounce)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"bounce_reason" : "(optional, string) [PII] The SMTP reason code and user friendly message received for this bounce event",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"email_address" : "(required, string) [PII] Email address of the user",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"is_drop" : "(optional, boolean) Indicates that this event counts as a drop event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// Email Bounce (users.messages.email.Bounce)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"bounce_reason" : "(optional, string) [PII] The SMTP reason code and user friendly message received for this bounce event",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"email_address" : "(required, string) [PII] Email address of the user",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"$insert_id" : "(required, string) Globally unique ID for this event",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"is_drop" : "(optional, boolean) Indicates that this event counts as a drop event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
// Email Bounces (users.messages.email.Bounce)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"bounce_reason" : "(optional, string) [PII] The SMTP reason code and user friendly message received for this bounce event",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"is_drop" : "(optional, boolean) Indicates that this event counts as a drop event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user",
"email" : "(required, string) [PII] Email address of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
// Email Bounced (users.messages.email.Bounce)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"email" : "(required, string) [PII] Email address of the user"
},
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"bounce_reason" : "(optional, string) [PII] The SMTP reason code and user friendly message received for this bounce event",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"is_drop" : "(optional, boolean) Indicates that this event counts as a drop event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
// users.messages.email.Bounce
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"bounce_reason" : "(optional, string) [PII] The SMTP reason code and user friendly message received for this bounce event",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"email_address" : "(required, string) [PII] Email address of the user",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"from_domain" : "(optional, string) Sending domain for the email",
"id" : "(required, string) Globally unique ID for this event",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"is_drop" : "(optional, boolean) Indicates that this event counts as a drop event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"sending_ip" : "(optional, string) IP address from which the email send was made",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Detalles de la propiedad
- El comportamiento de
dispatch_iddifiere entre Canvas y las campañas porque Braze trata los pasos de Canvas (excepto los pasos de entrada, que se pueden programar) como eventos desencadenados, incluso cuando están programados. Más información sobre el comportamiento del ID de envío.
Correo electrónico Eventos de clic
Este evento se produce cuando un usuario hace clic en un correo electrónico. Se pueden generar múltiples eventos para la misma campaña si un usuario hace clic varias veces o hace clic en diferentes enlaces dentro del correo electrónico.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
// Email Click (users.messages.email.Click)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"browser" : "(optional, string) Device browser - extracted from user_agent - on which the open occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_class" : "(optional, string) Device class extracted from user_agent (mobile, desktop, tablet, etc...)",
"device_model" : "(optional, string) Model of the device",
"device_os" : "(optional, string) Device operating system extracted from user_agent",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"email_address" : "(required, string) [PII] Email address of the user",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"is_amp" : "(optional, boolean) Indicates that this is an AMP event",
"link_alias" : "(optional, string) Alias associated with this link ID",
"link_id" : "(optional, string) Unique ID for the link which was clicked, as created by Braze",
"mailbox_provider" : "(optional, string) Mailbox provider value returned by the esp for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"url" : "(optional, string) URL that the user clicked on",
"user_agent" : "(optional, string) User agent on which the spam report occurred"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
// Email Click (users.messages.email.Click)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"browser" : "(optional, string) Device browser - extracted from user_agent - on which the open occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"$device" : "(optional, string) Model of the device",
"device_class" : "(optional, string) Device class extracted from user_agent (mobile, desktop, tablet, etc...)",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"device_os" : "(optional, string) Device operating system extracted from user_agent",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"email_address" : "(required, string) [PII] Email address of the user",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"$insert_id" : "(required, string) Globally unique ID for this event",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"is_amp" : "(optional, boolean) Indicates that this is an AMP event",
"link_alias" : "(optional, string) Alias associated with this link ID",
"link_id" : "(optional, string) Unique ID for the link which was clicked, as created by Braze",
"mailbox_provider" : "(optional, string) Mailbox provider value returned by the esp for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token",
"url" : "(optional, string) URL that the user clicked on",
"user_agent" : "(optional, string) User agent on which the spam report occurred"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
// Email Clicks (users.messages.email.Click)
{
"device_info" : {
"device_model" : "(optional, string) Model of the device",
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"browser" : "(optional, string) Device browser - extracted from user_agent - on which the open occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_class" : "(optional, string) Device class extracted from user_agent (mobile, desktop, tablet, etc...)",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"device_os" : "(optional, string) Device operating system extracted from user_agent",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"is_amp" : "(optional, boolean) Indicates that this is an AMP event",
"link_alias" : "(optional, string) Alias associated with this link ID",
"link_id" : "(optional, string) Unique ID for the link which was clicked, as created by Braze",
"mailbox_provider" : "(optional, string) Mailbox provider value returned by the esp for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event",
"url" : "(optional, string) URL that the user clicked on",
"user_agent" : "(optional, string) User agent on which the spam report occurred"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user",
"email" : "(required, string) [PII] Email address of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
// Email Link Clicked (users.messages.email.Click)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"email" : "(required, string) [PII] Email address of the user"
},
"device" : {
"model" : "(optional, string) Model of the device"
}
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"browser" : "(optional, string) Device browser - extracted from user_agent - on which the open occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_class" : "(optional, string) Device class extracted from user_agent (mobile, desktop, tablet, etc...)",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"device_os" : "(optional, string) Device operating system extracted from user_agent",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"is_amp" : "(optional, boolean) Indicates that this is an AMP event",
"link_alias" : "(optional, string) Alias associated with this link ID",
"link_id" : "(optional, string) Unique ID for the link which was clicked, as created by Braze",
"link_url" : "(optional, string) URL that the user clicked on",
"mailbox_provider" : "(optional, string) Mailbox provider value returned by the esp for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"user_agent" : "(optional, string) User agent on which the spam report occurred"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
// users.messages.email.Click
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"browser" : "(optional, string) Device browser - extracted from user_agent - on which the open occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_class" : "(optional, string) Device class extracted from user_agent (mobile, desktop, tablet, etc...)",
"device_model" : "(optional, string) Model of the device",
"device_os" : "(optional, string) Device operating system extracted from user_agent",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"email_address" : "(required, string) [PII] Email address of the user",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"from_domain" : "(optional, string) Sending domain for the email",
"id" : "(required, string) Globally unique ID for this event",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"is_amp" : "(optional, boolean) Indicates that this is an AMP event",
"link_alias" : "(optional, string) Alias associated with this link ID",
"link_id" : "(optional, string) Unique ID for the link which was clicked, as created by Braze",
"mailbox_provider" : "(optional, string) Mailbox provider value returned by the esp for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"url" : "(optional, string) URL that the user clicked on",
"user_agent" : "(optional, string) User agent on which the spam report occurred",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Detalles de la propiedad
- El comportamiento de
dispatch_iddifiere entre Canvas y las campañas porque Braze trata los pasos de Canvas (excepto los pasos de entrada, que se pueden programar) como eventos desencadenados, incluso cuando están programados. Más información sobre el comportamiento del ID de envío.
Eventos de aplazamiento por correo electrónico
Este evento se produce cuando un proveedor de servicios de Internet no entrega inmediatamente el envío por correo electrónico a una dirección de correo electrónico que no ha rebotado duro y Braze reintenta el envío durante un máximo de 72 horas. Las razones típicas de los aplazamientos incluyen la limitación de la tasa de volumen de correo electrónico basada en la reputación por parte del proveedor de buzón de entrada, problemas temporales de conectividad, el buzón del destinatario está lleno o errores de DNS.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// Email Deferral (users.messages.email.Deferral)
{
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"attempt_count" : "(optional, int) Number of attempts made to send the message",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"deferral_reason" : "(optional, string) [PII] The SMTP reason code and user friendly message received for this deferral event",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"email_address" : "(required, string) [PII] Email address of the user",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"recipient_domain" : "(optional, string) Receipient's email domain",
"send_id" : "(optional, string) Message send ID this message belongs to",
"timezone" : "(optional, string) Time zone of the user"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// Email Deferral (users.messages.email.Deferral)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"attempt_count" : "(optional, int) Number of attempts made to send the message",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"deferral_reason" : "(optional, string) [PII] The SMTP reason code and user friendly message received for this deferral event",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"email_address" : "(required, string) [PII] Email address of the user",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"$insert_id" : "(required, string) Globally unique ID for this event",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"recipient_domain" : "(optional, string) Receipient's email domain",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
// Email Deferrals (users.messages.email.Deferral)
{
"device_info" : { },
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"attempt_count" : "(optional, int) Number of attempts made to send the message",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"deferral_reason" : "(optional, string) [PII] The SMTP reason code and user friendly message received for this deferral event",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"recipient_domain" : "(optional, string) Receipient's email domain",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user",
"email" : "(required, string) [PII] Email address of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
// Email Deferred (users.messages.email.Deferral)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"email" : "(required, string) [PII] Email address of the user"
},
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"attempt_count" : "(optional, int) Number of attempts made to send the message",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"deferral_reason" : "(optional, string) [PII] The SMTP reason code and user friendly message received for this deferral event",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"recipient_domain" : "(optional, string) Receipient's email domain",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
// users.messages.email.Deferral
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"attempt_count" : "(optional, int) Number of attempts made to send the message",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_message_variation_id" : "(optional, string) API ID of the Canvas step message variation this user received",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"deferral_reason" : "(optional, string) [PII] The SMTP reason code and user friendly message received for this deferral event",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"email_address" : "(required, string) [PII] Email address of the user",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"from_domain" : "(optional, string) Sending domain for the email",
"id" : "(required, string) Globally unique ID for this event",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"recipient_domain" : "(optional, string) Receipient's email domain",
"send_id" : "(optional, string) Message send ID this message belongs to",
"sending_ip" : "(optional, string) IP address from which the email send was made",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Detalles de la propiedad
- El comportamiento de
dispatch_iddifiere entre Canvas y las campañas porque Braze trata los pasos de Canvas (excepto los pasos de entrada, que se pueden programar) como eventos desencadenados, incluso cuando están programados. Más información sobre el comportamiento del ID de envío.
Eventos de entrega de correo electrónico
Este evento se produce cuando un correo electrónico enviado llega correctamente a la bandeja de entrada del usuario final.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
// Email Delivery (users.messages.email.Delivery)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"email_address" : "(required, string) [PII] Email address of the user",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
// Email Delivery (users.messages.email.Delivery)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"email_address" : "(required, string) [PII] Email address of the user",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"$insert_id" : "(required, string) Globally unique ID for this event",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
// Email Deliveries (users.messages.email.Delivery)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user",
"email" : "(required, string) [PII] Email address of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
// Email Delivered (users.messages.email.Delivery)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"email" : "(required, string) [PII] Email address of the user"
},
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// users.messages.email.Delivery
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"email_address" : "(required, string) [PII] Email address of the user",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"from_domain" : "(optional, string) Sending domain for the email",
"id" : "(required, string) Globally unique ID for this event",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"sending_ip" : "(optional, string) IP address from which the email send was made",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Detalles de la propiedad
- El comportamiento de
dispatch_iddifiere entre Canvas y las campañas porque Braze trata los pasos de Canvas (excepto los pasos de entrada, que se pueden programar) como eventos desencadenados, incluso cuando están programados. Más información sobre el comportamiento del ID de envío.
Eventos de Marcar como Spam por correo electrónico
Este evento se produce cuando el usuario final pulsa el botón “spam” del correo electrónico. Tenga en cuenta que esto no representa el hecho de que el correo electrónico haya ido a la carpeta de correo no deseado, ya que Braze no realiza un seguimiento de este dato.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
// Email Mark As Spam (users.messages.email.MarkAsSpam)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"email_address" : "(required, string) [PII] Email address of the user",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"user_agent" : "(optional, string) User agent on which the spam report occurred"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
// Email Mark As Spam (users.messages.email.MarkAsSpam)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"email_address" : "(required, string) [PII] Email address of the user",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"$insert_id" : "(required, string) Globally unique ID for this event",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token",
"user_agent" : "(optional, string) User agent on which the spam report occurred"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
// Email Marks As Spam (users.messages.email.MarkAsSpam)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event",
"user_agent" : "(optional, string) User agent on which the spam report occurred"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user",
"email" : "(required, string) [PII] Email address of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
// Email Marked as Spam (users.messages.email.MarkAsSpam)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"email" : "(required, string) [PII] Email address of the user"
},
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"user_agent" : "(optional, string) User agent on which the spam report occurred"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// users.messages.email.MarkAsSpam
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"email_address" : "(required, string) [PII] Email address of the user",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"from_domain" : "(optional, string) Sending domain for the email",
"id" : "(required, string) Globally unique ID for this event",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_agent" : "(optional, string) User agent on which the spam report occurred",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Detalles de la propiedad
- El comportamiento de
dispatch_iddifiere entre Canvas y las campañas porque Braze trata los pasos de Canvas (excepto los pasos de entrada, que se pueden programar) como eventos desencadenados, incluso cuando están programados. Más información sobre el comportamiento del ID de envío.
Correo electrónico Eventos abiertos
Este evento se produce cuando un usuario abre un correo electrónico. Se pueden generar varios eventos para la misma campaña si un usuario abre el correo electrónico varias veces.
important:
Es un comportamiento conocido que los campos de evento de apertura de correo electrónico device_model y mailbox_provider están vacíos. Puedes ignorarlos por ahora.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
// Email Open (users.messages.email.Open)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"browser" : "(optional, string) Device browser - extracted from user_agent - on which the open occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_class" : "(optional, string) Device class extracted from user_agent (mobile, desktop, tablet, etc...)",
"device_model" : "(optional, string) Model of the device",
"device_os" : "(optional, string) Device operating system extracted from user_agent",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"email_address" : "(required, string) [PII] Email address of the user",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"is_amp" : "(optional, boolean) Indicates that this is an AMP event",
"machine_open" : "(optional, string) Populated to 'true' if the open event is triggered without user engagement, for example by an Apple device with Mail Privacy Protection enabled. Value may change over time to provide more granularity.",
"mailbox_provider" : "(optional, string) Mailbox provider value returned by the esp for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"user_agent" : "(optional, string) User agent on which the spam report occurred"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
// Email Open (users.messages.email.Open)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"browser" : "(optional, string) Device browser - extracted from user_agent - on which the open occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"$device" : "(optional, string) Model of the device",
"device_class" : "(optional, string) Device class extracted from user_agent (mobile, desktop, tablet, etc...)",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"device_os" : "(optional, string) Device operating system extracted from user_agent",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"email_address" : "(required, string) [PII] Email address of the user",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"$insert_id" : "(required, string) Globally unique ID for this event",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"is_amp" : "(optional, boolean) Indicates that this is an AMP event",
"machine_open" : "(optional, string) Populated to 'true' if the open event is triggered without user engagement, for example by an Apple device with Mail Privacy Protection enabled. Value may change over time to provide more granularity.",
"mailbox_provider" : "(optional, string) Mailbox provider value returned by the esp for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token",
"user_agent" : "(optional, string) User agent on which the spam report occurred"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
// Email Opens (users.messages.email.Open)
{
"device_info" : {
"device_model" : "(optional, string) Model of the device",
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"browser" : "(optional, string) Device browser - extracted from user_agent - on which the open occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_class" : "(optional, string) Device class extracted from user_agent (mobile, desktop, tablet, etc...)",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"device_os" : "(optional, string) Device operating system extracted from user_agent",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"is_amp" : "(optional, boolean) Indicates that this is an AMP event",
"machine_open" : "(optional, string) Populated to 'true' if the open event is triggered without user engagement, for example by an Apple device with Mail Privacy Protection enabled. Value may change over time to provide more granularity.",
"mailbox_provider" : "(optional, string) Mailbox provider value returned by the esp for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event",
"user_agent" : "(optional, string) User agent on which the spam report occurred"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user",
"email" : "(required, string) [PII] Email address of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
// Email Opened (users.messages.email.Open)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"email" : "(required, string) [PII] Email address of the user"
},
"device" : {
"model" : "(optional, string) Model of the device"
}
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"browser" : "(optional, string) Device browser - extracted from user_agent - on which the open occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_class" : "(optional, string) Device class extracted from user_agent (mobile, desktop, tablet, etc...)",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"device_os" : "(optional, string) Device operating system extracted from user_agent",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"is_amp" : "(optional, boolean) Indicates that this is an AMP event",
"machine_open" : "(optional, string) Populated to 'true' if the open event is triggered without user engagement, for example by an Apple device with Mail Privacy Protection enabled. Value may change over time to provide more granularity.",
"mailbox_provider" : "(optional, string) Mailbox provider value returned by the esp for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"user_agent" : "(optional, string) User agent on which the spam report occurred"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
// users.messages.email.Open
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"browser" : "(optional, string) Device browser - extracted from user_agent - on which the open occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_class" : "(optional, string) Device class extracted from user_agent (mobile, desktop, tablet, etc...)",
"device_model" : "(optional, string) Model of the device",
"device_os" : "(optional, string) Device operating system extracted from user_agent",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"email_address" : "(required, string) [PII] Email address of the user",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"from_domain" : "(optional, string) Sending domain for the email",
"id" : "(required, string) Globally unique ID for this event",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"is_amp" : "(optional, boolean) Indicates that this is an AMP event",
"machine_open" : "(optional, string) Populated to 'true' if the open event is triggered without user engagement, for example by an Apple device with Mail Privacy Protection enabled. Value may change over time to provide more granularity.",
"mailbox_provider" : "(optional, string) Mailbox provider value returned by the esp for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_agent" : "(optional, string) User agent on which the spam report occurred",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Detalles de la propiedad
- El comportamiento de
dispatch_iddifiere entre Canvas y las campañas porque Braze trata los pasos de Canvas (excepto los pasos de entrada, que se pueden programar) como eventos desencadenados, incluso cuando están programados. Más información sobre el comportamiento del ID de envío.
Enviar eventos por correo electrónico
Este evento se produce cuando una solicitud de envío de correo electrónico se ha comunicado correctamente entre Braze y SendGrid. Aunque esto no significa que el correo electrónico se haya recibido en la bandeja de entrada del usuario final.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// Email Send (users.messages.email.Send)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"email_address" : "(required, string) [PII] Email address of the user",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
// Email Send (users.messages.email.Send)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"email_address" : "(required, string) [PII] Email address of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
// Email Sends (users.messages.email.Send)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user",
"email" : "(required, string) [PII] Email address of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
// Email Sent (users.messages.email.Send)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"email" : "(required, string) [PII] Email address of the user"
},
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
// users.messages.email.Send
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"email_address" : "(required, string) [PII] Email address of the user",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Detalles de la propiedad
- El comportamiento de
dispatch_iddifiere entre Canvas y las campañas porque Braze trata los pasos de Canvas (excepto los pasos de entrada, que se pueden programar) como eventos desencadenados, incluso cuando están programados. Más información sobre el comportamiento del ID de envío. message_extraste permiten anotar tus eventos de envío con datos dinámicos de Contenido conectado, atributos personalizados (como idioma, país) y propiedades de entrada en Canvas. Consulte los extras de los mensajes para obtener más información.
Eventos de correo electrónico de rebote blando
Este evento se produce cuando un proveedor de servicios de Internet devuelve un rebote suave. Un rebote blando significa que no se ha podido entregar un correo electrónico debido a un fallo temporal de capacidad de entrega.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
// Email Soft Bounce (users.messages.email.SoftBounce)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"bounce_reason" : "(optional, string) [PII] The SMTP reason code and user friendly message received for this bounce event",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"email_address" : "(required, string) [PII] Email address of the user",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
// Email Soft Bounce (users.messages.email.SoftBounce)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"bounce_reason" : "(optional, string) [PII] The SMTP reason code and user friendly message received for this bounce event",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"email_address" : "(required, string) [PII] Email address of the user",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"$insert_id" : "(required, string) Globally unique ID for this event",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
// Email Soft Bounces (users.messages.email.SoftBounce)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"bounce_reason" : "(optional, string) [PII] The SMTP reason code and user friendly message received for this bounce event",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user",
"email" : "(required, string) [PII] Email address of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
// Email Soft Bounced (users.messages.email.SoftBounce)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"email" : "(required, string) [PII] Email address of the user"
},
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"bounce_reason" : "(optional, string) [PII] The SMTP reason code and user friendly message received for this bounce event",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"from_domain" : "(optional, string) Sending domain for the email",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// users.messages.email.SoftBounce
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"bounce_reason" : "(optional, string) [PII] The SMTP reason code and user friendly message received for this bounce event",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"email_address" : "(required, string) [PII] Email address of the user",
"esp" : "(optional, string) ESP related to the event (Sparkpost or Sendgrid)",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"from_domain" : "(optional, string) Sending domain for the email",
"id" : "(required, string) Globally unique ID for this event",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"sending_ip" : "(optional, string) IP address from which the email send was made",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Detalles de la propiedad
- El comportamiento de
dispatch_iddifiere entre Canvas y las campañas porque Braze trata los pasos de Canvas (excepto los pasos de entrada, que se pueden programar) como eventos desencadenados, incluso cuando están programados. Más información sobre el comportamiento del ID de envío.
Eventos para cancelar suscripción por correo electrónico
Este evento se produce cuando el usuario final ha hecho clic en “darse de baja” del correo electrónico.
important:
El evento Unsubscribe es en realidad un evento de clic especializado que se dispara cuando el usuario hace clic en el enlace de cancelación de suscripción del correo electrónico (ya sea un enlace de cancelación de suscripción normal dentro del cuerpo o pie de página del correo electrónico, o utilizando el encabezado de cancelación de suscripción de la lista), no cuando el usuario cambia el estado a cancelado. Si el cambio de estado de suscripción se envía a través de la API, o mediante un enlace personalizado (no de Braze) para darse de baja, no desencadenará un evento en Currents.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// Email Unsubscribe (users.messages.email.Unsubscribe)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"email_address" : "(required, string) [PII] Email address of the user",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// Email Unsubscribe (users.messages.email.Unsubscribe)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"email_address" : "(required, string) [PII] Email address of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
// Email Unsubscribes (users.messages.email.Unsubscribe)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user",
"email" : "(required, string) [PII] Email address of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
// Unsubscribed (users.messages.email.Unsubscribe)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"email" : "(required, string) [PII] Email address of the user"
},
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
// users.messages.email.Unsubscribe
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"email_address" : "(required, string) [PII] Email address of the user",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"ip_pool" : "(optional, string) IP pool from which the email send was made",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Detalles de la propiedad
- El comportamiento de
dispatch_iddifiere entre Canvas y las campañas porque Braze trata los pasos de Canvas (excepto los pasos de entrada, que se pueden programar) como eventos desencadenados, incluso cuando están programados. Más información sobre el comportamiento del ID de envío.
Característica Bandera Experimento Eventos de impresión
Este evento se produce siempre que un usuario ha tenido la oportunidad de interactuar con tu característica, o cuando podría haber interactuado si la característica está desactivada (en el caso de un grupo de control en una prueba A/B).
Las impresiones de la bandera de características sólo se registran una vez por sesión.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
// Feature Flag Experiment Impression (users.messages.featureflag.Impression)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"browser" : "(optional, string) Device browser - extracted from user_agent - on which the open occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_model" : "(optional, string) Model of the device",
"feature_flag_id_name" : "(optional, string) The Feature Flag Rollout identifier",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"os_version" : "(optional, string) Version of the operating system of the device",
"platform" : "(optional, string) Platform of the device",
"timezone" : "(optional, string) Time zone of the user"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
// Feature Flag Experiment Impression (users.messages.featureflag.Impression)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"browser" : "(optional, string) Device browser - extracted from user_agent - on which the open occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"$device" : "(optional, string) Model of the device",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"distinct_id" : "(required, string) [PII] External ID of the user",
"feature_flag_id_name" : "(optional, string) The Feature Flag Rollout identifier",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"$os" : "(optional, string) Version of the operating system of the device",
"platform" : "(optional, string) Platform of the device",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
// Feature Flag Experiment Impressions (users.messages.featureflag.Impression)
{
"device_info" : {
"device_model" : "(optional, string) Model of the device",
"ios_idfv" : "(optional, string) ID of the device on which the event occurred",
"platform" : "(optional, string) Platform of the device"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"browser" : "(optional, string) Device browser - extracted from user_agent - on which the open occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"feature_flag_id_name" : "(optional, string) The Feature Flag Rollout identifier",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
// Feature Flag Experiment Impressed (users.messages.featureflag.Impression)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : {
"model" : "(optional, string) Model of the device",
"type" : "(optional, string) Platform of the device"
}
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"browser" : "(optional, string) Device browser - extracted from user_agent - on which the open occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"feature_flag_id_name" : "(optional, string) The Feature Flag Rollout identifier",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
// users.messages.featureflag.Impression
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"browser" : "(optional, string) Device browser - extracted from user_agent - on which the open occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_message_variation_id" : "(optional, string) API ID of the Canvas step message variation this user received",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"carrier" : "(optional, string) Carrier of the device",
"country" : "(optional, string) [PII] Country of the user",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"device_model" : "(optional, string) Model of the device",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"feature_flag_id_name" : "(optional, string) The Feature Flag Rollout identifier",
"gender" : "(optional, string) [PII] Gender of the user, one of ['M', 'F', 'O', 'N', 'P']",
"id" : "(required, string) Globally unique ID for this event",
"language" : "(optional, string) [PII] Language of the user",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"os_version" : "(optional, string) Version of the operating system of the device",
"platform" : "(optional, string) Platform of the device",
"resolution" : "(optional, string) Resolution of the device",
"sdk_version" : "(optional, string) Version of the Braze SDK in use during the event",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Eventos de clic en mensajes dentro de la aplicación
Este evento se produce cuando un usuario hace clic en un mensaje in-app.
note:
dispatch_id está obsoleto y se eliminará en la próxima versión de Currents.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
// In-App Message Click (users.messages.inappmessage.Click)
{
"adid" : "(optional, string) [PII] Advertising identifier",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"button_id" : "(optional, string) ID of the button clicked, if this click represents a click on a button",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(optional, string) API ID of the card",
"device_model" : "(optional, string) Model of the device",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"os_version" : "(optional, string) Version of the operating system of the device",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"idfa" : "(optional, string) [PII] Advertising identifier",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
// In-App Message Click (users.messages.inappmessage.Click)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"button_id" : "(optional, string) ID of the button clicked, if this click represents a click on a button",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(optional, string) API ID of the card",
"$device" : "(optional, string) Model of the device",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"$os" : "(optional, string) Version of the operating system of the device",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
// In-App Message Clicks (users.messages.inappmessage.Click)
{
"device_info" : {
"android_advertising_id" : "(optional, string) [PII] Advertising identifier",
"device_model" : "(optional, string) Model of the device",
"ios_advertising_id" : "(optional, string) [PII] Advertising identifier",
"ios_idfv" : "(optional, string) ID of the device on which the event occurred",
"limit_ad_tracking" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"microsoft_advertising_id" : "(optional, string) [PII] Advertising identifier",
"platform" : "(optional, string) Platform of the device",
"roku_advertising_id" : "(optional, string) [PII] Advertising identifier"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"button_id" : "(optional, string) ID of the button clicked, if this click represents a click on a button",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(optional, string) API ID of the card",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
// In-App Message Clicked (users.messages.inappmessage.Click)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : {
"model" : "(optional, string) Model of the device",
"type" : "(optional, string) Platform of the device"
}
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"button_id" : "(optional, string) ID of the button clicked, if this click represents a click on a button",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(optional, string) API ID of the card",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// users.messages.inappmessage.Click
{
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(required, string) API ID of the app on which this event occurred",
"button_id" : "(optional, string) ID of the button clicked, if this click represents a click on a button",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(optional, string) API ID of the card",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"device_model" : "(optional, string) Model of the device",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"os_version" : "(optional, string) Version of the operating system of the device",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Detalles de la propiedad
- Para
ad_id,ad_id_type, yad_tracking_enabled, necesitas recopilar explícitamente el IDFA de publicidad de iOS y el ID de publicidad de Google de Android a través de los SDK nativos. Más información sobre esta configuración para iOS y Android. - Si utilizas Kafka para la ingesta de datos de Currents, ponte en contacto con tu administrador del éxito del cliente para habilitar el envío de
ad_id.
Eventos de impresión de mensajes dentro de la aplicación
Este evento se produce cuando un usuario visualiza un mensaje in-app.
note:
dispatch_id está obsoleto y se eliminará en la próxima versión de Currents.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
// In-App Message Impression (users.messages.inappmessage.Impression)
{
"adid" : "(optional, string) [PII] Advertising identifier",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(optional, string) API ID of the card",
"device_model" : "(optional, string) Model of the device",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"os_version" : "(optional, string) Version of the operating system of the device",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"idfa" : "(optional, string) [PII] Advertising identifier",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
// In-App Message Impression (users.messages.inappmessage.Impression)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(optional, string) API ID of the card",
"$device" : "(optional, string) Model of the device",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"$os" : "(optional, string) Version of the operating system of the device",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
// In-App Message Impressions (users.messages.inappmessage.Impression)
{
"device_info" : {
"android_advertising_id" : "(optional, string) [PII] Advertising identifier",
"device_model" : "(optional, string) Model of the device",
"ios_advertising_id" : "(optional, string) [PII] Advertising identifier",
"ios_idfv" : "(optional, string) ID of the device on which the event occurred",
"limit_ad_tracking" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"microsoft_advertising_id" : "(optional, string) [PII] Advertising identifier",
"platform" : "(optional, string) Platform of the device",
"roku_advertising_id" : "(optional, string) [PII] Advertising identifier"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(optional, string) API ID of the card",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
// In-App Message Viewed (users.messages.inappmessage.Impression)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : {
"model" : "(optional, string) Model of the device",
"type" : "(optional, string) Platform of the device"
}
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(optional, string) API ID of the card",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// users.messages.inappmessage.Impression
{
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(required, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"card_id" : "(optional, string) API ID of the card",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"device_model" : "(optional, string) Model of the device",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"os_version" : "(optional, string) Version of the operating system of the device",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Detalles de la propiedad
- Para
ad_id,ad_id_type, yad_tracking_enabled, necesitas recopilar explícitamente el IDFA de publicidad de iOS y el ID de publicidad de Google de Android a través de los SDK nativos. Más información sobre esta configuración para iOS y Android. - Si utilizas Kafka para la ingesta de datos de Currents, ponte en contacto con tu administrador del éxito del cliente para habilitar el envío de
ad_id.
Eventos de cancelación de notificación push
Este evento se produce si se ha abortado un mensaje de notificación push en función de las interrupciones de Liquid, etc.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
// Push Notification Abort (users.messages.pushnotification.Abort)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
// Push Notification Abort (users.messages.pushnotification.Abort)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
// Push Notification Aborts (users.messages.pushnotification.Abort)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred",
"platform" : "(optional, string) Platform of the device"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
// Push Notification Aborted (users.messages.pushnotification.Abort)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"platform" : "(required, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// users.messages.pushnotification.Abort
{
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_message_variation_id" : "(optional, string) API ID of the Canvas step message variation this user received",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"platform" : "(required, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Eventos de rebote de notificaciones push
Este evento se produce cuando se recibe un error del servicio de notificaciones push de Apple o de Fire Cloud Messaging. Esto significa que el mensaje push ha sido rebotado y, por tanto, no ha llegado al dispositivo del usuario.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// Push Notification Bounce (users.messages.pushnotification.Bounce)
{
"adid" : "(optional, string) [PII] Advertising identifier",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"idfa" : "(optional, string) [PII] Advertising identifier",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
// Push Notification Bounce (users.messages.pushnotification.Bounce)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
// Push Notification Bounces (users.messages.pushnotification.Bounce)
{
"device_info" : {
"android_advertising_id" : "(optional, string) [PII] Advertising identifier",
"ios_advertising_id" : "(optional, string) [PII] Advertising identifier",
"ios_idfv" : "(optional, string) ID of the device on which the event occurred",
"limit_ad_tracking" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"microsoft_advertising_id" : "(optional, string) [PII] Advertising identifier",
"platform" : "(optional, string) Platform of the device",
"roku_advertising_id" : "(optional, string) [PII] Advertising identifier"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
// Push Notification Bounced (users.messages.pushnotification.Bounce)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// users.messages.pushnotification.Bounce
{
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(required, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Detalles de la propiedad
- Si utilizas Kafka para la ingesta de datos de Currents, ponte en contacto con tu director del éxito del cliente o tu administrador de cuentas para habilitar la función para el envío de
ad_id.
Notificación push Eventos de apertura en primer plano de iOS
Este evento no es compatible con nuestro SDK Swift y ahora está obsoleto en nuestro SDK Obj-C.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
// Push Notification iOS Foreground Open (users.messages.pushnotification.IosForeground)
{
"adid" : "(optional, string) [PII] Advertising identifier",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_model" : "(optional, string) Model of the device",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"os_version" : "(optional, string) Version of the operating system of the device",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"idfa" : "(optional, string) [PII] Advertising identifier",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
// Push Notification iOS Foreground Open (users.messages.pushnotification.IosForeground)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"$device" : "(optional, string) Model of the device",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"$os" : "(optional, string) Version of the operating system of the device",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
// Ios Foreground Push Opened (users.messages.pushnotification.IosForeground)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : {
"model" : "(optional, string) Model of the device",
"type" : "(optional, string) Platform of the device"
}
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// users.messages.pushnotification.IosForeground
{
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(required, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"platform" : "(required, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Detalles de la propiedad
- Para
ad_id,ad_id_type, yad_tracking_enabled, necesitas recopilar explícitamente el IDFA de publicidad de iOS y el ID de publicidad de Google de Android a través de los SDK nativos. Más información sobre esta configuración para iOS y Android. - Si utilizas Kafka para la ingesta de datos de Currents, ponte en contacto con tu administrador del éxito del cliente para habilitar el envío de
ad_id.
Notificación push Eventos abiertos
Este evento se produce cuando un usuario hace clic directamente en la notificación Push para abrir la aplicación. Actualmente, los eventos Push Open se refieren específicamente a “Aperturas directas” y no a “Aperturas totales”. Esto no incluye las estadísticas mostradas a nivel de campaña de “aperturas influidas”, ya que éstas no se atribuyen a nivel de usuario.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
// Push Notification Open (users.messages.pushnotification.Open)
{
"adid" : "(optional, string) [PII] Advertising identifier",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_model" : "(optional, string) Model of the device",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"os_version" : "(optional, string) Version of the operating system of the device",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"idfa" : "(optional, string) [PII] Advertising identifier",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
// Push Notification Open (users.messages.pushnotification.Open)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"$device" : "(optional, string) Model of the device",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"$os" : "(optional, string) Version of the operating system of the device",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
// Push Notification Opens (users.messages.pushnotification.Open)
{
"device_info" : {
"android_advertising_id" : "(optional, string) [PII] Advertising identifier",
"device_model" : "(optional, string) Model of the device",
"ios_advertising_id" : "(optional, string) [PII] Advertising identifier",
"ios_idfv" : "(optional, string) ID of the device on which the event occurred",
"limit_ad_tracking" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"microsoft_advertising_id" : "(optional, string) [PII] Advertising identifier",
"platform" : "(optional, string) Platform of the device",
"roku_advertising_id" : "(optional, string) [PII] Advertising identifier"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
// Push Notification Tapped (users.messages.pushnotification.Open)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : {
"model" : "(optional, string) Model of the device",
"type" : "(optional, string) Platform of the device"
}
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
// users.messages.pushnotification.Open
{
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(required, string) API ID of the app on which this event occurred",
"button_action_type" : "(optional, string) Action type of the push notification button, null if not from a button click. One of ['uri', 'deep_link', 'none', 'close']",
"button_string" : "(optional, string) Identifier (button_string) of the push notification button clicked. null if not from a button click",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_message_variation_id" : "(optional, string) API ID of the Canvas step message variation this user received",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"device_model" : "(optional, string) Model of the device",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"os_version" : "(optional, string) Version of the operating system of the device",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Detalles de la propiedad
- Para
ad_id,ad_id_type, yad_tracking_enabled, necesitas recopilar explícitamente el IDFA de publicidad de iOS y el ID de publicidad de Google de Android a través de los SDK nativos. Más información sobre esta configuración para iOS y Android. - Si utilizas Kafka para la ingesta de datos de Currents, ponte en contacto con tu administrador del éxito del cliente para habilitar el envío de
ad_id.
Notificación push Enviar eventos
Este evento se produce cuando Braze procesa un mensaje push para un usuario, comunicándolo al servicio de notificaciones push de Apple o a Fire Cloud Messaging. Esto no significa que el push haya llegado al dispositivo, sólo que se ha enviado un mensaje.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
// Push Notification Send (users.messages.pushnotification.Send)
{
"adid" : "(optional, string) [PII] Advertising identifier",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"idfa" : "(optional, string) [PII] Advertising identifier",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// Push Notification Send (users.messages.pushnotification.Send)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"platform" : "(optional, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
// Push Notification Sends (users.messages.pushnotification.Send)
{
"device_info" : {
"android_advertising_id" : "(optional, string) [PII] Advertising identifier",
"ios_advertising_id" : "(optional, string) [PII] Advertising identifier",
"ios_idfv" : "(optional, string) ID of the device on which the event occurred",
"limit_ad_tracking" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"microsoft_advertising_id" : "(optional, string) [PII] Advertising identifier",
"platform" : "(optional, string) Platform of the device",
"roku_advertising_id" : "(optional, string) [PII] Advertising identifier"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
// Push Notification Sent (users.messages.pushnotification.Send)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(optional, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"platform" : "(required, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
// users.messages.pushnotification.Send
{
"ad_id" : "(optional, string) [PII] Advertising identifier",
"ad_id_type" : "(optional, string) One of ['ios_idfa', 'google_ad_id', 'windows_ad_id', 'roku_ad_id']",
"ad_tracking_enabled" : "(optional, boolean) Whether advertising tracking is enabled for the device",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"app_id" : "(required, string) API ID of the app on which this event occurred",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"platform" : "(required, string) Platform of the device",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Detalles de la propiedad
- Para
ad_id,ad_id_type, yad_tracking_enabled, necesitas recopilar explícitamente el IDFA de publicidad de iOS y el ID de publicidad de Google de Android a través de los SDK nativos. Más información sobre esta configuración para iOS y Android. - Si utilizas Kafka para la ingesta de datos de Currents, ponte en contacto con tu administrador del éxito del cliente para habilitar el envío de
ad_id. message_extraste permiten anotar tus eventos de envío con datos dinámicos de Contenido conectado, atributos personalizados (como idioma, país) y propiedades de entrada en Canvas. Consulte los extras de los mensajes para obtener más información.
SMS Abortar eventos
Este evento se produce si se ha abortado un mensaje SMS debido a que Liquid lo ha abortado, etc.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
// SMS Abort (users.messages.sms.Abort)
{
"event_properties" : {
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
// SMS Abort (users.messages.sms.Abort)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"distinct_id" : "(required, string) [PII] External ID of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
// SMS Aborts (users.messages.sms.Abort)
{
"device_info" : { },
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"source_request_id" : "(required, string) Globally unique ID for this event",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
// SMS Aborted (users.messages.sms.Abort)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
// users.messages.sms.Abort
{
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_message_variation_id" : "(optional, string) API ID of the Canvas step message variation this user received",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
SMS Operador Enviar eventos
Este evento se produce cuando se envía un SMS al operador.
important:
CarrierSend solo se admite para usuarios de infraestructuras heredadas.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// SMS Carrier Send (users.messages.sms.CarrierSend)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"from_phone_number" : "(optional, string) Phone number used to send in e.164 format (for example +14155552671)",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
// SMS Carrier Send (users.messages.sms.CarrierSend)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"from_phone_number" : "(optional, string) Phone number used to send in e.164 format (for example +14155552671)",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, int) UNIX timestamp at which the event happened",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
// SMS Carrier Sends (users.messages.sms.CarrierSend)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"from_phone_number" : "(optional, string) Phone number used to send in e.164 format (for example +14155552671)",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : {
"$mobile" : "(required, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
// SMS Sent to Carrier (users.messages.sms.CarrierSend)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"phone" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"from_phone_number" : "(optional, string) Phone number used to send in e.164 format (for example +14155552671)",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
// users.messages.sms.CarrierSend
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"from_phone_number" : "(optional, string) Phone number used to send in e.164 format (for example +14155552671)",
"id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Eventos de entrega de SMS
Este evento se produce cuando se ha entregado correctamente un SMS al teléfono móvil del usuario.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// SMS Delivery (users.messages.sms.Delivery)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"from_phone_number" : "(optional, string) Phone number used to send in e.164 format (for example +14155552671)",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
// SMS Delivery (users.messages.sms.Delivery)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"from_phone_number" : "(optional, string) Phone number used to send in e.164 format (for example +14155552671)",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, int) UNIX timestamp at which the event happened",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
// SMS Deliveries (users.messages.sms.Delivery)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"from_phone_number" : "(optional, string) Phone number used to send in e.164 format (for example +14155552671)",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : {
"$mobile" : "(required, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
// SMS Delivered (users.messages.sms.Delivery)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"phone" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"from_phone_number" : "(optional, string) Phone number used to send in e.164 format (for example +14155552671)",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
// users.messages.sms.Delivery
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"from_phone_number" : "(optional, string) Phone number used to send in e.164 format (for example +14155552671)",
"id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Eventos de fallo en la entrega de SMS
Este evento se produce cuando un SMS experimenta un fallo de entrega. Utilice este evento y los códigos de error proporcionados para ayudar a solucionar problemas con la entrega de SMS.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
// SMS Delivery Failure (users.messages.sms.DeliveryFailure)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"error" : "(optional, string) Error name",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"provider_error_code" : "(optional, string) Error code from the SMS provider",
"send_id" : "(optional, string) Message send ID this message belongs to",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
// SMS Delivery Failure (users.messages.sms.DeliveryFailure)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"error" : "(optional, string) Error name",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"provider_error_code" : "(optional, string) Error code from the SMS provider",
"send_id" : "(optional, string) Message send ID this message belongs to",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, int) UNIX timestamp at which the event happened",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
// SMS Delivery Failures (users.messages.sms.DeliveryFailure)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"error" : "(optional, string) Error name",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"provider_error_code" : "(optional, string) Error code from the SMS provider",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : {
"$mobile" : "(required, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
// SMS Delivery Failed (users.messages.sms.DeliveryFailure)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"phone" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"error" : "(optional, string) Error name",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"provider_error_code" : "(optional, string) Error code from the SMS provider",
"send_id" : "(optional, string) Message send ID this message belongs to",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
// users.messages.sms.DeliveryFailure
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"error" : "(optional, string) Error name",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"provider_error_code" : "(optional, string) Error code from the SMS provider",
"send_id" : "(optional, string) Message send ID this message belongs to",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Eventos de recepción de SMS
Este evento se produce cuando uno de sus usuarios envía un SMS a un número de teléfono de uno de sus grupos de suscripción Braze SMS.
Cuando Braze recibe un SMS entrante, atribuimos ese mensaje entrante a cualquier usuario que comparta ese número de teléfono. Como resultado, puede recibir varios eventos por mensaje entrante si varios usuarios de su instancia de Braze comparten el mismo número de teléfono. Si necesita atribuir ID de usuario específicos en función de mensajes anteriores enviados a ese usuario, puede utilizar el evento SMS Delivered para atribuir eventos Inbound Received al ID de usuario que haya recibido más recientemente un mensaje de su número Braze.
Si detectamos que este mensaje entrante es una respuesta a una campaña saliente o componente Canvas enviado desde Braze, también incluiremos los metadatos de la campaña o Canvas con el evento. Braze define una respuesta como un mensaje entrante que llega en las cuatro horas siguientes a un mensaje saliente. Sin embargo, hay una caché de un minuto para la información de la campaña atribuida del último SMS saliente recibido.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// SMS Inbound Received (users.messages.sms.InboundReceive)
{
"event_properties" : {
"action" : "(required, string) Action taken in response to this message. (for example Subscribed, Unsubscribed or None).",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"inbound_phone_number" : "(required, string) The inbound number that the message was sent to",
"media_urls" : "(optional, array of string) Media URLs from the user",
"message_body" : "(optional, string) Typed response from the user",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"user_phone_number" : "(required, string) [PII] The user's phone number from which the message was received"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
// SMS Inbound Received (users.messages.sms.InboundReceive)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"action" : "(required, string) Action taken in response to this message. (for example Subscribed, Unsubscribed or None).",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"distinct_id" : "(required, string) [PII] External ID of the user",
"inbound_phone_number" : "(required, string) The inbound number that the message was sent to",
"$insert_id" : "(required, string) Globally unique ID for this event",
"media_urls" : "(optional, array of string) Media URLs from the user",
"message_body" : "(optional, string) Typed response from the user",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token",
"user_phone_number" : "(required, string) [PII] The user's phone number from which the message was received"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
// SMS Inbound Received (users.messages.sms.InboundReceive)
{
"device_info" : { },
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"action" : "(required, string) Action taken in response to this message. (for example Subscribed, Unsubscribed or None).",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"inbound_phone_number" : "(required, string) The inbound number that the message was sent to",
"message_body" : "(optional, string) Typed response from the user",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"source_request_id" : "(required, string) Globally unique ID for this event",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : {
"$mobile" : "(required, string) [PII] The user's phone number from which the message was received"
},
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
// SMS Inbound Received (users.messages.sms.InboundReceive)
{
"anonymousId" : "(optional, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"phone" : "(required, string) [PII] The user's phone number from which the message was received"
},
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"action" : "(required, string) Action taken in response to this message. (for example Subscribed, Unsubscribed or None).",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"inbound_phone_number" : "(required, string) The inbound number that the message was sent to",
"media_urls" : "(optional, array of string) Media URLs from the user",
"message_body" : "(optional, string) Typed response from the user",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
// users.messages.sms.InboundReceive
{
"action" : "(required, string) Action taken in response to this message. (for example Subscribed, Unsubscribed or None).",
"app_group_id" : "(required, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"inbound_phone_number" : "(required, string) The inbound number that the message was sent to",
"media_urls" : "(optional, array of string) Media URLs from the user",
"message_body" : "(required, string) Typed response from the user",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) Braze user ID of the user who performed this event",
"user_phone_number" : "(required, string) [PII] The user's phone number from which the message was received"
}
Sucesos de rechazo de SMS
Este evento se produce cuando un envío de SMS es rechazado por el operador, esto puede ocurrir por varias razones. Utilice este evento y los códigos de error proporcionados para ayudar a solucionar problemas con la entrega de SMS.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
// SMS Rejection (users.messages.sms.Rejection)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"error" : "(optional, string) Error name",
"from_phone_number" : "(optional, string) Phone number used to send in e.164 format (for example +14155552671)",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"provider_error_code" : "(optional, string) Error code from the SMS provider",
"send_id" : "(optional, string) Message send ID this message belongs to",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
// SMS Rejection (users.messages.sms.Rejection)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"error" : "(optional, string) Error name",
"from_phone_number" : "(optional, string) Phone number used to send in e.164 format (for example +14155552671)",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"provider_error_code" : "(optional, string) Error code from the SMS provider",
"send_id" : "(optional, string) Message send ID this message belongs to",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, int) UNIX timestamp at which the event happened",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
// SMS Rejections (users.messages.sms.Rejection)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"error" : "(optional, string) Error name",
"from_phone_number" : "(optional, string) Phone number used to send in e.164 format (for example +14155552671)",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"provider_error_code" : "(optional, string) Error code from the SMS provider",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : {
"$mobile" : "(required, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
// SMS Rejected (users.messages.sms.Rejection)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"phone" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"error" : "(optional, string) Error name",
"from_phone_number" : "(optional, string) Phone number used to send in e.164 format (for example +14155552671)",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"provider_error_code" : "(optional, string) Error code from the SMS provider",
"send_id" : "(optional, string) Message send ID this message belongs to",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// users.messages.sms.Rejection
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"error" : "(optional, string) Error name",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"from_phone_number" : "(optional, string) Phone number used to send in e.164 format (for example +14155552671)",
"id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"provider_error_code" : "(optional, string) Error code from the SMS provider",
"send_id" : "(optional, string) Message send ID this message belongs to",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Eventos de envío de SMS
Este evento se produce cuando un usuario envía un SMS.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
// SMS Send (users.messages.sms.Send)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"category" : "(optional, string) Keyword category name, only populated for auto-reply messages: 'opt-in', 'opt-out', 'help', or custom value",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
// SMS Send (users.messages.sms.Send)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"category" : "(optional, string) Keyword category name, only populated for auto-reply messages: 'opt-in', 'opt-out', 'help', or custom value",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, int) UNIX timestamp at which the event happened",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
// SMS Sends (users.messages.sms.Send)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"category" : "(optional, string) Keyword category name, only populated for auto-reply messages: 'opt-in', 'opt-out', 'help', or custom value",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : {
"$mobile" : "(required, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
// SMS Sent (users.messages.sms.Send)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"phone" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"category" : "(optional, string) Keyword category name, only populated for auto-reply messages: 'opt-in', 'opt-out', 'help', or custom value",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
// users.messages.sms.Send
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"category" : "(optional, string) Keyword category name, only populated for auto-reply messages: 'opt-in', 'opt-out', 'help', or custom value",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Detalles de la propiedad
message_extraste permiten anotar tus eventos de envío con datos dinámicos de Contenido conectado, atributos personalizados (como idioma, país) y propiedades de entrada en Canvas. Consulte los extras de los mensajes para obtener más información.
Enlace corto SMS Eventos de clic
Este evento se produce cuando un usuario hace clic en un enlace corto de SMS.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// SMS Short Link Click (users.messages.sms.ShortLinkClick)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"short_url" : "(required, string) Shortened url that was clicked",
"url" : "(optional, string) URL that the user clicked on",
"user_agent" : "(optional, string) User agent on which the spam report occurred",
"user_phone_number" : "(optional, string) [PII] The user's phone number from which the message was received"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// SMS Short Link Click (users.messages.sms.ShortLinkClick)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"distinct_id" : "(required, string) [PII] External ID of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"short_url" : "(required, string) Shortened url that was clicked",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token",
"url" : "(optional, string) URL that the user clicked on",
"user_agent" : "(optional, string) User agent on which the spam report occurred",
"user_phone_number" : "(optional, string) [PII] The user's phone number from which the message was received"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
// SMS Short Link Clicks (users.messages.sms.ShortLinkClick)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"short_url" : "(required, string) Shortened url that was clicked",
"source_request_id" : "(required, string) Globally unique ID for this event",
"url" : "(optional, string) URL that the user clicked on",
"user_agent" : "(optional, string) User agent on which the spam report occurred"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : {
"$mobile" : "(required, string) [PII] The user's phone number from which the message was received"
},
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
// SMS Short Link Clicked (users.messages.sms.ShortLinkClick)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"phone" : "(optional, string) [PII] The user's phone number from which the message was received"
},
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"short_url" : "(required, string) Shortened url that was clicked",
"url" : "(optional, string) URL that the user clicked on",
"user_agent" : "(optional, string) User agent on which the spam report occurred"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
// users.messages.sms.ShortLinkClick
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"short_url" : "(required, string) Shortened url that was clicked",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"url" : "(required, string) URL that the user clicked on",
"user_agent" : "(optional, string) User agent on which the spam report occurred",
"user_id" : "(required, string) Braze user ID of the user who performed this event",
"user_phone_number" : "(optional, string) [PII] The user's phone number from which the message was received"
}
Eventos de abortar webhook
Este evento se produce si se ha abortado un mensaje de webhook en función de los abortos de Liquid, etc.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// Webhook Abort (users.messages.webhook.Abort)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// Webhook Abort (users.messages.webhook.Abort)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
// Webhook Aborts (users.messages.webhook.Abort)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// Webhook Aborted (users.messages.webhook.Abort)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
// users.messages.webhook.Abort
{
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_message_variation_id" : "(optional, string) API ID of the Canvas step message variation this user received",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Webhook Enviar eventos
Este evento ocurre cuando un webhook fue procesado y enviado al tercero especificado en ese webhook. Ten en cuenta que esto no significa que se haya recibido o no la solicitud.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
// Webhook Send (users.messages.webhook.Send)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, int) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// Webhook Send (users.messages.webhook.Send)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
// Webhook Sends (users.messages.webhook.Send)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"source_request_id" : "(required, string) Globally unique ID for this event"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, int) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : { },
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
// Webhook Sent (users.messages.webhook.Send)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : { },
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to"
},
"timestamp" : "(required, int) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
// users.messages.webhook.Send
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"send_id" : "(optional, string) Message send ID this message belongs to",
"time" : "(required, int) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Detalles de la propiedad
message_extraste permiten anotar tus eventos de envío con datos dinámicos del Contenido conectado, atributos personalizados (como el idioma o el país) y propiedades de entrada del Canvas. Consulte los extras de los mensajes para obtener más información.
Eventos de WhatsApp Abortar
Este evento se produce si se ha abortado un mensaje de WhatsApp debido a que Liquid lo ha abortado, etc.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// WhatsApp Abort (users.messages.whatsapp.Abort)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, long) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
// WhatsApp Abort (users.messages.whatsapp.Abort)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, long) UNIX timestamp at which the event happened",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
// WhatsApp Aborts (users.messages.whatsapp.Abort)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"source_request_id" : "(required, string) Globally unique ID for this event",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, long) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : {
"$mobile" : "(required, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
// WhatsApp Aborted (users.messages.whatsapp.Abort)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"phone" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"timestamp" : "(required, long) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// users.messages.whatsapp.Abort
{
"abort_log" : "(optional, string) [PII] Log message describing abort details (up to 128 chars)",
"abort_type" : "(optional, string) Type of abort",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_message_variation_id" : "(optional, string) API ID of the Canvas step message variation this user received",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, long) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Actos de entrega de WhatsApp
Este evento se produce cuando un mensaje de WhatsApp enviado llega correctamente al dispositivo del usuario final.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// WhatsApp Delivery (users.messages.whatsapp.Delivery)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"from_phone_number" : "(required, string) Phone number used to send in e.164 format (for example +14155552671)",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, long) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// WhatsApp Delivery (users.messages.whatsapp.Delivery)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"from_phone_number" : "(required, string) Phone number used to send in e.164 format (for example +14155552671)",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, long) UNIX timestamp at which the event happened",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
// WhatsApp Deliveries (users.messages.whatsapp.Delivery)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"from_phone_number" : "(required, string) Phone number used to send in e.164 format (for example +14155552671)",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"source_request_id" : "(required, string) Globally unique ID for this event",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, long) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : {
"$mobile" : "(required, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
// WhatsApp Delivered (users.messages.whatsapp.Delivery)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"phone" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"from_phone_number" : "(required, string) Phone number used to send in e.164 format (for example +14155552671)",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"timestamp" : "(required, long) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
// users.messages.whatsapp.Delivery
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_message_variation_id" : "(optional, string) API ID of the Canvas step message variation this user received",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"from_phone_number" : "(required, string) Phone number used to send in e.164 format (for example +14155552671)",
"id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, long) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Eventos de fallo de WhatsApp
Este evento se produce cuando WhatsApp no puede entregar el mensaje al usuario. Un rebote duro significa un fallo permanente en la capacidad de entrega.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
// WhatsApp Failure (users.messages.whatsapp.Failure)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"from_phone_number" : "(required, string) Phone number used to send in e.164 format (for example +14155552671)",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"provider_error_code" : "(required, string) Error code from WhatsApp",
"provider_error_title" : "(required, string) Description of error from WhatsApp",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, long) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
// WhatsApp Failure (users.messages.whatsapp.Failure)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"from_phone_number" : "(required, string) Phone number used to send in e.164 format (for example +14155552671)",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"provider_error_code" : "(required, string) Error code from WhatsApp",
"provider_error_title" : "(required, string) Description of error from WhatsApp",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, long) UNIX timestamp at which the event happened",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
// WhatsApp Failures (users.messages.whatsapp.Failure)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"from_phone_number" : "(required, string) Phone number used to send in e.164 format (for example +14155552671)",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"provider_error_code" : "(required, string) Error code from WhatsApp",
"provider_error_title" : "(required, string) Description of error from WhatsApp",
"source_request_id" : "(required, string) Globally unique ID for this event",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, long) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : {
"$mobile" : "(required, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
// WhatsApp Failed (users.messages.whatsapp.Failure)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"phone" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"from_phone_number" : "(required, string) Phone number used to send in e.164 format (for example +14155552671)",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"provider_error_code" : "(required, string) Error code from WhatsApp",
"provider_error_title" : "(required, string) Description of error from WhatsApp",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"timestamp" : "(required, long) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// users.messages.whatsapp.Failure
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_message_variation_id" : "(optional, string) API ID of the Canvas step message variation this user received",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"from_phone_number" : "(required, string) Phone number used to send in e.164 format (for example +14155552671)",
"id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"provider_error_code" : "(required, string) Error code from WhatsApp",
"provider_error_title" : "(required, string) Description of error from WhatsApp",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, long) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Eventos recibidos de WhatsApp
Este evento se produce cuando uno de tus usuarios envía un mensaje de WhatsApp a un número de teléfono de uno de tus grupos de suscripción de Braze WhatsApp.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
// WhatsApp Inbound Received (users.messages.whatsapp.InboundReceive)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"action" : "(required, string) Action taken in response to this message. (for example Subscribed, Unsubscribed or None).",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"inbound_phone_number" : "(required, string) The inbound number that the message was sent to",
"media_urls" : "(optional, array of string) Media URLs from the user",
"message_body" : "(optional, string) Typed response from the user",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"quick_reply_text" : "(optional, string) Text of button pressed by the user",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"user_phone_number" : "(required, string) [PII] The user's phone number from which the message was received"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, long) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
// WhatsApp Inbound Received (users.messages.whatsapp.InboundReceive)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"action" : "(required, string) Action taken in response to this message. (for example Subscribed, Unsubscribed or None).",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"distinct_id" : "(required, string) [PII] External ID of the user",
"inbound_phone_number" : "(required, string) The inbound number that the message was sent to",
"$insert_id" : "(required, string) Globally unique ID for this event",
"media_urls" : "(optional, array of string) Media URLs from the user",
"message_body" : "(optional, string) Typed response from the user",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"quick_reply_text" : "(optional, string) Text of button pressed by the user",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, long) UNIX timestamp at which the event happened",
"token" : "(required, string) The Mixpanel API token",
"user_phone_number" : "(required, string) [PII] The user's phone number from which the message was received"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
// WhatsApp Inbound Received (users.messages.whatsapp.InboundReceive)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"action" : "(required, string) Action taken in response to this message. (for example Subscribed, Unsubscribed or None).",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"inbound_phone_number" : "(required, string) The inbound number that the message was sent to",
"message_body" : "(optional, string) Typed response from the user",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"quick_reply_text" : "(optional, string) Text of button pressed by the user",
"source_request_id" : "(required, string) Globally unique ID for this event",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, long) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : {
"$mobile" : "(required, string) [PII] The user's phone number from which the message was received"
},
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
// WhatsApp Inbound Received (users.messages.whatsapp.InboundReceive)
{
"anonymousId" : "(optional, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"phone" : "(required, string) [PII] The user's phone number from which the message was received"
},
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"action" : "(required, string) Action taken in response to this message. (for example Subscribed, Unsubscribed or None).",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"inbound_phone_number" : "(required, string) The inbound number that the message was sent to",
"media_urls" : "(optional, array of string) Media URLs from the user",
"message_body" : "(optional, string) Typed response from the user",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"quick_reply_text" : "(optional, string) Text of button pressed by the user",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"timestamp" : "(required, long) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
// users.messages.whatsapp.InboundReceive
{
"action" : "(required, string) Action taken in response to this message. (for example Subscribed, Unsubscribed or None).",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_message_variation_id" : "(optional, string) API ID of the Canvas step message variation this user received",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"id" : "(required, string) Globally unique ID for this event",
"inbound_phone_number" : "(required, string) The inbound number that the message was sent to",
"media_urls" : "(optional, array of string) Media URLs from the user",
"message_body" : "(optional, string) Typed response from the user",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"quick_reply_text" : "(optional, string) Text of button pressed by the user",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, long) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"user_id" : "(optional, string) Braze user ID of the user who performed this event",
"user_phone_number" : "(required, string) [PII] The user's phone number from which the message was received"
}
WhatsApp Leer eventos
Este evento se produce cuando el usuario final lee un mensaje de WhatsApp.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// WhatsApp Read (users.messages.whatsapp.Read)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"from_phone_number" : "(required, string) Phone number used to send in e.164 format (for example +14155552671)",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, long) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// WhatsApp Read (users.messages.whatsapp.Read)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"from_phone_number" : "(required, string) Phone number used to send in e.164 format (for example +14155552671)",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, long) UNIX timestamp at which the event happened",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
// WhatsApp Reads (users.messages.whatsapp.Read)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"from_phone_number" : "(required, string) Phone number used to send in e.164 format (for example +14155552671)",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"source_request_id" : "(required, string) Globally unique ID for this event",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, long) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : {
"$mobile" : "(required, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
// WhatsApp Read (users.messages.whatsapp.Read)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"phone" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"from_phone_number" : "(required, string) Phone number used to send in e.164 format (for example +14155552671)",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"timestamp" : "(required, long) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
// users.messages.whatsapp.Read
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_message_variation_id" : "(optional, string) API ID of the Canvas step message variation this user received",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"from_phone_number" : "(required, string) Phone number used to send in e.164 format (for example +14155552671)",
"id" : "(required, string) Globally unique ID for this event",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, long) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Detalles de la propiedad
state_change_source devolverá una cadena con el nombre completo de la fuente. Por ejemplo, la importación del CSV de origen devolverá la cadena CSV Import. A continuación se enumeran las fuentes disponibles:
| Fuente | Descripción |
|---|---|
| SDK | Puntos finales del SDK |
| Dashboard | Cuando se actualiza el estado de suscripción de un usuario desde la página Perfil de usuario del panel de control |
| Página de suscripción | Cuando un usuario se da de baja a través de un enlace de correo electrónico que no es el centro de preferencias |
| API REST | Puntos finales de la API REST |
| Importación CSV | Importación de usuarios CSV |
| Centro de preferencias | Cuando se actualiza un usuario desde el centro de preferencias |
| Mensaje entrante | Cuando un usuario es actualizado por mensajes entrantes de usuarios finales a través de canales, como SMS |
| Migración | Cuando un usuario se actualiza mediante migraciones internas o scripts de mantenimiento |
| Fusión de usuarios | Cuando se actualiza un usuario mediante el proceso de fusión de usuarios |
| Paso de actualización de usuario del Canvas | Cuando se actualiza un usuario mediante el paso Actualización de usuarios de Canvas |
| Lista de cancelación de suscripciones | Cuando un usuario cancela la suscripción a través del mailto de Braze o del encabezado de cancelar suscripción con un solo clic |
Enviar eventos de WhatsApp
Este evento se produce cuando una solicitud de envío se ha comunicado correctamente entre Braze y WhatsApp. Sin embargo, esto no significa que el mensaje haya sido recibido por el usuario final.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// WhatsApp Send (users.messages.whatsapp.Send)
{
"device_id" : "(optional, string) ID of the device on which the event occurred",
"event_properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"from_phone_number" : "(required, string) Phone number used to send in e.164 format (for example +14155552671)",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"event_type" : "(required, string) The event type name, as it is exported to Amplitude",
"insert_id" : "(required, string) Globally unique ID for this event",
"library" : "Braze",
"time" : "(required, long) UNIX timestamp at which the event happened",
"user_id" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
// WhatsApp Send (users.messages.whatsapp.Send)
{
"event" : "(required, string) The event type name, as it is exported to Mixpanel",
"properties" : {
"$partner_id" : "braze",
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"distinct_id" : "(required, string) [PII] External ID of the user",
"from_phone_number" : "(required, string) Phone number used to send in e.164 format (for example +14155552671)",
"$insert_id" : "(required, string) Globally unique ID for this event",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, long) UNIX timestamp at which the event happened",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)",
"token" : "(required, string) The Mixpanel API token"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
// WhatsApp Sends (users.messages.whatsapp.Send)
{
"device_info" : {
"ios_idfv" : "(optional, string) ID of the device on which the event occurred"
},
"environment" : "(required, string) The mParticle environment (either 'development' or 'production')",
"events" : [
{
"data" : {
"custom_attributes" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"from_phone_number" : "(required, string) Phone number used to send in e.164 format (for example +14155552671)",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"source_request_id" : "(required, string) Globally unique ID for this event",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"custom_event_type" : "(required, string) The mParticle custom event type if the event_type is 'custom_event' (always 'other')",
"event_name" : "(required, string) The event type name, as it is exported to mParticle",
"source_message_id" : "(required, string) Globally unique ID for this event",
"timestamp_unixtime_ms" : "(required, long) UNIX timestamp at which the event happened"
},
"event_type" : "(required, string) mParticle event type (either 'uninstall' or 'custom_event')"
}
],
"schema_version" : 2,
"user_attributes" : {
"$mobile" : "(required, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"user_identities" : {
"customerid" : "(required, string) [PII] External ID of the user"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
// WhatsApp Sent (users.messages.whatsapp.Send)
{
"anonymousId" : "(required, string) Braze user ID of the user who performed this event",
"context" : {
"traits" : {
"phone" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)"
},
"device" : { }
},
"event" : "(required, string) The event type name, as it is exported to Segment",
"messageId" : "(required, string) Globally unique ID for this event",
"properties" : {
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"canvas_variation_name" : "(optional, string) Name of the Canvas variation this user received",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"from_phone_number" : "(required, string) Phone number used to send in e.164 format (for example +14155552671)",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"subscription_group_id" : "(optional, string) Subscription group API ID"
},
"timestamp" : "(required, long) UNIX timestamp at which the event happened",
"type" : "track",
"userId" : "(optional, string) [PII] External ID of the user"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
// users.messages.whatsapp.Send
{
"app_group_id" : "(optional, string) API ID of the app group this user belongs to",
"campaign_id" : "(optional, string) API ID of the campaign this event belongs to",
"campaign_name" : "(optional, string) Name of the campaign",
"canvas_id" : "(optional, string) API ID of the Canvas this event belongs to",
"canvas_name" : "(optional, string) Name of the Canvas",
"canvas_step_id" : "(optional, string) API ID of the Canvas step this event belongs to",
"canvas_step_message_variation_id" : "(optional, string) API ID of the Canvas step message variation this user received",
"canvas_step_name" : "(optional, string) Name of the Canvas step",
"canvas_variation_id" : "(optional, string) API ID of the Canvas variation this event belongs to",
"device_id" : "(optional, string) ID of the device on which the event occurred",
"dispatch_id" : "(optional, string) ID of the dispatch this message belongs to",
"external_user_id" : "(optional, string) [PII] External ID of the user",
"from_phone_number" : "(required, string) Phone number used to send in e.164 format (for example +14155552671)",
"id" : "(required, string) Globally unique ID for this event",
"message_extras" : "(optional, string) [PII] A JSON string of the tagged key-value pairs during liquid rendering",
"message_variation_id" : "(optional, string) API ID of the message variation this user received",
"message_variation_name" : "(optional, string) Name of the message variation",
"subscription_group_id" : "(optional, string) Subscription group API ID",
"time" : "(required, long) UNIX timestamp at which the event happened",
"timezone" : "(optional, string) Time zone of the user",
"to_phone_number" : "(optional, string) [PII] Phone number of the user receiving the message in e.164 format (for example +14155552671)",
"user_id" : "(required, string) Braze user ID of the user who performed this event"
}
Editar esta página en GitHub
¿QUÉ TAN ÚTIL FUE ESTA PÁGINA?
New Stuff!