커스텀 인앱 메시지 트리거

기본적으로, 인앱 메시지는 SDK에 의해 기록된 이벤트 유형에 의해 트리거됩니다. 서버에서 보낸 이벤트로 인앱 메시지를 트리거하려는 경우에도 이를 수행할 수 있습니다.

이 기능을 활성화하기 위해 무음 푸시가 기기로 전송되어 기기가 SDK 기반 이벤트를 기록할 수 있습니다. 이 SDK 이벤트는 이후에 사용자에게 표시되는 인앱 메시지를 트리거할 수 있습니다.

1단계: 무음 푸시 및 키-값 페어 처리

application(_:didReceiveRemoteNotification:fetchCompletionHandler:) 메소드에 다음 코드를 추가합니다:

• objective-c
• swift

1
2
3
4
5
6
- (void)handleExtrasFromPush:(NSDictionary *)userInfo {
  NSLog(@"A push was received.");
  if (userInfo !=nil && userInfo[@"IS_SERVER_EVENT"] !=nil && userInfo[@"CAMPAIGN_NAME"]!=nil) {
    [[Appboy sharedInstance] logCustomEvent:@"IAM Trigger" withProperties:@{@"campaign_name": userInfo[@"CAMPAIGN_NAME"]}];
  }
 };

1
2
3
4
5
6
func handleExtras(userInfo: [AnyHashable : Any]) {
  NSLog("A push was received");
  if userInfo != nil && (userInfo["IS_SERVER_EVENT"] as? String) != nil && (userInfo["CAMPAIGN_NAME"] as? String) != nil {
    Appboy.sharedInstance()?.logCustomEvent("IAM Trigger", withProperties: ["campaign_name": userInfo["CAMPAIGN_NAME"]])
  }
}

푸시가 수신되면 SDK에서 기록한 이벤트 ‘인앱 메시지 트리거’가 고객 프로필에 기록됩니다. 이 인앱 메시지는 애플리케이션이 포그라운드에 있을 때 무음 푸시를 수신해야만 트리거됩니다.

2단계: 푸시 캠페인 만들기

서버 전송 이벤트를 통해 트리거되는 무음 푸시 캠페인을 만듭니다. 무음 푸시 캠페인을 생성하는 방법에 대한 자세한 내용은 무음 푸시 알림을 참조하세요.

입니다.

푸시 캠페인에는 이 푸시 캠페인이 SDK 커스텀 이벤트를 기록하기 위해 전송되었음을 나타내는 키-값 페어 추가 항목이 포함되어야 합니다. 이 이벤트는 인앱 메시지를 트리거하는 데 사용됩니다:

application(_:didReceiveRemoteNotification:fetchCompletionHandler:) 메서드 내 코드가 IS_SERVER_EVENT 키에 있는지 확인하고, 이 키가 존재하면 SDK 커스텀 이벤트를 기록합니다.

푸시 페이로드의 키-값 페어 추가 항목 내에서 원하는 값을 보내 이벤트 이름이나 이벤트 속성정보를 변경할 수 있습니다. 사용자 지정 이벤트를 로깅할 때 이러한 추가 정보는 이벤트 이름의 매개변수 또는 이벤트 속성으로 사용할 수 있습니다.

3단계: 인앱 메시지 캠페인 만들기

Braze 대시보드 내에서 사용자가 볼 수 있는 인앱 메시지 캠페인을 생성하세요. 이 캠페인에는 액션 기반 전달이 있어야 하며 application(_:didReceiveRemoteNotification:fetchCompletionHandler:) 메서드 내에서 로깅된 사용자 지정 이벤트에서 트리거되어야 합니다.

다음 예제에서는 초기 무음 푸시의 일부로 이벤트 속성정보를 전송하여 트리거할 특정 인앱 메시지를 구성합니다.

푸시 메시지는 SDK에서 기록한 커스텀 이벤트에 사용되기 때문에, Braze는 이 솔루션을 활성화하기 위해 각 사용자의 푸시 토큰을 저장해야 합니다. iOS 및 Android 모두에서 Braze는 사용자에게 OS의 푸시 프롬프트가 제공된 시점부터 토큰을 저장합니다. 이전에는 푸시를 사용하여 사용자에게 접근할 수 없으며, 이전 솔루션은 불가능합니다.