Notifiche push

Abilita le notifiche push per le app iOS o Android che utilizzano Marketo Mobile SDK.

Configurare le notifiche push in iOS

Esistono tre passaggi per abilitare le notifiche push:

Configurare le notifiche push sull’account Apple Developer

Abilitare le notifiche push in xCode

Attiva la funzionalità di notifica push nel progetto xCode.

Abilitare le notifiche push in app con Marketo SDK

Aggiungere il codice seguente al file AppDelegate.m per inviare notifiche push ai dispositivi dei clienti.

Nota - Se si utilizza l’estensione Adobe Launch, utilizzare ALMarketo come nome della classe.

Aggiungi la seguente importazione a AppDelegate.h.

#import <UserNotifications/UserNotifications.h>

import UserNotifications

Aggiungi UNUserNotificationCenterDelegate a AppDelegate come mostrato di seguito.

@interface AppDelegate : UIResponder <UIApplicationDelegate, UNUserNotificationCenterDelegate>

class AppDelegate: UIResponder, UIApplicationDelegate , UNUserNotificationCenterDelegate

Aggiungi il seguente codice per inizializzare il servizio di notifica 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
}

Chiama questo metodo per avviare la registrazione al servizio push di Apple. Se la registrazione ha esito positivo, l’app chiama il metodo application:didRegisterForRemoteNotificationsWithDeviceToken: dell’oggetto delegato dell’app e gli trasmette un token dispositivo.

Se la registrazione non riesce, l’app chiama il metodo application:didFailToRegisterForRemoteNotificationsWithError: del delegato dell’app.

Registra il token push con Marketo. Il token del dispositivo deve essere registrato per ricevere notifiche push da 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)
}

Puoi anche annullare la registrazione del token quando l’utente si disconnette.

[[Marketo sharedInstance] unregisterPushDeviceToken];

Marketo.sharedInstance().unregisterPushDeviceToken

Per registrare nuovamente il token push, estrai il codice dal passaggio 3 in un metodo AppDelegate. Chiamare tale metodo dal metodo di accesso ViewController.

Gestisci la notifica push dopo la registrazione del token 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)
}

Aggiungere il metodo seguente a AppDelegate.

Utilizza questo metodo per visualizzare un avviso, riprodurre un suono o aumentare il badge mentre l’app è in primo piano. Chiama il completionHandler appropriato in questo metodo.

-(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])
}

Gestisce le notifiche push appena ricevute in AppDelegate.

Il delegato chiama questo metodo quando l’utente risponde a una notifica aprendo l’applicazione, ignorando la notifica o scegliendo un UNNotificationAction. Impostare il delegato prima che l’applicazione restituisca 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)
}

Tracciare le notifiche push.

Se l’app è in background o inattiva, il dispositivo riceve una notifica push come mostrato di seguito. Marketo tiene traccia di quando l’utente seleziona la notifica.

Quando il dispositivo riceve una notifica push, la trasmette al callback application:didReceiveRemoteNotification: sul delegato dell’app.

Il seguente registro attività di Marketo mostra gli eventi dell’app e gli eventi di notifica push.

Configurare le notifiche push in Android

Dispositivi di prova Android

Aggiungi Attività Marketo al file manifesto all’interno del tag dell’applicazione.

<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/>

Registra servizio push Marketo

NOTA: FCM SDK aggiunge automaticamente le autorizzazioni richieste e la funzionalità del ricevitore. Se utilizzavi una versione precedente di SDK, rimuovi i seguenti elementi obsoleti, che potrebbero causare la duplicazione dei messaggi.

<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"/>

Risoluzione dei problemi

Se i messaggi push per dispositivi mobili non funzionano come previsto, controlla i problemi di configurazione comuni prima di esaminare i dettagli di implementazione.

Il messaggio push non viene visualizzato

Verifica se i messaggi push sono disabilitati sul dispositivo. Gli utenti mobili possono controllare se ricevono messaggi per ogni app e gli sviluppatori o gli addetti al marketing possono disabilitare i messaggi durante lo sviluppo.

Verifica se l’app è aperta e attiva. Quando l’app è attiva, i messaggi push mobili non vengono visualizzati sullo schermo. Vengono invece visualizzate nell’area “Notifiche locali” dell’app.

Visualizzare i registri attività in Marketo

Utilizza i registri attività di Marketo per verificare che sia stato inviato un messaggio.

Esamina i record di attività di una persona che avrebbe dovuto ricevere il messaggio. Se il messaggio è stato inviato, il registro attività contiene un record. Se non esiste alcun record, controlla il certificato iOS o la configurazione della chiave API Android in Marketo.

Certificato o chiave non valida

Verifica che sia caricato il certificato corretto per Sandbox o Produzione. Se necessario, riesporta i certificati iOS o le chiavi Android e ricaricali in Marketo.

Il file .p12 non dispone di un certificato o di una chiave (iOS)

Quando esporti il certificato, esporta sia la chiave che il certificato.

Provisioning dei profili non aggiornato (iOS)

Dopo aver aggiunto un dispositivo, aggiorna i profili di provisioning e genera nuovi certificati. Puntare il progetto Xcode ai profili e ai certificati corretti e importare i certificati in Marketo.

Impossibile caricare il certificato iOS (IOS)

Verifica che la password utilizzata per esportare il certificato non contenga spazi. Ad esempio, invece di:

Hello World 123

utilizza questo:

HelloWorld123

Risoluzione dei problemi dei certificati iOS

Per le applicazioni sandbox, utilizza un certificato “sviluppatore” o “universale”. Per le applicazioni di produzione, carica un certificato di “distribuzione” o “universale” valido.

Notifica di mancato recapito push/Token non valido

Un token di registrazione può diventare non valido nei seguenti scenari: