Help Articles

Help Articles Seraphim

Help Topics 

 

Application setup

Application setup Seraphim

To add an application, go to Settings > Applications and click the "Add" button 

In the window that appears, fill in all the required fields.

  • Application name - any suitable
  • Bundle ( com.company.appname )
  • Google Property ID - (?) 
  • Application category name (?) 
  • The application metric is optional. It is needed for analytics.

 

Application ID

Application ID Seraphim

An Android application ID (Application ID) is a unique string that identifies your application across devices and app stores such as the Google Play Store.

The app ID is usually specified in the build.gradle file of your android project. It looks like a reverse domain name in the format com.example.myapp. Each application must have a unique identifier to avoid conflicts and ensure that the application is uniquely identified.

The app ID not only uniquely identifies your app in the app stores, but also defines the app's package name in the Android operating system. It is used to access various resources and application components such as permissions, activities, and services.

In addition, the Application ID may play a role when interacting with other services and APIs, such as ad networks or analytics tools, that require an Application ID for integration.

Application categories

Application categories Seraphim

To make it easier to find the desired application in the list, they are grouped into categories.

When you create an application, you can assign a category to it.

Next, the application will be displayed as a child application of this category.

How to set up Google Analytics

How to set up Google Analytics Seraphim

In order to set up Google Analytics for data transmission, you need to 

  1. Go to the Google Analytics website 
  2. Enable the Google Analytics API 
  3. If you have permission issues, you can watch this video

Property Id

Property Id Seraphim

PropertyId - This is the identifier of the property in Google Analytics, according to which information is collected from applications (there may be several).

To determine the Google Analytics 4 property ID:

  1. Visit Google Analytics
  2. Select Admin. 
  3. Select Property. 
  4. Select Property Settings. 

 

To customize the transfer of propertyId 

  1. Create a service account
  2.  Grant service account rights to all analytics. 
  3. Find propertyId in Analytics.
  4. Grant Analyst rights to this service account

 

 

Useful Resources

Useful Resources Seraphim

List of useful resources 

Banner exchange

Banner exchange Seraphim

The system allows you to exchange advertising banners within the company. In this case, no fee is charged. You are in complete control of your traffic and resources. 

Banner exchange can be both unmotivated and motivated. Analytics systems will not consider this traffic as advertising. That is, it will be perceived as independent (direct). 

Thus, you can not only reduce the cost of purchased traffic (by transferring users to other relevant applications), but also significantly improve the performance of your application. 

In order for the application to receive traffic, it is enough to set up its promotional materials and add it to the network. Traffic will start flowing in immediately.

It should be remembered! 

Traffic comes only from your applications. And accordingly, if the application does not give traffic, then other applications will not receive it.

 

Reports

Reports Seraphim

Banner exchange reports are generated in real time. 

Report filters are different from Google Analytics filters. 

The following events are logged for banner exchange: 

  • Demonstration of the promotional banner
  • Go to the app store by clicking on the promotional banner
  • Referral installation 

In the reports, you can see both incoming and outgoing traffic. Also divide traffic into banners and icons.

Conversion transition to install

Conversion transition to install Seraphim

Banner exchange > Conversion transition to install

Shows how well clicks to the app store convert into game installs. 

Filters:

Platforms:

  • by platforms at once (sum), 
  • by a single platform.

Type:

  • Icon,
  • Banner

Incoming traffic

Incoming traffic Seraphim

Banner exchange > Incoming traffic

Shows the amount of traffic received for each individual application. Impressions, transitions and installations are displayed in one chart at once. With the ability to filter by the following parameters:

Platforms:

  • by platforms at once (sum), 
  • by a single platform.

Type:

  • Icon,
  • Banner

Summary report

Summary report Seraphim

Banner exchange > Summary report

Demonstrates the operational dynamics of banner exchange in the following sections:

Actions:

  • Displays of promotional materials 
  • Transitions to the application store 
  • Referral installation of applications

Platforms:

  • by platforms at once (sum), 
  • by a single platform.

Type:

  • Icon,
  • Banner

Settings

Settings Seraphim
  • Setting up receiving traffic
  • Configuring traffic return 
  • SDK integration

Configuring traffic return

Configuring traffic return Seraphim

The necessary conditions:

  1. SDK is integrated
  2. The application is added and configured correctly, as described in the instructions

 

Setting procedure:

In order for the application to start sending traffic, you need to

  1. configure the platform on which the application runs. For this
    1. go to application settings 
    2. Select the required application 
    3. Go to the platforms page
       

Next, you should go to the desired platform. For example Android and fill in the application settings.

  • Game Bundle is the applicationID under which it is registered in the Google Play store. (e.g. com.foranj.newyeartale)
  • Store url - link where the application is available through the browser
  • in-app-url - a link by which the application is available for searching in the native app store (in this case, google play). An example of what it should look like is given next to the input field (market://details?id=[bundle])
  • Activity flag - indicates that the application will send and receive traffic.

All these fields are mandatory. Based on these fields, behavior models of the banner exchange network will be formed.

After filling in all the fields, click the "apply" button.

 

File browser

File browser Seraphim

The file browser is integrated into the system for the convenience of selecting files, as well as for convenient access to promotions within the company. Files uploaded to the storage will be available to all users attached to the company.

 

The file browser is available on the profile page and on the banner exchange promo materials selection page.

Image upload

  1. Open the file browser by clicking the appropriate button 
  2. On the left side, in the explorer, go to the root folder of your company. 
  3. Create, if necessary, a subfolder inside the company folder. 
  4. Select the required folder where the image will be uploaded.
  5. Press the "download" button, which is located at the top of the window. 
  6. The same file can be applied as a promotional material by clicking the "select" button

Choosing an image as a promotional material

When setting up banner exchange, you must select its image. You can do this in the following way:

  1. Click the "open file browser" button. 
  2. On the left side (in the explorer), click on your company folder. 
  3. Next inside, go to the next level folder of interest. 
  4. On the right side, the contents of the selected folder will appear. 
  5. Select one of the files and click the "select" button. 
  6. The image will be selected as promotional material .

 

Important!

  1. The files must have a jpeg or jpg extension. 
  2. The files must be inside your company folder. Otherwise, they will be inaccessible to other members of your company. 
  3. Before uploading a file to the system, you should use one of the image pasteurization systems, such as tinyPNG. This will significantly reduce the traffic of your application.

Setting up receiving traffic

Setting up receiving traffic Seraphim

The necessary conditions:

  1. SDK is integrated
  2. The application has been added and configured correctly, as described in the instructions
  3. The application has "traffic delivery" enabled and configured through banner exchange

Setting up receiving traffic:

  1. go to application settings 
  2. Select the desired application 
  3. Go to the icon page
  4. Using the built-in file browser, select the appropriate icon for the application. It will be shown to the players in the game interface.
  5. Press the "apply" button and the icon will be applied to this platform. If you click the "apply on all" button, the icon will be applied on all configured platforms.
  6. In the same way, configure the application banner that will be shown on the exit screen of the game.
  7. Make sure that the platforms you are interested in are activated, as described in the traffic return settings

After saving the settings, the banner exchange network behavior model will be rebuilt. New promotional banners will be shown to users as the data is updated with the start of the next session.

Change Tracking

Change Tracking Seraphim

Daily, the digital assistant reviews the change in the description of the google play store apps.

The following parameters are analyzed:

  • App icon
  • Name
  • Size
  • Ratings
  • Description
  • Short description
  • Images
  • Videos

All changes are logged and displayed on the respective pages.

You can add applications to your favorites. And also set up notifications. You will receive a message with a description of the changes and a link to the full details.

 

Notifications

Notifications Seraphim

Notifications about changes in the google play app store

Company

Company Seraphim

By creating a company, you can 

  • Implement banner exchange within your applications 
  • Significantly expand the capabilities of Google Analytics 
  • Receive notifications of changes in the google play store for the positions you are interested in 
  • Receive videos of player gameplay 

Within the company will be available 

  • general list of images
  • access to settings
  • access to analytic
  • saccess to videos
  • access to error reports

Registration

Registration Seraphim

Settings > Company

  • Go to the link Settings > Company
  • Fill in the field with the name of the company
  • Fill in the field with the Google Analytics key (description) 

The next step is to invite users. Or go straight to setting up applications.

User Invitation

User Invitation Seraphim

Settings > Company

 

Precondition:

  • The user must be registered in the system

Adding Users:

  • Go to the link Settings > Company
  • Enter the email address of the registered user
  • Click the "Invite" button
  • After the user receives the notification and agrees with it, the user's data will appear in the list of invitees.

 

Important! 

Invite and delete users, as well as change company settings - can only be the owner of the company

Google Analytics Reports

Google Analytics Reports Seraphim

Reports are based on data from Google Analytics v.4 (hereinafter referred to as GA4) Data from GA4 is loaded as needed. The downloaded data is updated once a day. Further, the data is cached and the data retrieval limit is no longer used.

Prerequisites

  1. Company is set up 
  2. Application is set up

Custom Reports

  • Settings
  • View

Dash Board

Dash Board Seraphim

Оперативная информация о приложениях.

  • Total DAU - сводный отчёт по всем приложениям, добавленным в систему и получающих данные из Google Analytics.
  • Versions - Сводный отчёт по версиям приложений, установленных у пользователей. Формируется на основании DAU
  • New Users - Сводный отчёт зарегистрированным новым установкам с разрезом по версиям приложений

 

Report Options

Report Options Seraphim

All reports can be parameterized by several sections:

  1. Project: one of the applications for which data is collected 
  2. Country: filtering by country can occur in several modes
    1. All in one - all countries, no filtering
    2. Apart country - several selected countries, with a separate column for each country Unity Country - several selected countries united in one graph
    3. Top XX - Countries with maximum indicators with a separate column for each country
  3. Platform: whether to display data for a separate platform , or group them together 
  4. Stream: Which data stream to display. Depends on platform selection
  5. Version. Which version to display. Depends on platform choice

 

It is also possible to compare filtered indicators in one or more charts. To do this, you need to check the "comparison" box and fill in the filter of the second data block.

If you check the "two graphs" checkbox in the comparison mode, then the data will be displayed on separate graphs side by side. If you uncheck this box, then the data will be displayed in one graph.

Comparison is not possible in some of the filtered countries. Modes such as Top XX, Apart Country will be disabled if Single Graph Compare Mode is enabled.

Report types

Report types Seraphim

Comparative

Comparative Seraphim

Comparative report type allows you to compare two applications. Or one application, but with a different set of filters. Like different versions. For them, the main reports are built on one page - a set of single reports.

Full report

Full report Seraphim

All reports for one application are built on one page according to the set filters. Allows you to evaluate the effectiveness of the application by various metrics. For example, you can evaluate the effectiveness of an application in a particular country or for a particular version.

Single report

Single report Seraphim

Available in the menu Reports > Single 

Single reports allow 

  • Visualize one of the app's metrics;
  • Compare that metric with another app or with a different set of filters
  • Apply a wide set of filters to a metric

 

Reports

Reports Seraphim

You can generate one of the proposed reports

User reports:

User Level Reporting:

  • Level Funnel

Game session reports:

In-app ad reporting:

  • ADS views
  • ADS Table
  • ADS users per Total users
  • ADS shows per user
  • ADS shows per session

Monetization Reports:

  • ($) Purchases total
  • (¢) Purchase Per User
  • First Time Purchasers
  • Total Purchasers
  • Gem Spend Table

Average session duration

Average session duration Seraphim

report on the average duration of one session. If there were several sessions per day, then the average duration is calculated as the ratio of the total duration of daily activity to the number of sessions.

In a period of more than 1 day, it is considered as the ratio of the sum of the average duration of a day's session to the sum of the number of user sessions.

sum(averageSessionDuration) / sum(sessionsPerUser)

DAU

DAU Seraphim

Daily Amount Users report - how many users started the game on a particular day.

In the long run, the average number of users who have started the game is displayed. Calculated as the sum of the number of users divided by the number of days  
[sum(totalUsers) / count(distinct date)]

New installations

New installations Seraphim

Displays data about new installations in the application

In long-term periods, the average number of new users who launched the game is displayed. Calculated as the sum of the number of users divided by the number of days [sum(newUsers) / count(distinct date)]

Player quality

Player quality Seraphim

The ratio of the number of quality sessions to the total number of sessions.

A high-quality session is considered to be a session with a gameplay duration of more than 10 seconds or at least one conversion to the goal.

 

 

 

Retention

Retention Seraphim

Player retention report by game level.

Shows the percentage of users who returned to the game in the following days to the number of users on day zero (install day).

Working with charts

Working with charts Seraphim

Each chart has a wide functionality

  • Disabling an individual graph. To disable one of the chart lines: 
    • Find the desired line in the legend, 
    • click on the inscription 
    • The graph line of the corresponding inscription will be disabled. The scale has been rebuilt. 
    • To turn it on, click on it again, or refresh the page. 
  • Displaying data in a table 
    • Find the chart menu
    • Click "View Data Table"
    • A table with data will appear below.
  • Export chart 
    • Find the chart menu
    • Choose one of the options 
      • Download PNG
      • Download JPG
      • Download PDF
      • Download SVG
  • Print Graph 
    • Find the chart menu
    • Select Print Chart
  • Full screen mode 
    • Find the chart menu
    • Select the Full Screen item
  • Detailing the chart
    • Move the mouse pointer to the range of interest. A tooltip will appear with the values at the nearest point in the graph. 
  • Search by legend 
    • Move the mouse pointer over one of the names in the legend. The graph corresponding to the selected legend item will be highlighted.

 

Video Analytics

Video Analytics Seraphim

Video Analytics

Running a video analytics experiment

Running a video analytics experiment Seraphim

Prerequisites 

  1. The company is configured 
  2. The application is configured 
  3. SDK is added to the application 
  4. The first launch of the application of the tested version with the integrated SDK is completed

Event recording

  1. Go to the page Video > Experiments 
  2. Press the "Create new" button
  3. Fill in the required fields 
    1. Name of the experiment
    2. Select the application under test from the list of previously configured ones
    3. Select the version from the list (Versions are included in the list at the first start)
    4. Select the start date of the experiment, as well as its duration
  4. Click the "Create" button

In a few minutes the experiment will start. Watching the video of the experiment will be available on the same page immediately after it is recorded by the players.

 

Setting up video analytics

Setting up video analytics Seraphim

Setting up video analytics 

All you need to do is connect the application to the system. 

For the correct functioning of the system, it is important that the app bundle (App bundle name) is configured. 

Further, the application can be selected when starting the experiment.

 

 

Video analytics integration

Video analytics integration Seraphim

To integrate video analytics into the application, just add the SDK to the project

Video analytics. Viewing recorded clips

Video analytics. Viewing recorded clips Seraphim

To view previously recorded clips: 

  • Go to the page Video -> Experiments
  • From the list, select the project you are interested in. 
    If experiments have been previously created, you will see a list of them.
  • Go to the experiment page by clicking the "View" button. 
    The experiment will be loaded, with an interactive view control. 

 

On the first screen, you will see a list of recorded sessions. The list contains

  •  Session ID within the experiment
  • Level reached by the player
  • Number of recorded events
  • Number of frames recorded
  • Number of errors and exceptions that occurred 

By clicking on one of the sessions, you will be able to view the gameplay video. Events will be displayed in the order they occur. 

The refresh rate is different for each device. Selected in accordance with the bandwidth of the device's channel and the speed of the device, so that the player does not experience discomfort when playing. In this regard, the refresh rate of frames in some cases may be small.