Server-to-Server Mobile Data Ingestion
Server-to-server (S2S) connections allow you to send raw app data from your server to ours. For brands who need to send us app measurement data, integrating a mobile measurement partner (MMP) is still the easiest method, however, S2S is valuable if you wish to send app event data that you’re unable to share through the MMP. Discuss the process with your Client Services Manager to see if this option is best for you. Once you’re ready to get started, follow the steps below:
-
Review our schema requirements and make a copy of this CSV template.
-
Fill it out, then upload a compressed CSV file to Tatari's s3 bucket using this uploader script.
-
Email solutions@tatari.tv to confirm receipt of your server-to-server data. This will kick off the data review process.
Note: You do not need to re-confirm the data transfer for each upload, just for the initial data transfer. We will automatically check for new files every day.
FAQs
What is the uploader script?
The script allows you to use your Tatari.tv dashboard credentials for authentication, and will deliver the file directly to our S3 bucket for ingestion. To upload a file, invoke the script as
bash upload.sh <slug> /path/to/events.csv.gz YYYY-MM-DD
Please replace <slug> with your own slug, which you can determine using your Tatari dashboard url. For example, if your dashboard url is https://www.tatari.tv/dashboard/abc, then your slug is abc. You should invoke the script as
bash upload.sh abc /path/to/events.csv.gz YYYY-MM-DD
The file path is the local file path to the event CSV you intend to upload, and the date is day of the events that are represented by the upload.
What data do I need to send to Tatari?
Please send data for the past 24 hours and avoid sending duplicates wherever possible. See the data requirements and full schema here.
When should I send the data?
Please upload a new CSV by midnight (Pacific Time) to Tatari's s3 bucket so that we can ingest all (99%) events from that day.
How often should I send data?
You will need to upload a new report at least once per day. Our team will automatically ingest it each morning—no need to alert us.
What happens after I send my initial data to Tatari?
Our team will review the data and may follow up with questions as needed. We typically require one week's worth of data before going live and if everything looks good, we’ll begin processing the data into your Tatari dashboard and S3 reports. We will continue to do so automatically every day.
When will I see the data reflected in my dashboard?
Generally, data is available the following day in the late afternoon Eastern Time.
Have questions? Email solutions@tatari.tv.