Skip to content

Registrar eventos personalizados

Aprende a registrar eventos personalizados a través del SDK de Braze.

Registro de un evento personalizado

Para registrar un evento personalizado, utiliza el siguiente método de registro de eventos.

Para una implementación estándar del SDK Web, puedes utilizar el siguiente método:

1

braze.logCustomEvent("YOUR_EVENT_NAME");

Si prefieres utilizar Google Tag Manager, puedes usar el tipo de etiqueta «Evento personalizado» para llamar allogCustomEventmétodo y enviar eventos personalizados a Braze, incluyendo opcionalmente propiedades del evento. Para ello:

  1. Introduce el Nombre del Evento utilizando una variable o escribiendo un nombre de evento.
  2. Utiliza el botón Añadir Fila para añadir propiedades del evento.

Un cuadro de diálogo que muestra los ajustes de configuración de la etiqueta de acción Braze. Las configuraciones incluidas son «tipo de etiqueta» (evento personalizado), «nombre del evento» (clic en el botón) y «propiedades del evento».

Para Android nativo, puedes utilizar el siguiente método:

1

Braze.getInstance(context).logCustomEvent(YOUR_EVENT_NAME);

1

Braze.getInstance(context).logCustomEvent(YOUR_EVENT_NAME)

1

AppDelegate.braze?.logCustomEvent(name: "YOUR_EVENT_NAME")

1

[AppDelegate.braze logCustomEvent:@"YOUR_EVENT_NAME"];

1

braze.logCustomEvent('YOUR_EVENT_NAME');

Utiliza el método del complemento Braze Cordova:

1

BrazePlugin.logCustomEvent("YOUR_EVENT_NAME");

LalogCustomEventAPI acepta:

  • eventName (cadena obligatoria): Utiliza hasta 255 caracteres. No comiences el nombre con $. Utiliza caracteres alfanuméricos y signos de puntuación.
  • eventProperties (objeto opcional): Añade pares clave-valor para los metadatos del evento. Utiliza claves de hasta 255 caracteres y no empieces las claves con $.

Para los valores de propiedad, utilizastring (hasta 255 caracteres), numeric,boolean , matrices de objetos u objetos JSON anidados.

Para obtener más información sobre la implementación, consulta el código fuente del SDK de Braze Cordova:

Si has realizado la integración de Infillion Beacons en tu aplicación Android, puedes utilizar visit.getPlace()opcionalmente para registrar eventos específicos de ubicación.requestImmediateDataFlush verifica que tu evento se registre incluso si tu aplicación está en segundo plano.

1
2

Braze.getInstance(context).logCustomEvent("Entered " + visit.getPlace());
Braze.getInstance(context).requestImmediateDataFlush();

1
2

Braze.getInstance(context).logCustomEvent("Entered " + visit.getPlace())
Braze.getInstance(context).requestImmediateDataFlush()

1

Braze.logCustomEvent("YOUR_EVENT_NAME");

1

m.Braze.logEvent("YOUR_EVENT_NAME")

1

AppboyBinding.LogCustomEvent("YOUR_EVENT_NAME");

Añadir propiedades de metadatos

Cuando registras un evento personalizado, tienes la opción de añadir metadatos sobre ese evento personalizado pasando un objeto de propiedades con el evento. Las propiedades se definen como pares clave-valor. Las claves son cadenas y los valores pueden ser string, numeric, boolean,Date objetos, matrices u objetos JSON anidados.

Para agregar propiedades de metadatos, utiliza el siguiente método de registro de eventos.

1
2
3
4
5
6
7
8
9
10

braze.logCustomEvent("YOUR-EVENT-NAME", {
  you: "can", 
  pass: false, 
  orNumbers: 42,
  orDates: new Date(),
  or: ["any", "array", "here"],
  andEven: {
     deeply: ["nested", "json"]
  }
});

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

Braze.logCustomEvent("YOUR-EVENT-NAME",
    new BrazeProperties(new JSONObject()
        .put("you", "can")
        .put("pass", false)
        .put("orNumbers", 42)
        .put("orDates", new Date())
        .put("or", new JSONArray()
            .put("any")
            .put("array")
            .put("here"))
        .put("andEven", new JSONObject()
            .put("deeply", new JSONArray()
                .put("nested")
                .put("json"))
        )
));

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

Braze.logCustomEvent("YOUR-EVENT-NAME",
    BrazeProperties(JSONObject()
        .put("you", "can")
        .put("pass", false)
        .put("orNumbers", 42)
        .put("orDates", Date())
        .put("or", JSONArray()
            .put("any")
            .put("array")
            .put("here"))
        .put("andEven", JSONObject()
            .put("deeply", JSONArray()
                .put("nested")
                .put("json"))
        )
))

1
2
3
4
5
6
7
8
9
10
11
12
13

AppDelegate.braze?.logCustomEvent(
  name: "YOUR-EVENT-NAME",
  properties: [
    "you": "can",
    "pass": false,
    "orNumbers": 42,
    "orDates": Date(),
    "or": ["any", "array", "here"],
    "andEven": [
      "deeply": ["nested", "json"]
    ]
  ]
)

1
2
3
4
5
6
7
8
9
10
11

[AppDelegate.braze logCustomEvent:@"YOUR-EVENT-NAME"
                       properties:@{
  @"you": @"can",
  @"pass": @(NO),
  @"orNumbers": @42,
  @"orDates": [NSDate date],
  @"or": @[@"any", @"array", @"here"],
  @"andEven": @{
    @"deeply": @[@"nested", @"json"]
  }
}];

1
2
3
4
5

braze.logCustomEvent('custom_event_with_properties', properties: {
    'key1': 'value1',
    'key2': ['value2', 'value3'],
    'key3': false,
});

Registra eventos personalizados con un objeto de propiedades:

1
2
3
4
5

var properties = {};
properties["key1"] = "value1";
properties["key2"] = ["value2", "value3"];
properties["key3"] = false;
BrazePlugin.logCustomEvent("YOUR-EVENT-NAME", properties);

También puedes pasar propiedades en línea:

1
2
3
4

BrazePlugin.logCustomEvent("YOUR-EVENT-NAME", {
  "key": "value",
  "amount": 42,
});

La aplicación de muestra oficial de Cordova incluye propiedades de cadena, numéricas, booleanas, de matriz y de objetos anidados:

Ejemplo de extracto del proyecto:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

var properties = {};
properties["One"] = "That's the Way of the World";
properties["Two"] = "After the Love Has Gone";
properties["Three"] = "Can't Hide Love";
BrazePlugin.logCustomEvent("cordovaCustomEventWithProperties", properties);
BrazePlugin.logCustomEvent("cordovaCustomEventWithoutProperties");
BrazePlugin.logCustomEvent("cordovaCustomEventWithFloatProperties", {
  "Cart Value": 4.95,
  "Cart Item Name": "Spicy Chicken Bites 5 pack"
});
BrazePlugin.logCustomEvent("cordovaCustomEventWithNestedProperties", {
  "array key": [1, "2", false],
  "object key": {
    "k1": "1",
    "k2": 2,
    "k3": false,
  },
  "deep key": {
    "key": [1, "2", true]
  }
});

Para obtener más información sobre la API y el puente nativo, consulta:

1
2
3
4
5

Braze.logCustomEvent("custom_event_with_properties", {
    key1: "value1",
    key2: ["value2", "value3"],
    key3: false,
});

1

m.Braze.logEvent("YOUR_EVENT_NAME", {"stringPropKey" : "stringPropValue", "intPropKey" : Integer intPropValue})

1

AppboyBinding.LogCustomEvent("event name", properties(Dictionary<string, object>));

Buenas prácticas

Hay tres comprobaciones importantes que debes realizar para que las propiedades del evento personalizado se registren según lo esperado:

Se pueden registrar varias propiedades cada vez que se registra un evento personalizado.

Verificar eventos

Comprueba con tus desarrolladores qué propiedades del evento están siendo objeto de seguimiento. Ten en cuenta que todas las propiedades del evento distinguen entre mayúsculas y minúsculas. Para obtener información adicional sobre el seguimiento de eventos personalizados, consulta estos artículos basados en tu plataforma:

Verificar registro

Para confirmar que las propiedades del evento se han seguido correctamente, puedes ver todas las propiedades del evento desde la página Eventos personalizados.

  1. Vaya a Configuración de datos > Eventos personalizados.
  2. Localiza tu evento personalizado en la lista.
  3. Para tu evento, selecciona Administrar propiedades para ver los nombres de las propiedades asociadas a un evento.

Verificar los valores

Después de añadir tu usuario como usuario de prueba, sigue estos pasos para verificar tus valores:

  1. Realiza el evento personalizado dentro de la aplicación.
  2. Espera unos 10 segundos a que se vacíen los datos.
  3. Actualiza el registro de usuarios del evento para ver el evento personalizado y el valor de la propiedad del evento que se pasó con él.
Github   Editar esta página en GitHub
New Stuff!