커스텀 이벤트 기록

Braze SDK를 통해 커스텀 이벤트를 기록하는 방법을 알아보세요.

참고

목록에 없는 래퍼 SDK의 경우 관련 네이티브 Android 또는 Swift 메서드를 대신 사용하세요.

이커머스 권장 이벤트에 대해서는 이커머스 이벤트 기록을 참조하세요.

커스텀 이벤트 로깅하기

커스텀 이벤트를 로깅하려면 다음 이벤트 로깅 메서드를 사용합니다.

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

메타데이터 속성정보 추가하기

커스텀 이벤트를 기록할 때 이벤트와 함께 속성정보 객체를 전달하여 해당 커스텀 이벤트에 대한 메타데이터를 추가할 수 있습니다. 속성정보는 키-값 페어로 정의됩니다. 키는 문자열이며, 값은 string, numeric, boolean, Date 객체, 배열 또는 중첩된 JSON 객체가 될 수 있습니다.

메타데이터 속성정보를 추가하려면 다음 이벤트 로깅 메서드를 사용합니다.

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

중요

time 및 event_name 키는 예약되어 있으며 커스텀 이벤트 속성정보로 사용할 수 없습니다.

모범 사례

커스텀 이벤트 속성정보가 예상대로 기록되도록 하기 위해 수행해야 할 세 가지 중요한 확인 사항이 있습니다:

• 기록되는 이벤트 확인
• 로그 확인
• 값 확인

커스텀 이벤트가 기록될 때마다 여러 속성정보가 함께 기록될 수 있습니다.

이벤트 확인

개발자에게 어떤 이벤트 속성정보가 추적되고 있는지 확인하세요. 모든 이벤트 속성정보는 대소문자를 구분한다는 점에 유의하세요. 커스텀 이벤트 추적에 대한 자세한 내용은 플랫폼에 따라 다음 문서를 참조하세요:

• Android
• iOS
• 웹

로그 확인

이벤트 속성정보가 성공적으로 추적되고 있는지 확인하려면 커스텀 이벤트 페이지에서 모든 이벤트 속성정보를 조회할 수 있습니다.

1. 데이터 설정 > 커스텀 이벤트로 이동합니다.
2. 목록에서 해당 커스텀 이벤트를 찾습니다.
3. 해당 이벤트에서 속성정보 관리를 선택하여 이벤트에 연결된 속성정보의 이름을 확인합니다.

값 확인

사용자를 테스트 사용자로 추가한 후, 다음 단계에 따라 값을 확인합니다:

1. 앱 내에서 해당 커스텀 이벤트를 수행합니다.
2. 데이터가 전송될 때까지 약 10초간 기다립니다.
3. 이벤트 사용자 로그를 새로고침하여 커스텀 이벤트와 함께 전달된 이벤트 속성정보 값을 확인합니다.

커스텀 이벤트 문제 해결

다음 시나리오를 활용하여 SDK 전반의 커스텀 이벤트 로깅 문제를 해결하세요.

커스텀 이벤트 트리거 확인

커스텀 이벤트가 나타나지 않는 경우, 앱에서 추적 중인 액션이 테스트하려는 액션과 일치하지 않을 수 있습니다.

• 개발자 팀에 어떤 앱 액션이 커스텀 이벤트를 트리거하는지 확인하세요.
• SDK 업그레이드 후 braze 대신 appboy를 참조하는 등 더 이상 사용되지 않는 코드 경로가 있는지 확인하세요.

익명 프로필에 커스텀 이벤트가 로깅되는 경우

커스텀 이벤트를 로깅하기 전에 사용자를 식별하지 않으면, Braze가 해당 이벤트를 익명 프로필에 연결할 수 있습니다.

• 커스텀 이벤트를 수행하기 전에 changeUser()를 호출하여 Braze가 식별된 고객 프로필에 이벤트를 로깅하도록 하세요.
• 식별된 테스트 사용자로 테스트한 후 이벤트 사용자 로그를 확인하세요.

커스텀 이벤트 로깅 설정 확인

커스텀 이벤트가 예상대로 나타나지 않는 경우, 개발자 팀이 올바른 앱 액션에 대해 커스텀 이벤트 로깅을 구현했는지 확인하세요.

• 개발자 팀에 이벤트가 올바르게 로깅되고 예상된 사용자 액션에서 트리거되는지 확인을 요청하세요.
• 팀이 Braze 지원팀에 티켓을 접수할 때 상세 로그와 관련 코드 스니펫을 포함하세요.
• 앱이 Swift 또는 Android를 사용하는 경우, 개발자 팀이 SDK 디버거 사전 요구 사항을 활용하여 상세 로그를 생성할 수 있습니다.
• 개발자 팀이 문제를 파악할 수 없는 경우, Braze 지원 티켓을 접수하세요.