AppMetrica
AppMetrica splits app statistics into in-app activity and user acquisition through trackers. Renta exports either of them as an aggregated table: you pick one report type, then the dimensions and metrics that form its rows.
Authentication
Renta uses OAuth to authenticate with Yandex. You will be redirected to Yandex to grant Renta limited access to your AppMetrica applications.
Your credentials are encrypted in transit and at rest, and never stored in Renta's application database. You stay in control and can revoke access from your Yandex account settings at any time.
Connect AppMetrica source
- Navigate to the Connections > Catalog section in the left sidebar.
- Open the Analytics category and click the AppMetrica card.
The AppMetrica Logs API card next to it is a different source. It exports raw event and installation rows instead of aggregated reports.

Click Log in to your Appmetrica account. You will be redirected to Yandex to grant access.

Yandex shows the sign-in screen with the list of permissions Renta requests, including access to the statistics of your applications in AppMetrica. Choose the account that has access to your applications and confirm. After that you are redirected back to Renta.

Finish the setup:
- Source name.
Specify a name for this data source. This is used exclusively in the Renta interface. - Access granted.
Verify that the account is connected successfully.
Click Save to finish.
If your Yandex authorization later changes (for example, after a password change), click Re-authorize on this source. The connection refreshes in place and every pipeline built on it keeps running.

The new source appears in the Sources list with the Active status. You can now use it in pipelines.

Create an AppMetrica pipeline
Link your AppMetrica source to a destination and configure the pipeline.
In the left sidebar, click New pipeline. On the Source step, select AppMetrica under Already connected and click Next step.

Choose the AppMetrica connection you created earlier and click Next step.

On the Destination step, select your destination (for example, Google BigQuery) and click Next step.

Choose the destination connection you want to load data into and click Next step.

Pipeline configuration
On the final step, choose which AppMetrica data to export and how Renta loads it.
Report configuration
Point the pipeline at the application and choose the report type.

-
Counters Choose the application to export data from. The list contains the applications available to the connected Yandex account, shown by application name. One pipeline exports one application.
-
Report Types Choose the type of statistics to export. One pipeline exports one report type.
Report type What it covers Metrics General events In-app activity, grouped by attributes of the app and the device: app version, device type, operating system, screen resolution, and geography. Users, Sessions, Devices Custom events The events you send from the app yourself, with the same app and device attributes plus the event label. The parameters you attach to an event are available as averages and sums. Users, Sessions, Devices, Client Events, Average Parameters, Sum Parameters Campaigns Tracker clicks, grouped by campaign and publisher: how much traffic each acquisition source sent. Clicks Installs Attributed installations, grouped by campaign and publisher: which acquisition sources the installs came from. Install Devices
Parameters
Select the dimensions and metrics to include in the destination table. Your dataset schema is defined by the parameters you choose here.

| Name | API name | Description |
|---|---|---|
App Version text | ym:ge:appVersion | The version of the application. |
App Version and OS text | ym:ge:appVersionAndOS | Combination of app version and operating system. |
Build Number text | ym:ge:buildNumber | The build number of the application. |
App ID text | ym:ge:appID | The unique identifier for the application. |
Operating System Version text | ym:ge:operatingSystemVersion | The version of the operating system on the device. |
Mobile Device Branding text | ym:ge:mobileDeviceBranding | The branding of the mobile device. |
Mobile Device Model text | ym:ge:mobileDeviceModel | The model of the mobile device. |
Device Type text | ym:ge:deviceType | The type of device (e.g., smartphone, tablet). |
iOS IDFA text | ym:ge:iosIDFA | The Identifier for Advertisers on iOS devices. |
Screen Resolution text | ym:ge:screenResolution | The screen resolution of the device. |
Month text | ym:ge:month | The specific month of the event. |
Year text | ym:ge:year | The specific year of the event. |
Region text | ym:ge:region | The geographical region of the user. |
Region Area text | ym:ge:regionArea | The area within the region. |
Region City text | ym:ge:regionCity | The city within the region. |
Region Country text | ym:ge:regionCountry | The country of the user. |
Today date | date_today | Today's date |
Year text | year | Year of the date |
Year of week (Sun-Sat) text | yearofweek | Year of week for US weeks |
Year of week (Mon-Sun) text | yearofweekiso | Year of week for ISO weeks |
Year & month text | yearmonth | Year and month combined |
Quarter text | quarter | Quarter of the year |
Month text | month | Month of the year |
Year & week (Sun-Sat) text | yearweek | Year and week for US weeks |
Year & week (Mon-Sun) text | yearweekiso | Year and week for ISO weeks |
Week (Sun-Sat) text | week | US week number |
Week (Mon-Sun) text | weekiso | ISO week number |
Day of week (Sun-Sat) text | dayOfWeekName | Day of week name for US weeks |
Day of week text | dayOfWeekNameIso | Day of week name for ISO weeks (Mon-Sun) |
Day of month text | dayOfMonth | Day of the month |
Date date | date | Specific date |
| Name | API name | Description |
|---|---|---|
Users int | ym:ge:users | The number of unique users. |
Sessions int | ym:ge:sessions | The number of sessions. |
Devices int | ym:ge:devices | The number of devices. |
| Name | API name | Description |
|---|---|---|
App Version text | ym:ce:appVersion | The version of the application. |
App Version and OS text | ym:ce:appVersionAndOS | Combination of app version and operating system. |
Build Number text | ym:ce:buildNumber | The build number of the application. |
App ID text | ym:ce:appID | The unique identifier for the application. |
Operating System Version text | ym:ce:operatingSystemVersion | The version of the operating system on the device. |
Mobile Device Branding text | ym:ce:mobileDeviceBranding | The branding of the mobile device. |
Mobile Device Model text | ym:ce:mobileDeviceModel | The model of the mobile device. |
Device Type text | ym:ce:deviceType | The type of device (e.g., smartphone, tablet). |
iOS IDFA text | ym:ce:iosIDFA | The Identifier for Advertisers on iOS devices. |
Screen Resolution text | ym:ce:screenResolution | The screen resolution of the device. |
Event Label text | ym:ce:eventLabel | Label of the custom event. |
Month text | ym:ce:month | The specific month of the event. |
Year text | ym:ce:year | The specific year of the event. |
Region text | ym:ce:region | The geographical region of the user. |
Region Area text | ym:ce:regionArea | The area within the region. |
Region City text | ym:ce:regionCity | The city within the region. |
Region Country text | ym:ce:regionCountry | The country of the user. |
Today date | date_today | Today's date |
Year text | year | Year of the date |
Year of week (Sun-Sat) text | yearofweek | Year of week for US weeks |
Year of week (Mon-Sun) text | yearofweekiso | Year of week for ISO weeks |
Year & month text | yearmonth | Year and month combined |
Quarter text | quarter | Quarter of the year |
Month text | month | Month of the year |
Year & week (Sun-Sat) text | yearweek | Year and week for US weeks |
Year & week (Mon-Sun) text | yearweekiso | Year and week for ISO weeks |
Week (Sun-Sat) text | week | US week number |
Week (Mon-Sun) text | weekiso | ISO week number |
Day of week (Sun-Sat) text | dayOfWeekName | Day of week name for US weeks |
Day of week text | dayOfWeekNameIso | Day of week name for ISO weeks (Mon-Sun) |
Day of month text | dayOfMonth | Day of the month |
Date date | date | Specific date |
| Name | API name | Description |
|---|---|---|
Users int | ym:ce:users | The number of unique users. |
Sessions int | ym:ce:sessions | The number of sessions. |
Devices int | ym:ce:devices | The number of devices. |
Client Events int | ym:ce:clientEvents | The number of client-side events. |
Average Parameters float | ym:ce:avgParams | Average value of event parameters. |
Sum Parameters int | ym:ce:sumParams | Sum of event parameters. |
| Name | API name | Description |
|---|---|---|
Campaign text | ym:c:campaign | The name of the marketing campaign. |
Publisher ID text | ym:c:publisherID | The unique identifier of the publisher. |
Publisher Name text | ym:c:publisherName | The name of the publisher. |
Publisher text | ym:c:publisher | The publisher associated with the campaign. |
Today date | date_today | Today's date |
Year text | year | Year of the date |
Year of week (Sun-Sat) text | yearofweek | Year of week for US weeks |
Year of week (Mon-Sun) text | yearofweekiso | Year of week for ISO weeks |
Year & month text | yearmonth | Year and month combined |
Quarter text | quarter | Quarter of the year |
Month text | month | Month of the year |
Year & week (Sun-Sat) text | yearweek | Year and week for US weeks |
Year & week (Mon-Sun) text | yearweekiso | Year and week for ISO weeks |
Week (Sun-Sat) text | week | US week number |
Week (Mon-Sun) text | weekiso | ISO week number |
Day of week (Sun-Sat) text | dayOfWeekName | Day of week name for US weeks |
Day of week text | dayOfWeekNameIso | Day of week name for ISO weeks (Mon-Sun) |
Day of month text | dayOfMonth | Day of the month |
Date date | date | Specific date |
| Name | API name | Description |
|---|---|---|
Clicks int | ym:c:clicks | The number of clicks generated by the campaign. |
| Name | API name | Description |
|---|---|---|
Campaign text | ym:i:campaign | The marketing campaign that led to the app install. |
Publisher ID text | ym:i:publisherID | The unique identifier of the publisher responsible for the app install. |
Publisher Name text | ym:i:publisherName | The name of the publisher responsible for the app install. |
Publisher text | ym:i:publisher | The publisher associated with the app install campaign. |
Today date | date_today | Today's date |
Year text | year | Year of the date |
Year of week (Sun-Sat) text | yearofweek | Year of week for US weeks |
Year of week (Mon-Sun) text | yearofweekiso | Year of week for ISO weeks |
Year & month text | yearmonth | Year and month combined |
Quarter text | quarter | Quarter of the year |
Month text | month | Month of the year |
Year & week (Sun-Sat) text | yearweek | Year and week for US weeks |
Year & week (Mon-Sun) text | yearweekiso | Year and week for ISO weeks |
Week (Sun-Sat) text | week | US week number |
Week (Mon-Sun) text | weekiso | ISO week number |
Day of week (Sun-Sat) text | dayOfWeekName | Day of week name for US weeks |
Day of week text | dayOfWeekNameIso | Day of week name for ISO weeks (Mon-Sun) |
Day of month text | dayOfMonth | Day of the month |
Date date | date | Specific date |
| Name | API name | Description |
|---|---|---|
Install Devices int | ym:i:installDevices | The number of devices on which the app was installed. |
| Name | API name | Description |
|---|---|---|
Crash Dump Object array_text | ym:cr:crashDumpObj | The object containing detailed information about a crash. |
Today date | date_today | Today's date |
Year text | year | Year of the date |
Year of week (Sun-Sat) text | yearofweek | Year of week for US weeks |
Year of week (Mon-Sun) text | yearofweekiso | Year of week for ISO weeks |
Year & month text | yearmonth | Year and month combined |
Quarter text | quarter | Quarter of the year |
Month text | month | Month of the year |
Year & week (Sun-Sat) text | yearweek | Year and week for US weeks |
Year & week (Mon-Sun) text | yearweekiso | Year and week for ISO weeks |
Week (Sun-Sat) text | week | US week number |
Week (Mon-Sun) text | weekiso | ISO week number |
Day of week (Sun-Sat) text | dayOfWeekName | Day of week name for US weeks |
Day of week text | dayOfWeekNameIso | Day of week name for ISO weeks (Mon-Sun) |
Day of month text | dayOfMonth | Day of the month |
Date date | date | Specific date |
| Name | API name | Description |
|---|---|---|
Year text | ym:s:year | The year when the session occurred. |
Month text | ym:s:month | The month when the session occurred. |
Today date | date_today | Today's date |
Year text | year | Year of the date |
Year of week (Sun-Sat) text | yearofweek | Year of week for US weeks |
Year of week (Mon-Sun) text | yearofweekiso | Year of week for ISO weeks |
Year & month text | yearmonth | Year and month combined |
Quarter text | quarter | Quarter of the year |
Month text | month | Month of the year |
Year & week (Sun-Sat) text | yearweek | Year and week for US weeks |
Year & week (Mon-Sun) text | yearweekiso | Year and week for ISO weeks |
Week (Sun-Sat) text | week | US week number |
Week (Mon-Sun) text | weekiso | ISO week number |
Day of week (Sun-Sat) text | dayOfWeekName | Day of week name for US weeks |
Day of week text | dayOfWeekNameIso | Day of week name for ISO weeks (Mon-Sun) |
Day of month text | dayOfMonth | Day of the month |
Date date | date | Specific date |
- Dimensions.
The attributes rows are grouped by. Each entry shows the label and the API name below it, soym:i:campaignappears under Campaign. - Metrics.
The numeric columns. Select at least one metric: a report without metrics has nothing to count and AppMetrica rejects it.
Unselect All clears the picker, and the Selected tab shows the current choice.
In the destination table, column names repeat the API names of the parameters without the ym:ge:, ym:ce:, ym:c:, and ym:i: prefixes: ym:ge:appVersion becomes appVersion. Renta also copies the description of each parameter into the description of the corresponding column.
Date parameters
The Dimensions tab of the General events and Custom events reports contains date fields: Date and Today, plus calendar fields such as Year, Quarter, Month, Week, and Day of week. Renta derives the calendar fields from the event date, and adds the date to the report automatically when you select one of them.
Include the Date parameter in the report. With it, the destination table is partitioned by the date column and Renta loads data incrementally. It also enables the Overwrite period setting, which appears below the date range once a date parameter is selected. Without it, Renta reloads the whole date range on every run.
The Campaigns and Installs reports have no date parameters at all. Their tables get no date column, which means every run reloads the full date range. Use them for the totals of the selected period, and take the daily breakdown of acquisition from the General events report.
Table name and date range
Name the pipeline and set the historical period to load.

- Integration name.
The name of the pipeline. It is used exclusively in the Renta interface. - Table name.
The destination table name. You can keep the auto-generated name or enter your own. - Date start.
The first date of the extraction period. - Date end.
The last date of the extraction period. You can pick a fixed date or a relative option such as Today.
AppMetrica limits a Yandex account to 5,000 report requests per day, counted across every pipeline built on that account. If you load years of history for several pipelines at once, AppMetrica answers with a Too Many Requests error. Load long history in parts, or wait until the quota resets.
Overwrite period
The overwrite period defines how many recent days Renta reloads on every run. The setting appears once a date parameter is selected in Parameters.
On each run, Renta re-fetches the data starting from the date of the last successful run minus the overwrite period. The affected days are deleted from the destination table and inserted again, while older data stays untouched.
AppMetrica keeps matching installs to clicks for 10 days after the click, and up to 30 days depending on the tracker settings, so acquisition figures for past dates keep changing. Set the overwrite period to cover the attribution window you use.
Schedule
Choose how often the pipeline runs.

| Schedule type | Description |
|---|---|
| Manual | The pipeline runs only when triggered manually through the interface or via API. |
| Daily | The pipeline runs once a day at the specified update time. |
| Interval | The pipeline runs at specified time intervals. |
| Cron Expression | The pipeline runs on a schedule defined by a cron expression. |
For Daily schedules, set the Update time, the exact time each run starts, then click Create pipeline.

Renta also supports API triggers and integration with external orchestrators such as Apache Airflow, Dagster, and Prefect. See the full scheduling documentation for details.
The new pipeline appears in the Pipelines section under the ETL tab, where you can track its runs, progress, and the destination table name.

Sync strategy
The synchronization strategy depends on whether the report includes a date parameter.
| Strategy | Supported report types | Description |
|---|---|---|
| Incremental | General events, Custom events (with the Date or Today parameter selected) | Each row carries its date, and the destination table is partitioned by that column. On every run Renta requests the window from the last successful run minus the overwrite period to the end of the date range: the affected daily partitions are deleted and inserted again, and older partitions stay untouched. |
| Full reload | Campaigns, Installs, and also General events and Custom events when no date parameter is selected | The report returns no date column to partition by, so Renta requests the whole configured date range and replaces the dataset on every run. |
Changing the selected parameters updates the table schema, so the next run after the change reloads the entire date range.
Ready to get started?
Build your data pipeline today or get a personalized demo. Start free!
Need help?
Get expert support to ensure your project succeeds. We're here to help!
Feature requests?
Help shape our product! Share your ideas for new features and integrations.