Implementação do rastreamento local local-tracking
Sobre o rastreamento local about-local-tracking
Nesta página, saiba como garantir que o rastreamento de notificação local tenha sido implementado corretamente. Observe que isso implica que a notificação local já foi configurada.
O rastreamento de notificação local pode ser dividido em três tipos:
-
Impressões locais - Quando uma notificação local foi entregue ao dispositivo e está no centro de notificações, mas não foi tocada. Na maioria dos casos, o número de impressões deve ser semelhante, se não igual ao número entregue. Ele garante que o dispositivo recebeu a mensagem e transmite essas informações de volta para o servidor.
-
Clique local - Quando uma notificação local for entregue ao dispositivo e o usuário clicar na notificação. O usuário queria visualizar a notificação (que, por sua vez, moverá para o rastreamento aberto local) ou descartar a notificação.
-
Abertura local - Quando uma notificação local tiver sido entregue ao dispositivo e o usuário tiver clicado na notificação que está causando a abertura do aplicativo. É semelhante ao clique local, exceto que uma abertura local não será acionada se a notificação tiver sido rejeitada.
Para implementar o rastreamento do Adobe Campaign Standard, o aplicativo móvel precisa incluir o SDK móvel no aplicativo. Esses SDKs estão disponíveis em Adobe Mobile Services.
Para enviar informações de rastreamento, há três variáveis que devem ser enviadas: duas fazem parte dos dados recebidos do Adobe Campaign e a outra é uma variável de ação que determina se é uma impressão, clique ou abertura.
deliveryId dos dados de entrada (similar ao rastreamento de push onde _dld é usado)broadlogId dos dados de entrada (similar ao rastreamento de push onde _mld é usado)Implementar o rastreamento de impressão local implement-local-impression-tracking
O SDK do Adobe Experience Platform Mobile enviará automaticamente o evento de impressão para o Android e o iOS sem nenhuma configuração adicional.
Implementar o rastreamento de cliques implementing-click-tracking
Para rastreamento de cliques, você deve enviar o valor "2" para a ação ao chamar as funções collectMessageInfo() ou trackAction().
Para Android implement-click-tracking-android
Para rastrear cliques, dois cenários devem ser implementados:
-
O usuário vê a notificação, mas a apaga.
Para rastrear cliques em caso de cenário de descarte, adicione o receptor da transmissão
NotificationDismissalHandlerno arquivo AndroidManifest do módulo do aplicativo.code language-none <receiver android:name="com.adobe.marketing.mobile.NotificationDismissalHandler"> </receiver> -
O usuário vê a notificação e clica nela, isso se transformará em um rastreamento aberto.
Esse cenário deve produzir um clique e uma abertura. O rastreamento desse clique fará parte da implementação necessária para rastrear as aberturas. Consulte Implementação do rastreamento aberto.
Para iOS implement-click-tracking-ios
Para enviar as informações de rastreamento de cliques, você deve adicionar o seguinte:
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()
}
}
Implementar o rastreamento aberto implement-open-tracking
Você deve enviar "1" e "2", pois o usuário deve clicar na notificação para abrir o aplicativo. Se o aplicativo não for iniciado/aberto por meio de notificação local, nenhum evento de rastreamento ocorrerá.
Para Android implement-open-tracking-android
Para rastrear aberturas, devemos criar intenções. Os objetos de intenção permitem que o Android OS chame seu método quando determinadas ações são realizadas. Nesse caso, clique na notificação para abrir o aplicativo.
Este código é baseado na implementação do rastreamento de impressão de cliques. Com a intenção definida, agora você deve enviar as informações de rastreamento de volta para a Adobe Campaign. Nesse caso, o Modo de Exibição do Android(Activity) que disparou a notificação será aberto ou trazido para o primeiro plano como resultado do clique pelo usuário. O objeto de intenção em Activity contém os dados de notificação que podem ser usados para rastrear aberturas.
MainActivity.java (estende 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);
}
}
}
Para 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()
}
}