Table of contents

Requirements

Problem statement

The lack of integration with Firebase Dynamic Links SDK can limit the accessibility of the application's content, reduce the effectiveness of advertising and marketing campaigns, and restrict content sharing, which can have a negative impact on our customers, sales, and profitability.

Possible solution:

To implement the integration with Firebase Dynamic Links SDK into our platform.

https://firebase.google.com/docs/dynamic-links?hl=es-419

Acceptance criteria

• Dynamic links:

  • If the mobile customer clicks on a dynamic link and has installed the app, then it goes to the app directly. Otherwise, he/she is redirected to the store (Apple store or Play store) and gets the app.

  • The web customer (Desktop or mobile devices) accesses the webpage directly in the browser, but:

    • If the user types the dynamic link on Safari on iPhone, a page with a button is displayed, then it goes to the app.

  • In the First access:

    • Always will show the preview page with a open to app button (Android and IOS), this is a normally behavior.

    • After the app installed, the preview page won’t show anymore, when the user open the app from dynamic link.

• Deep links:

  • If the mobile customer clicks on a deep link and has installed the app, then it goes to the app directly. Otherwise, he/she is redirected to the respective content within the website.

  • The web customer (Desktop or mobile devices) accesses the webpage directly in the browser, but:

    • If the user types the deep link on the browser using a mobile device, he/she is redirected to the respective content within the website. If it is on an iPhone, a banner is displayed indicating to use the app.

• Push notification:

  • Both dynamic links and deep links can be sent by push notification message on Salesforce. However, there is a limitation to include a longer link on the field on Salesforce. For this reason, it is recommended the use of dynamic links instead. Regarding the behavior when the user taps the push notification message, the result is the same as the user clicks on the link by marketing email campaign.

• UTM parameters:

  • UTM parameters can be included on deep links.

    • E.g: https://www.popeyes.es/rewards/offers?utm_source=Newsletter&utm_medium=email&utm_campaign=test_123

    • OBS: UTM parameters available on step 5 on Firebase Dynamic link is used just when is necessary have UTM mapping on Firebase Google Analitycs, since when the link arrive on firebase, it clean the UTM parameters.

    • E.g: If we use the below link, it will go to firebase and the parameters will be cleaned, because these params are use just on Firebase.

      Open

      

      Link: https://iberia.page.link/?link=https://www.popeyes.es/menu/picker-fca2d119-edc2-46a5-9e37-6fdea2cd47d9&apn=es.popeyes.android&isi=1489613084&ibi=com.iberia.popeyes&utm_campaign=TestUTMCampaign&utm_medium=TestUTMMedium&utm_source=TestUTMSource

• In-app messages:

  • This feature is out of this scope, but it will be implemented on another story: Feature - In-app

Dynamic Links FAQ:

Firebase Dynamic Links is no longer recommended for new projects. In the future, the Dynamic Links service will shut down, but you will have at least 12 months from the announcement date to migrate. Around the end of Q2-2023, we will announce more information.

We launched Dynamic links about 7 years ago to make URLs more powerful (for example, dynamically changing the destination of a link based on run-time conditions) at a time when there were different degrees of support on various OSes and platforms. We remain committed to the importance of enabling app teams of all sizes to improve their deep linking experiences and are investigating how to help developers adopt technologies such as App Links, and Universal Links. → At least 1 sprint for refinement + 1 sprint for dev

How long will I have to migrate?

We want to make the migration as smooth as possible, so you will have a minimum of 12 months to fully migrate. We will share more details around the end of Q2-2023.

Will new and existing links continue to work?

Yes, your new and existing links will continue to work until the Dynamic Links service is shut down. Around the end of Q2-2023, we will provide more information on the long term plan for Firebase Dynamic Links.

Scenarios

Scenario 1: xxx

Design

Figma design here: [insert link]

Development

We have worked to cover all scenarios listed on the acceptance criteria. Currently, we have to implement the remaining items:

https://rbictg.atlassian.net/browse/IBFEC-824

Tests

Remaining tests:

Status BK PT: Both deep link and dynamic link are working for Android. For iOS, we are waiting for Apple configs to be released to production.

Release

Remaining fix:

Status: A change in the social login feature done by another vendor caused an impact on the APK signature. We are waiting for the fix to have a new version.