實作本機追蹤 local-tracking

Last update: Fri Dec 29 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
Instance Settings

建立對象：

Experienced
Admin

關於本機追蹤 about-local-tracking

在本頁面中，瞭解如何確保本機通知追蹤已正確實作。請注意，這表示本機通知已設定。

本機通知追蹤可以分割成三種型別：

本機曝光數 — 當本機通知已傳送至裝置，且位於通知中心時，卻完全未觸及。在大多數情況下，如果不與遞送的數字相同，則曝光數應該類似。這可確保裝置確實收到訊息，並將該資訊轉送回伺服器。
本機點按 — 當本機通知已傳送至裝置，且使用者已按一下通知時。使用者想要檢視通知（接著會移至本機開啟追蹤）或關閉通知。
本機開啟 — 當本機通知已傳送至裝置，且使用者已按一下導致應用程式開啟的通知時。這類似於本機點按，但如果通知已關閉，則不會觸發本機開啟。

若要實作Adobe Campaign Standard的追蹤，行動應用程式必須在應用程式中包含行動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

針對點選追蹤，您必須傳送值「2」以在呼叫時執行動作 collectMessageInfo() 或 trackAction() 函式。

適用於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作業系統在完成某些動作時，呼叫您的方法，在此案例中是按一下通知以開啟應用程式。

此程式碼以點按曝光追蹤的實施為基礎。在設定意圖後，您現在必須將追蹤資訊傳送回Adobe Campaign。在此案例中，Android View(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