Pushmeldingen push-notifications
Het is van cruciaal belang dat u gebruikers van de AEM Mobile-app onmiddellijk op de hoogte kunt stellen van belangrijke meldingen voor de waarde van een mobiele app en de marketingcampagnes. Hieronder wordt beschreven welke stappen moeten worden uitgevoerd om uw app pushmeldingen te laten ontvangen, en hoe u pushberichten van AEM Mobile naar de toepassing kunt configureren en verzenden die op de telefoon is geïnstalleerd. Bovendien, beschrijft deze sectie hoe te om te vormen Diepe koppeling aan uw pushmeldingen.
Het gebruik van pushberichten met AEM vereist een aantal verschillende technologieën. Ten eerste moet een serviceprovider voor pushberichten worden gebruikt om de meldingen en apparaten te beheren (AEM doet dit nog niet). Twee leveranciers worden gevormd uit-van-de-doos met AEM: Amazon Simple Notification Service (of SNS), en Pushwoosh. Ten tweede moet de pushtechnologie voor het desbetreffende mobiele besturingssysteem de juiste service doorlopen — Apple Push Notification Service (APNS) voor iOS-apparaten. en Google Cloud Messaging (of GCM) voor Android-apparaten. Hoewel AEM niet rechtstreeks met deze platformspecifieke services communiceert, moeten sommige gerelateerde configuratiegegevens samen met de meldingen worden verstrekt om deze services in staat te stellen de push uit te voeren.
Na installatie en configuratie (zoals hieronder uitgelegd) werkt het als volgt:
- Er wordt een pushmelding gemaakt in AEM en verzonden naar de serviceprovider (Amazon SNS of Pushwoosh).
- De dienstverlener ontvangt het en verzendt het naar de kernleverancier (APNS of GCM).
- De kernleverancier duwt het bericht aan alle apparaten die voor die duw worden geregistreerd. Voor elk apparaat gebruikt het het cellulaire gegevensnetwerk of WiFi, welke momenteel beschikbaar op het apparaat is.
- De melding wordt weergegeven op het apparaat als de app waarvoor deze is geregistreerd, niet wordt uitgevoerd. Een gebruiker die op de melding tikt, start de app en geeft de melding weer in de app. Als de toepassing al wordt uitgevoerd, wordt alleen de melding in de app weergegeven.
Deze release van AEM biedt ondersteuning voor mobiele iOS- en Android-apparaten.
Overzicht en procedure overview-and-procedure
Als u pushberichten wilt gebruiken in een AEM Mobile-app, moet u de volgende stappen op hoog niveau uitvoeren.
Een AEM ontwikkelaar:
- Registreren bij Apple en Google Messaging Services
- Registreer met de dienst van het duw overseinen en vorm het
- Pushondersteuning toevoegen aan de app
- Een telefoon voorbereiden voor testen
Terwijl een AEM beheerder:
- Push-on voor AEM toepassingen configureren
- De app ontwikkelen en implementeren
- Een pushmelding verzenden
- deep linking configureren (optioneel)
Stap 1: Registreren bij Apple en Google Messaging Services step-register-with-apple-and-google-messaging-services
De Apple Push Notification Service (APNS) gebruiken using-the-apple-push-notification-service-apns
Ga naar de Apple-pagina hier om vertrouwd te raken met de Apple Push Notification Service.
Als u APNS wilt gebruiken, hebt u een Certificaat bestand (een .cer-bestand), een push Persoonlijke sleutel (een .p12-bestand) en een Wachtwoord persoonlijke sleutel uit Apple. Instructies over hoe dat moet gebeuren zijn te vinden hier.
De Google Cloud Messaging (GCM)-service gebruiken using-the-google-cloud-messaging-gcm-service
Ga naar de Google-pagina hier om vertrouwd te raken met Google Cloud Messaging voor Android.
U moet de stappen volgen hier tot Een Google API-project maken, De GCM-service inschakelen, en API-sleutels verkrijgen. U hebt de API-sleutel om pushmeldingen naar Android-apparaten te verzenden. Neem ook uw Projectnummer, ook wel een Id van GCM-afzender.
In de volgende stappen wordt een andere methode getoond voor het maken van GCM API-sleutels:
- Log in google en ga naar de Google Developer-pagina.
- Kies uw app in de lijst (of maak een nieuwe).
- Voer onder Android-pakketnaam uw toepassings-id in, bijvoorbeeld
com.adobe.cq.mobile.weretail.outdoorsapp. (Als dat niet werkt, probeert u het opnieuw met "test.test".) - Klikken Doorgaan met kiezen en configureren van services
- Selecteer Cloud Messaging en klik vervolgens op Google Cloud Messaging inschakelen.
- De nieuwe Server API Sleutel en (nieuwe of bestaande) identiteitskaart van de Afzender zullen dan worden getoond.
Stap 2: Registreer en vorm de Dienst van het Overseinen van de Duw step-register-and-configure-a-push-messaging-service
AEM is geconfigureerd om een van de drie services te gebruiken voor pushberichten:
- Amazon SNS
- Pushwoosh
- Adobe mobiele services
Amazon SNS en Pushwoosh kunt u geduwd van binnen AEM schermen verzenden.
Adobe mobiele services Met de configuratie kunt u pushberichten configureren en verzenden vanuit Adobe Mobile Services met een Adobe Analytics-account (de app moet echter worden gemaakt met deze configuratieset om pushmeldingen van AMS in te schakelen).
Het gebruiken van de het overseinendienst van Amazon SNS using-the-amazon-sns-messaging-service
Als u geen SNS van Amazon wilt gebruiken kunt u deze stappen overslaan.
Ga als volgt te werk om Amazon SNS in te stellen voor pushberichten:
-
Registreren met Amazon SNS
- Registreer uw account-id. De opmaak moet twaalf cijfers zonder spaties of streepjes zijn, d.w.z. "123456789012".
- Zorg ervoor dat u zich in de regio 'us-East' of 'eu' bevindt, aangezien een van deze stappen later vereist is (Identity Pool Creation).
- Meld u na de registratie aan bij de beheerconsole en selecteer SNS (Push Notification Service). Klik op Aan de slag als dit wordt weergegeven.
-
Toegangstoets en id maken
- Klik op de aanmeldnaam rechtsboven in het scherm en kies Beveiligingsreferenties in het menu.
- Klik op Toegangstoetsen, en in de ruimte hieronder, klik Nieuwe toegangstoets maken.
- Klikken Toegangstoets tonen en kopieer en sla de Toegangstoets-id en de Geheime Toegangstoets op. Als u de optie kiest om de toetsen te downloaden, krijgt u een CSV-bestand dat dezelfde waarden bevat.
- Andere aan beveiliging gerelateerde certificaten en andere kunnen op deze pagina worden beheerd.
note note NOTE Een toegangstoets kan voor meerdere apps worden gebruikt. Voor organisaties die een "AWS Sandbox"rekening gebruiken, zijn de stappen zeer gelijkaardig, en hier geschetst:
- Klik op de aanmeldnaam rechtsboven in het scherm en kies Mijn beveiligingsreferenties in het menu.
- Klik op Gebruikers in de linkerlijst van acties, en kies uw gebruikersnaam.
- Klik op het tabblad Beveiligingsreferenties.
- Vanaf hier zie je je toetsen en maak je nieuwe toetsen. Sla de toetsen op voor later gebruik.
-
Een onderwerp maken
- Klikken Onderwerp maken en kies een onderwerpnaam. Registreer alle velden, zoals Onderwerpnaam, Onderwerpeigenaar, Gebied en Weergavenaam.
- Klikken Andere onderwerphandelingen > Onderwerpbeleid bewerken. Onder Deze gebruikers toestaan zich op dit onderwerp te abonneren, selecteert u Iedereen.
- Klikken Beleid bijwerken.
note note NOTE U kunt veelvoudige onderwerpen voor verschillende scenario's zoals dev, test, demo, etc. tot stand brengen. De rest van de configuratie van SNS kan het zelfde blijven. Ontwikkel app met het verschillende onderwerp; naar dat onderwerp verzonden pushmeldingen worden alleen ontvangen door de toepassing die met dat onderwerp is gemaakt. -
Platform-toepassingen maken
-
Klik op Toepassingen en vervolgens op Toepassing Platform maken. Kies een naam en selecteer een platform (APNS voor iOS, GCM voor Android). Afhankelijk van het platform moeten andere velden worden ingevuld:
- Voor APNS moeten een P12-bestand, een wachtwoord, een certificaat en een persoonlijke sleutel worden ingevoerd. Deze hadden in de stap moeten worden verkregen De Apple Push Notification Service (APNS) gebruiken hierboven.
- Voor GCM moet een API-sleutel worden ingevoerd. Dit had in de stap moeten worden verkregen De Google Cloud Messaging (GCM)-service gebruiken hierboven.
-
Herhaal de bovenstaande stap eenmaal voor elk platform dat u wilt ondersteunen. Als u zowel naar iOS als naar Android wilt gaan, moet u twee Platform-toepassingen maken.
-
-
Een identiteitsgroep maken
- Gebruiken Cognito om een Identity Pool te maken, waarin de basisgegevens van niet-geverifieerde gebruikers worden opgeslagen. Opmerking: Amazon Cognito biedt momenteel alleen ondersteuning voor "us-East"- en "eu"-regio's.
- Geef deze een naam en schakel het selectievakje 'Toegang tot niet-geverifieerde identiteiten inschakelen' in.
- Op de volgende pagina ("Uw Cognito-identiteiten hebben toegang tot uw bronnen nodig") klik op Toestaan.
- Klik in de rechterbovenhoek van de pagina op de koppeling "Identiteitsgroep bewerken". De id van de identiteitspool wordt weergegeven. Sla deze tekst op voor later.
- Kies op dezelfde pagina de vervolgkeuzelijst naast "Niet-geverifieerde rol" en zorg ervoor dat deze de rol Cognito_<pool name="">UnauthRole geselecteerd. Sla uw wijzigingen op.
-
Toegang configureren
- Aanmelden bij Identiteitsbeheer en toegangsbeheer (IAM)
- Rollen selecteren
- Klik op de rol die in de vorige stap is gemaakt, genaamd Cognito_<youridentitypoolname>Unauth_Role. Neem de weergegeven "Rol ARN" op.
- Open Inline-beleid als dit nog niet geopend is. Hier wordt een beleid met een naam als oneClick_Cognito_ weergegeven<youridentitypoolname>Unauth_Role_1234567890123.
- Klik op "Beleid bewerken". Vervang de inhoud van het Beleidsdocument door dit fragment van JSON:
table 0-row-1 html-authored no-header {
"Versie": "2012-10-17",
"Verklaring": [
{
"Actie": [
"mobileanalytics:PutEvents",
"cognito-sync:*",
"SNS:CreatePlatformEndpoint",
"SNS:Subscribe"
],
"Effect": "Toestaan",
"Bron": [
"*"
]
}
]
}
- Klikken op Beleid toepassen
De Pushwoosh-berichtenservice gebruiken using-the-pushwoosh-messaging-service
Als u Pushwoosh niet wilt gebruiken, kunt u deze stap overslaan.
Pushwoosh gebruiken:
-
Registreren met Pushwoosh
- Ga naar push.woosh.com en maak een nieuwe account.
-
Een API-toegangstoken maken
- Ga op de Pushwoosh-site naar het menu-item API Access om een API Access Token te genereren. U moet dit veilig vastleggen.
-
Een nieuwe app maken
- Voor Android-ondersteuning moet u de GCM API-sleutel opgeven.
- Kies Cordova als framework wanneer u de app configureert.
- Voor iOS-ondersteuning moet u het certificaatbestand (.cer), het pushcertificaat (.p12) en het wachtwoord voor de persoonlijke sleutel opgeven. Deze hadden verkregen moeten worden van de Apple APNS-site. Kies Cordova voor Framework.
- Pushwoosh genereert een toepassings-id voor die app in de notatie "XXXXX-XXXXX", waarbij elke X een hexadecimale waarde (0 tot en met F) is.
Stap 3: Pushondersteuning toevoegen aan de app step-add-push-support-to-the-app
Configuratie ContentSync toevoegen add-contentsync-configuration
Maak twee inhoudsknooppunten (één in app-config en één in app-config-dev) met de naam notificationsConfig:
- /content/
<your app>/shell/jcr:content/pge-app/app-config-dev/notificationsConfig - /content/
<your app>/shell/jcr:content/pge-app/app-config/notificationsConfig
Met deze eigenschappen (.content.xml-bestanden):
<jcr:root xmlns:jcr=" <span id=" translate="no" />https://www.jcp.org/jcr/1.0🔗" xmlns:nt=" https://www.jcp.org/jcr/nt/1.0"
jcr:primaryType="nt:ungestructureerde"
excludeProperties="[appAPIAccessToken]"
path="…/…/…/…"
targetRootDirectory="www"
type="notificationSconfig"/>
Client-bibliotheken toevoegen add-client-libraries
De clientbibliotheken voor pushmeldingen moeten als volgt aan de app worden toegevoegd:
In CRXDE Lite:
- Navigeren naar /etc/designs/phonegap/<app name="">/clientlibsall.
- Dubbelklik op de ingesloten sectie in het deelvenster Eigenschappen.
- Voeg in het dialoogvenster dat wordt weergegeven een nieuwe clientbibliotheek toe door op de knop + te klikken.
- Voeg in het nieuwe tekstveld "cq.mobile.push" toe en klik op OK.
- Voeg nog een cq.mobile.push.amazon toe en klik op OK.
- Sla de wijzigingen op.
Stap 4: Een telefoon voorbereiden voor testen step-prepare-a-phone-for-testing
iOS ios
Voor iOS moet u een Mac OS-computer gebruiken en moet u zich aansluiten bij de iOS Developer Program. Sommige bedrijven hebben bedrijfslicenties die voor alle ontwikkelaars beschikbaar kunnen zijn.
Met XCode 8.1, alvorens de Berichten van de Duw te gebruiken moet u naar het lusje van Mogelijkheden in uw project gaan, en knevel de knevel van de Berichten van de Duw.
Android android
U kunt als volgt de app op een Android-telefoon installeren met CLI (zie hieronder: Stap 6 - De app ontwikkelen en implementeren), moet u eerst de telefoon op "ontwikkelaarwijze zetten." Zie Opties voor ontwikkelaars op het apparaat inschakelen voor meer informatie hierover.
Stap 5: Push-on voor AEM toepassingen configureren step-configure-push-on-aem-apps
Alvorens te bouwen en aan uw gevormde mobiele apparaat op te stellen, moet u de berichtmontages voor de overseinendienst vormen u besloot te gebruiken.
- Maak de juiste machtigingsgroepen voor pushberichten.
- Meld u aan bij AEM als de juiste gebruiker en klik op het tabblad Apps.
- Klik op de app.
- Zoek het element Cloud Services beheren en klik op het potlood om de wolkenconfiguratie te wijzigen.
- Selecteer als berichtconfiguratie Amazon SNS Connection, Pushwoosh Connection of Adobe Mobile Services.
- Voer de providereigenschappen in en klik op Verzenden om deze op te slaan, en op Gereed. Zij worden in dit stadium niet op afstand gecontroleerd, behalve in het geval van AMS.
- U zou nu moeten zien config u enkel op de Manage Cloud Services tegel inging.
Stap 6: De app ontwikkelen en implementeren step-build-and-deploy-the-app
Opmerking: Raadpleeg ook onze instructies hier bij het ontwikkelen van PhoneGap-toepassingen.
Er zijn twee manieren om uw app te maken en te implementeren met PhoneGap.
Opmerking: Voor het testen van pushberichten zijn emulators niet voldoende omdat pushberichten een afzonderlijk protocol gebruiken tussen de pushprovider (Apple of Google) en het apparaat. De huidige Mac/PC-hardware en -emulators ondersteunen dit niet.
-
PhoneGap Build is een service die wordt aangeboden door PhoneGap en waarmee u uw app op de servers kunt maken en rechtstreeks naar het apparaat kunt downloaden. Zie de PhoneGap Build voor meer informatie over het instellen en gebruiken van PhoneGap Build.
-
PhoneGap-opdrachtregelinterface (CLI) laat u een rijke reeks bevelen PhoneGap op uw bevellijn gebruiken om uw app te bouwen, te zuiveren en op te stellen. Zie de documentatie voor PhoneGap-ontwikkelaars om te leren hoe u PhoneGap CLI instelt en gebruikt.
Stap 7: Een pushmelding verzenden step-send-a-push-notification
Voer de volgende stappen uit om een nieuw bericht te maken en te verzenden.
-
Een nieuwe melding maken
- Zoek in het dashboard van uw AEM Mobile-app de tegel Push Notifications.
- Kies "Maken" in het menu in de rechterbovenhoek. Merk op dat deze knoop niet beschikbaar zal zijn tot de wolkenconfig eerst wordt geplaatst.
- Voer in de wizard Melding maken een titel en een bericht in en klik vervolgens op de knop "Maken". Uw melding is nu klaar om direct of later te worden verzonden. Deze kan worden bewerkt en het bericht en/of de titel kan worden gewijzigd en opgeslagen.
-
Melding verzenden
- Zoek in het dashboard Apps naar de tegel Push Notifications.
- Selecteer de melding of klik op de knop Details rechtsonder (. . .), om de lijst met meldingen weer te geven. Deze lijst geeft ook aan of een melding klaar is om te worden verzonden, al is verzonden of dat er een fout is opgetreden tijdens het verzenden.
- Schakel het selectievakje voor één melding in (alleen) en klik op de knop Melding verzenden boven de lijst. U hebt één kans om het bericht te "annuleren" of "verzenden" in het dialoogvenster dat verschijnt.
-
De resultaten verwerken
-
Als de pushmeldingenservice (Amazon SNS of Pushwoosh) het verzendverzoek ontvangt, deze als geldig bevestigt en het naar de native providers (APNS en GCM) verzendt, wordt het verzenddialoogvenster zonder bericht gesloten. In de meldingslijst wordt de status van die melding vermeld als Verzonden.
-
Als het verzenden van de push-berichten mislukt, wordt in het dialoogvenster een bericht weergegeven dat het probleem aangeeft. In de meldingslijst wordt de status van die melding weergegeven als Fout, maar als het probleem is verholpen, kan de melding opnieuw worden verzonden. In het geval van een fout, zou de extra fouteninformatie in het logboek van de serverfout moeten verschijnen.
-
Er zijn enkele platformverschillen tussen iOS- en Android-pushberichten. Onder hen:
- De toepassing wordt gestart nadat deze is geïmplementeerd op Android en wordt gemaakt met CLI. In iOS moet u de toepassing handmatig starten. Aangezien de stap voor pushregistratie plaatsvindt bij het opstarten, kunnen Android-apps direct pushmeldingen ontvangen (omdat deze zijn gestart en geregistreerd), maar iOS-apps niet.
- Op Android staat de tekst van de knop OK in alle hoofdletters (en in alle andere knoppen die worden toegevoegd aan de melding in de app), maar in iOS niet.
-
Voor AMS-pushmeldingen moeten meldingen worden samengesteld en verzonden vanaf de AMS-server. AMS biedt extra mogelijkheden voor pushmeldingen naast die welke worden geboden door AEM meldingen met AWS en Pushwoosh.
Diepe koppeling met pushmeldingen configureren configuring-deep-linking-with-push-notifications
Wat is diep met elkaar verbonden? In de context van een pushmelding is het een manier om een app te openen of (indien geopend) naar een opgegeven locatie in de app te leiden.
Hoe werkt het? De auteur van een pushmelding voegt desgewenst een knoplabel toe (d.w.z. "Toon me!") naar de melding en kiest u de pagina die ze in de melding willen koppelen via een visuele padbrowser. Wanneer de drukknop wordt verzonden, gebeurt deze als normaal, behalve dat in het bericht in de app de knop OK wordt vervangen door de knop "Afwijzen" en de nieuwe knop wordt opgegeven ("Weergeven!") wordt ook weergegeven. Als u op de nieuwe knop klikt, gaat de app naar de opgegeven pagina in de app. Als u op Afwijzen klikt, wordt het bericht genegeerd.
Als de app niet is geopend, wordt de schaduw normaal weergegeven. Als u actie onderneemt op het bericht in de schaduw, wordt de app geopend en wordt de gebruiker de diepe koppelingsknoppen getoond op basis van wat is geconfigureerd in het pushbericht.
Maak het bericht, voeg een knoptekst en koppelingspad toe voor de optionele koppeling deep:
-
Klik op de bewerking in de rechterbovenhoek van het dialoogvenster Cloud Services beheren tegel.
-
Selecteer Pushwoosh-verbinding. Klik op Next.
-
Voer de details van de eigenschappen in en klik op Verzenden.
Als u uw configuratie verzendt, Pushmeldingen de tegelweergaven worden weergegeven in het dashboard.
Wizard Melding maken create-notification-wizard
Wanneer de Pushmeldingen de tegelvertoningen in uw dashboard, gebruiken creeer berichttovenaar om de inhoud toe te voegen:
-
Klik op het symbool Toevoegen in de rechterbovenhoek van het dialoogvenster Pushmeldingen tegel om de Wizard Melding maken.
-
Wanneer u op het bladerpictogram in het koppelingspad klikt, krijgt de gebruiker de inhoudstructuur van de app te zien.
Als u het pad hebt geselecteerd, klikt u op het vinkje.
note note NOTE De tekst van de Knoop van de Verbinding is beperkt tot 20 karakters. Als de eindgebruiker niet over de nieuwste versie van de toepassing beschikt en het gekoppelde pad niet beschikbaar is, wordt de gebruiker door de actie van de diepe koppeling te bevestigen naar de hoofdpagina van de app gebracht. -
Voer de Tekstdetails in de Wizard Melding maken en klik op Maken.
Open de details door te klikken op het pushbericht dat u hebt gemaakt in het dialoogvenster Pushmeldingen tegel.
U kunt eigenschappen bewerken, meldingen verzenden of de melding verwijderen.
De volgende stappen the-next-steps
Als u de details van pushberichten voor uw app begrijpt, raadpleegt u Aanpassing van AEM Mobile-inhoud.