Registro de eventos personalizados
Aprende a registrar eventos personalizados a través del SDK de Braze.
note:
Para los SDK envoltorio que no aparecen en la lista, utiliza en su lugar el método nativo de Android o Swift correspondiente.
Registro de un evento personalizado
Para registrar un evento personalizado, utiliza el siguiente método de registro de eventos.
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)
|
Si has integrado Infillion Beacons en tu aplicación, puedes utilizar además visit.getPlace()
para registrar eventos específicos de ubicación. requestImmediateDataFlush
verifica que tu evento se registrará 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
| AppDelegate.braze?.logCustomEvent(name: "YOUR_EVENT_NAME")
|
1
| [AppDelegate.braze logCustomEvent:@"YOUR_EVENT_NAME"];
|
Para una implementación estándar del SDK Web, puedes utilizar el siguiente método:
1
| braze.logCustomEvent("YOUR_EVENT_NAME");
|
Si quieres utilizar Google Tag Manager en su lugar, puedes utilizar el tipo de etiqueta Evento personalizado para llamar al métodologCustomEvent
y enviar eventos personalizados a Braze, incluyendo opcionalmente propiedades del evento personalizadas. Para ello:
- Introduce el Nombre del Evento utilizando una variable o escribiendo un nombre de evento.
- Utiliza el botón Añadir Fila para añadir propiedades del evento.

1
| braze.logCustomEvent('YOUR_EVENT_NAME');
|
1
| Braze.logCustomEvent("YOUR_EVENT_NAME");
|
1
| m.Braze.logEvent("YOUR_EVENT_NAME")
|
1
| AppboyBinding.LogCustomEvent("YOUR_EVENT_NAME");
|
1
| UBraze->LogCustomEvent(TEXT("YOUR_EVENT_NAME"));
|
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
, u Date
objetos.
Para añadir propiedades de metadatos, utiliza el siguiente método de registro de eventos.
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
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
| braze.logCustomEvent('custom_event_with_properties', properties: {
'key1': 'value1',
'key2': ['value2', 'value3'],
'key3': false,
});
|
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>));
|
1
2
3
4
5
6
7
8
9
| TMap<FString, FString> Properties;
Properties.Add(TEXT("you"), TEXT("can"));
Properties.Add(TEXT("pass"), TEXT("false"));
Properties.Add(TEXT("orNumbers"), FString::FromInt(42));
Properties.Add(TEXT("orDates"), FDateTime::Now().ToString());
Properties.Add(TEXT("or"), TEXT("any,array,here")); // Arrays are stored as comma-separated strings
Properties.Add(TEXT("andEven"), TEXT("deeply:nested,json"));
UBraze->LogCustomEventWithProperties(TEXT("YOUR_EVENT_NAME"), Properties);
|
important:
Las claves time
y event_name
están reservadas y no pueden utilizarse como propiedades del evento personalizado.