python adjust

Bem-vindo ao python-adjust

Este é um invólucro python não oficial para a API REST AJUST.COM. Não sou de forma alguma afiliados ao AJUST.COM, use por seu próprio risco.

Cumprimentos

Este projeto foi inspirado por ajuste

Documentação

Encontre documentação oficial por: https://help.adjust.com/en/article/kpi-service

Investir rápido

Seu acesso ao serviço KPI está vinculado à sua conta de usuário de ajuste. Cada conta de usuário possui um token de usuário associado, para permitir que você controla individualmente o acesso aos seus KPIs.

Você pode encontrar seu próprio token de usuário no painel, em Configurações da conta> seus dados> Detalhes do usuário . Este é o token do usuário que nos referiremos para sua autenticação abaixo.

 pip install python-adjust

Vamos recuperar a lista de aplicativos acessíveis a você

 from adjustapi . api import AdjustApi

api = AdjustApi ( 'USER_TOKEN' )

apps = api . list_apps ()

print ( apps [ 0 ]. name , apps [ 0 ]. token , apps [ 0 ]. id )
# Prints something like: "MyTestApp ft5popkfebns com.mytest.app"

É assim que a API KPI funciona

 kpis_api = api . kpi_service ( trackers = trackers ,
                           start_date = start_date ,
                           end_date = end_date ,
                           countries = countries ,
                           app_tokens = app_tokens ,
                           kpis = kpis )
print ( str ( kpis_api . fetch_kpi ()))
# prints: KpiResult(result_parameters=ResultParameters(kpis=['revenue'], start_date=datetime.date(2020, 4, 4), end_date=datetime.date(2020, 5, 4), sandbox=False, countries=['us'], events=None, trackers=[TrackerResultParameters(token='tsrdag', name='Facebook Installs::Expired Attributions', currency=None, has_subtrackers=False)], grouping=['trackers'], period=None, attribution_type='click', utc_offset='00:00', cohort_period_filter=None, day_def=None, attribution_source='dynamic'), result_set={'token': 'thomki', 'name': 'Facebook Installs', 'currency': 'USD', 'trackers': [{'token': 'tsodkg', 'kpi_values': [3627.54]}]})

print ( str ( kpis_api . fetch_events ()))
# prints: KpiResult(result_parameters=ResultParameters(kpis=['revenue'], start_date=datetime.date(2020, 4, 4), end_date=datetime.date(2020, 5, 4), sandbox=False, countries=['us'], events=[EventParameter(name='com.test.subscription.name', token='s6p2ub'), EventParameter(name='event_name', token='eakvze'), EventParameter(name='event.name.2', token='5a6u7u'), EventParameter(name='event_name_3', token='e34v0e')], trackers=[TrackerResultParameters(token='6tcrta', name='Facebook Installs::Expired Attributions', currency=None, has_subtrackers=False)], grouping=['trackers', 'event_types'], period=None, attribution_type='click', utc_offset='00:00', cohort_period_filter=None, day_def=None, attribution_source='dynamic'), result_set={'token': 'thamsi', 'name': 'Facebook Installs', 'currency': 'USD', 'trackers': [{'token': 'tsrdta', 'events': [{'token': 'e6e2v1', 'kpi_values': [1149.77]}, {'token': 'ea3vpe', 'kpi_values': [95.88]}, {'token': 'e34v0e', 'kpi_values': [17.99]}, {'token': 'eovy8e', 'kpi_values': [147.63]}}]}]})

print ( str ( kpis_api . fetch_cohorts ()))
# KpiResult(result_parameters=ResultParameters(kpis=['revenue'], start_date=datetime.date(2020, 4, 4), end_date=datetime.date(2020, 5, 4), sandbox=False, countries=['us'], events=None, trackers=[TrackerResultParameters(token='csodbh', name='Facebook Installs::Expired Attributions', currency=None, has_subtrackers=False)], grouping=['trackers', 'periods'], period='day', attribution_type='click', utc_offset='00:00', cohort_period_filter=None, day_def='24h', attribution_source='dynamic'), result_set={'token': 'chamsh', 'name': 'Facebook Installs', 'currency': 'USD', 'trackers': [{'token': 'cscoth', 'periods': [{'period': '0', 'kpi_values': [109.89]}}]}]})

Mas na maioria das vezes você precisa desses dados como tabela, para que você possa recuperá -los como dados de dados de pandas

 kpis_api = api . kpi_service ( trackers = trackers ,
                           start_date = start_date ,
                           end_date = end_date ,
                           countries = countries ,
                           app_tokens = app_tokens ,
                           kpis = kpis )
print ( str ( kpis_api . fetch_kpi ( as_df = True )))

# '  tracker_token                             tracker_name  revenue
# 0        tsrdag  Facebook Installs::Expired Attributions  3627.54'

Para mais informações, consulte a documentação.

Se você tiver alguma dúvida, sinta -se à vontade para adicionar problemas ou escrever para mim.

TODO: Adicione o link ao gancho de fluxo de ar e operador para ajuste