Python library

In MyTracker, you can use a Python library for even more convenient tracking of data through API requests. You can download raw data, reports and segments in just a few code lines.

Only account owners and users with the granted export permissions can export raw data and segments from the account. For details, see User management.

Using Python library

Before start working with the Python library:

get authentication data
install the library via the pip package manager

To install the library:

pip install mytracker-export-api

Find the Python library in the GitHub repository.

Exporting raw data

Use your API User ID and API Secret Key along with the required raw data parameters, selectors, and events to export raw data:


from mytracker_export_api import MyTracker

API_USER_ID = 123
API_SECRET_KEY = 'AaBbCc'

params = {
    'dateFrom': '2022-05-01',
    'dateTo': '2022-05-31',
    'selectors': 'idAdEventTypeTitle,tsClick,tsView,dtEvent,tsEvent,idPartnerTitle,advertisingId',
    'idApp': 2,
    'event': 'installs'
}

client = MyTracker(api_user_id=API_USER_ID, api_secret_key=API_SECRET_KEY)
raw_data = client.get_raw_data(params)
raw_data.head()

The result will be returned in Pandas DataFormat by default:

	idAdEventTypeTitle	dtEvent	tsEvent	idPartnerTitle	advertisingId
0	Unknown	2022-05-31	1010101010	Organic	00000000-0000-0000-0000-000000000000
1	Unknown	2022-05-30	2020202020	Organic	00000000-0000-0000-0000-000000000000
2	Unknown	2022-05-31	3030303030	Organic	00000000-0000-0000-0000-000000000000
3	Unknown	2022-05-14	4040404040	Organic	00000000-0000-0000-0000-000000000000
4	Unknown	2022-05-29	5050505050	Organic	00000000-0000-0000-0000-000000000000

If you want to save the table as a CSV file, use raw_data.to_csv:

raw_data.to_csv('raw_data.csv', index=False)

If you want to receive a response from a server and not a default DataFrame, use the return_df=False value:

response = client.get_raw_data(params, return_df=False)
print(response)

In this case, the response will be the following:

{'code': 200,
    'data': {'idRawExport': '11040581',
        'status': 'Success!',
        'files': [{'link': 'https://somelink.csv.gz',
            'timestampExpires': '1655975434'}]},
    'message': 'Ok'}

Use the received link to download the raw data file. For details, refer to the Data download section.

If there is an error occurred in a request, then the MyTrackerError exception with a server response and error details will be requested.

Exporting reports

Use your API User ID and API Secret Key along with the required parameters and selectors to export reports:


    from mytracker_export_api import MyTracker

    API_USER_ID = 123
    API_SECRET_KEY = 'AaBbCc'

    params = {
        'settings[selectors]': 'date,idPartner,sumCampaignCost',
        'settings[filter][date][from]': '2022-06-01',
        'settings[filter][date][to]': '2022-06-10',
        'settings[filter][dimension][idApp][value][]': [1, 2, 3],
        'settings[filter][dimension][idPartner][value][]': [10006, 10008],
        'settings[idCurrency]': 840,
        'settings[tz]': 'Europe/Moscow',
        'settings[precision]': 5,
        'settings[retIndent]': 3600,
    }

    client = MyTracker(api_user_id=API_USER_ID, api_secret_key=API_SECRET_KEY)
    report = client.get_report(params)
    report.head()

To get data for multiple applications, add square brackets to the key 'idApp[]': [1, 2, 3] or separate the desired values in the string with commas 'idApp': '1,2,3'.

	Date	Partner	Campaign cost
0	2022-06-01	Google Ads (AdWords)	33097.9940
1	2022-06-01	Facebook	7877.1799
2	2022-06-02	Google Ads (AdWords)	31768.5755
3	2022-06-02	Facebook	6858.8901
4	2022-06-03	Google Ads (AdWords)	30292.7189

If you want to save the table as a CSV file, use report.to_csv:

report.to_csv('report.csv', index=False)

If you want to receive a response from a server and not a default DataFrame, use the return_df=False value:

response = client.get_report(params, return_df=False)
print(response)

In this case, the response will be the following:

{'code': 200,
    'data': {'idReportFile': '1394792',
        'status': 'Success!',
        'files': [{'link': 'https://somelink.csv.gz',
            'timestampExpires': '1655977002'}]},
    'message': 'Ok'}

Use the received link to download the report file. For details, refer to the Data download section.

If there is an error occurred in a request, then the MyTrackerError exception with a server response and error details will be requested.

Exporting segment

Use your API User ID and API Secret Key along with the required parameters to export segments:


    from mytracker_export_api import MyTracker

    API_USER_ID = 123
    API_SECRET_KEY = 'AaBbCc'

    params = {
        'idSegment': 1111,
        'requestFields': 'idfa,gaid',
        'includeHeaderLine': 1,
        'registerType': 0,
        'hashType': 0
    }

    client = MyTracker(api_user_id=API_USER_ID, api_secret_key=API_SECRET_KEY)
    response = client.get_segment(params)
    print(response)

When exporting segments, you receive only a response from a server:

{'code': 200,
    'data': {'idSegmentExport': '16',
        'status': 'Success!',
            'files': [{'link': 'https://somelink.csv.gz',
            'timestampExpires': '1655392109'}]},
    'message': 'Ok'}

Use the received link to download the segment file. For details, refer to the Data download section.

If there is an error occurred in a request, then the MyTrackerError exception with a server response and error details will be requested.

Was this article helpful?