Skip to main content
Feedback

MobileAction walkthrough

Pulling data

  1. Select the connection.
  2. Select the required report.
  3. Select additional attributes.

Reports

Daily Keyword rankings and App version details

  1. Apps: Select the input field or the Refresh button to load all available apps. Select the desired apps from the list, or leave the checkbox empty to include all apps.

The data returns contain 3 parts: track_id, app_id, and app_name separated by a |-|

For example, 123 |-| 456345 |-| great-app

  1. Countries: 2. Countries: Leave the field blank to include all supported countries for each app (since different apps support different countries). Alternatively, select specific countries from the list to fetch data only for those locations.
  1. Device: Select the device. The default device is "iPhone".

    It is not relevant in the "Version Details" report.

  2. Time Period: The report works on full days only—for example, 2018/10/23. You can select a custom date range or a defined time period from the list (for example, Yesterday, Last Week).
(If selecting Date range:)
  1. Select the start date and end date.
  2. Leave the end date empty to pull data until the river runs.
  3. After each run of the river, the start date will be updated automatically with the end date, and the end date will be updated with the empty value. This enables the next run to pull data from the end of the previous run.
  4. Select the time zone offset. This is relevant only if the end date is empty to determine the river’s run according to the time zone.
  5. Days back: Use this option to pull data from the given days before the start date.

If selecting any other value:

Select the time zone offset to send the correct dates that consider the offset.

App details and Keyword spots

  1. Apps: Select the input field or the Refresh button to load all available apps. Select the desired apps from the list, or leave the field blank to include all apps.

The data returns contain 3 parts: track_id, app_id, and app_name separated by a |-|

For example, 123 |-| 456345 |-| great-app

  1. Countries: Leave this field blank to get all relevant countries per app (different apps support different countries). You can select from a list of countries to pull data only from those countries.
  • The Keyword Spots report is only for iOS applications. An iOS application is identified by its App ID. If the App ID is numeric, then it is an iOS app; otherwise, it is an Android app.

MobileAction API limitations

The MobileAction API has two main limitations:

  1. You can make 200 API calls within a minute.
  2. You cannot make more than 1000 calls on a given day.

To modify these limitations, contact your MobileAction representative.

Daily keyword rankings API calls calculation explanation

Select one call per app, per country, and per day. For example, if you choose one application, 10 countries, and 15 days, this results in (1 x 10 x 15) 150 calls

App version details API calls calculation explanation

Select only one call per app, country, and version. For example, if you choose one application, 10 countries, and the app has 60 versions, this results in (1 x 10 x 60) 600 calls.

App details and keyword spots calls calculation explanation

One call per app and per country. For example, choosing two applications and 10 countries results in (1 x 20) 20 calls.

  • The call count varies depending on how you configure the river.
  • When you do not set the countries in advance, the system makes an additional call per app to get all relevant countries when the river executes. For example, if you choose 10 apps and no countries, the system makes an additional 10 calls to get all countries.
On this Page