AEM Mobile-inhoud aanpassen aem-mobile-content-personalization
Met de AEM Mobile-functie voor inhoudpersonalisatie kunt u AEM-auteurs om inhoud van mobiele apps aan te passen door Adobe Target. Hierdoor kunnen gebruikers van mobiele toepassingen gerichte aanbiedingen ontvangen. Adobe Experience Manager Mobile biedt de mogelijkheid om inhoud te maken, als doel in te stellen en te leveren die de gebruiker inhoud biedt die specifiek is voor zijn of haar eigen smaak.
Zoals vaak het geval AEM, moeten beheerders en ontwikkelaars eerst de omgeving voorbereiden voordat auteurs deze inhoud kunnen gaan maken.
AEM zijn vereist voor het tot stand brengen van een verbinding tussen AEM Mobile en de Cloud Service van Adobe Target.
Ondertussen AEM Mobile ontwikkelaars moeten hun bestaande scripts aanpassen om het schrijven van doelgerichte inhoud te vergemakkelijken.
Voor beheerders for-administrators
Er zijn een aantal stappen die moeten worden samengevoegd voordat auteurs van inhoud gerichte inhoud kunnen gaan genereren voor mobiele apps: Er is de juiste set machtigingen voor gebruikers en groepen, het maken van cloudservices, het configureren van de toepassing voor de activiteit en het genereren van de inhoud.
Dit artikel zal u door het proces begeleiden dat wordt gebruikt om te vormen AEM Mobile Hybride Reference Application voor doelwitten.
De aanname is dat de Hybride Reference Application van AEM Mobile met succes is geïmplementeerd en toegankelijk via het AEM Mobile-dashboard.
Voordat auteurs doelinhoud binnen een toepassing kunnen genereren, moet uw AEM instantie geconfigureerd met de Adobe Target Cloud Service.
Machtigingen permissions
Gebruikers die toegang tot de personalisatieconsole nodig hebben, moeten deel uitmaken van de target-activity-authors
groep.
Voorgesteld wordt dat als onderdeel van de gebruikersinstellingen en groepsinstellingen de doelgroep-activiteit-groep moet worden toegevoegd aan de groep met apps-beheerders. Door de doel-activiteit-auteursgroep toe te voegen zal dit gebruikers capaciteit toestaan om de ingang van het menu van de Navigatie van de Aanpassing te zien.
Cloud Services cloud-services
Om gerichte inhoud te krijgen die voor mobiele toepassingen werkt zijn er twee diensten die moeten worden gevormd: De Adobe Target Service en de Adobe Mobile Services-service. De Adobe Target Service biedt de engine voor het verwerken van clientverzoeken en het retourneren van gepersonaliseerde inhoud. De service Adobe Mobile Services biedt de verbinding tussen de Adobe-services en de mobiele toepassing via het bestand ADBMobileConfig.json dat wordt gebruikt door de AMS Cordova-plug-in. Via het AEM Mobile-dashboard kunt u uw toepassing configureren door de twee services toe te voegen.
Zoek op het AEM Mobile-dashboard de Cloud Services Beheren en klik op +.
Selecteer de "Adobe Target"-cloudservicekaart van de wizard Cloud Service toevoegen en klik op Volgende.
Van Uitgezocht een drop-down van de Configuratie kunt u of een nieuwe configuratie tot stand brengen of van bestaande selecteren. Om een nieuwe configuratie tot stand te brengen selecteer "tot Configuratie"van dropdown. Ga een titel voor de configuratie van het Doel in. Voer uw clientcode, e-mail en wachtwoord in die aan uw doelaccount zijn gekoppeld. Als u de waarden voor deze velden niet weet, neemt u contact op met de Adobe Target-ondersteuning. Klik op de knop "Verifiëren" om de referenties te valideren. Zodra geverifieerd, klik de Submit knoop om de wolkendienst tot stand te brengen.
Na voltooiing van de tovenaar zal de Manage Cloud Service tegel de de wolkendienst van het Doel bevatten, nochtans bevat het een waarschuwing over een ontbrekende rekening van de Dienst van Adobe Mobile.
Adobe mobiele services adobe-mobile-services
Het is noodzakelijk om een Adobe Mobile Services (AMS)-account ook aan de toepassing te koppelen, biedt de AMS-service het vereiste ADBMobileConfig.json-bestand dat de informatie over de doelclientcode bevat. Voordat u een koppeling met de AMS-account maakt, moet de AMS-account worden gewijzigd door een gebruiker die machtigingen voor AMS heeft.
Clientcode client-code
Als u zich wilt aanmelden bij de AMS-services gaat u naar https://mobilemarketing.adobe.comselecteert u de mobiele toepassing en klikt u op de instellingen. Zoek het veld SDK-doelopties en plaats de clientcode in het veld en klik op Opslaan.
Nu de clientcode aan de mobiele toepassing is gekoppeld, worden de instellingen voor de service-instellingen via het bestand ADBMobileConfig.json geleverd wanneer de AMS-cloudservice via het dashboard Adobe Mobile is geconfigureerd.
Adobe Mobile Service Cloud Service adobe-mobile-service-cloud-service
Nu AMS is geconfigureerd, is het tijd om de mobiele toepassing te koppelen aan het dashboard voor mobiele Adobe. Zoek op het AEM Mobile-dashboard de Cloud Services Beheren en klik op +.
Selecteer de Adobe Mobile Services-kaart en klik op Volgende.
Selecteer in de stap Maken of Selecteren van de wizard het vervolgkeuzemenu Mobiele service en selecteer de vermelding Configuratie maken. Geef een titel, bedrijf, gebruikersnaam en wachtwoord op en selecteer het juiste datacenter. Als u deze waarden niet kent, neemt u contact op met de beheerder van de Adobe Mobile-service om deze te verkrijgen. Klik op de knop Verifiëren als alle velden zijn ingevuld. Het verificatieproces gaat naar AMS en verifieert de referenties voor de account. Na een geslaagde validatie wordt een lijst met mobiele toepassingen gevuld. Hierin selecteert u de bijbehorende mobiele toepassing in het vervolgkeuzemenu. Klik op de knop Verzenden om de wizard te voltooien. Het proces kan enige tijd duren om de configuratiegegevens en eventuele bijbehorende analyses voor de toepassing te verkrijgen. Als het proces is voltooid, klikt u op de knop Gereed van het modaal om terug te keren naar het mobiele dashboard van Adobe.
Als u terugkeert naar het mobiele dashboard, bevat de titel Cloud Services beheren de AMS-cloudservice. U zult ook opmerken dat de Analyze de tegel van Metriek met levenscyclusrapporten zal worden bevolkt.
Voor auteurs for-authors
Vereiste: Zoals hierboven vermeld, moeten beheerders de verbinding met de Adobe Target Service configureren voordat auteurs nieuwe, doelinhoud kunnen genereren.
Nadat de beheerder de twee cloudservices heeft geconfigureerd en de ontwikkelaar de handler mobileappoffers heeft geconfigureerd, kunnen auteurs van inhoud nu gerichte ervaringen genereren.
Voor het ontwerpen van doelgerichte inhoud in een AEM Mobile-app wordt een vergelijkbare procedure gevolgd als voor het ontwerpen van AEM Sites:
Hier vindt u een volledig overzicht van Doelinhoud ontwerpen in AEM
Voor ontwikkelaars for-developers
AEM ontwikkelaars die mobiele toepassingen bouwen zouden de patronen moeten blijven volgen die algemeen tijdens AEM worden gebruikt wanneer het ontwikkelen van componenten. Hier volgen de stappen die nodig zijn om auteurs van inhoud in staat te stellen doelgerichte inhoud te maken:
Adobe Target ContentSync Handlers adobe-target-contentsync-handlers
Om inhoud aan de het apparateninhoud van de gebruiker te leveren wordt geproduceerd door de aanbiedingen terug te geven die door AEM inhoudsauteurs worden gecreeerd. Voor het afhandelen van de rendering van doelaanbiedingen is er een nieuwe handler voor inhoudssynchronisatie die de aanbiedingen verwerkt. Als u de Hybride Reference Application als voorbeeld gebruikt, bevat het en-inhoudspakket (english) de ContentSyncConfig met een mobileappoffers handler. De volgende stap is van cruciaal belang voor het renderen van aanbiedingen voor het apparaat. De handler mobileappoffers heeft een padeigenschap die het pad naar de personalisatieactiviteit aangeeft die voor de toepassing moet worden gebruikt.
Als er bijvoorbeeld een activiteit is die zich bevindt op /content/campagnes/hybridref Kopieer dit pad en plak het als de waarde voor de pad eigenschap van de handler mobileappoffers.
Zodra de activiteitenweg in het de wegbezit van de mobileappoffers manager is geplaatst sparen de manager. De handler is nu gereed om de renderingaanbiedingen voor onze mobiele apparaten te starten.
Rendermodus render-mode
De handler mobileappoffers is anders geconfigureerd voor publicatie- en ontwikkelinstellingen. Voor publicatie-instellingen wordt een eigenschap aangeroepen renderMode met een waarde van publish ingesteld op de cq:ContentSyncConfig-node. De handler mobileappoffers verwijst naar de renderMode en zal, indien ingesteld op publiceren, de id van het mbox wijzigen die wordt gemaakt. Standaard wordt in vakken die AEM maakt, een waarde —auteur toegevoegd aan de id van het mbox. Hieruit blijkt dat de activiteit niet is gepubliceerd en de niet-gepubliceerde campagne voor het indienen van voorstellen moet gebruiken.
Wanneer inhoud wordt gefaseerd via het mobiele dashboard van Adobe, wordt gefaseerde inhoud beschouwd als inhoud die klaar is voor productie en wordt deze weergegeven via de niet-dev Content Sync Config. Als u deze manier weergeeft, wordt de auteur —verwijderd van alle id's van het selectievakje en wordt verwacht dat een gepubliceerde activiteit beschikbaar is op de doelserver. Controleer voordat u inhoud met werkgebied test of de activiteit is gepubliceerd.
Ontwikkeling van apps voor persoonlijke instellingen personalization-app-development
Onderdelen components
De basis voor om het even welke inhoud is typisch een paginacomponent die of één van de basis AEM paginacomponenten wcm/stichting/componenten/pagina uitbreidt afhankelijk van als u HTML of JSPs gebruikt. De duur van deze stappen zal zich op het gebruiken van wcm/stichting/componenten/paginacomponent concentreren. De basisstructuur van de paginacomponent wordt onderverdeeld in veelvoudige manuscripten, waarbij elk manuscript het specifieke doel verstrekt om de ontwikkelaar toe te staan om hun code te organiseren en met voeten te treden indien nodig. De twee manuscripten die voor Personalisatie van belang zijn zijn head.html en body.html. Deze twee manuscripten verstrekken een gebied waar de code kan worden ingespoten om de Hub van de Context, Cloud Services, en Mobiele authoring te steunen.
Hier volgt een overzicht van de twee primaire scripts die worden gebruikt om het aanwijzen van inhoud mogelijk te maken.
head.html head-html
Om de auteur de capaciteit te verstrekken om hun inhoud te richten moet het doelmenu aan de pagina worden toegevoegd zodat de auteur context van uitgeeft wijze aan het richten wijze kan veranderen. Om deze eigenschap toe te laten, zou de ontwikkelaar het head.html manuscript moeten wijzigen om het volgende codefragment dichtbij de bovenkant van head.html of zo dicht bij te omvatten <title></title> element zo mogelijk.
<meta data-sly-test="${!wcmmode.disabled}">
<div data-sly-call="${clientLib.all @ categories='personalization.kernel'}" data-sly-unwrap></div>
<div data-sly-resource="${'config' @ resourceType='cq/personalization/components/clientcontext_optimized/config'}" data-sly-unwrap></div>
<div data-sly-resource="${'contexthub' @ resourceType='granite/contexthub/components/contexthub'}" data-sly-unwrap></div>
</meta>
Om auteurs de mogelijkheid te bieden de beoogde inhoud voor te vertonen, moet de editor de configuratie van de Adobe Target-cloudservice kunnen vinden. In het codeblok hieronder worden twee belangrijke scripts toegevoegd. De eerste die de capaciteit voor de pagina toevoegt om van de bijbehorende de wolkendienst van het Doel de plaats te bepalen en de vraag te maken aan Adobe Target. De tweede is de toevoeging van de categorie cq.apps.targeting.
De cq.apps.targeting de categorie overschrijft de standaard-cq/personalization/component/target-component en gebruikt de mobiele apps/componenten/doelcomponent die aanbiedingen specifiek voor mobiel toepassingsverbruik rendert. Meer details van dit zullen in de sectie van de Component van het Doel worden besproken.
De code moet worden toegevoegd in head.html en vlak voor het einde van het dialoogvenster </head> element.
<div data-sly-test="${!wcmmode.disabled}">
<div data-sly-include="/libs/cq/cloudserviceconfigs/components/servicelibs/servicelibs.jsp" data-sly-unwrap></div>
<meta data-sly-call="${clientLib.all @ categories='cq.apps.targeting'}" data-sly-unwrap></meta>
</div>
body.html body-html
Om de auteur van de inhoud toe te laten de capaciteit om verschillende karakters te testen het body.html manuscript moet het volgende codeblok als eerste kind van het lichaamselement omvatten.
<div data-sly-test="${!wcmmode.disabled}">
<div data-sly-resource="${'clientcontext' @ resourceType='cq/personalization/components/clientcontext_optimized'}" data-sly-unwrap></div>
</div>
Het laatste vereiste beetje van code is bij de zeer bodem van body.html. Met deze code wordt gezocht naar de bijbehorende cloudservice en wordt de juiste code voor de doelengine geïnjecteerd.
<div data-sly-test="${!wcmmode.disabled}">
<div data-sly-resource="${'cloudservices' @ resourceType='cq/cloudserviceconfigs/components/servicecomponents'}" data-sly-unwrap></div>
</div>
Referentietoepassing reference-application
Voorbeelden van head.html en body.html vindt u in het gedeelte AEM Mobile Hybride Reference Application het tonen van de ontwikkelaar waar te om de manuscriptblokken binnen de twee manuscripten te plaatsen.
Handlers voor inhoudssynchronisatie content-sync-handlers
Wanneer de auteur van de inhoud klaar is met het maken van inhoud voor de mobiele toepassing, bestaat de volgende stap uit het downloaden van de bron en het bouwen van de toepassing, of het plaatsen van de te publiceren inhoud. Er zijn een aantal stappen waarbij de ontwikkelaar betrokken is om dit te bewerkstelligen. AEM Mobile gebruikt voor het renderen van de inhoud contentsync-handlers om de inhoud te renderen en in te pakken. Er is een nieuwe handler voor inhoudssynchronisatie geïntroduceerd voor het gebruik van Aanpassing voor het renderen van doelinhoud. De handler 'mobileappoffers' weet hoe de gekoppelde doelaanbiedingen die door de auteur van de inhoud zijn gemaakt, moeten worden weergegeven. De handler mobileappoffers breidt de abstracte update-handler voor pagina's daarom uit. Veel eigenschappen zijn vergelijkbaar. De details van de handler mobileappoffers hebben de volgende eigenschappen.
Doelcomponent target-component
AEM Mobile gebruikt de mobiele apps/componenten/doelcomponent om inhoud specifiek voor mobiele toepassingen te renderen. De mobiele doelcomponent breidt de cq/personalization/components/target component uit en overschrijft het script engine_tnt.jsp. Door de engine_tnt.jsp te overschrijven, kan AEM Mobile de gegenereerde HTML voor het gebruik van mobiele apps besturen. Voor elke component die door een inhoudauteur wordt gericht, wordt een bijbehorende mbox gecreeerd door engine_tnt.jsp.
Voor elke box een kenmerk van cq-gericht toegevoegd, zodat ontwikkelaars van toepassingen aangepaste code kunnen schrijven die ze kunnen gebruiken. De AEM Mobile Hybride Reference App heeft een voorbeeld van een richtlijn van de Angular die het cq-richten attribuut gebruikt. Het concept van contentvervanging wanneer en hoe dit gebeurt, is in hoge mate aan de ontwikkelaar van de mobiele toepassing. Er is een Mobile SDK die via AEM /etc/clientlibs/mobileapps/js/mobileapps.js wordt geleverd die API verstrekt om de Adobe het richten dienst te roepen. Het is aan de toepassingsontwikkelaar om te specificeren wanneer die vraag volgens het ontwerp van hun toepassing zou moeten worden gemaakt.