AEM Mobile innehållspersonalisering aem-mobile-content-personalization
Med funktionen för innehållspersonalisering i AEM Mobile kan AEM författare anpassa mobilappsinnehåll med Adobe Target. Detta gör att man kan leverera riktade erbjudanden till användare av mobilappar. Adobe Experience Manager Mobile ger möjlighet att skapa, målinrikta och leverera innehåll som ger användaren innehåll som är specifikt för den egna smaken.
I AEM måste administratörer och utvecklare först förbereda miljön för att kunna börja skapa det här innehållet.
AEM administratörer krävs för att upprätta en anslutning mellan AEM Mobile och Adobe Target Cloud Service.
Under tiden måste AEM Mobile utvecklare redigera sina befintliga skript för att underlätta framtagning av riktat innehåll.
För administratörer for-administrators
Det finns flera steg som måste utföras innan innehållsförfattare kan börja generera riktat innehåll för mobilappar: rätt uppsättning behörigheter för användare och grupper hämtas, molntjänster skapas, programmet konfigureras för aktiviteten konfigureras och innehållet slutligen genereras.
I den här artikeln får du hjälp med hur du konfigurerar AEM Mobile Hybrid Reference Application för målinriktning.
Det förutsätts att AEM Mobile Hybrid Reference Application har distribuerats och är tillgängligt via AEM Mobile Dashboard.
Innan författare kan generera riktat innehåll i ett program måste din AEM vara konfigurerad med Adobe Target-Cloud Servicen.
Behörigheter permissions
Användare som behöver åtkomst till personaliseringskonsolen måste ingå i gruppen target-activity-authors.
Som en del av användar- och gruppinställningarna bör målaktivitetsgruppen läggas till i gruppen som administrerar program. Genom att lägga till gruppen target-activity-authors kan användarna se menyposten i Personalization.
Cloud Service cloud-services
För att få målinriktat innehåll att fungera för mobilprogram finns det två tjänster som måste konfigureras: Adobe Target-tjänsten och Adobe-tjänsten för mobiltjänster. Adobe Target-tjänsten tillhandahåller motorn för bearbetning av klientförfrågningar och returnering av det anpassade innehållet. Tjänsten Adobe Mobile Services tillhandahåller anslutningen mellan Adobes tjänster och mobilprogrammet via filen ADBMomobileConfig.json som används av plugin-programmet AMS Cordova. Från AEM Mobile Dashboard kan du konfigurera programmet genom att lägga till de två tjänsterna.
Gå till Cloud Servicen Hantera på AEM Mobile Dashboard och klicka på plusknappen (+).
I guiden Lägg till Cloud Service väljer du molntjänstkortet"Adobe Target" och klickar på Nästa.
I listrutan Välj en konfiguration kan du antingen skapa en konfiguration eller välja en befintlig konfiguration. Om du vill skapa en konfiguration väljer du Skapa konfiguration i listrutan. Ange en rubrik för målkonfigurationen. Ange klientkod, e-postadress och lösenord som är kopplade till ditt Target-konto. Om du inte känner till värdena för dessa fält kan du kontakta Adobe Target support. Klicka på Verifiera för att validera inloggningsuppgifterna. Klicka på knappen Skicka för att skapa molntjänsten.
När guiden har slutförts innehåller rutan Hantera Cloud Service molntjänsten Target. Det innehåller dock en varning om att ett Adobe-mobiltjänstkonto saknas.
Adobe Mobile Services adobe-mobile-services
Det är också nödvändigt att länka ett AMS-konto (Adobe Mobile Services) till programmet. AMS-tjänsten tillhandahåller den ADBMobleConfig.json-fil som krävs och som innehåller målklientens kodinformation. Innan du skapar en association med AMS-kontot måste AMS-kontot ändras av en användare som har behörighet till AMS.
Klientkod client-code
Om du vill logga in på AMS-tjänsterna går du till https://mobilemarketing.adobe.com, markerar mobilprogrammet och klickar på inställningarna. Leta reda på fältet SDK-målalternativ, placera klientkoden i fältet och klicka på Spara.
När nu klientkoden har kopplats till mobilprogrammet levereras inställningarna för tjänsten via ADBMobilConfig.json-filen när AMS-molntjänsten har konfigurerats via Adobe Mobile Dashboard.
Adobe Mobile Service Cloud Service adobe-mobile-service-cloud-service
Nu när AMS har konfigurerats är det dags att associera mobilappen i kontrollpanelen för mobiler i Adobe. Gå till Cloud Servicen Hantera på AEM Mobile Dashboard och klicka på plusknappen (+).
Markera Adobe Mobile Services-kortet och klicka på Next.
Välj listrutan Mobiltjänst i steget Skapa eller Välj guide och välj posten Skapa konfiguration. Ange titel, företag, användarnamn, lösenord och välj lämpligt datacenter. Om du inte känner till de här värdena kontaktar du Adobe-administratören för mobiltjänsten för att få dem. När alla fält har fyllts i klickar du på Verifiera. Verifieringsprocessen går till AMS och verifierar kontots inloggningsuppgifter. När verifieringen är klar fylls en lista över mobilprogram i där du väljer det associerade mobilprogrammet i listrutan. Klicka på Skicka för att slutföra guiden. Det kan ta en stund att hämta konfigurationsdata och associerade analyser till programmet. När processen är klar klickar du på Klar för att gå tillbaka till instrumentpanelen för Adobe Mobile.
Återgår till Mobile Dashboard och rutan Hantera Cloud Service innehåller AMS-molntjänsten. Dessutom innehåller rutan Analyze Metrics (Analysera mätvärden) livscykelrapporter.
För författare for-authors
Krav: Som nämnts ovan måste administratörer konfigurera anslutningen till Adobe Target-tjänsten innan författare kan generera nytt riktat innehåll.
När administratören har konfigurerat de två molntjänsterna och utvecklaren har konfigurerat hanteraren för mobilappserbjudanden kan innehållsförfattare nu börja generera målinriktade upplevelser.
När du redigerar riktat innehåll i en AEM Mobile-app följer du en liknande procedur som när du skapar AEM Sites:
Här finns en fullständig översikt över Redigering av riktat innehåll i AEM
För utvecklare for-developers
AEM utvecklare som skapar mobilapplikationer bör fortsätta att följa de mönster som ofta används AEM under utvecklingen av komponenter. Här går Adobe igenom de steg som krävs för att innehållsförfattare ska kunna skapa riktat innehåll:
Adobe Target ContentSync-hanterare adobe-target-contentsync-handlers
För att leverera innehåll till användarens enhet genereras innehållet genom att de erbjudanden som skapas av AEM återges. För att hantera återgivningen av målerbjudanden finns det en ny hanterare för innehållssynkronisering som bearbetar erbjudandena. Med Hybrid Reference Application som exempel innehåller det engelska (engelska) innehållspaketet ContentSyncConfig med en mobileappoffers -hanterare. Nästa steg är avgörande för att återge erbjudanden till enheten. Hanteraren för mobileappoffers har en path-egenskap som identifierar sökvägen till den personaliseringsaktivitet som ska användas för programmet.
Om det till exempel finns en aktivitet på /content/campaign/hybridref kopierar du den här sökvägen och klistrar in den som värdet för egenskapen path i hanteraren för mobileappoffers.
När aktivitetssökvägen har angetts i mobileappoffers-hanterarens path-egenskap sparar du hanteraren. Hanteraren är nu redo att börja återge erbjudanden för mobila enheter.
Återgivningsläge render-mode
Hanteraren för mobileappoffers är annorlunda konfigurerad för publicerings- och utvecklingsinställningar. För publiceringsinställningar finns egenskapen renderMode med värdet publish inställt på cq:ContentSyncConfig-noden. Hanteraren mobileappoffers refererar till renderMode och redigerar, om den är inställd på publicering, det mbox-id som skapas. Som standard har rutor som skapas av AEM ett —author-värde tillagt till mbox-ID:t. Detta identifierar att aktiviteten inte har publicerats och bör använda den opublicerade kampanjen för erbjudandelösningar.
När innehåll mellanlagras via Adobe Mobile Dashboard betraktas mellanlagrat innehåll som produktionsklart innehåll och återges via den icke-dev-konfiguration för innehållssynkronisering. Om du återger på det här sättet tas —author bort från alla mbox-ID:n och en publicerad aktivitet förväntas bli tillgänglig på målservern. Innan du testar mellanlagrat innehåll måste du kontrollera att aktiviteten redan är publicerad.
Personalization App Development personalization-app-development
Komponenter components
Grunden för allt innehåll är vanligtvis en sidkomponent som utökar någon av de grundläggande AEM sidkomponenterna wcm/foundation/components/page eller foundation/components/page beroende på om du använder HTML eller JSP. Längden på de här stegen fokuserar på att använda komponenten wcm/foundation/components/page. Den grundläggande strukturen för sidkomponenten bryts ned i flera skript, där varje skript har det specifika syftet att låta utvecklaren ordna och åsidosätta koden om det behövs. De två skripten som är intressanta för Personalization är head.html och body.html. De här två skripten utgör ett område där kod kan injiceras för att ge stöd åt kontextnavet, Cloud Servicen och mobilutveckling.
Här är en översikt över de två primära skripten som används för att aktivera målinriktning av innehåll.
head.html head-html
För att författaren ska kunna ange sitt innehåll som mål måste målmenyn läggas till på sidan så att författaren kan ändra sammanhanget från redigeringsläge till målinriktningsläge. Om du vill aktivera den här funktionen bör utvecklaren ändra head.html-skriptet så att det innehåller följande kodfragment i närheten av head.html eller så nära <title></title>-elementet som möjligt.
<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>
För att författarna ska kunna förhandsgranska målinnehållet måste redigeraren kunna hitta konfigurationen för Adobe Target molntjänst. Kodblocket nedan lägger till två viktiga skript. Först lägger du till möjligheten för sidan att hitta den associerade molntjänsten Target och ringa samtal till Adobe Target. Den andra är tillägget för kategorin cq.apps.targeting.
Kategorin cq.apps.targeting åsidosätter standardkomponenten cq/personalization/component/target och använder den mobileapps/components/target-komponent som renderar erbjudanden specifikt för användning i mobilprogram. Mer information om detta finns under Målkomponent.
Koden ska läggas till i head.html och placeras precis före slutet av </head>-elementet.
<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
För att innehållsförfattaren ska kunna testa olika profiler måste skriptet body.html innehålla följande kodblock som det första underordnade elementet i body-elementet.
<div data-sly-test="${!wcmmode.disabled}">
<div data-sly-resource="${'clientcontext' @ resourceType='cq/personalization/components/clientcontext_optimized'}" data-sly-unwrap></div>
</div>
Den sista biten av koden som krävs finns längst ned i body.html. Den här kodbiten söker efter den associerade molntjänsten och injicerar lämplig målmotorkod.
<div data-sly-test="${!wcmmode.disabled}">
<div data-sly-resource="${'cloudservices' @ resourceType='cq/cloudserviceconfigs/components/servicecomponents'}" data-sly-unwrap></div>
</div>
Referensprogram reference-application
Exempel på head.html och body.html finns i AEM Mobile Hybrid Reference Application som visar var utvecklaren ska placera skriptblocken i de två skripten.
Hanterare för innehållssynkronisering content-sync-handlers
När innehållsförfattaren är klar med att skapa innehåll för mobilprogrammet är nästa steg att hämta källan och skapa programmet, eller att mellanlagra innehållet som ska publiceras. Det finns flera steg som utvecklaren är involverad i för att detta ska hända. AEM Mobile använder Content sync-hanterare för att återge och paketera innehållet, vilket underlättar återgivningen av innehållet. En ny hanterare för innehållssynkronisering har introducerats för att återge riktat innehåll i Personalization-användningsexemplet. Hanteraren mobileappoffers vet hur man återger associerade målerbjudanden som har skapats av innehållsförfattaren. Hanteraren för mobileappoffers utökar uppdateringshanteraren för abstrakta sidor, därför liknar många av egenskaperna. Information om hanteraren för mobileappoffers har följande egenskaper.
Målkomponent target-component
För att hjälpa till att återge innehåll specifikt för mobilprogram använder AEM Mobile mobilapparna/komponenterna/målkomponenten. Den mobila målkomponenten utökar cq/personalization/components/target-komponenten och åsidosätter skriptet engine_tnt.jsp. Genom att åsidosätta engine_tnt.jsp kan AEM Mobile styra det genererade HTML för mobilapparnas användningsfall. För varje komponent som har en innehållsförfattare som mål skapas en associerad mbox av engine_tnt.jsp.
För varje mbox läggs attributet cq-targeting till, vilket gör att programutvecklare kan skriva egen kod som ska användas hur de vill. AEM Mobile Hybrid Reference App har ett exempel på ett Angular-direktiv som använder attributet cq-targeting. Det är upp till utvecklaren av mobilapplikationer som bestämmer när och hur innehållet ska ersättas. Det finns en mobil-SDK som levereras via AEM /etc/clientlibs/mobileapps/js/mobileapps.js som tillhandahåller ett API för att anropa tjänsten Adobe Targeting. Det är programutvecklaren som bestämmer när anropet ska göras enligt utformningen av programmet.