Edit in GitHubLog an issue

Target mobile preview

Use the mobile preview link to perform easy end-to-end QA for mobile app activities and enroll yourself into different experiences right on your device without any special test devices.

Overview#

The mobile preview functionality lets you fully test your Mobile app activities prior to launching them live.

Prerequisites#

  1. Use a supported version of the SDK: The mobile preview feature requires that you download and install the appropriate 4.14 (or later) version of Adobe Mobile SDK in your corresponding apps.

    For instructions to download the appropriate SDK, see:

  2. Set up a URL scheme: The preview link uses a URL scheme to open your app. You must specify a unique URL scheme for the preview.

    The following illustration is an example on iOS:

    alt image

    The following illustration is an example on Android:

    alt image

  3. Track Adobe DeepLink

    iOS: In the app delegate, call [ADBMobile trackAdobeDeepLink:url when the delegate is asked to open the resource with the URL scheme that was specified in the previous step.

    The following code snippet is an example:

    Copied to your clipboard
    1- (BOOL) application:(UIApplication *)app openURL:(NSURL *)url
    2 options:(NSDictionary<NSString *,id> *)options {
    3
    4 if ([[url scheme] isEqualToString:@"com.adobe.targetmobile"]) {
    5 [ADBMobile trackAdobeDeepLink:url];
    6 return YES;
    7 }
    8 return NO;
    9}
    10

    Android: In the app , call Config.trackAdobeDeepLink(URL); when the caller is asked to open the resource with the URL scheme that was specified in the previous step.

    Copied to your clipboard
    1 private Boolean shouldOpenDeeplinkUrl() {
    2 Intent appLinkIntent = getIntent();
    3 String appLinkAction = appLinkIntent.getAction();
    4 Uri appLinkData = appLinkIntent.getData;
    5 if (appLinkData.toString().startsWith("com.adobe.targetmobile")) {
    6 Config.trackAdobeDeepLink(appLinkData);
    7 return true;
    8 }
    9 return false;
    10 }

    To make Mobile Preview work for Android, you must also add the following code snippet in AndroidManifest.xml if using version 5 of the Adobe Mobile SDK:

    Copied to your clipboard
    <activity android:name="com.adobe.marketing.mobile.FullscreenMessageActivity" />

    If you are using version 4 of the Adobe Mobile SDK, use the following code snippet:

    Copied to your clipboard
    <activity android:name="com.adobe.mobile.MessageFullScreenActivity" />

Generating a Preview Link#

  1. In the Target UI, click the More Options icon (three vertical ellipses), then select Create Mobile Preview.

    alt image

  2. Select the activities that you want to preview, then click Generate Mobile Preview Link.

alt image

  1. Specify your app's URL scheme.

    This needs to be the same as what is present in your iOS or Android app. Repeat this process separately for iOS and Android, if required.

    alt image

  2. Click Generate Mobile Preview Link, then copy the link.

    alt image

Preview on Your Device#

Open the link in a mobile browser on a device where you have your app installed. This app can be the production app that you downloaded from the Apple App store or the Google Play store. It doesn't have to be a special build. If you have an active preview link, you will be able to view the experiences on device.

  1. Open the link in your mobile browser.

    Share the link that you copied in the previous step from the Target UI to your mobile device in a convenient way, for example using text, email, or Slack.

    | preview deep link 1 | preview deep link 2 |

    Your app opens and starts the Target Mobile Preview Mode.

  2. Select the combination of experiences that you want to see, then click Launch Experiences.

    | mobile preview 1 | mobile preview 2 | mobile preview 3 | | mobile preview 4 | mobile preview 5 | mobile preview 6 |

Limitations#

  • The view must load again for the new content to display after the Launch Experiences button is clicked. The easiest way is to switch to a different screen and then come back to the screen where you are expecting the change to happen.
  • Mobile preview is not supported for Android versions earlier than API-19 (KitKat).
Was this helpful?
  • Privacy
  • Terms of Use
  • Do not sell my personal information
  • AdChoices
Copyright © 2022 Adobe. All rights reserved.