Friday, 1 December 2017

Looking for an AEM Mobile App developer or development partner?

Adobe Experience Manager Mobile(AEMM) is a new comer in Adobe Marketing Cloud & having its own share in mobile app market. We need potential  to implement a fully functional AEMM application which utilizes all capabilities. In addition to this, a successful creative team plays an integral part of providing a seamless user experience(UX Designs) across screens on mobile application. An effective development and creative team together can deliver a powerful mobile application.

What we offer as services as part of AEM Mobile app development

Our AEMM Developers does
•    Migration of other apps to AEM Mobile.
•    Integrating AEM content with AEM Mobile articles.
•    Creation of .articles through various HTML elements including Angular JS.
•    Personalized content utilizing the AEM Mobile entitlement features.
•    A unified On-Demand portal dash board integration for authoring.
•    Integration which are allowed by AEM Mobile technology like Login functionality (SAML 2.0, OAuth 2.0, Generic).
•    Customizing the app based on multi-platform Apache Cordova (open source using HTML5, and JavaScript) development.
•    Adobe cloud integration like Analytics and Campaign. Analytics helps to improve the app usage in more efficient way and campaigns help for promoting customer preferences to users.
•    A fully functional AEMM search implementation.
•    Integrated Hybrid Mobile Apps with Adobe analytics tools.
•    Integrated Hybrid Mobile Apps with AEM Content.
•    Our expert creative engineers design screens which are efficient, engagement friendly.

Our AEMM related Maintenance & Support activities includes
•    Authoring and migrations.
•    Account administration and management.
•    Managing Adobe Analytics, marketing campaigns etc.
•    Social sharing setup, management.
•    Custom extensible Cordova development.

Contact us for partnering with us.
'cqguru@gmail.com'

Read the blog here : http://aem-mobile.blogspot.in/


Monday, 7 August 2017

Difference between Adobe Experience Manager Mobile(AEM Mobile) and PhoneGap.

AEM Mobile Vs PhoneGap.
Technical clients come up with a common question, what is the difference between AEM Mobile and PhoneGap?

Adobe PhoneGap is a powerful opensource platform for creating and publishing multi-platform mobile apps. Web technologies like HTML and CSS are used to build apps which are wrapped in a native app wrapper.

AEM Mobile is one of the new entrant in mobile technology which enables enterprise organizations to produce, manage and maintain their mobile apps through a unified dashboard, which in turn reducing time to market and making it easier for organizations to engage audiences quicker. AEM Mobile collaborates PhoneGap Enterprise and Adobe Digital Publishing Suite with AEM Apps to make an app which changes an enterprise customers essential for the business.

Differences:

PhoneGap

  • Need web development skills like HTML,CSS, Javascript.
  • Opensource. So great community support.
  • PhoneGap supports quick test and preview of the changes on iOS and Andriod.
  • With PhoneGap, we need to do some HTML / JavaScript / CSS coding to design and build an app that works on any platform.
  • Phonegap supports third party data integrations.
  • PhoneGap Build service can be utilised by AEM Mobile for quicker app installation/updates.


AEM Mobile

  • No need of web development skills to work on basic AEM Mobile apps.
  • AEM Mobile is licensed, with Adobe community support available.
  • Using AEM Mobile, we can build an app from scratch without any coding and have it on devices in a minutes with less effort.
  • AEM Mobile once built, helps to add content to the app without rebuilding, and many build options like iOS, Android, Windows, or the Web available.
  • AEM Mobile helps even a non IT person to create content with existing or new data through template-based authoring.
  • AEM Mobile provides a dashboard to manage various operations of an app.
  • AEM Mobile helps to develop and deliver apps for iOS and Android quickly compared to other technologies.
  • AEM Mobile has power to extend some of the most used Cordova Plugins to include in the app; also new plugins are easy to create.
  • AEM Mobile provides option to instant update of apps and its content.
  • AEM Mobile can be easily connected to other Adobe cloud tools like analytics, Test and Target.
  • AEM Mobile provides API support to integrate third party applications like login, authentication etc.

Both
Both PhoneGap and AEM Mobile supports Apache Cordova plug-ins to access native device APIs such as GPS, camera, contacts etc. AEM Authored data can be pulled to PhoneGap and AEM Mobile by configuring.

Friday, 28 April 2017

AEM Mobile app with PhoneGap

AEM Mobile app with PhoneGap


An app in AEM is commonly divided into two parts.

  • 'shell'
  • 'content'

Shell: The shell in high level is all the non-AEM authored content of a Hybrid(cross platform) PhoneGap app built by the app developer.
The 'shell' is a part which has the static parts of the app; Real world examples could be PhoneGap configuration files, the navigation controls, and the app framework. Any content of the archive that we import are stored as part of the shell.

Content:
Content includes the components, templates and authored pages that are authored in AEM built by the AEM Developer. Content is categorized as either developer content or as authored content.
Developer Content: Designs, page templates, and components are considered to be dev content since they are built by a developer.
Author Content: Pages that are built using the design, components and templates are referred as author content.

Generic Phone gap CRX site structre is given below



What are the general difference between Phonegap, Cordova, Ionic Framework, React Native?

Phonegap / Apache Cordova is a framework for developing hybrid mobile application using HTML5 and JavaScript.
Ionic that uses apache cordova (phonegap) for accessing mobile hardware (api) such as camera, contacts, Accelerometer, Vibration and more.
Ionic comes with Angular, which has a beautiful UI Components for mobile applications.
Ionic Framework is a framework functions based on Cordova, comes with a set of standard controls that has power of native controls.
To be complete, NativeScript and React Native are cross platform development environments that feel somewhat like hybrid, in that they use web frameworks or view layers (Angular 2 and React), but they don't rely on a WebView, and are therefore native approaches that simply rely on JavaScript instead of the native language on each platform.

Wednesday, 22 March 2017

Parameters involved in Sign In and Login Scripts

Parameters involved in Sign In and Login Scripts

In previous post we have given the details of Generic Identity Sign In. Here we will give details on parameters involved in Sign in with the sample script which helps login functionality.




  •  redirectUrl – the callback URL that the sign-in UI will need to use to redirect the user to the app based on successful or failure login.
  •  projectId – project ID mentioned in On-Demand portal  
  •  appId – the app bundle ID mentioned in projects ettings
  •  appVersion – the version of the Runtime app
  •  uuid – application running device's UUID  


 In the device we need to get the redirectUri, so that we can redirect the user to app home page on login. Below code retrieves the redirectUri and saves it in appData.

 Code to get redirect URL
    var urlParam = window.location.search.substring(1);
    urlParam = decodeURIComponent(urlParam);
    var appData = {};
    if (urlParam !== '') { // fail-safe
         var param, paramList = urlParam.split('&');
         for (var index in paramList)
        {
         param = paramList[index].split('=');  
         if (param.length === 2)
          { // fail-safe  
          appData[param[0]] = param[1];
          }
        }
    }
 
 
  Code for redirect:
 
    function login() {
    //Use a call to your db and check user credentials are valid. If it is success set the user values to a property called 'uservalues'
    function success(uservalues) {
    var authToken = JSON.stringify(uservalues);    // uservalues which is a collection of information to a specific user
    window.location = appData.redirectUri + '?authToken=' + authToken;
        else{
        window.location = appData.redirectUri + '?error="Internal Error"';
        }
    }
 
    Related Posts:
AEM Mobile integration with third party applications
AEMM: How to create custom authentication

Setting up custom analytics in AEM Mobile

Setting up custom analytics in AEM Mobile:

Custom analytics works based on the events transferred during page load/application launches. AEM Mobile apps can be configured to read custom events and send data to Analytics as per our needs.  For eg: AEM Mobile analytics provides the 'count of article views' by default. But it does not provide 'user specific article view' in analytics.

We need to define the custom events through Mobile Marketing Dashboard and its processing rules. Once this is done, we can send these pre-configured custom analytics events from within our AEM Mobile HTML content.

Below diagram shows an over view of custom analytics in AEM Mobile



Basic requirements:

1). License for Mobile Marketing SDK(Part of Digital Marketing Cloud).

2). The user who configures the custom analytics events must be an admin for the report suite in Adobe Analytics (with process rule edit permission).

3). The articles which are sending custom events must be pre configured for extensibility features by default. [On-Demand Portal> Content & Layouts> Content> Article Properties> Article Metadata> Enable Extensibility Features check box selected]


Read related posts

Integrate Analytics with AEM Mobile

Default reports available through AEM Mobile


Steps for Setting up custom analytics

1) Mobile Marketing Dashboard configurations:

In Mobile marketing dashboard (https://mobilemarketing.adobe.com/) Manage App Settings> Manage Variables & Metrics>Custom Metrics.

Custom Metrics: select an event number , enter an event name, and select type 'Whole Number'

Custom Variables: select an evar number, enter an evar name, select Tracking Call for persistence value from the drop-down.
Save the changes, rebuild your app in order for the changes to take place.

2) Configurations on Adobe Analytics (Omniture)

Omniture Step1:
Login to Omniture(https://my.omniture.com/login/), Admin> report suites> select your report suite. Then Edit Settings > Conversion > Success Events.

Click on Add New. Type an event name, and select the type Counter for the newly added event and save the configuration.

Omniture Step2:
Defining processing rules: Once the admin configures the custom analytics events and its evars, next step is adding Processing Rules for the newly created events and evars.

In Omniture Admin> Report Suite > Select the relevant report Suite > Edit Settings > General > Processing Rules

Select an  existing rule and  Add Rule > Add Action. Configure the action to set the custom event to 1 if the condition below is met. Here we are setting action to send user defined string to send the event.
Again Add Rule to create a new rule for evars, Add Action. Then configure the action to overwrite the custom evar with the evar to be used to send the event.

Save the changes, rebuild your app in order for the changes to take place.

3) Adding custom events to HTML content

Once the custom events, its evars, and processing rules are defined, we are done with configurations. Now we need to modify the HTML so that it can handle the analytics configurations.
Ensure extensibility features are enabled for your HTML content in On-Demand Portal.


i) Include the Analytics SDK in your pages. Add below line in your article HTML in the <head> tag.
<script type="text/javascript" src="cordova.js"></script>

ii) Send the Custom Event
Now configure your HTML content to send the custom event, for e.g. if you are sending the login event to analytics,
ADB.trackAction("login", {"evar51":"user-defined value"}, {"user":"testuser","remember":"true"});

The login event uses evar51 with its own set of parameters to recognise the event.

In the Back-end, when an event happens, Processing Rule increment the count of the corresponding event and the previously defined values will be overwritten with the values the user set in evar51.

Debugging the issues:
Analytics may not be appearing due to below reasons:

  • Any change in Mobile Marketing Dashboard, Omniture, needs rebuild of app in order for the changes to take place.
  • Check the extensibility features are enabled for analytics tracking.

Thursday, 9 March 2017

AEM Mobile with Login Functionality

Custom authentication Using Generic Identity Provider in AEM Mobile

AEM Mobile supports different ways of Sign in in to the application. Below are the three methods which can be integrated for AEM Mobile login functionality.

  • SAML 2.0 (Gigya, MFA/OKTA)
  • OAuth 2.0 (Facebook, Google id's)
  • Generic

AEM Mobile fetches authorization tokens from these identity providers, which you can use in your entitlement service to authorize users to content. AEM Mobile provides many APIs for Sign in procedures; For eg 'setAuthToken' 'isAuthenticated', 'launchSignInUI' etc.

Here we are going to understand the Generic identity provider implementation and it supports two types of login. First one is using a separate HTML form which is hosted in internet and second method using Sig in in experience in an AEM Mobile article itself.

Generic Identity Provider Implementation.




When users tap on Sign In button from the AEM Mobile app menu, the users are redirected to the provided sign-in UI. The Sign In HTML will have login functionality written, so that the code calls the DB and verify the user information and if it is a successful login, the user is redirected to app Home page with additional authToken Parameters. The authToken can be any String which holds multiple values related to User like user id, user location, user preferences etc.

The token can be a JSON file(Stringify this before passing to AEM Mobile as authToken) as given below. In AEM Mobile app, we can retrieve this authToken and read values, and use this values if required to set some additional features. For eg. say we need to set articles based on Geo of 'LA', so that only LA user will be able to see this content after login. We can send the authToken with below JSON and check in app for geo location. If it matches the geo 'LA' then display the article.

{
    "UserArray":[{
            "UserName":"user1",
            "userGeo":"LA",
            "userAge":"23",
            "userLastLogIn":"04-04"
        }
        
    ]
}  

Steps involved in setting up Generic Identity Provider.

Step 1: Create Login HTML

Create HTML Page with login functionality. Below given a sample HTML form page.

<html>
<head>
</head>
<body>
<form method="post" onsubmit="login();">

<input type="text" name="username">
<input type="password" id="password">

<input type="submit" value="Login" />

<script>
//You code which will call login functionality and verify the submitted user credentials by invoking DB.
// If login is success set the authToken and redirect the user from Login UI page to app home page.
//A sample code is available in next page of the blog. Parameters involved in Sign In and Login Scripts
</script>
</body>
</html>

Step 2: Host the Login HTML in you internet site.

We can place the login HTML to any internet facing site, so that we will have a new login URL like www.yourdomain.com/login.html. Ensure this is accessible through app.

Step 3: Configure the Identity Provider
Once the Login UI is ready and hosted, get the URL. Go to Master Settings of On-Demand portal > Identity Providers tab

Identity Provider Name: Generic 
Identity Provider Type: Generic

In the next 'Generic setup' screen, provide below details.

Authentication URL *: The URL Where you have hosted the login UI.
Default Session Expiry : You can leave this blank (Number of seconds that a successful sign-in is valid)

Save the configuration.

Step 4: Enable Custom Authentication in On-Demand portal
  • Go to project Settings in On-Demand Portal > Select the project to be edited, click on Edit and go to 'Access' tab.
  • Enable the check box under section 'Custom Authentication'
  • Select identity provider 'Generic'
  • Add a bundle ID under section 'Entitlement & Authentication' (This ID will be sent when apps request entitlement or authentication information)

Step 5: Build the app(not a preflight app) sign it, and test it as described here.

Read : Parameters involved in Sign In and Login Scripts

Authoring AEM Mobile Article from Custom Third party applications.


AEM Mobile on Demand portal allows third party application authoring though the APIs provided. We can have either a CMS plugin(wordpress or joomla) which talks to the API or a complete Web-based authoring solution for the same.



Using the API's services, we can manage:

  1. Articles
  2. Collections
  3. Products
  4. Push notifications

Authoring Orchestrator
Let us see the steps involved in setting up a web based authoring application system (I call it 'Authoring Orchestrator') for AEM Mobile. One of the major condition to run this application is that we need a public hosted server so that our application files can be deployed over internet.

Step 1:
Download the On-Demand Services API files : This set of files contains API Documentation, Examples etc.

Step 2:
Get the API Keys, generate Device ID, Device Token

To access the On-Demand Services API, you need to request an API key through the form specified. If you need further assistance, please let us know thorough the comment section.

Step 3:
Update /aemmobile-api-examples/config/credentials.php for below details

i) Update the values for ‘client_id' (with API Key), 'client_secret';
ii) Update the value for 'device_token', 'device_id' received from the AEX service.
iii) Provide a value for 'client_version' (It can be like 'aemmobile-orchestrator-api-doc-1.0');

Step 4:

Deploy the file folder in hosted server so that files are available over internet. The url could be
www.yourserverpath/aemmobile-api-examples/demo/index.php

Step 5:
Test the set up.
We can call the test file using url www.yourserverpath/aemmobile-api-examples/demo/01_get_access_token.php
This returns back the access token if your set up is correctly configured.

Copy the 'access_token' returned in previous example and update /aemmobile-api-examples/config/credentials.php
Now access www.yourserverpath/aemmobile-api-examples/demo/02_get_user_permissions.php, which returns the project id.
Update /aemmobile-api-examples/config/parameters.php 'publication_id' with previously retrieved project ID.
Now call www.yourserverpath/aemmobile-api-examples/demo/03_update_home_collection.php will return the top-level collections.

We can call all tests provided at www.yourserverpath/aemmobile-api-examples/demo/index.php in a similar manner.

Above tests ensures that we have configured the 'Authoring Orchestrator' correctly.

Step 6: 
Create a form(HTML/PHP) which takes the article details and post it to relevant API.

In this case you need an html or PHP file which takes all article meta data like Article Name, Article Title etc. On submission, you need to post this data by referring relevant API file.

For eg: If we are creating a new article we need to post the data to '/aemmobile-api-examples/article/create_article.php'
Once the article is created, we can have similar operation for image updation and .article file upload for the newly created article.

This 'article' folder contains article operations like

create article, delete article, get article list, get article metadata, publish article, upload article etc.

Similarly there are many directories which helps us to operate on authentication, banner, card, collection, image, layout, project etc.

Facing difficulties in configuration? Let us know through comments.

Angular JS Implementation for AEM Mobile Articles

AngularJS Articles in AEM Mobile

AEM Articles are normal HTML articles and it supports any front end technology, a normal web page supports. Here we will see how can we create an Angular article in AEM Mobile.

What is AngularJS?

Angular JS is a new Javascript technology which can be added to any HTML by adding relevant Angular library inside <script> tag.
Angular adds Directives to HTML page, and binds data to page with Expressions.

How to add AngularJS in an article?
AEM Mobile article structure contains an index.html with js, css, images, lib folders. This structure is used to create .article file using AEM Mobile packager.

Steps to create angular article:


  • Get Angular

We need to get latest AngularJS library from AngularJS website. Download 'angular.min.js' and any required angular additional libraries to your /js directory in article folder.


  • Create Controller

Now create a file controller.js in /js folder and add below code.

<!--Your Controller.js-->


var app = angular.module("myFirstAngular",['ngSanitize'], function ($compileProvider) {

  $compileProvider.aHrefSanitizationWhitelist(/^\s*(https?|ftp|mailto|file):/);

});
app.controller("controller",function($scope,$window,$sce){
 
$scope.personsList =[
                {name:'John',age:'23'},
                {name:'Jannet',age:'24'},
                {name:'Mark',age:'25'}              
                ];
                }
                );
             

  • Update index file of article to involve AngularJS in article  

         
Add angularJS libraries in your index.html. Below we have added sanitizor also which helps to sanitize the urls.              
        <head>          
            <script src="js/angular.min.js"></script>
            <script src="js/angular-sanitize.min.js"></script>
        </head>


  • Define body element which refers the controller and app.      

        <!-- Body-->
        <!-- ng-app defines an AngularJS application below-->
        <!-- ng-controller defines the application controller below-->
        <body ng-app="myFirstAngular" ng-controller="controller">

  • Add AngularJS code (which is of syntax 'ng-')

        <!--Div -->
        <!--ng-repeat repeats a set of HTML, a given number of times-->
        <div ng-repeat="person in personsList">
                        <div class = "your class">
                            <p class="name">{{person.name}}</p>
                            <p class="age" >{{person.age}}</p>
                        </div>                      
        </div>

  • Save and upload to AEM - Ondemand Portal

Save all the files, drag and drop it to AEM Mobile Packager. Your angular .article file is ready. Upload this to AEM - On-demand portal.

When you use AngularJS, you may face issue in adding 'navto' as cross browser call.
Just add 'navto' in aHrefSanitizationWhitelist so that it gets white listed.

Create 'push notifications' in AEM Mobile




Push notifications are used to re-engage passive users to the app again or conveying information about new content or products which are available in app. These push notifications can be created using the On-Demand Portal or through APIs. A separate Marketing Cloud license also provides different way of delivering push notifications through DPS.

We have different delivery options like can send the message only to phone users, or by scheduling a delivery time.

Types of push notifications:
Background notifications: which download a specific item or collection.
Text notifications: Which sends a text message to users to notify something.

Need to create push notifications for Android and iOS independently.

Apple Push Notification Service (APNS) for iOS apps.(Support both text notifications and background notifications)
Google Cloud Messaging (GCM) for Android apps.  (Support only text notifications)


Here we will show how to send push notification through android devices.

There are four steps involved in sending push notification in Android.

Configure your app for Google Cloud Messaging using the Google Developer Console.
Configure notifications section of the On-Demand Portal.
Build the Android app with push notifications enabled.
Send the text notification.


Step 1:
Configure Google Cloud Messaging.
1) Go to https://developers.google.com/mobile/add?platform=android


2) Enter values for option as below 'Create a new app or choose an existing app.'
App Name: A name for your app service
Android Package Name:  package name that you use for Bundle ID in On-Demand services (Project settings>Access>Entitlement & Authentication>Bundle ID)

3) Click 'Choose and Configure Services'

4) Select Cloud Messaging, and then 'Enable Google Cloud Messaging.'


5) Create the config file by selecting 'Generate configuration files.'

6) Keep back up of 'Server API Key' and 'Sender ID' values

7) Download the configuration file by clicking on 'Download google-services.json'



Step 2:
Configure Notification Section

1) Go to 'Notifications.'
2) Select the project which you want to update, and click Push Credentials. Then click the Android tab.
3) Select the Android app you created, and then click Add Credentials.



Specify the Server API Key and Project Number (Which you backed up in previous section step 6).

Step 3:
Building an Android app and sign it.
1) Login to On-Demand Portal and re-check 'Bundle ID' which is configured for 'Step 1, Android package name is matching project's bundle id.
2) Go to on demand Apps> App Details Tab, 'Android Push Notifications', then select 'Enable push notifications '




3) Click Upload, select the JSON file downloaded from the Google Developer Console.
4) Build , Sign, install the app on your android device.

Step 4:
Send the text notifications :


1) Click Notifications, and then click Android > Click Create > Text Notification>Details : mention below details
Destination App ID: The app which you need to send notification for
Text Notification Message: Enter the text notification message which needs to be send to users.

2) Click Delivery Options, and specify the following options:
Notification Audience: At present the options are All users, phone, tablet, users who are not app-online for a month.
Delivery Time: Immediate/ scheduled based on time zone,date time.

3) Click Create to send or schedule the message notification.

The Text notifications appear on any Android device in which the app is installed(user must have opted in to receive push notifications).



 Notes: As of now push notification does not allow linking to a specific collection. Cancel option is available for scheduled push notification, if a scheduled text notification has not yet been sent.
  If we need to send message to users within the app, we can use In-App Messaging(Which is part of Mobile Marketing SDK). In-App Messaging is a premium product. 

AEM Mobile related default reports in Adobe Analytics



Overview:
AEM Mobile analtics data can be configured to Adobe Analytics(SiteCatalyst/ Omniture) & Analytics Essentials(Mobile Marketing). SiteCatalyst provides report generation for all levels of Mobile content. Analytics Essentials provides some additional options like in App message,Acquisition tracking, Location and target etc. Analytics Essentials are part of Adobe Marketing Cloud.

AEM Mobile apps are pre-configured to report analytics information to Adobe data centers. all app related information like life cycle of the application are saved by default.



Each project in AEM Mobile on demand portal will have a report suite is automatically created. Generally mobile app stores information like Path, Dashboards, Favorites, App and Mobile metrics and app-specific items (For e.g. Articles, Collections, Banners).

AS of now the menu is not customizable.In case customization is required, you need to contact your Adobe Analytics Administrator.

Default reports available in Reports & Analytics tool

Article Reports : All article reports like Article Impressions, Article Clicks, Article Views, Article Scroll, and Social Share.

Collection Reports: All information like Collection and Article Impressions, Collection Open, and Article Click.

Social Share Report: Number of social shares.

Social Share Channel Breakdown Report: Device specific social share referral.

Banner Metrics: Banner impressions, clicks.

Overlay Reports: Hyper link clicks are tracked.

Video Engagement Report: Reports like count, percentage of completion, duration , average time on video etc.

Visitor Profile Reports: Visitor reports like unique visitors, overall visitors etc.


Key Metrics Report: App level reports like installation, launches details etc.


Can we get analytics report for Web Viewer?
Yes . But Web Viewer only supports clicks reports not mobile related swiper or taps.


Adobe Analytics integration for AEM Mobile

Create Sign In in AEM Mobile


Usual mobile apps provides a login screen on launching the application. But AEM Mobile provides this as an app menu. Which means, we need to tap on App Menu> Signin to launch the signin screen. The default collection is displayed on launching the app.

People ask in AEM Mobile, is there any way to provide such option a login screen/window that automatically opens after the splash screen upon app launch. AEM Mobile  directly does not provide such option. They have radmap to provide such option in future.

How can we achieve it manually?
Dynamic Banner is one of the option to do this. We need to provide an HTML Dynamic banner in home screen and on tapping this, the launchSignInUI API can be called from backend. Please note, this API works with both Custom Authentication and authentication via a Direct Entitlement Server. And always there will be a Sign In option avaliable in the app menu.

 If the Direct Entitlement APIs authentication is enabled, then the native sign in dialog will display. Custom Authentications like SAML, OAuth2 or Generic Identity Provider, displays a web view with sign in UX. 

How do you create banners
? Read this blog

Another less preferred option is normal HTML Article,
Create an HTML article with SignIn information and set it as the first item in Top Level Collection. The top level means it will always be the first item that gets displayed to users. ANother option could be creating a link/ button on home article clicking on this launches Sign In. But this also requires an API Call and will work with both Custom Authentication and authentication via a Direct Entitlement Server.

Note: Since we are setting this as top level one, place a logic to display this only when the Sin in is not done. Else it can have bad impact on user experience.
 
Read more on Authentication and Login APIs
https://helpx.adobe.com/digital-publishing-solution/help/identity-providers.html
https://helpx.adobe.com/digital-publishing-solution/help/app-runtime-api.html


Adobe Analytics integration with Adobe Campaign

Adobe Analytics integration with Adobe Campaign

Adobe campaign: Adobe Campaign lets you design and orchestrate targeted and personalized campaigns on multiple channels, such as e-mail, direct mail, SMS, Wap Push, search, social etc.
Adobe Analytics: Analytics service provide various levels of views like visitor geo location, what days they come the most frequently, and how long they’re staying as well as several metrics based on e-commerce data, CRM attributes, engagement, etc

Adobe Analytics data can be used to create effective Adobe campaign across channels. Adobe Analytics & Campaign Combined Together can delver following capabilities.
Performance measurement in real time
360-degree qualification and targeting
Highly personalized remarketing

Campaign to Mobile App

The Mobile App Channel lets you use the Adobe Campaign platform to send personalized notifications to iOS and Android terminals via apps. Basically there are two delivery channels available:


  • An iOS channel
  • An Android channel


There are ways to optout it. The NMAC opt-out management (mobileAppOptOutMgt) workflow updates notification unsubscriptions on mobile devices.

Adobe Campaign is compatible with both binary and HTTP/2 APNS.

To use the functionalities of the Adobe Campaign Mobile App Channel, you need to change/adapt your mobile application to integrate it into the Adobe Campaign platform using Two SDKs (one for android , other for iOS)

Steps involved in campaign set up are.

Configure connectors
Collecting information (collect the technical specifications which define the set of parameters that enable Adobe Campaign and the mobile application to communicate, like integration key, variables, urls etc)

Creating the service
Adobe Campaign administrator needs to create and configure a service linked to the mobile application

Push Notification services.

  • APNS (Apple Push Notification Service) for Apple
  • GCM (Google Cloud Messaging) for Android


Adobe Campaign uses two types of APIs:
•    Generic data access APIs for querying the data model data
•    Business specific APIs that let you act on each object: deliveries, workflows, subscriptions, etc.


Collecting data by Campaign
Action, Event activities support below data collection methods

1) The Data loading: The Data loading (RDBMS) activity lets you access this external database directly and to collect only the data required for targeting.

2) The Loading: The Loading (SOAP) activity is used in addition to the data loading (RDBMS) activity when it is not possible to collect data directly via the FDA in an external database.

3) Data loading (file): The Load (File) activity lets you directly access a source of external data and use it in Adobe Campaign. A scheduler can be run to retrieve the file.

Thursday, 23 February 2017

Article operations in AEM Mobile


Article operations in AEM Mobile

How do we modify the existing article?

Unzip the .article as below using any zip extractor.


Now we will have a folder with structure as below. To modify


Go to respective folder / file and update as required. Once done, drag and drop this article to 'AEM Mobile Packager', so you will have a new .article file.


Upload error, how to find out reason.

Some times while uploading an edited article, we find 'Upload Failed' error as below.


To find reason click on the red 'Upload Failed' error. You can see a pop up with error details.


How to fix the error?

The reason is manifest file does not match MD5 calculated internally. To fix this remove the manifest file and drag and drop it to 'AEM Mobile Packager' again and try re uploading.



Adjusting Home Navigation Menu from AEM Mobile On-Demand portal

Adjusting Home Navigation Menu from AEM Mobile On-Demand portal

There are cases where we need to adjust home menu options of AEM Mobile application. See below a sample menu. It has landing collections and products menus which are configurable and adjustable.

The sign in menu appears automatically once the entitlement service for sign in is configured.

Settings contains licensing information, track usage data option, version of app, build details etc.





How do we adjust?

Go to Content & layout > Content map click on the item to be moved from right pane.


Now just drag and drop the item on target areas which are allowed and highlighted in blue during drag.


Once preflight option is done, you will have the new menu in preflight app and on publish, this gets activated to production app



AEM Mobile Testing Interview questions

Add caption
AEM Mobile Testing Interview questions

  • How do we create an aem mobile app from portal?

  • Do you know about AEM Mobile entitlement?

  • How do we author an article in portal?

  • Do you know to configure the app menu?

  • What are all the performance checks we can do on a mobile app?

  • What are all the security checks we can do on an app?

  • How to change metadata of content in portal?

  • How to update an image in an article?

  • Do you know to add a user and configure his permissions?
  • What is the difference between preflight and a production app? How they differ from installation.


AEM Mobile Interview questions for developers

AEM Mobile Interview questions

  • How do we configure AEM with AEM on demand portal?

  • What is entitlement and how it works?

  • What are all the ways of creating article?

  • What is the difference between free threshold and metered content?

  • How do we author AEM Mobile content from AEM?

  • Can we author AEM Mobile content from third party applications?

  • What are all the ways to improve performance of AEM Mobile pages?

  • How the search works on AEM Mobile? Which layout is used for AEM Mobile search?

  • How do we unzip a .article file?

  • What are all the types of files which can be authored on a page in AEM Mobile?

  • How the meta data is added in aem mobile content?

  • How to create a preflight app and web url?

  • How do we configure the menu items in Mobile app?

  • How do we update the fonts in AEM Mobile app?

  • Explain the user roles in AEM Mobile portal?

Friday, 17 February 2017

Create an APP in AEM And Mapping with AEM Mobile On-Demand



Create an APP in AEM And Mapping with AEM Mobile On-Demand Portal

To work with AEM Mobile On-Demand Portal, we need an app created in AEM. Mobile Apps dashboard(http://localhost:8080/libs/mobileapps/admin/content/dashboard.html) collectively holds all mobile apps in AEM. To publish or sync a content between AEM and AEM Mobile, an app is necessary at AEM and a mapped project in AEM Mobile. Consider we already have a project in AEM Mobile, and need to link it with AEM.

There are two steps required to sync AEM and AEM Mobile
1) Creating an On-Demand app in AEM 6.2
2) Link the AEM 6.2 APP with AEM Mobile On-Demand Project

>>Creating an On-Demand app
In AEM 6.2, go the Mobile section as shown below.
Click Create > App. The select template "AEM Mobile runtime", click on 'Next'


Enter app properties such as Title, Name, Description.



Ensure the app properties are matching with the properties used in the AEM Mobile On-Demand Portal, and click Next.

>>Link the AEM 6.2 APP with AEM Mobile

Under 'Manage Connection', map the AEM APP from section 'Select an Experience Manager Mobile Config', with AEM Mobile project from section 'Select an existing Experience Manager Mobile Project' as shown below.



Once the connection is successful, the 'Manage Connection' section looks as below.
Now we will be able to sync data/content between AEM app and AEM Mobile On Demand Portal.



Test the configuration.

Assume we have some collection already created in AEM Mobile portal. Now Go to 'Manage Connection' > click on 'Import Collections', confirm the import pop up screen. You will be able to see the AEM Mobile On-Demand portal collections imported into AEM environment with a success message.

Integrate AEM with AEM Mobile


Integrate AEM with AEM Mobile

The article is based on AEM 6.2. You may need to refer the url(https://helpx.adobe.com/digital-publishing-solution/help/configure-aem.html) for AEM 6.1 version integration.

How do we get AEM 6.2 Jar?
You may need to raise a request with Adobe in AEM License section for the same mentioning the partnership of your organisation with Adobe.

Integrate AEM with AEM Mobile

AEM Integration with AEM Mobile On-Demand portal helps organizations to manage mobile content easily and work in more distributed way. Once the integration is done, we will be able to add content (Article, collections, banners etc) through AEM for the Mobile Application. We also can import existing content available in AEM Mobile On-Demand portal to our AEM Development environment.

To complete the integration, we need API access of On-Demand portal, which requires additional license from Adobe. Below given the details required.

API Key & Client Secret are credentials to access the API Gateway. (Refer Link and Raise a request for API Key from Adobe https://helpx.adobe.com/digital-publishing-solution/help/integrating-dps.html#apikey)
Device ID and Device Token are credentials to identify the API user. (Generate the Device details using above API received from Adobe then from URL https://aex.aemmobile.adobe.com/)

Note: Ensure the Adobe ID used to get API access should match the Device ID generation.

Once both steps are done, you will have

  • API Key (IMS Client ID)
  • Secret Key
  • Device ID
  • Device Token:


Note: Expiry Time automatically gets extended once in use and expiry date is reached.

Integrate AEM 6.2 to work with AEM Mobile.

Follow below steps to integrate the AEM with AEM Mobile On-Demand Portal

In AEM click Adobe Experience Manager, and then go to Tools > Operations > Web Console.



In the new window, search for 'Experience Manager Mobile On-demand Services Client' and click the edit icon.


Enter the API Key (IMS Client ID) and Client Secret in the "Client Id' and 'Client Secret' as shown below and save it.

Now go back to AEM page, Tools > Deployment > Cloud Services. Search for 'Adobe Experience Manager Mobile On-demand Services', and click 'Configure Now'.


In the 'Create Configuration' pop-up window, enter 'Title', 'Name', and click Create.


Enter the 'Device Id' and 'Device Token' which was generated using the 'IMS Device Token Generator' to the pop up window 'Adobe Experience Manager On-Demand Services Account Configuration'. Once the 'OK' button is clicked we will be able to see the configuration saved.

How to Test the connection/configuration?
On the service which we created click on configuration > 'Edit' , the pop up window will have previously saved 'Device ID' and 'Devce Token' and 'Test Device Configuration' on bottom. Click on 'Test Device Configuration'. If the connection is correct we will get a message 'Connection Successful'


If the connection was not successful, ensure that 'Device ID' and 'Device Token' values are correct, have not expired and are copied properly (by copying on notepad and removing any white-spaces).

Click 'OK', and then navigate back to the AEM window. You can see the AEM On-Demoand Cloud Service is enabled and 'Green'

Create Article/Banner from AEM and publish it to AEM Mobile


Create Article/Banner from AEM and publish it to AEM Mobile

AEM Version 6.2

Once the AEM is configured with AEM Mobile account as mentioned in (Link), we will be able to import articles, collections banners etc from AEM On-Demand Portal. We can also create an article, banner, collection from AEM and publish to AEM M
obile on-demand portal. The synch method is quite easy to follow.

Let us see how to create a banner in AEM and publish it to AEM Mobile. Creation / updation of article method remains same as in banners.

In section 'Manage Banners' , click on 'Create Banner' as shown below.




Now go through the screens and fill out all mandatory fields as shown below. Ensure we are clicking on 'Next' to fill out various sections like 'Properties', 'Advertisement', 'Images', 'Collections'. In final screen select the collection where the article/banner to be linked with.





Once we click on 'Create' on final screen we will get confirmation 'Banner Created' with option to view new banner.



WE will have various options like publish, unpublish,Add to a collection, Unlink from collection, upload delete etc for an article. Also we can view and change the properties further.
Now the Manage Banners section listt out all the banners which are created using AEM or through AEM Mobile on demand portal. Section 'Source' specifies the source of content creation.
It also says the advertisement details, whether the article/banner is published etc.



Individual articles/banners can be published by selecting it as shown below below.

Add/MAP user to AEM Mobile project

We need to add multiple users to AEM Mobile account in order to deliver shared development environment and multiple project maintenance. In addition to this AEM integration with AEM Mobile also requires a user to be mapped with a project, preferably a dedicated user.

To do this, we have to login to On-Demand Portal http://aemmobile.adobe.com , click on users from left navigation, select the project which user needs to be mapped, then click on (+) Add User enter the user details (Users Adobe id mapped email) and submit.

Now select on 'Custom' drop-down so that we can immediately map the user access with the assigned project.



There are multiple sections where user can get access on as below.

Administration

  • Application Development
  • Content
  • Notifications
  • Products & Subscriptions


Select appropriate check boxes according to the requirement and save the selection. The new user with specific access is mapped to the project now.




Any time the user permission can be edited by >Users> selecting the user then edit.