QR Code Linking to App

Configuration

Request a new iOS build from Salesforce. Along with the build, Salesforce will provide you with an Apple App Site Association (AASA) file.

Verification

Before you begin verification make sure all the steps in the configuration section are completed successfully. There are three scenarios you must test to verify that functionality is working as expected.

When App is installed and Not running

• Action: Scan the QR code.
• End Behavior: App will launch and go to the directed page to which the URL was mapped to.

When App is installed and Running

• Action: Scan the QR code.
• End Behavior: App will launch and go to the directed page to which the URL was mapped to.

When App is not Installed

• Action: Scan the QR code.
• End Behavior: A browser should launch directing the user to the client’s website.

Product Details Pages

Problem: I, as a user, am not taken to the PDP when I scan a product url.

http://www.<merchant>.com/<productID>

Troubleshooting:

1. In CMS go to Products > Products.
2. Search for the product that one is trying to go to.
3. View Product Details.
4. Ensure the “ProductURL” field’s value is exactly the same as the QR code scanned.

   http://www.<merchant>.com/<productID>

Possible Solutions: Update the product feed with the desired URL.

Category Search Pages

Problem:I, as a user, am not taken to a category search page when I scan.

http://www.<merchant>.com/category/shoes/sandals

Troubleshooting:

• Make sure said category is in the product feed or category feed.
• If the URL is different than other category URLs then Point of Sale will have to be notified

Possible Solutions:

1. Add the category URL to the feed.
2. Manually map said URL.

   This should be used as a last resort option and only if the category URL is an anomaly; the rest of the category URLs map correctly.

Manually Mapped URLs

Scenario: I, as a merchant, would like our users to go to the store locator when they scan the QR code. http://www.<merchant>.com/stores

Steps:

1. To do this in CMS go to Layout Pages > Deeplink Mapping.
2. Click the plus icon in the upper right corner.
3. Enter the URL in the field web url; http://www.<merchant>.com/stores.
4. Set a deep link; choose the deep link one wants the user to be directed to.
5. Click set.
6. Click save.

Test: Scan the QR code containing the URL mapped. The user should be directed accordingly.

Landing Page for App Store or Playstore

A landing page may be necessary to incentivize the user to download the app if they do not have it. One will have to do this by a landing page on their website.

Scenario:

• Merchant wants the user to download the app.
• Pre-conditions
  • ie) headers, url query parameter
  • Merchant builds redirect logic for the landing page
  • User does not have the app
  • User scans QR code of http://www.<merchant>.com/<productID>

Only Have Some of the Web URLs Go to App

iOS

In iOS, one may modify the AASA file. See the Apple Support Universal Links guide for more details.

{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "9JA89QQLNQ.com.apple.wwdc",
        "paths": [ "/wwdc/news/", "/videos/wwdc/2015/*"] <- this determines which paths open the app
      }
    ]
  }
}

• Branch.io, which is a third-party library that helps link from weblinks to apps. Branch.io has other supporting features. To find out more go to Branch.io .
• Responsys is an ESP that supports universal and app links. To find out more go to Responsys.