added ability to control report frequency and more from top-level api