jmjeong / django-appsales

iTunesConnect application sales report generator

django-appsales

django-appsales helps iPhone and iPad developers to track their application sales. django-appsales download your data from the web and store it in local database.

You can download django-appsales from Git-hub.

Characteristics

• Track daily sales and Reviews
• Total statistics for your application
• It is free and is released under Apache License

Installation

Requirements

• python 2.6 or later
• django 1.2.3
• django-extensions
• django-pagination
• pyofc2
• south

You can install all of above program using easy install.

sudo easy_install django django-extensions django-pagination pyofc2 south

You need java package to download app sales data using AutoIngest.class tool.

sudo apt-get install openjdk-6-jre-headless

Download source code

git clone git://github.com/jmjeong/django-appsales.git appsales

Installation

• Edit settings.py file

ACCOUNT_INFO = [
    {                                   # account 1
        'VENDOR_ID'   :   ,             # Vendor ID(8x...) the entity which you want to download the report
        'APPSTORE_ID' : '',             # iTunes Store AppStore ID
        'APPSTORE_PW' : '',             # iTunes Store AppStore PW
      
        # Directory where sales data is stored
        'DATA_DIR' : os.path.join(os.path.dirname(__file__), 'app1-sales-rawdata')
        },
    # {                                 # account 2
    #     'VENDOR_ID'   :   ,           # Vendor ID(8x...) 
    #     'APPSTORE_ID' : '',           # iTunes Store AppStore ID
    #     'APPSTORE_PW' : '',           # iTunes Store AppStore PW
      
    #     # Directory where sales data is stored
    #     'DATA_DIR' : os.path.join(os.path.dirname(__file__), 'app2-sales-rawdata')
    #     },
    ]

# for admob integration
#
ADMOB_INFO = {
    'client_key' : '',                  # API key
    'email' : '',                       # id
    'passwd' : '',                      # passwd
    }

• ./manage.py syncdb
• ./manage.py migrate

You can set admin account during syncdb process.

• ./manage.py runserver

jmjeong-ui-MacBook-Pro:appsales jmjeong$ ./manage.py runserver
Validating models...
0 errors found

Django version 1.2.3, using settings 'appsales.settings'
Development server is running at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

For deploying your site, consults Django deployment document.

Upgrade

django-appsales use South package for upgrading from the previous version.

• ./manage.py migrate --list
• ./manage.py migrate --all

Download and Populate daily sales and reviews

• ./manage.py runjob download
• ./manage.py runjob populate
• ./manage.py runjob download-admob
• ./manage.py runjob download-review

Automation

You can register download script in crontab for automation.

crontab -e

@daily /path/to/cron.sh
@daily /path/to/manage.py runjob download-review

Screenshots

• main page

  

• sort view

  

• total statistics

  

Credits

• author : Jaemok Jeong([email protected])
• Country Flag Icon Set