Angepasste Events protokollieren

Erfahren Sie, wie Sie angepasste Events über das Braze SDK protokollieren können.

Hinweis

Für Wrapper-SDKs, die nicht aufgeführt sind, verwenden Sie stattdessen die entsprechende native Android- oder Swift-Methode.

Informationen zu empfohlenen E-Commerce-Events finden Sie unter E-Commerce-Events protokollieren.

Ein angepasstes Event protokollieren

Um ein angepasstes Event zu protokollieren, verwenden Sie die folgende Methode zur Event-Protokollierung.

• web
• android
• swift
• flutter
• cordova
• infillion
• react native
• roku
• unity

1

braze.logCustomEvent("YOUR_EVENT_NAME");

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

1

BrazePlugin.logCustomEvent("YOUR_EVENT_NAME");

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

Hinzufügen von Metadaten-Eigenschaften

Wenn Sie ein angepasstes Event protokollieren, haben Sie die Möglichkeit, Metadaten über dieses angepasste Event hinzuzufügen, indem Sie ein Eigenschaften-Objekt mit dem Event übergeben. Eigenschaften werden als Schlüssel-Wert-Paare definiert. Schlüssel sind Strings und Werte können string, numeric, boolean, Date-Objekte, Arrays oder verschachtelte JSON-Objekte sein.

Um Metadaten-Eigenschaften hinzuzufügen, verwenden Sie die folgende Methode zur Event-Protokollierung.

• web
• android
• swift
• flutter
• cordova
• react native
• roku
• unity

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

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

1
2
3
4

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

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

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

Wichtig

Die Schlüssel time und event_name sind reserviert und können nicht als Event-Eigenschaften für angepasste Events verwendet werden.

Bewährte Vorgehensweisen

Es gibt drei wichtige Prüfungen, die Sie durchführen sollten, damit Ihre angepassten Event-Eigenschaften wie erwartet protokolliert werden:

• Überprüfen, welche Events protokolliert werden
• Protokoll überprüfen
• Werte überprüfen

Bei jeder Protokollierung eines angepassten Events können mehrere Eigenschaften erfasst werden.

Events überprüfen

Klären Sie mit Ihren Entwickler:innen, welche Event-Eigenschaften getrackt werden. Beachten Sie, dass bei allen Event-Eigenschaften die Groß- und Kleinschreibung berücksichtigt wird. Weitere Informationen zum Tracking angepasster Events finden Sie in diesen plattformspezifischen Artikeln:

• Android
• iOS
• Web

Protokoll überprüfen

Um zu bestätigen, dass die Event-Eigenschaften erfolgreich getrackt werden, können Sie alle Event-Eigenschaften auf der Seite Custom Events einsehen.

1. Gehen Sie zu Data Settings > Custom Events.
2. Suchen Sie Ihr angepasstes Event in der Liste.
3. Wählen Sie für Ihr Event Manage Properties aus, um die Namen der mit dem Event verknüpften Eigenschaften anzuzeigen.

Werte überprüfen

Nachdem Sie sich selbst als Testnutzer:in hinzugefügt haben, führen Sie die folgenden Schritte aus, um Ihre Werte zu überprüfen:

1. Führen Sie das angepasste Event innerhalb der App aus.
2. Warten Sie ungefähr 10 Sekunden, bis die Daten übertragen wurden.
3. Aktualisieren Sie das Event-Nutzerprotokoll, um das angepasste Event und den übergebenen Wert der Event-Eigenschaft einzusehen.

Fehlerbehebung bei angepassten Events

Nutzen Sie diese Szenarien, um die Protokollierung angepasster Events über SDKs hinweg zu beheben.

Überprüfen des Triggers für angepasste Events

Wenn ein angepasstes Event nicht angezeigt wird, stimmt die getrackte Aktion in Ihrer App möglicherweise nicht mit der Aktion überein, die Sie testen.

• Klären Sie mit Ihrem Entwicklerteam, welche App-Aktion das angepasste Event auslöst.
• Prüfen Sie nach SDK-Upgrades auf veraltete Code-Pfade, z. B. Verweise auf appboy statt braze.

Angepasste Events werden einem anonymen Profil zugeordnet

Wenn Sie eine:n Nutzer:in nicht identifizieren, bevor Sie ein angepasstes Event protokollieren, kann Braze dieses Event einem anonymen Profil zuordnen.

• Rufen Sie changeUser() auf, bevor Sie das angepasste Event ausführen, damit Braze es einem identifizierten Kundenprofil zuordnet.
• Testen Sie mit einer/einem identifizierten Testnutzer:in und überprüfen Sie dann das Event-Nutzerprotokoll.

Überprüfen der Einrichtung der Protokollierung angepasster Events

Wenn angepasste Events nicht wie erwartet angezeigt werden, bestätigen Sie, dass Ihr Entwicklerteam die Protokollierung angepasster Events für die richtige App-Aktion implementiert hat.

• Bitten Sie Ihr Entwicklerteam zu überprüfen, ob das Event korrekt protokolliert und durch die erwartete Nutzeraktion ausgelöst wird.
• Wenn Ihr Team ein Ticket beim Braze-Support eröffnet, fügen Sie ausführliche Protokolle und relevante Code-Snippets bei.
• Wenn Ihre App Swift oder Android verwendet, kann Ihr Entwicklerteam die Voraussetzungen für den SDK-Debugger nutzen, um ausführliche Protokolle zu erstellen.
• Wenn Ihr Entwicklerteam das Problem nicht identifizieren kann, eröffnen Sie ein Braze-Support-Ticket.