Registro de eventos personalizados
Aprenda como registrar eventos personalizados através do SDK Braze.
note:
Para SDKs wrapper não listados, use o método nativo relevante do Android ou Swift.
Registro de um evento personalizado
Para registrar um evento personalizado, use o seguinte método de registro de eventos.
Para Android nativo, você pode usar o seguinte método:
1
| Braze.getInstance(context).logCustomEvent(YOUR_EVENT_NAME);
|
1
| Braze.getInstance(context).logCustomEvent(YOUR_EVENT_NAME)
|
Se você integrou Infillion Beacons em seu app, você pode usar visit.getPlace()
para registrar eventos específicos de localização. requestImmediateDataFlush
verifica se seu evento será registrado mesmo que seu app esteja em 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 uma implementação padrão do SDK Web, você pode usar o seguinte método:
1
| braze.logCustomEvent("YOUR_EVENT_NAME");
|
Se você gostaria de usar o Google Tag Manager em vez disso, você pode usar o tipo de tag Evento Personalizado para chamar o logCustomEvent
método e enviar eventos personalizados para o Braze, incluindo opcionalmente propriedades de eventos personalizados. Para fazer isso:
- Digite o nome do evento usando uma variável ou digitando um nome de evento.
- Use o botão Adicionar linha para adicionar propriedades de eventos.

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"));
|
Quando você registra um evento personalizado, você tem a opção de adicionar metadados sobre esse evento personalizado passando um objeto de propriedades com o evento. As propriedades são definidas como pares de valores-chave. As chaves são strings e os valores podem ser objetos string
, numeric
, boolean
ou Date
.
Para adicionar propriedades de metadados, use o seguinte 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:
As chaves time
e event_name
são reservadas e não podem ser usadas como propriedades de eventos personalizados.