1 of 20

Mobile News Apps public docs

Naviga Mobile News Apps

Required information

This is the required initial information and actions to start app setup.

Setup developer accounts Complete setup with financial information, payments, addresses etc. All administrative information must be correct for the developer accounts to function.

Invite Naviga team
Naviga team will act as agent with permissions to build and distribute apps within the customers developer account. Also access to certificates must be granted.
Apple:
Google:

Appstore Connect API Key Create API key with admin access. This should be provided to the Naviga team with notes of Issuer ID and Key ID. Either give the Naviga team access to download them or use a secure services to send them.

Note: The API Key can only be downloaded once.

No keys or certificates should be sent through insecure communications.

Feel free to use our secrets share service:

Signing keys
Google signing keys with credentials to use them. Note the need for security in transfer.

Google Service Account
Set up API access in Google Play Console and provide keys to Naviga.

App setup in stores:

Design
Colors, Fonts, Typography, Logos, Icons or other graphic resources.

Configuration base

What info Naviga professional services need as a minimum to start a Mobile project.

Font

Preferred format is TrueType font format (ttf) for fonts.

As alternative, OpenType font format (otf) will most likely work. But otf will in some cases not render as good as ttf.

Color

At least one primary color code in hex format, 6 or 8 digits, is required.

Logotype

(and/or logomark)

Main app logotype in svg format, one black and one white.

They will be rescaled by Naviga to be used in multiple places. For example splash screen, appbar icon, toolbar and app icon.

Feature icons (optional)

Icons in svg format, square.

For use in bottom nav icons, actions i app bar. If not specified, Naviga standard will apply.

Store information

Required and suggested information when publishing Naviga news apps on stores.

Privacy Policy

Google Play

Google Play > Policy > App content > Povacy policy

Paste url to policy

Ownership

When publishing News apps Google and Apple have some specific requirements to verify publisher ownership.

Suggestions and example how to configure your app and Google play.

Background

AppStore Privacy

This is how Naviga suggest you enter privacy details when publishing a Naviga news app.

Apple App Store

This is how Naviga suggest you enter privacy details when publishing a Naviga news app for iOS.

Google Play Data Safety

Fast track:

To skip the manual config, use the csv file below as a quickstart.

CSV file contains below settings, for a Naviga Standard config Android app.

169KB

data_safety_export.csv

Open

Background

Help users understand how your app collects and shares their data

To help users better understand your app's privacy, security and data handling practices before they download it, provide information about your app's safety. The information that you provide is shown on your Store Listing so that users can learn how you collect and share their data.

Manual guide: Google Play > Policy > App content

2. Data collection and security

3. Naviga Android apps collects or shares:

Data type

Purpose

Optionals

You might need to mark more, if customer app is using 3rd part tools or has addition config.

Data type

Purpose

4. Data usage and handling

Email address

App info and performance: Crash logs, Diagnostics and Other app performance data

App activity: App interactions

Device or other IDs

5. Preview

Save!

Deleting user data

Naviga don't provide an end user interface for deleting data, we are a "ombud".

Statistics Events

All Apps dispatch statistics events via different Statistics Providers. Default is the Firebase Analytics integration (Google Analytics v4).

For each action or view in the app an event is triggered. Those events has parameters, described on these sub pages.

Global attributes

The attributes of each event type may differ but each event also contains the following global attributes:

Article Event

Show article.

An event dispatched when an article is opened.

eventName - viewShow
viewName - article or packagePreview
moduleID - Module ID from app config
moduleName - Module name
moduleTitle - Module title from app config
articleHeadline - Article headline
articleUUID - Article UUID
articleUrl - Article URL
isFrequency - Boolean, whether article is metered.
isPremium - Boolean, whether article is premium content.
source - String, if the article was opened from a push notification.

Example - Event dispatched when an article with title of "Title of an Amazing Article" is opened.

eventName: viewShow
viewName: article

ArticleList Event

Show ContentList module.

An event dispatched when a ContentList or NearMe module are rendered.

eventName - viewShow
viewName - articleList

ArticleListRow Event

Show article teaser.

An event dispatched when an article teaser is viewed in a list.

eventName - articleListRowView
viewName - article or packagePreview
moduleID - Module ID in app config
moduleName - Module name
moduleTitle - Module title in app config
articleHeadline - Article's headline
articleUUID - Article's UUID
isFrequency - Boolean, whether article is metered
isPremium - Boolean, whether article is premium content
userHasAccess - Boolean, whether the user has access to article or not
subscriptionId - Subscription UUID

Example - event dispatched when an article teaser is viewed in a list

eventName: articleListRowView
viewName: article or packagePreview

Article Read Event

Stop showing article.

An event dispatched when an article has been read.

eventName - viewShow
viewName - articleRead
moduleID - Module ID from app config
moduleName - Module name
moduleTitle - Module title from app config
articleHeadline - Article's headline
articleUUID - Article's UUID
isFrequency - Boolean, whether article is metered
isPremium - Boolean, whether article is premium content
userHasAccess - Boolean, whether the user has access to article or not

Example - this event was dispatched when an article was read.

eventName: viewShow
viewName: articleRead

Flow Event

User, login, password and similar views.

An event dispatched when a Flow view's registerStats property is true.

eventName - viewShow
viewName - flow
moduleID - Module id from app config, or global
moduleName - Module name, or empty if omitted
moduleTitle - Module title from app config, or empty if omitted
viewId - Flow ID or empty if omitted

Example - Event dispatched during a custom User Login flow

eventName - viewShow
viewName - flow

Example - Event dispactched during a custom Free Trial flow

eventName - viewShow
viewName - flow

Example - Event dispactched during a custom Forgot Password flow

eventName - viewShow
viewName - flow

Notification Event

Receive and open push notifications

Receive notification

Notification Received Event. An event dispatched when a push notification is received by a device registered for push notifications.

eventName - showNotification
viewName - empty if omitted
moduleID - Notification context
moduleName - Module name, or empty if omitted
moduleTitle - Module title in app config, or empty if omitted
streamID - Notification uuid
streamType - Open Content property name for the concept
streamTitle - Concept headline
notificationTitle - Notification alert title
notificationText - Notification alert body
contentID - Notification uuid
contentType - Linked contentType

Example - The device receives a manual push notification with a link to open an article if clicked.

eventName - showNotification
viewName -

Example - The device receives a manual push notification which does not contain a link to an article (or anything), and does not contain any module info.

eventName - showNotification
viewName -

Example - The device receives a manual push notification for the Editions module about a new Edition.

eventName - showNotification
viewName -

Example - The device receives an automatic push notification, from the NearMe module, with a link to an article.

eventName - showNotification
viewName -

Open notification

Notification Opened Event. An event dispatched when a push notification is opened.

eventName - openNotification
viewName - empty if omitted
moduleID - Notification context

Onboarding Event

Show onboarding view

An event dispatched when an on-boarding slide is displayed.

eventName - viewShow
viewName - promotion

Profile Event

Show profile module

An event dispatched when profile module is opened.

eventName - viewShow
viewName - profile
moduleID - Module id from app config, or global
moduleName - Module name, or empty if omitted
moduleTitle - Module title from app config, or empty if omitted

eventName - viewShow
viewName - profile
moduleID - profile

TopicPicker Event

Show the Add subscription view, and add subscription event

View dialog

Topic Picker View: An event dispatched when the topic picker is opened.

eventName - viewShow
viewName - topicPicker
moduleID - Module id from app config, or global
moduleName - Module name
moduleTitle - Module title from app config

Example - User navigates to the module "Top News", and the topicPicker dialog appears.

eventName - viewShow
viewName - topicPicker

Create subscription

TopicPicker Create Subscription events are dispatched when a user saves their choices made in the topic picker.

One event is dispatched for each choice that was made.

eventName - createStream
viewName - topicPicker
moduleID - Module ID from app config, or global

Mobile News Apps public docs

Naviga Mobile News Apps

Required information

Configuration base

Font

Color

Logotype

Feature icons (optional)

Store information

Privacy Policy

Google Play

Ownership

AppStore Privacy

Apple App Store

Google Play Data Safety

Background

Help users understand how your app collects and shares their data

Manual guide: Google Play > Policy > App content

2. Data collection and security

3. Naviga Android apps collects or shares:

Optionals

4. Data usage and handling

Email address

App info and performance: Crash logs, Diagnostics and Other app performance data

App activity: App interactions

Device or other IDs

5. Preview

Deleting user data

Statistics Events

Global attributes

Article Event

ArticleList Event

ArticleListRow Event

Article Read Event

Flow Event

Notification Event

Receive notification

Open notification

Onboarding Event

Profile Event

TopicPicker Event

View dialog

Create subscription

Naviga Mobile News Apps

Required information

Store information

Configuration base

Font

Color

Logotype

Feature icons (optional)

Ownership

Privacy Policy

Google Play

Google Play

Is your app a news app?

Article Read Event

Profile Event

Article Event

ArticleList Event

Flow Event

ArticleListRow Event

Onboarding Event

Statistics Events

Global attributes

TopicPicker Event

View dialog

Create subscription

AppStore Privacy

Apple App Store

App privacy > Advertising data

App privacy > Crash data

App privacy > Device ID

App privacy > Product interaction

App privacy > User ID

Notification Event

Receive notification

Open notification

Google Play Data Safety

Background