푸시 추적 구현

푸시 추적 정보

푸시 알림이 완전히 개발되었는지 확인하려면 모든 푸시 알림에 추적이 활성화되지 않았으므로 추적 부분이 올바르게 구현되었는지 확인해야 합니다. 이 기능을 사용하려면 개발자가 추적이 활성화된 배달을 식별해야 합니다. Adobe Campaign Standard은 on 또는 off​의 두 값으로 _acsDeliveryTracking이라는 플래그를 전송합니다. 앱 개발자는 변수가 on​으로 설정된 게재에만 추적 요청을 보내야 합니다.

중요

21.1 릴리스 이전에 설정된 배달이나 사용자 지정 템플릿을 사용하여 배달에는 이 변수를 사용할 수 없습니다.

푸시 추적은 다음 3가지 유형으로 구분됩니다.

  • 푸시 노출 횟수 - 푸시 알림이 장치에 배달되고 알림 센터에 앉아 있지만 전혀 손대지 않은 경우입니다. 이것은 임프레션으로 간주됩니다. 대부분의 경우 노출 횟수는 배달된 숫자와 동일하지 않을 경우 비슷해야 합니다. 장치가 메시지를 받고 해당 정보를 서버에 다시 전달하도록 합니다.

  • 푸시 클릭 - 푸시 알림이 장치에 전달되고 사용자가 장치를 클릭한 경우입니다. 사용자가 알림을 보거나(나중에 푸시 열기 추적으로 이동) 알림을 해지하려고 했습니다.

  • 열기 푸시 - 푸시 알림이 장치에 전달되고 사용자가 알림을 클릭했을 때 앱이 열립니다. 알림이 해제된 경우 열린 푸시를 트리거하지 않는다는 점을 제외하고 푸시 클릭과 유사합니다.

Campaign Standard 추적을 구현하려면 모바일 앱에 Mobile SDK가 포함되어야 합니다. 이러한 SDK는 Adobe Mobile Services에서 사용할 수 있습니다. 자세한 정보는 이 페이지를 참조하십시오.

추적 정보를 보내려면 3개의 변수를 보내야 합니다. Campaign Standard에서 받은 데이터의 일부인 두 개와 노출, 클릭 또는 열기​인지 여부를 지정하는 작업 변수

변수
broadlogId 데이터의 _mId
deliveryId 데이터의 _dId
액션 열기는 1개, 클릭은 2개, 임프레션은 7개

Android에 대한 구현

푸시 노출 추적 구현 방법

노출 횟수 추적의 경우 trackAction() 함수를 호출할 때 동작에 대해 값 "7"을 보내야 합니다.

21.1 릴리스 이전에 만들어진 배달품이나 사용자 지정 템플릿을 사용한 배달은 이 섹션을 참조하십시오.

@Override
public void onMessageReceived(RemoteMessage remoteMessage) {
....{Handle push messages}....
  if (data.size() > 0) {
    String deliveryId = data.get("_dId");
    String messageId = data.get("_mId");
    String acsDeliveryTracking = data.get("_acsDeliveryTracking");
 
    /*
    This is to handle deliveries created before 21.1 release or deliveries with custom template
    where acsDeliveryTracking is not available.
    */
    if( acsDeliveryTracking == null ) {
        acsDeliveryTracking = "on";
    }
 
    HashMap<String, String> contextData = new HashMap<>();
    if (deliveryId != null && messageId != null && acsDeliveryTracking.equals("on")) {
                contextData.put("deliveryId", deliveryId);
                contextData.put("broadlogId", messageId);
                contextData.put("action", "7");
                MobileCore.trackAction("tracking", contextData);
    }
  }
}

클릭 추적을 구현하는 방법

클릭 추적의 경우 trackAction() 함수를 호출할 때 동작에 대해 값 "2"를 보내야 합니다.

클릭을 추적하려면 2개의 시나리오를 처리해야 합니다.

  • 사용자가 알림을 볼 수 있지만 지웁니다.
  • 사용자가 알림을 보고 클릭하여 열린 추적으로 전환합니다.

이를 처리하려면 다음 두 가지 인터페이스를 사용해야 합니다.알림을 클릭할 때와 알림을 해제할 수 있습니다.

21.1 릴리스 이전에 만들어진 배달품이나 사용자 지정 템플릿을 사용한 배달은 이 섹션을 참조하십시오.

MyFirebaseMessagingService.java

private void sendNotification(Map<String, String> data) {
    Intent openIntent = new Intent(this, CollectPIIActivity.class);
    Intent dismissIntent = new Intent(this, NotificationDismissedReceiver.class);
    openIntent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
  
    //put the data map into the intent to track clickthroughs
    Bundle pushData = new Bundle();
    Set<String> keySet = data.keySet();
    for (String key : keySet) {
        pushData.putString(key, data.get(key));
    }
    openIntent.putExtras(pushData);
    dissmissIntent.putExtras(pushData);
  
  
    PendingIntent pendingIntent = PendingIntent.getActivity(this, 0, openIntent,
        PendingIntent.FLAG_UPDATE_CURRENT);
    PendingIntent onDismissPendingIntent = PendingIntent.getBroadcast(this.getApplicationContext(), 0, dismissIntent, 0);
  
    //<BUILD NOTIFICATION using notification builder>
    //Add both Intents to the notification
    notificationBuilder.setContentIntent(pendingIntent);
    notificationBuilder.setDeleteIntent(onDismissPendingIntent);
}

BroadcastReceiver​이(가) 작동하려면 AndroidManifest.xml​에 등록해야 합니다.

<manifest>
    <application>
        <receiver android:name=".NotificationDismissedReceiver">
        </receiver>
    </application>
</manifest>

NotificationDismessedReceiver.java

public class NotificationDismissedReceiver extends BroadcastReceiver {
    private static final String TAG = NotificationDismissedReceiver.class.getSimpleName();
    @Override
    public void onReceive(Context context, Intent intent) {
        Bundle data = intent.getExtras();
        String deliveryId = data.getString("_dId");
        String messageId = data.getString("_mId");
        String acsDeliveryTracking = data.get("_acsDeliveryTracking");
         
        /*
        This is to handle deliveries created before 21.1 release or deliveries with custom template
        where acsDeliveryTracking is not available.
        */
        if( acsDeliveryTracking == null ) {
            acsDeliveryTracking = "on";
        }
 
        HashMap<String, Object> contextData = new HashMap<>();
 
        //We only send the click tracking since the user dismissed the notification
        if (deliveryId != null && messageId != null && acsDeliveryTracking.equals("on")) {
            contextData.put("deliveryId", deliveryId);
            contextData.put("broadlogId", messageId);
            contextData.put("action", "2");
            MobileCore.trackAction("tracking", contextData);
        }
    }
}

열기 추적을 구현하는 방법

앱을 열려면 알림을 클릭해야 하므로 "1" 및 "2"를 보내야 합니다. 푸시 알림을 통해 앱을 시작/열지 않으면 추적 이벤트가 발생하지 않습니다.

열기를 추적하려면 의도를 만들어야 합니다. 의도 개체를 사용하면 특정 작업이 완료되면 Android OS에서 메서드를 호출할 수 있습니다. 이 경우 알림을 클릭하여 앱을 엽니다.

이 코드는 클릭 노출 추적 구현을 기반으로 합니다. 이제 Intent​이(가) 설정된 상태에서 추적 정보를 다시 Adobe Campaign Standard으로 보내야 합니다. 이 경우 Open Intent​을(를) 앱의 특정 보기로 열도록 설정해야 합니다. 그러면 Intent Object​의 알림 데이터와 함께 onResume 메서드가 호출됩니다.

21.1 릴리스 이전에 만들어진 배달품이나 사용자 지정 템플릿을 사용한 배달은 이 섹션을 참조하십시오.

@Override
protected void onResume() {
    super.onResume();
    handleTracking();
}
 
 
private void handleTracking() {
    //Check to see if this view was opened based on a notification
    Intent intent = getIntent();
    Bundle data = intent.getExtras();
 
    if (data != null) {
        //This was opened based on the notification, you need to get the tracking that was passed on.
        String deliveryId = data.getString("_dId");
        String messageId = data.getString("_mId");
        String acsDeliveryTracking = data.get("_acsDeliveryTracking");
        /*
        This is to handle deliveries created before 21.1 release or deliveries with custom template
        where acsDeliveryTracking is not available.
        */
        if( acsDeliveryTracking == null) {
            acsDeliveryTracking = "on";
        }
 
        HashMap<String, String> contextData = new HashMap<>();
 
        if (deliveryId != null && messageId != null && acsDeliveryTracking.equals("on")) {
            contextData.put("deliveryId", deliveryId);
            contextData.put("broadlogId", messageId);
 
            //Send Click Tracking since the user did click on the notification
            contextData.put("action", "2");
            MobileCore.trackAction("tracking", contextData);
 
            //Send Open Tracking since the user opened the app
            contextData.put("action", "1");
            MobileCore.trackAction("tracking", contextData);
        }
    }
}

iOS에 대한 구현

푸시 노출 추적 구현 방법

노출 횟수 추적의 경우 trackAction() 함수를 호출할 때 동작에 대해 값 "7"을 보내야 합니다.

iOS 알림의 작동 방식을 이해하려면 앱의 3가지 상태를 자세히 살펴보아야 합니다.

  • 전경:앱이 현재 활성화되어 있고 현재 화면에 있는 경우(전경).
  • 배경:is 앱이 화면에 표시되지 않지만 프로세스가 닫히지 않은 경우입니다. 홈 단추를 두 번 클릭하면 일반적으로 배경에 있는 모든 앱이 표시됩니다.
  • 해제/폐쇄:프로세스가 종료된 앱.

앱이 닫혀 있는 경우 Apple은 앱이 다시 시작될 때까지 앱을 호출하지 않습니다. 즉, iOS에서 알림을 받은 시점을 알 수 없습니다.

앱이 백그라운드에 있는 동안 Impression 추적이 계속 작동하려면 Content-Available​을(를) 전송하여 앱에서 추적이 완료되어야 한다는 것을 알려야 합니다.

주의

iOS 노출 추적은 정확하지 않으며 신뢰할 수 있는 것으로 간주해서는 안 됩니다.

21.1 릴리스 이전에 만들어진 배달품이나 사용자 지정 템플릿을 사용한 배달은 이 섹션을 참조하십시오.

다음 코드는 백그라운드 앱을 대상으로 합니다.

// In didReceiveRemoteNotification event handler in AppDelegate.m
 
//In order to handle push notification when only in background with content-available: 1
func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
 
        //Check if the app is not in the foreground right now
        if(UIApplication.shared.applicationState != .active) {
            let deliveryId = userInfo["_dId"] as? String
            let broadlogId = userInfo["_mId"] as? String
            let acsDeliveryTracking = userInfo["_acsDeliveryTracking"] as? String
            /*
            This is to handle deliveries created before 21.1 release or deliveries with custom template where acsDeliveryTracking is not available.
            */
            if( acsDeliveryTracking == nil ) {
                acsDeliveryTracking = "on";
            }
            if (deliveryId != nil && broadlogId != nil && acsDeliveryTracking?.caseInsensitiveCompare("on") == ComparisonResult.orderedSame) {
               ADBMobile.trackAction("tracking", data: ["deliveryId": deliveryId!, "broadlogId": broadlogId!, "action":"7"])
            }
        }
        completionHandler(UIBackgroundFetchResult.noData)
    }

다음 코드는 포그라운드 앱을 대상으로 합니다.

// This will get called when the app is in the foreground
 
func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
 
 
        let userInfo = notification.request.content.userInfo
        let deliveryId = userInfo["_dId"] as? String
        let broadlogId = userInfo["_mId"] as? String
        let acsDeliveryTracking = userInfo["_acsDeliveryTracking"] as? String
        /*
        This is to handle deliveries created before 21.1 release or deliveries with custom template where acsDeliveryTracking is not available.
        */
        if( acsDeliveryTracking == nil ) {
            acsDeliveryTracking = "on";
        }
        if (deliveryId != nil && broadlogId != nil && acsDeliveryTracking?.caseInsensitiveCompare("on") == ComparisonResult.orderedSame) {
             ADBMobile.trackAction("tracking", data: ["deliveryId": deliveryId!, "broadlogId": broadlogId!, "action":"7"])
        }
        completionHandler([.alert,.sound])
    }

클릭 추적을 구현하는 방법

클릭 추적의 경우 trackAction() 함수를 호출할 때 동작에 대해 값 "2"를 보내야 합니다.
21.1 릴리스 이전에 만들어진 배달품이나 사용자 지정 템플릿을 사용한 배달은 이 섹션을 참조하십시오.

// AppDelegate.swift
...
import os.log
import UserNotifications
...
  
func registerForPushNotifications() {
        let center = UNUserNotificationCenter.current()
        center.delegate = notificationDelegate
        //Here we are creating a new Category that allows us to handle Dismiss Actions
        let defaultCategory = UNNotificationCategory(identifier: "DEFAULT", actions: [], intentIdentifiers: [], options: .customDismissAction)
        //Add it to our array of Category, in this case we only have one
        center.setNotificationCategories([defaultCategory])
        center.requestAuthorization(options: [.alert, .sound, .badge]) {
            (granted, error) in
            os_log("Permission granted: %{public}@", type:. debug, granted.description)
            if error != nil {
                return
            }
            if granted {
                os_log("Notifications allowed", type: .debug)
            }
            else {
                os_log("Notifications denied", type: .debug)
            }
  
            // 2. Attempt registration for remote notifications on the main thread
            DispatchQueue.main.async {
                UIApplication.shared.registerForRemoteNotifications()
            }
        }
    }

이제 푸시 알림을 전송할 때 카테고리를 추가해야 합니다. 이 경우 "기본값"이라고 했습니다.

그런 다음 Dismiss​을 처리하고 추적 정보를 보내려면 다음을 추가해야 합니다.

func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
        let userInfo = response.notification.request.content.userInfo
        switch response.actionIdentifier {
        case UNNotificationDismissActionIdentifier:
            print("Dismiss Action")
            let deliveryId = userInfo["_dId"] as? String
            let broadlogId = userInfo["_mId"] as? String
            let acsDeliveryTracking = userInfo["_acsDeliveryTracking"] as? String
            /*
            This is to handle deliveries created before 21.1 release or deliveries with custom template where acsDeliveryTracking is not available.
            */
            if( acsDeliveryTracking == nil ) {
                acsDeliveryTracking = "on";
            }
            if (deliveryId != nil && broadlogId != nil && acsDeliveryTracking?.caseInsensitiveCompare("on") == ComparisonResult.orderedSame) {
                ADBMobile.trackAction("tracking", data: ["deliveryId": deliveryId!, "broadlogId": broadlogId!, "action":"2"])
            }
        default:
            ////MORE CODE
        }
        completionHandler()
    }

열기 추적을 구현하는 방법

앱을 열려면 알림을 클릭해야 하므로 "1" 및 "2"를 보내야 합니다. 푸시 알림을 통해 앱을 시작/열지 않으면 추적 이벤트가 발생하지 않습니다.

21.1 릴리스 이전에 만들어진 배달품이나 사용자 지정 템플릿을 사용한 배달은 이 섹션을 참조하십시오.

import Foundation
import UserNotifications
import UserNotificationsUI
 
class NotificationDelegate: NSObject, UNUserNotificationCenterDelegate {
 
    // Called when user clicks the push notification or also called from willPresent()
    func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
 
        let userInfo = response.notification.request.content.userInfo
        os_log("App push data %{public}@, in userNotificationCenter:didReceive()", type: .debug, userInfo)
        switch response.actionIdentifier {
        case UNNotificationDismissActionIdentifier:
            //This is to handle the Dismiss Action
            let deliveryId = userInfo["_dId"] as? String
            let broadlogId = userInfo["_mId"] as? String
            let acsDeliveryTracking = userInfo["_acsDeliveryTracking"] as? String
            /*
            This is to handle deliveries created before 21.1 release or deliveries with custom template where acsDeliveryTracking is not available.
            */
            if( acsDeliveryTracking == nil ) {
                acsDeliveryTracking = "on";
            }
            if (deliveryId != nil && broadlogId != nil && acsDeliveryTracking?.caseInsensitiveCompare("on") == ComparisonResult.orderedSame) {
                ADBMobile.trackAction("tracking", data: ["deliveryId": deliveryId!, "broadlogId": broadlogId!, "action":"2"])
            }
        default:
            //This is to handle the tracking when the app opens
            let deliveryId = userInfo["_dId"] as? String
            let broadlogId = userInfo["_mId"] as? String
            let acsDeliveryTracking = userInfo["_acsDeliveryTracking"] as? String
            /*
            This is to handle deliveries created before 21.1 release or deliveries with custom template where acsDeliveryTracking is not available.
            */
            if( acsDeliveryTracking == nil ) {
                acsDeliveryTracking = "on";
            }
            if (deliveryId != nil && broadlogId != nil && acsDeliveryTracking?.caseInsensitiveCompare("on") == ComparisonResult.orderedSame) {
                ADBMobile.trackAction("tracking", data: ["deliveryId": deliveryId!, "broadlogId": broadlogId!, "action":"2"])
                ADBMobile.trackAction("tracking", data: ["deliveryId": deliveryId!, "broadlogId": broadlogId!, "action":"1"])
            }
        }
        completionHandler()
    }
}

이 페이지에서는

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free