Skip to content

Angepasste Events protokollieren

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

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

Protokollieren eines angepassten Events

Um ein angepasstes Event zu protokollieren, verwenden Sie die folgende Event-Protokollierungsmethode.

Für eine Standard-Web-SDK-Implementierung können Sie die folgende Methode verwenden:

1

braze.logCustomEvent("YOUR_EVENT_NAME");

Wenn Sie stattdessen den Google Tag Manager verwenden möchten, können Sie den Tag-Typ Custom Event verwenden, um die logCustomEvent-Methode aufzurufen und angepasste Events an Braze zu senden – optional mit angepassten Event-Eigenschaften. Gehen Sie dazu wie folgt vor:

  1. Geben Sie den Event Name an, indem Sie entweder eine Variable verwenden oder einen Event-Namen eingeben.
  2. Verwenden Sie den Button Add Row, um Event-Eigenschaften hinzuzufügen.

Ein Dialogfeld mit den Konfigurationseinstellungen für Braze Action Tags. Die Einstellungen umfassen „tag type“ (Custom Event), „event name“ (button click) und „event properties“.

Für natives Android können Sie die folgende Methode verwenden:

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

Verwenden Sie die Braze Cordova-Plugin-Methode:

1

BrazePlugin.logCustomEvent("YOUR_EVENT_NAME");

Die logCustomEvent-API akzeptiert:

  • eventName (erforderlicher String): Verwenden Sie bis zu 255 Zeichen. Beginnen Sie den Namen nicht mit $. Verwenden Sie alphanumerische Zeichen und Satzzeichen.
  • eventProperties (optionales Objekt): Fügen Sie Schlüssel-Wert-Paare für Event-Metadaten hinzu. Verwenden Sie Schlüssel mit bis zu 255 Zeichen und beginnen Sie Schlüssel nicht mit $.

Für Eigenschaftswerte verwenden Sie string (bis zu 255 Zeichen), numeric, boolean, Arrays oder verschachtelte JSON-Objekte.

Implementierungsdetails finden Sie in der Braze Cordova SDK-Quelle:

Wenn Sie Infillion Beacons in Ihre Android-App integriert haben, können Sie optional visit.getPlace() verwenden, um standortspezifische Events zu protokollieren. requestImmediateDataFlush stellt sicher, dass Ihr Event auch dann protokolliert wird, wenn Ihre App im Hintergrund läuft.

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, können Sie Metadaten zu diesem Event hinzufügen, indem Sie ein Eigenschaftenobjekt 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 Event-Protokollierungsmethode.

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

Protokollieren Sie angepasste Events mit einem Eigenschaftenobjekt:

1
2
3
4
5

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

Sie können Eigenschaften auch inline übergeben:

1
2
3
4

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

Die offizielle Cordova-Beispiel-App enthält String-, numerische, boolesche, Array- und verschachtelte Objekteigenschaften:

Beispielprojekt-Auszug:

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

Details zu API und nativer Bridge finden Sie unter:

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

Best Practices

Es gibt drei wichtige Überprüfungen, damit Ihre angepassten Event-Eigenschaften wie erwartet protokolliert werden:

Bei der Protokollierung eines angepassten Events können mehrere Eigenschaften protokolliert werden.

Events überprüfen

Erkundigen Sie sich bei Ihren Entwickler:innen, welche Event-Eigenschaften getrackt werden. Beachten Sie, dass bei allen Event-Eigenschaften zwischen Groß- und Kleinschreibung unterschieden wird. Weitere Informationen zum Tracking angepasster Events finden Sie in diesen Artikeln basierend auf Ihrer Plattform:

Protokoll überprüfen

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

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

Werte überprüfen

Nachdem Sie Ihre:n Nutzer:in 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 etwa 10 Sekunden, bis die Daten übertragen wurden.
  3. Aktualisieren Sie das Event-Nutzerprotokoll, um das angepasste Event und den Wert der damit übergebenen Event-Eigenschaft anzuzeigen.

Fehlerbehebung bei angepassten Events

Verwenden Sie diese Szenarien zur Fehlerbehebung bei der Protokollierung angepasster Events über SDKs.

Ü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.

  • Bestätigen Sie mit Ihrem Entwickler:innen-Team, welche App-Aktion das angepasste Event triggert.
  • 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 Nutzerprofil 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 Entwickler:innen-Team die Protokollierung angepasster Events für die richtige App-Aktion implementiert hat.

  • Bitten Sie Ihr Entwickler:innen-Team zu überprüfen, ob das Event korrekt protokolliert und durch die erwartete Nutzer:innen-Aktion getriggert 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 Entwickler:innen-Team die Voraussetzungen für den SDK-Debugger nutzen, um ausführliche Protokolle zu generieren.
  • Wenn Ihr Entwickler:innen-Team das Problem nicht identifizieren kann, eröffnen Sie ein Braze Support-Ticket.
New Stuff!