实施本地跟踪 local-tracking

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

undefined
undefined

关于本地跟踪 about-local-tracking

在此页面中，了解如何确保正确实施本地通知跟踪。请注意，这意味着已配置本地通知。

本地通知跟踪可以拆分为三种类型：

本地展示次数 — 本地通知已传送到设备并位于通知中心上，但完全没有被触碰时。在大多数情况下，展示次数应与交付的展示次数大致相同。它可确保设备确实收到消息，并将该信息中继回服务器。
本地点击 — 本地通知已送达设备，且用户已点击通知。用户希望查看通知（通知随后将移至本地打开跟踪）或关闭通知。
本地打开 — 本地通知已传送到设备，且用户已单击导致应用程序打开的通知。这与本地点击类似，不同之处在于，如果取消通知，则不会触发本地打开。

要为Adobe Campaign Standard实施跟踪，移动应用程序需要在应用程序中包含Mobile SDK。这些SDK在Adobe Mobile Services中可用。

要发送跟踪信息，必须发送三个变量：两个变量是从Adobe Campaign接收的数据的一部分，另一个变量是操作变量，用于指示该变量是展示变量、单击变量还是打开变量。

变量

值

deliveryId

来自传入数据的deliveryId（与使用_dld的推送跟踪类似）

broadlogId

来自传入数据的broadlogId（与使用_mld的推送跟踪类似）

操作

“1”表示打开，“2”表示单击，“7”表示展示

实施本地展示跟踪 implement-local-impression-tracking

Adobe Experience Platform Mobile SDK将自动为Android和iOS发送展示事件，而无需任何其他配置。

实施点击跟踪 implementing-click-tracking

对于点击跟踪，调用collectMessageInfo()或trackAction()函数时必须发送值“2”才能执行操作。

适用于Android的 implement-click-tracking-android

要跟踪点击量，必须实施两种方案：

用户看到通知但将其清除。

要在删除场景时跟踪点击，请将广播接收器NotificationDismissalHandler添加到应用程序模块的AndroidManifest文件中。

code language-none
`<receiver android:name="com.adobe.marketing.mobile.NotificationDismissalHandler"> </receiver>`

用户看到通知并单击它，将变为打开跟踪。

此方案应生成一个单击和一个打开操作。跟踪此点击将是跟踪打开情况所需的实施的一部分。请参阅实施打开跟踪。

适用于iOS的 implement-click-tracking-ios

要发送点击跟踪信息，必须添加以下内容：

class NotificationDelegate: NSObject, UNUserNotificationCenterDelegate {

   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["deliveryId"] as? String
            let broadlogId = userInfo["broadlogId"] as? String
            if (deliveryId != nil && broadlogId != nil) {

                //If you are using ACPCore v2.3.0 or later, use the next line.

                ACPCore.collectMessageInfo(["deliveryId": deliveryId!, "broadlogId": broadlogId!, "action":"2"])

                //Else comment out the above line and uncomment the line below

                // ACPCore.trackAction("tracking", data: ["deliveryId": deliveryId!, "broadlogId": broadlogId!, "action":"2"])
            }
        default:

            ////MORE CODE
        }
        completionHandler()
    }
}

实施开放跟踪 implement-open-tracking

您必须发送“1”和“2”，因为用户必须单击通知才能打开应用程序。如果未通过本地通知启动/打开应用程序，则不会发生跟踪事件。

适用于Android的 implement-open-tracking-android

要跟踪打开情况，我们必须创建意图。目的对象允许Android OS在完成某些操作后调用您的方法，在此例中，单击通知以打开应用程序。

此代码基于点击展示跟踪的实施。现在，对于意图集，您必须将跟踪信息发送回Adobe Campaign。在这种情况下，触发通知的Android视图(Activity)将打开或作为用户单击的结果置于前台。 Activity中的目的对象包含可用于跟踪打开的通知数据。

MainActivity.java（扩展Activity）

@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) {

        //Opened based on the notification, you must get the tracking that was passed on.

        Map<String, String> notificationData = (Map<String, Object>)data.getSerializableExtra("NOTIFICATION_USER_INFO");
        String deliveryId = (String)notificationData.get("deliveryId");
        String messageId = (String)notificationData.get("broadlogId");

        if (deliveryId != null && messageId != null) {
            HashMap<String, String> contextData = new HashMap<>();
            contextData.put("deliveryId", deliveryId);
            contextData.put("broadlogId", messageId);

            //Send click tracking since the user did click on the notification

            contextData.put("action", "2");

            //If you are using ACPCore v1.4.0 or later, use the next line.

            MobileCore.collectMessageInfo(contextData);

            //Else comment out the above line and uncomment the line below

            // MobileCore.trackAction("tracking", contextData);

            //Send open tracking since the user opened the app

            contextData.put("action", "1");

            //If you are using  ACPCore v1.4.0 or later, use the next line.

            MobileCore.collectMessageInfo(contextData);

            //Else comment out the above line and uncomment the line below

            // MobileCore.trackAction("tracking", contextData);
        }
    }
}

适用于iOS的 implement-open-tracking-ios

import os.log
import Foundation
import UserNotifications
import UserNotificationsUI
import ACPCore

class NotificationDelegate: NSObject, UNUserNotificationCenterDelegate {

    //Called when user clicks the local 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["deliveryId"] as? String
            let broadlogId = userInfo["broadlogId"] as? String
            if (deliveryId != nil && broadlogId != nil) {

                //If you are using ACPCore v2.3.0 or later, use the next line.

                ACPCore.collectMessageInfo(["deliveryId": deliveryId!, "broadlogId": broadlogId!, "action":"2"])

                //Else comment out the above line and uncomment the line below

                // ACPCore.trackAction("tracking", data: ["deliveryId": deliveryId!, "broadlogId": broadlogId!, "action":"2"])
            }
        default:
            //This is to handle the tracking when the app opens
            let deliveryId = userInfo["deliveryId"] as? String
            let broadlogId = userInfo["broadlogId"] as? String
            if (deliveryId != nil && broadlogId != nil) {

               //If you are using ACPCore v2.3.0 or later, use the next line.

               ACPCore.collectMessageInfo(["deliveryId": deliveryId!, "broadlogId": broadlogId!, "action":"2"])
               ACPCore.collectMessageInfo(["deliveryId": deliveryId!, "broadlogId": broadlogId!, "action":"1"])

               //Else comment out the above line and uncomment the line below

               // ACPCore.trackAction("tracking", data: ["deliveryId": deliveryId!, "broadlogId": broadlogId!, "action":"2"])
               // ACPCore.trackAction("tracking", data: ["deliveryId": deliveryId!, "broadlogId": broadlogId!, "action":"1"])
            }
        }
        completionHandler()
    }
}

recommendation-more-help

3ef63344-7f3d-48f9-85ed-02bf569c4fff