Skip to content

사용자 지정 이벤트 로그

Braze SDK를 통해 사용자 지정 이벤트를 기록하는 방법을 알아보세요.

사용자 지정 이벤트 로깅하기

사용자 지정 이벤트를 기록하려면 다음 이벤트 로깅 방법을 사용하세요.

표준 웹 SDK 구현의 경우 다음 방법을 사용할 수 있습니다:

1

braze.logCustomEvent("YOUR_EVENT_NAME");

대신 Google 태그 관리자를 사용하려면 사용자 지정 이벤트 태그 유형을 사용하여 logCustomEvent 메서드를 호출하고 사용자 지정 이벤트 속성을 포함하여 선택적으로 사용자 지정 이벤트를 Braze에 전송할 수 있습니다. 이렇게 하려면

  1. 변수를 사용하거나 이벤트 이름을 입력하여 이벤트 이름을 입력합니다.
  2. 행 추가 버튼을 사용하여 이벤트 속성을 추가합니다.

Braze 작업 태그 구성 설정을 보여주는 대화상자. 포함된 설정은 "태그 유형"(커스텀 이벤트), "이벤트 이름"(버튼 클릭), 및 "이벤트 속성"입니다.

네이티브 Android의 경우 다음 방법을 사용할 수 있습니다:

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

인필리온 비콘을 Android 앱에 통합한 경우 선택적으로 visit.getPlace() 을 사용하여 위치별 이벤트를 기록할 수 있습니다. requestImmediateDataFlush 은 앱이 백그라운드에 있는 경우에도 이벤트가 기록되는지 확인합니다.

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 객체일 수 있습니다.

메타데이터 속성을 추가하려면 다음 이벤트 로깅 메서드를 사용하세요.

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

Best practices

커스텀 이벤트 속성이 예상대로 기록되도록 수행해야 할 세 가지 중요한 점검이 있습니다:

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

이벤트 확인

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

로그 확인

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

  1. 데이터 설정 > 사용자 지정 이벤트로 이동합니다.
  2. 목록에서 커스텀 이벤트를 찾으세요.
  3. 이벤트에 대해 속성 관리를 선택하여 이벤트와 관련된 속성의 이름을 확인합니다.

값 확인

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

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