How is this source different from the AppMetrica source?

This source exports raw rows: one installation or one e-commerce event per row, with its own identifiers and timestamps. The AppMetrica source exports aggregated reports, where a row is a combination of the dimensions you selected and the metrics are counts and sums. Use this source to build your own aggregations or to join app data with other sources at the device level, and the AppMetrica source for ready-made statistics.

Why is Date end set to Yesterday?

Events reach the Logs API with a delay, so the current day is always incomplete at the moment of the export. Keep **Date end** set to **Yesterday** to load whole days only, and use the **Overwrite period** to re-request the recent ones as late events arrive.

Which time zone are the dates in?

AppMetrica records events in the time zone configured for the application, under **Settings** > **Main** > **Time zone UTC** in the AppMetrica interface. The date range and the *_datetime fields follow that setting. The *_timestamp fields hold Unix time, so use them when you need a value that does not depend on the application's time zone.

Does the E-commerce report contain only purchases?

No. A row is any e-commerce event the app sends, and the ecom_type field says which one: show_screen , show_product_card , show_product_details , add_cart_item , remove_cart_item , begin_checkout , or purchase . Filter by that field to get purchases alone.

Can one pipeline export several applications?

No. The **Counters** list accepts one application. To export several applications, create a separate pipeline for each one and give each pipeline its own table name.

Why are the column names in my table so cryptic?

The picker and the destination table use the field names of the Logs API itself, such as appmetrica_device_id or ecom_product_sku . On Google BigQuery, Renta attaches the description of each field to the corresponding column, so you can read what a column means in the table schema.

AppMetrica Logs API

The AppMetrica Logs API exports the raw rows behind the reports: one installation or one e-commerce event per row, with the device identifiers and timestamps attached to it.

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 Logs API source

Follow these steps to add AppMetrica Logs API as a source in Renta using OAuth authentication.

Go to the CatalogStep 1

Navigate to the Connections > Catalog section in the left sidebar.
Open the Analytics category and click the AppMetrica Logs API card.

The AppMetrica card next to it is a different source. It exports aggregated reports built from dimensions and metrics instead of raw rows.

AppMetrica Logs API card in the Analytics category of the Renta source catalog

Authorize connectionStep 2

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

Authorize connection page for a new AppMetrica Logs API connection in Renta

Choose a Yandex accountStep 3

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.

Yandex sign-in page with the account selection and the list of permissions requested by Renta

Name the connection and saveStep 4

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.

Set up your AppMetrica Logs API connection with the source name field and the access granted block

Source createdStep 5

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

Sources list with the new AppMetrica Logs API source in the Active status

Create an AppMetrica Logs API pipeline

Link your AppMetrica Logs API source to a destination and configure the pipeline.

Select AppMetrica Logs API as the sourceStep 1

In the left sidebar, click New pipeline. On the Source step, select AppMetrica Logs API under Already connected and click Next step.

Select a source step with AppMetrica Logs API under Already connected

Select your AppMetrica Logs API connectionStep 2

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

Select your AppMetrica Logs API connection step with the connected Yandex account

Select a destinationStep 3

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

Select a destination step with Google BigQuery under Already connected

Select the destination connectionStep 4

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

Select your Google BigQuery connection step with the dataset and project identifiers

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.

AppMetrica Logs API application and report type selection on the pipeline settings step

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 what to export. One pipeline exports one report type.

Report type	What one row contains
Installation report	One installation: the install and click timestamps, the attribution block (tracker, campaign, publisher, match type, re-attribution and re-installation flags), device identifiers, and the device, network, geography, and app attributes.
E-commerce report	One e-commerce event: its type and the screen, product, cart, order, and referrer attributes, together with the event identity, device identifiers, and the device, network, geography, and app attributes.

Parameters

Select the fields to include in the destination table. Your dataset schema is defined by the parameters you choose here.

The Parameters list is a single flat list of the fields available for the selected report type, named exactly as they are named in the Logs API: installation_id, appmetrica_device_id, ecom_product_sku. Check the fields to export, use the search to find a field by name, or click Select All. The Selected tab shows everything you picked, and the Selected Parameters list below the picker lets you remove a field with the minus button.

Select at least one field: a pipeline with an empty Parameters list cannot be created.

The list of the Installation report covers attribution (tracker_name, publisher_name, click_datetime, attributed_touch_type, is_reattribution), install timestamps, device identifiers (appmetrica_device_id, google_aid, ios_ifa, oaid), and the device, network, geography, and app attributes.

The list of the E-commerce report follows the funnel instead: the event type in ecom_type, then the screen, product, cart, and order fields, plus the event identity (event_name, event_datetime, session_id) and the same device and app attributes.

In the destination table, column names repeat the field names of the Logs API as they are. On Google BigQuery, Renta also attaches the description of each field to the corresponding column.

Date parameters

The list also contains date fields calculated by Renta: Date and Today, plus calendar fields such as Year, Quarter, Month, Week, and Day of week. Renta derives them from the installation date in the Installation report and from the event date in the E-commerce report.

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 the parameter is selected. Without it, Renta reloads the whole date range on every run.

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. Set it to Yesterday.

Leave Date end set to Yesterday. Events reach the Logs API with a delay, so an export that includes the current day returns it incomplete, and the run records a partial day as if it were final.

AppMetrica prepares each export on its side before it can be downloaded, and Renta waits for it. The first run over a long history therefore takes noticeably longer than the following daily runs, which pick up a day or two at a time.

Overwrite period

The overwrite period defines how many recent days Renta reloads on every run. The setting appears once the 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.

Installations keep being matched to clicks after the install itself: AppMetrica attributes a click for 10 days by default, and up to 30 days depending on the tracker settings. Rows already exported can therefore get their attribution filled in later. 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.

AppMetrica Logs API update time selection and the Create pipeline button

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.

Pipelines list with the new AppMetrica Logs API integration in the Completed status

Sync strategy

The synchronization strategy depends on whether the report includes the Date parameter.

Strategy	Supported report types	Description
Incremental	Installation report, E-commerce report (with the Date or Today parameter selected)	Each row carries its date, and the destination table is partitioned by the `date` 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	Installation report, E-commerce report (without a date parameter)	The table has 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.

Frequently asked questions

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.