Skip to content

Registre eventos personalizados

Saiba como registrar eventos personalizados por meio do SDK do Braze.

Registro de um evento personalizado

Para registrar um evento personalizado, use o seguinte método de registro de eventos.

Para uma implementação padrão do Web SDK, você pode usar o seguinte método:

1

braze.logCustomEvent("YOUR_EVENT_NAME");

Se, em vez disso, você quiser usar o Google Tag Manager, poderá usar o tipo de tag Custom Event para chamar o métodologCustomEvent e enviar eventos personalizados para o Braze, incluindo opcionalmente propriedades de eventos personalizados. Para isso:

  1. Digite o nome do evento usando uma variável ou digitando um nome de evento.
  2. Use o botão Adicionar linha para adicionar propriedades de eventos.

Uma caixa de diálogo mostrando as definições de configuração da tag de ação do Braze. As configurações incluídas são "tag type" (evento personalizado), "event name" (nome do evento) (clique no botão) e "event properties" (propriedades do evento).

Para o 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)

1

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

1

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

1

braze.logCustomEvent('YOUR_EVENT_NAME');

Se tiver integrado o Infillion Beacons ao seu aplicativo Android, você poderá usar opcionalmente o visit.getPlace() para registrar eventos específicos do local. O requestImmediateDataFlush verifica se o evento será registrado mesmo que o 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

Braze.logCustomEvent("YOUR_EVENT_NAME");

1

m.Braze.logEvent("YOUR_EVENT_NAME")

1

AppboyBinding.LogCustomEvent("YOUR_EVENT_NAME");

Adição de propriedades de metadados

Ao registrar 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 string, numeric, boolean, Date objetos, vetores de objetos ou objetos JSON aninhados.

Para adicionar propriedades de metadados, use o seguinte 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,
});

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>));

Melhores práticas

Há três verificações importantes a serem realizadas para que as propriedades do seu evento personalizado registrem o que é esperado:

Várias propriedades podem ser registradas cada vez que um evento personalizado é registrado.

Verificar eventos

Verifique com seus desenvolvedores quais propriedades de eventos estão sendo rastreadas. Lembre-se de que todas as propriedades do evento diferenciam maiúsculas de minúsculas. Para obter informações adicionais sobre rastreamento de eventos personalizados, confira estes artigos com base na sua plataforma:

Verificar registro

Para confirmar que as propriedades do evento são rastreadas com sucesso, você pode visualizar todas as propriedades do evento na página de Eventos Personalizados.

  1. Acessar Configurações de Dados > Eventos Personalizados.
  2. Localize seu evento personalizado na lista.
  3. Para seu evento, selecione Manage Properties (Gerenciar propriedades ) para visualizar os nomes das propriedades associadas a um evento.

Verifique os valores

Depois de adicionar seu usuário como um usuário teste, siga estas etapas para verificar seus valores:

  1. Execute o evento personalizado dentro do app.
  2. Aguarde cerca de 10 segundos para que os dados sejam liberados.
  3. Atualize o registro de usuários de eventos para ver o evento personalizado e o valor da propriedade do evento que foi passado com ele.
Github   Editar esta página no GitHub
New Stuff!