Notificaciones push

Habilite las notificaciones push para las aplicaciones de iOS o Android que utilicen Marketo Mobile SDK.

Configuración de notificaciones push en iOS

Para activar las notificaciones push hay que seguir tres pasos:

Configuración de notificaciones push en la cuenta de desarrollador de Apple

Habilitar notificaciones push en xCode

Active la capacidad de notificación push en el proyecto xCode.

Habilitar notificaciones push en la aplicación con Marketo SDK

Agregue el siguiente código al archivo AppDelegate.m para enviar notificaciones push a los dispositivos del cliente.

Nota - Si usa la extensión Adobe Launch, use ALMarketo como nombre de clase.

Agregar la siguiente importación a AppDelegate.h.

#import <UserNotifications/UserNotifications.h>

import UserNotifications

Agregar UNUserNotificationCenterDelegate a AppDelegate como se muestra a continuación.

@interface AppDelegate : UIResponder <UIApplicationDelegate, UNUserNotificationCenterDelegate>

class AppDelegate: UIResponder, UIApplicationDelegate , UNUserNotificationCenterDelegate

Agregue el siguiente código para inicializar el servicio de notificaciones push.

BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
        center.delegate = self;
        [center requestAuthorizationWithOptions:(UNAuthorizationOptionSound | UNAuthorizationOptionAlert | UNAuthorizationOptionBadge) completionHandler:^(BOOL granted, NSError * _Nullable error){
            if(!error){
                dispatch_async(dispatch_get_main_queue(), ^{
                    [[UIApplication sharedApplication] registerForRemoteNotifications];
                });
            }
        }];

    return YES;
}

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

    UNUserNotificationCenter.current().requestAuthorization(options: [.alert, .sound,    .badge]) { granted, error in
            if let error = error {
                print("\(error.localizedDescription)")
            } else {
                DispatchQueue.main.async {
                    application.registerForRemoteNotifications()
                }
            }
        }

        return true
}

Llame a este método para iniciar el registro con el servicio push de Apple. Si el registro se realiza correctamente, la aplicación llama al método application:didRegisterForRemoteNotificationsWithDeviceToken: del objeto delegado de la aplicación y le pasa un token de dispositivo.

Si el registro falla, la aplicación llama al método application:didFailToRegisterForRemoteNotificationsWithError: de su delegado de la aplicación.

Registre el token push con Marketo. El token del dispositivo debe estar registrado para recibir notificaciones push de Marketo.

- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    // Register the push token with Marketo
    [[Marketo sharedInstance] registerPushDeviceToken:deviceToken];
}

func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
    // Register the push token with Marketo
    Marketo.sharedInstance().registerPushDeviceToken(deviceToken)
}

También puede anular el registro del token cuando el usuario cierre la sesión.

[[Marketo sharedInstance] unregisterPushDeviceToken];

Marketo.sharedInstance().unregisterPushDeviceToken

Para volver a registrar el token push, extraiga el código del paso 3 en un método AppDelegate. Llame a ese método desde el método de inicio de sesión ViewController.

Administre la notificación push después de registrar el token del dispositivo con Marketo.

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo
{
    [[Marketo sharedInstance] handlePushNotification:userInfo];
}

func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) {
    Marketo.sharedInstance().handlePushNotification(userInfo)
}

Agregue el método siguiente a AppDelegate.

Utilice este método para mostrar una alerta, reproducir un sonido o aumentar el distintivo mientras la aplicación está en primer plano. Llame al completionHandler adecuado en este método.

-(void)userNotificationCenter:(UNUserNotificationCenter *)center
    willPresentNotification:(UNNotification *)notification
        withCompletionHandler:(void (^)(UNNotificationPresentationOptions options))completionHandler{

    completionHandler(UNAuthorizationOptionSound | UNAuthorizationOptionAlert | UNAuthorizationOptionBadge);
}

func userNotificationCenter(_ center: UNUserNotificationCenter,
            willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (
    UNNotificationPresentationOptions) -> Void) {
    completionHandler([.alert, .sound,.badge])
}

Controlar las notificaciones push recién recibidas en AppDelegate.

El delegado llama a este método cuando el usuario responde a una notificación abriendo la aplicación, descartando la notificación o eligiendo UNNotificationAction. Establezca el delegado antes de que la aplicación vuelva de applicationDidFinishLaunching:.

- (void)userNotificationCenter:(UNUserNotificationCenter *)center
didReceiveNotificationResponse:(UNNotificationResponse *)response withCompletionHandler:(void(^)(void))completionHandler {
    [[Marketo sharedInstance] userNotificationCenter:center didReceiveNotificationResponse:response withCompletionHandler:completionHandler];
}

func userNotificationCenter(_ center: UNUserNotificationCenter,
                                didReceive response: UNNotificationResponse,
                                withCompletionHandler
                                completionHandler: @escaping () -> Void) {
        Marketo.sharedInstance().userNotificationCenter(center, didReceive: response, withCompletionHandler: completionHandler)
}

Seguimiento de notificaciones push.

Si la aplicación está en segundo plano o inactiva, el dispositivo recibe una notificación push como se muestra a continuación. Marketo realiza un seguimiento cuando el usuario selecciona la notificación.

Cuando el dispositivo recibe una notificación push, pasa la notificación a la llamada de retorno application:didReceiveRemoteNotification: en el delegado de la aplicación.

El siguiente registro de actividades de Marketo muestra eventos de aplicación y eventos de notificaciones push.

Configuración de notificaciones push en Android

Dispositivos de prueba Android

Agregue la actividad de Marketo al archivo de manifiesto dentro de la etiqueta de aplicación.

<activity android:name="com.marketo.MarketoActivity"  android:configChanges="orientation|screenSize">
    <intent-filter android:label="MarketoActivity">
        <action  android:name="android.intent.action.VIEW"/>
        <category  android:name="android.intent.category.DEFAULT"/>
        <category  android:name="android.intent.category.BROWSABLE"/>
        <data android:host="add_test_device" android:scheme="mkto"/>
    </intent-filter/>
</activity/>

Registrar el servicio push de Marketo

NOTA: FCM SDK agrega automáticamente los permisos necesarios y la funcionalidad del receptor. Si ha utilizado una versión anterior de SDK, elimine los siguientes elementos obsoletos, lo que podría provocar la duplicación de mensajes.

<receiver android:name="com.marketo.MarketoBroadcastReceiver" android:permission="com.google.android.c2dm.permission.SEND">
    <intent-filter>
        <!‐‐Receives the actual messages.‐‐>
        <action android:name="com.google.android.c2dm.intent.RECEIVE"/>
        <!‐‐Register to enable push notification‐‐>
        <action android:name="com.google.android.c2dm.intent.REGISTRATION"/>
        <!‐‐‐Replace YOUR_PACKAGE_NAME with your own package name‐‐>
        <category android:name="YOUR_PACKAGE_NAME"/>
    </intent-filter>
</receiver>

<!‐‐Marketo service to handle push registration and notification‐‐>
<service android:name="com.marketo.MarketoIntentService"/>

Resolución de problemas

Si los mensajes push móviles no funcionan según lo esperado, compruebe los problemas de configuración comunes antes de investigar los detalles de implementación.

El mensaje de inserción no aparece

Compruebe si los mensajes push están desactivados en el dispositivo. Los usuarios de dispositivos móviles pueden controlar si reciben mensajes para cada aplicación, y los desarrolladores o especialistas en marketing pueden desactivar los mensajes durante el desarrollo.

Compruebe si la aplicación está abierta y activa. Cuando la aplicación está activa, los mensajes push de dispositivos móviles no aparecen en la pantalla. Aparecen en el área de “notificaciones locales” de la aplicación.

Ver los registros de actividad en Marketo

Utilice los registros de actividad de Marketo para comprobar que se ha enviado un mensaje.

Revise los registros de actividad de una persona que debería haber recibido el mensaje. Si se envió el mensaje, el registro de actividad contiene un registro. Si no existe ningún registro, compruebe el certificado de iOS o la configuración de la clave de API de Android en Marketo.

El certificado o la clave no son válidos

Compruebe que se ha cargado el certificado correcto para la zona protegida o la producción. Si es necesario, vuelva a exportar los certificados de iOS o las claves de Android y vuelva a cargarlos en Marketo.

Falta un certificado o una clave en el archivo .p12 (iOS)

Al exportar el certificado, exporte tanto la clave como el certificado.

Aprovisionamiento de perfiles obsoletos (iOS)

Después de agregar un dispositivo, actualice los perfiles de aprovisionamiento y genere nuevos certificados. Dirija el proyecto Xcode a los perfiles y certificados correctos e importe los certificados en Marketo.

No Se Puede Cargar El Certificado De iOS (IOS)

Asegúrese de que la contraseña utilizada para exportar el certificado no contenga espacios. Por ejemplo, en lugar de esto:

Hello World 123

use esto:

HelloWorld123

Solución de problemas de certificados iOS

Para las aplicaciones de zona protegida, utilice un certificado “desarrollador” o “universal”. Para aplicaciones de producción, cargue un certificado “distribución” o “universal” válido.

Devolución de push/token no válido

Un token de registro puede no ser válido en los siguientes casos: