Ir para o conteúdo

Introduction

This following document outlines the procedure for seamlessly integrating the DMA library into Android OS-based mobile native applications. It serves as a comprehensive guide, offering step-by-step instructions on leveraging the DMA framework SDK and constructing an application using its functionalities.

Provided functionality

The DialMyApp Android Framework enables seamless integration of DialMyApp features into your Android applications.

The framework currently supports the following features:

  1. Call interception: When a user initiates a call to a number associated with the DialMyApp profile, the framework intercepts the call and displays the corresponding profile content. But not every application can be published in Google Play because two sensitive permissions should be used (READ_CALL_LOG and PROCESS_OUTGOING_CALLS) and you need approval from Google to publish an application with these permissions (more about Google's rules). But from our experience, your application can use these permissions in the following cases: 1) the main activity of the app is related to phone handling (as DialMyApp app); 2) the company's app holder is a device manufacturer (as Samsung, LG, Xiaomi, etc); 3) the company's app holder is a mobile operator (as Vodafone, Verizon, TIM, Orange, etc).

  2. Display of profiles from incoming push: The DialMyApp server is capable of triggering the display of a profile by sending a push message to the application. The framework efficiently parses the message content and presents the relevant profile on the current application screen. Please note that this functionality requires active push registration of DialMyApp.

  3. Cache for viewed profiles: Every viewed profile is stored in a local cache, ensuring quick and efficient access.

  4. Periodic update of locally stored profiles: The application proactively checks for newer versions of cached profiles. If an updated version is available, the app seamlessly updates the local database, ensuring the most up-to-date information is readily accessible.

  5. Communicate with the host app in the agreed formats (can be some information sharing through shared preferences, or by calling some intents, etc).

  6. Show profiles in webview and provide necessary information and intercommunication between web layer and native.

DialMyApp Maintenance Functionality

  1. Regular (daily) update of the profiles/configurations from the DMA server.
  2. Regular update of device's information sent to the server.
  3. Registration of Push tokens sent to the server.
  4. A SMS phone number verification process.

Analytics

  1. Gather analytics events and send them to the DMA server for processing while showing a profile. The sole purpose of this navigation data registration is to generate operational dashboards of profiles navigation performance that will be provided to the company. No private information from the customer is retrieved or stored at DMA servers.

Platform support

Supported OS: Android 5.1+

Privacy policy

To ensure compliance with privacy regulations, please ensure that your application's privacy policy includes the relevant information covered in the DialMyApp privacy policy, which can be found at the following URL: https://www.dialmyapp.com/privacy-policy/.

Limitations

The framework integrates Apache Cordova platform. The current framework version has limitations when integrating with a project that already uses Cordova platform. The project uses the Cordova Android library. Versions of this library are subject to additional verifications to be made.