Customer Data Submission Specifications

Financial and Usage data can be submitted to Audible Magic in two main ways:

  • Direct integration with Audible Magic by using the appropriate API (Application Programming Interface). For more information on this method, helpdesk@audiblemagic.com.
  • Transfer of financial and/or usage data through file feeds. This method is described in more detail below.

The examples below are generic. Because each implementation is unique, Audible Magic will create a reporting specification that is customized to each platform/customer.

 

Financial Report Specification

Financial information can be transferred though an Audible Magic Financial file. The financial file will include data such as gross revenue, subscriber totals, and exchange rates.  

In the table below, a single organization (Test Company A) has two separate offers - a monthly plan, and a trial plan. Each offer has different values for total number of users, gross revenue, and MSRP. Both offers are active only in the US - so the exchange rate is 1 (from USD to USD).

This data should be submitted in text/CSV format and should include the header row.

Period Start Date,Period End Date,Organization Code,Service Provider Code,Offer Code,Usage Payment Type Code,Place Holder 1,Key Type Code,Key Value,Place Holder 2
8/1/2023,8/31/2023,TEST COMPANY A,TCAUS,TCA_MONTHLY_PLAN,PD,,USER_COUNT,456.288543,
8/1/2023,8/31/2023,TEST COMPANY A,TCAUS,TCA_MONTHLY_PLAN,PD,,SERVICE_GROSS_REVENUE,12472.76,
8/1/2023,8/31/2023,TEST COMPANY A,TCAUS,TCA_MONTHLY_PLAN,PD,,MSRP,39.99,
8/1/2023,8/31/2023,TEST COMPANY A,TCAUS,TCA_MONTHLY_PLAN,PD,,EXCHANGE_RATE,1,
8/1/2023,8/31/2023,TEST COMPANY A,TCAUS,TCA_TRIAL_PLAN,TG,,USER_COUNT,127.52,
8/1/2023,8/31/2023,TEST COMPANY A,TCAUS,TCA_TRIAL_PLAN,TG,,SERVICE_GROSS_REVENUE,0,
8/1/2023,8/31/2023,TEST COMPANY A,TCAUS,TCA_TRIAL_PLAN,TG,,MSRP,0,
8/1/2023,8/31/2023,TEST COMPANY A,TCAUS,TCA_TRIAL_PLAN,TG,,EXCHANGE_RATE,1,

 

Detail/Usage Specification

Usage information can be transferred though an Audible Magic Detail file. This file will list all items that have been used (streamed, purchased, etc) in all offers during the respective period.

In the table below, several tracks have been streamed. There are five rows in this report, two unique tracks were used through the monthly plan, and three were used through the trial plan.

This data should be submitted in text/CSV format and should include the header row.

Period Start Date,Period End Date,Organization Code,Service Provider Code,Offer Code,Usage Payment Type Code,Usage Activity Type Code,Codec Code,Audio Bit Rate,Venue ID,Customer ID,Postal Code,Distribution Method,Seconds Played,PLACE_HOLDER_1,Audible Magic Component ID,Count,PLACE_HOLDER_2
8/1/2023,8/31/2023,TEST COMPANY A,TCAUS,TCA_MONTHLY_PLAN,PD,S,MP4,,,,,,,,706775,21,
8/1/2023,8/31/2023,TEST COMPANY A,TCAUS,TCA_MONTHLY_PLAN,PD,S,MP4,,,,,,,,438385909,576,
8/1/2023,8/31/2023,TEST COMPANY A,TCAUS,TCA_TRIAL_PLAN,TG,S,MP4,,,,,,,,462180957,74,
8/1/2023,8/31/2023,TEST COMPANY A,TCAUS,TCA_TRIAL_PLAN,TG,S,MP4,,,,,,,,116619689,54,
8/1/2023,8/31/2023,TEST COMPANY A,TCAUS,TCA_TRIAL_PLAN,TG,S,MP4,,,,,,,,120213573,59,

 

For additional questions about the information here or in your customized report implementation, please contact AMreporting@audiblemagic.com.