Pushmeldingen

Uitleg over het inschakelen van pushmeldingen.

Pushmelding instellen op iOS

Er zijn drie stappen om pushmeldingen in te schakelen:

Pushmeldingen configureren op Apple Developer Account

Enable Push Notifications in xCode

Schakel de functie voor pushmeldingen in in het xCode-project.

Enable Push Notifications in App with Marketo SDK

De volgende code toevoegen aan AppDelegate.m bestand om pushmeldingen naar de apparaten van uw klant te verzenden.

Opmerking - Als u de Adobe Launch extensie, gebruiken ALMarketo als klassenaam

Importeren na in AppDelegate.h.

#import <UserNotifications/UserNotifications.h>

import UserNotifications

Toevoegen UNUserNotificationCenterDelegate tot AppDelegate zoals hieronder weergegeven.

@interface AppDelegate : UIResponder <UIApplicationDelegate, UNUserNotificationCenterDelegate>

class AppDelegate: UIResponder, UIApplicationDelegate , UNUserNotificationCenterDelegate

Inleiding pushmeldingenservice. Voeg onder code toe om pushberichten in te schakelen.

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
}

Roep deze methode aan om het registratieproces met Apple Push Service in werking te stellen. Als de registratie slaagt, roept de app de gedelegeerde objecten van uw app aan application:didRegisterForRemoteNotificationsWithDeviceToken: en geeft deze een apparaattoken door.

Als de registratie mislukt, roept de app de gedelegeerde van de app aan application:didFailToRegisterForRemoteNotificationsWithError: in plaats daarvan.

Registreer pushtoken bij Marketo. Als u pushberichten van Marketo wilt ontvangen, moet u het apparaattoken registreren bij 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)
}

Het token kan ook niet worden geregistreerd wanneer de gebruiker zich afmeldt.

[[Marketo sharedInstance] unregisterPushDeviceToken];

Marketo.sharedInstance().unregisterPushDeviceToken

Om het duptoken opnieuw te registreren haalt de code uit stap 3 in een methode AppDelegate en roept van de ViewController login methode.

Druk op pushmelding. Als u pushberichten van Marketo wilt ontvangen, moet u het apparaattoken registreren bij Marketo.

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

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

Voeg de volgende methode in AppDelegate toe

Met deze methode kunt u een waarschuwing, geluid of een hogere badge weergeven terwijl de app op de voorgrond staat. U moet completionHandler van uw keus in deze Methode roepen.

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

Pas ontvangen pushmelding verwerken in AppDelegate

De methode zal op de afgevaardigde worden geroepen wanneer de gebruiker op het bericht door de toepassing te openen antwoordde, het bericht te ontslaan of een UNNotificationAction te kiezen. De afgevaardigde moet worden geplaatst alvorens de toepassing van applicationDoesFinishLaunching terugkeert:.

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

Pushmeldingen bijhouden

Als uw app op de achtergrond wordt uitgevoerd (of niet actief is), ontvangt het apparaat een pushmelding zoals hieronder wordt weergegeven. Marketo houdt bij wanneer de gebruiker op het bericht tikt.

Als het apparaat een pushmelding ontvangt, wordt deze doorgegeven aan application:didReceiveRemoteNotification: callback op uw afgevaardigde van de App.

Hieronder volgt een Marketo-activiteitenlogboek van Marketo waarin gebeurtenissen voor apps en pushmeldingen worden weergegeven.

Pushmelding instellen op Android

Android-testapparaten

Voeg Marketo Activity toe in manifestbestand in toepassingstag.

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

Marketo Push Service registreren

OPMERKING: De FCM SDK voegt automatisch alle vereiste machtigingen en de vereiste ontvangerfunctionaliteit toe. Zorg ervoor dat u de volgende verouderde (en mogelijk schadelijke, omdat hierdoor dubbele berichten kunnen ontstaan) elementen uit het manifest van uw app verwijdert als u eerdere versies van SDK hebt gebruikt

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

Problemen oplossen

Het opzetten van mobiele pushberichten omvat vele stappen en de coördinatie van ontwikkelaars en marketeers. Als u problemen ondervindt, kunt u een aantal eenvoudige dingen controleren.

Nadat u ervoor hebt gezorgd dat de eenvoudige dingen correct zijn, dan kunt u dieper in de programmeringsdetails graven.

Het pushbericht wordt niet weergegeven

Controleer eerst of de pushberichten op de handset zijn uitgeschakeld. Mobiele gebruikers kunnen bepalen of ze berichten voor een bepaalde app ontvangen of niet. Vaak zullen ontwikkelaars (en marketers) deze berichten op een bepaald punt tijdens ontwikkeling onbruikbaar maken. Het eerste wat u moet controleren is of de ontvanger pushberichten voor uw app heeft uitgeschakeld.

Ten tweede: is de toepassing al geopend en actief op het apparaat? Wanneer uw app de actieve app op het apparaat is, verschijnen er geen mobiele pushberichten op het scherm. In plaats daarvan worden ze weergegeven in het gebied Lokale meldingen van uw app.

De activiteitenlogboeken in Marketo weergeven

De eerste plaats om te kijken wanneer het volgen van een fout is in de logboeken van de Activiteit van Marketo. U kunt activiteitenlogboeken gebruiken om te verifiëren dat een bericht werd verzonden.

In het activiteitenlogboek, bekijk de activiteitenverslagen voor een persoon die een bericht verondersteld werd te ontvangen. Als het bericht werd verzonden, zal er een verslag aanwezig in het activiteitenlogboek zijn. Als dat niet het geval is, is het probleem waarschijnlijk het gevolg van de configuratie van het iOS-certificaat of de Android API-sleutel in Marketo.

Certificaat of sleutel is ongeldig

Controleer uw configuratie tweemaal om ervoor te zorgen dat u het juiste die certificaat voor Sandbox of Productie hebt wordt geladen. Soms is het beter dat de ontwikkelaar de certificaten (iOS) of toetsen (Android) opnieuw exporteert en deze vervolgens opnieuw laadt in Marketo om te controleren of ze correct zijn.

.p12-bestand ontbreekt een certificaat of sleutel (iOS)

Wanneer u het certificaat exporteert, moet u ervoor zorgen dat u de sleutel exporteert en het certificaat.

Provisioning Profiles Out-of-Date (iOS)

Wanneer u een nieuw apparaat toevoegt, moet u uw inrichtingsprofielen bijwerken en nieuwe certificaten genereren. Zorg ervoor dat uw Xcode-project vervolgens naar de juiste profielen en certificaten verwijst en importeer die certificaten in Marketo.

Kan iOS-certificaat niet uploaden (IOS)

Zorg ervoor dat het wachtwoord dat wordt gebruikt tijdens het exporteren van het certificaat geen spaties bevat.  In plaats van deze:

Hello World 123

gebruik dit:

HelloWorld123

Problemen met iOS-certificaten oplossen

Voor sandboxtoepassingen kunt u een certificaat "developer" of "Universal" gebruiken. Maar voor productietoepassingen moet u een geldig "distributie"of "universeel"certificaat uploaden.

Stuiteren/Ongeldige token

Een bestaand registratietoken kan in een aantal scenario's niet langer geldig zijn, zoals: