Test Custom Integrations

To test your custom integrations in a nonproduction environment, use AgentExchange App Analytics Simulation Mode. Submit an App Analytics query request and receive sample usage data.

To receive sample usage data, enable simulation mode, then submit a query request that includes a simulation mode package ID.

1. Enable simulation mode in your test org using the Metadata API AppAnalyticsSettings enableSimulationMode org preference.

2. To simulate package usage log, usage summary, or subscriber snapshot downloads, complete the required fields in your SOAP API AppAnalyticsQueryRequest. Include DataType, and leave OrganizationIDs blank. For PackageIDs, include at least one simulation mode package ID that matches the scenario you’re testing.

   Package Dataset	Simulation Mode Package ID	Description
   Small Dataset	033xx00SIMsmall	Contains a small amount of data. For use with all query types. Use this package ID to download data for any query-allowed timespan.
   Large Dataset	033xx00SIMlarge	Contains a large amount of data for two org IDs (00Dxx00SIM00foo and 00Dxx00SIM00bar). For use only with package usage log queries.
   Empty Dataset	Use any other 15-character package ID prefixed with 033xx00SIM. Examples: 033xx00SIMempty 033xx00SIM44444	Contains no data. For use with all query types. Use one of these package IDs to return an empty dataset.

3. Submit your query.

4. Check your API request.

   1. If successful, retrieve the App Analytics Query Request object created in the API request. The DownloadURL field populates when the request is completed.

   2. If you get an error, edit your query. Use a smaller time window, such as a 14 days, or specify one org ID. Then resubmit your query.

5. Download the comma-separated value (.csv) file containing sample usage data from the DownloadURL field in the App Analytics Query Request object.