You can't use this until you register with us!

Description

Download app report data from the Singular asynchronous API.

Purchasing Options

Singular to S3 Downloader - $99.99 / month

Available Actions

View Custom Dimensions and Metrics

Gather all of the custom dimensions and metrics available to your account and print them to the task execution log.

Variables

General Parameters
singular_connection required

API key to use to authenticate with Singular.


Download Data by Day

Download daily report data based on the options specified.

Variables

Singular Parameters
singular_connection required

API key to use to authenticate with Singular.

apps

Specify mappings between short identifiers and Singular app names in JSON format. The short identifiers will be used in the name of reports created and should not contain spaces or other illegal characters. Reports will only be created for apps listed in the mappings.

dimensions required

Select which Dimensions to include as columns in each report.

custom_dimensions

Specify additional custom dimensions to include by ID or name. Available custom dimensions can be obtained by using the View Custom Dimensions and Metrics action of the task.

metrics required

Select which Metrics to include as columns in each report.

cohort_metrics

Select which Cohort Metrics to include as columns in each report. Only select choices that are listed as available with the View Custom Dimensions and Metrics action of the task.

periods required

Select which Cohort Periods to include as columns in each report.

country_code_format required

Select iso for two character country codes or iso3 for three character country codes in your report data.

concurrency required

Specify the number of concurrent report requests, up to 100, to submit to Singular.

ready_threshold

Percent of the total data for a day that must be in a ready state for the modified data from that day to be downloaded. Set this field to 0 to always download all ready data. Not recommended for processing recent days where a high percentage of data may not yet be ready, but will become ready on a subsequent Task run. If left blank, a value of 80 with be used.

timeout

Number of seconds to wait for Singular to respond with data.

retry

Not yet implemented. This parameter currently has no effect.

last_run required

Datetime stamp where new report creation should begin. Formatted as YYYY-MM-DD HH:MM:SS in UTC timezone. This field will automatically be updated to the most recent date downloaded when this task runs.

lookback required

Number of days prior to the Next Run Start Point that should be examined for data modified after the Next Run Start Point. Each day takes 15-30 seconds to examine.


S3 Target Parameters
aws_bucket_connection required

S3 Bucket location where the data will be stored.

s3_path required

Path from the starting folder in the S3 Bucket Connection to the folder where the data will be stored.

delete_existing required

Overwrite files with the same name.