커스텀 이벤트 기록

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

커스텀 이벤트 로깅하기

커스텀 이벤트를 기록하려면 다음 이벤트 로깅 방법을 사용하세요.

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

메타데이터 등록정보 추가하기

커스텀 이벤트를 기록할 때, 이벤트와 함께 등록정보 오브젝트를 전달하여 해당 커스텀 이벤트에 대한 메타데이터를 추가할 수 있습니다. 등록정보는 키-값 페어로 정의됩니다. 키는 문자열이며 값은 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>));

모범 사례

커스텀 이벤트 등록정보가 예상대로 기록되도록 하려면 세 가지 중요한 확인 사항을 점검해야 합니다:

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

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

이벤트 확인

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

• Android
• iOS
• 웹

로그 확인

이벤트 등록정보가 성공적으로 추적되었는지 확인하려면 커스텀 이벤트 페이지에서 모든 이벤트 등록정보를 볼 수 있습니다.

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

값 확인

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

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

커스텀 이벤트 문제 해결

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

커스텀 이벤트 트리거 확인

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

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

커스텀 이벤트가 익명 프로필에 기록됨

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

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

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

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

• 개발자 팀에 이벤트가 올바르게 기록되고 예상된 사용자 동작에서 트리거되는지 확인하도록 요청하세요.
• 팀이 Braze 고객지원에 티켓을 열 때 상세 로그 및 관련 코드 스니펫을 포함하세요.
• 앱이 Swift 또는 Android를 사용하는 경우, 개발자 팀은 SDK 디버거 필수 조건을 사용하여 상세 로그를 생성할 수 있습니다.
• 개발자 팀이 문제를 식별할 수 없는 경우, Braze 고객지원 티켓을 열어주세요.