Atribut Pengguna

Data reset

Home > Sitemap

Overview

Database Administrator Ekspor memberi Anda akses penuh ke data acara mentah. Ini memungkinkan Anda menggunakan data dengan cara apa pun yang Anda pilih, misalnya untuk membangun pertanyaan atau visualisasi data kustom.

Ada dua cara Anda dapat mengakses ekspor data mentah:

Antarmuka pengguna dasbor Unity AnalyticsSebuah platform data yang menyediakan analitik untuk permainan Unity Anda. More info
Lihat di Glossary dashboard user interface
REST API

Database Ekspor menyediakan data dari Juni 2016.

Antarmuka pengguna dasbor analis

Dasbor Unity Analytics menyediakan cara untuk mengekspor dan mengakses data acara baku Anda tanpa menulis kode. Di dashboard Unity Analytics Anda (), pilih proyek Anda dan arahkan ke AnalyticsUnity Analytics
Lihat di Glossary > Raw Data Export.

Kemudian ikuti langkah-langkah ini di bagian Export dari layar itu:

Tentukan Data Set yang ingin Anda ekspor (seperti appRunning, appStart, custom, deviceInfo, atau transaksi).
Tentukan Start Date, atau secara alternatif terus mengekspor data dari pekerjaan sebelumnya dengan memilih Previous Job Id dari kotak drop-down.
Tentukan End Date.
Format file default ke JSON. Tentukan format file pilihan Anda dengan mengklik dan memilih item dari menu drop-down di bawah Export as JSON.

The Export section and Activity table on the Raw Data Export screen — Bagian **Export** dan tabel **Activity** pada layar **Raw Data Export** screen

Database Ekspor secara otomatis menciptakan pekerjaan dan menampilkannya di tabel Activity di layar.

Setelah pekerjaan dilakukan, Anda dapat mengunduh data Anda dengan memilih file dari kolom Download.

API documentation

Setiap titik data yang dikirim ke Unity Analytics disimpan di toko data Unity. API Ekspor Data Baku memungkinkan Anda untuk mengunduh data acara baku Anda dalam file sebagai data diterima dan disimpan.

Requirements

Setiap permintaan memerlukan otentikasi dasar HTTP menggunakan ID Proyek Unity Anda (UPID) dan Kunci API.

Limitations

Periode permintaan (startDate hingga endDate) terbatas pada 31 hari.
Batasan penggunaan dapat dikenakan perubahan.
Unity Analytics mempertahankan file data baku yang dihasilkan untuk permintaan selama 14 hari. (Untuk mengakses data setelah 14 hari telah berlalu, buat permintaan baru.)

User workflow

Untuk mengekspor data baku, sebut Buat API Ekspor Data Baku. Permintaan ini memicu pekerjaan asinkron untuk memproses data. Waktu ini diperlukan tergantung pada berapa banyak data yang diekspor.

Untuk mendapatkan status atau hasil saat ini, poll menggunakan API Ekspor Data Baku. Setelah ekspor selesai, Anda bisa mendapatkan hasil dari API ini. Hasilnya berisi daftar file dan URL unduhan yang sesuai. Anda dapat memutar melalui URL dan mengunduh data yang diekspor.

Notes:

Semua tanggal dan waktu dalam permintaan atau tanggapan berada di zona waktu UTC.
Permintaan API atau tanggapan menggunakan format JSON (yang diformat untuk pembacaan dalam dokumen ini). Format file data dapat dikonfigurasi.
Data diekspor dalam file terkompresi .gzip.
Basis URL untuk API adalah .

Buat Ekspor Data Baku

Database Ekspor spesifik untuk proyek dan spesifik untuk satu dataset (tipe acara). Periode permintaan terbatas pada 31 hari.

Gunakan metode HTTP berikut untuk membuat Ekspor Data Baku:

POST api/v2/projects/{UNITY_PROJECT_ID}/rawdataexports

Argument disediakan dalam payload atas permintaan, dan dalam format JSON dengan aplikasi / json Content-Type.

Request argument	Required or optional	Type	Description
startDate	Diperlukan kecuali lanjutkan Dari ditentukan	string	Tanggal awal (termasuk) ekspor. Tanggal dinyatakan dalam format YY-MM-DD (ISO-8601).
endDate	Required	String	Data akhir (eksklusif) ekspor. Tanggal diungkapkan dalam format YY-MM-DD (ISO 8601). Ini adalah tanggal di mana untuk menutup query. Ketika mencari hari ini, gunakan tanggal hari berikutnya.
format	Required	String	Format data output: json (newline-delimited json) atau tsv.
dataset	Required	String	Salah satu jenis acara berikut: appStart, appRunning, perangkat Info, kustom, atau transaksi.
continueFrom	Optional	String	ID Ekspor Data Baku untuk terus mengekspor data dari. Ini digunakan untuk melanjutkan ekspor sebelumnya dari titik selesai. Lihat Melanjutkan informasi lebih lanjut. Alih-alih menentukan startDate, ID Ekspor Data Baku sebelumnya dapat ditentukan dalam melanjutkanFrom. Ini adalah kesalahan untuk menentukan terusFrom dan startDate.

Template untuk permintaan menggunakan cURL di baris perintah:

curl --user {UNITY_PROJECT_ID}:{API_KEY} --request POST --header "Content-Type: application/json" --data {REQUEST_JSON}
https://analytics.cloud.unity3d.com/api/v2/projects/{UNITY_PROJECT_ID}/rawdataexports

Contoh nilai:

UNITY_PROJECT_ID = aa43ae0a-a7a7-4016-ae96-e253bb126aa8
API_KEY = 166291ff148b2878375a8e54aebb1549
REQUEST_JSON = { "startDate": "2016-05-15" , "endDate": "2016-05-16", "format": "tsv", "dataset": "appStart" }

Permintaan aktual menggunakan nilai contoh:

curl --user aa43ae0a-a7a7-4016-ae96-e253bb126aa8:166291ff148b2878375a8e54aebb1549 --request POST --header "Content-Type: application/json" --data '{ "startDate": "2016-05-15" , "endDate": "2016-05-16", "format": "tsv", "dataset": "appStart" }' https://analytics.cloud.unity3d.com/api/v2/projects/aa43ae0a-a7a7-4016-ae96-e253bb126aa8/rawdataexports

Respon menggunakan Atribut Ekspor Data Baku yang umum dalam format JSON.

Tanggapan Ekspor Data Baku

Response attribute	Type	Description
id	String	ID Ekspor Data Baku.
upid	String	ID Proyek Unity.
createdAt	String	Waktu yang dibuat dalam format ISO 8601.
status	string	Status saat ini ekspor. Nilai yang mungkin adalah: berjalan, selesai, atau gagal.
duration	Long	Waktu yang dibutuhkan untuk mengekspor data (dalam mili detik).
request	Json	argumen permintaan.
result	Json	Hasilnya mengandung atribut yang mendetail data yang diekspor. Hasilnya hanya tersedia setelah ekspor berhasil diselesaikan. Lihat di bawah ini untuk atribut hasil.
result.size	Long	Total ukuran data yang diekspor (dalam byte).
result.eventCount	Long	Jumlah total peristiwa yang diekspor.
result.intraDay	Boolean	Ketika permintaan termasuk hari saat ini mungkin tidak mengandung semua data untuk hari. Atribut ini adalah TRUE jika data tidak lengkap untuk hari terakhir.
result.fileList	Json	Daftar file yang berisi data yang diekspor. Daftar file kosong ketika tidak ada data.
result.fileList.name	String	Nama file.
result.fileList.url	String	URL download untuk file. File dikompresi dalam format gzip.
result.fileList.size	Long	Ukuran file di byte.
result.fileList.date	String	File berisi acara untuk tanggal tertentu ini. Tanggal ini didasarkan pada waktu pengiriman acara. Mungkin ada beberapa file untuk tanggal yang sama. Tanggal dalam format ISO 8601.

Contoh tanggapan:

{  
   "id":"8228d1e9-31b3-4a5e-aabe-55d9c8afa052",
   "upid":"beff3f49-b9ed-41a4-91ea-677e9b85e71e",
   "createdAt":"2016-05-10T10:10:10.100+0000",
   "status":"running",
   "duration" : 0,
   "request":{  
      "startDate":"2016-05-01",
      "endDate":"2016-05-02",
      "format":"json",
      "dataset":"appRunning"
   }
}

Lanjutkan pembuatan dari Ekspor Data Baku

Ketika Anda menjalankan Ekspor Data Baku berkala, Anda harus memberikan melanjutkan Dari argumen bukan awal untuk memastikan Anda terus dari Ekspor Data Baku sebelumnya. ID Ekspor Data Baku Prior dapat dipetik melalui GET API atau diakses melalui Dasbor.

Prior Raw Data Exports in the Unity Analytics Project Dashboard — Ekspor Data Baku Prior di Dashboard Proyek Unity Analytics

Dapatkan Ekspor Data Baku

Gunakan metode HTTP berikut untuk mendapatkan status Ekspor Data Baku tertentu atau ekspor berkelanjutan:

GET api/v2/projects/{UNITY_PROJECT_ID}/rawdataexports/{raw_data_export_id}

Semua argumen yang diperlukan adalah bagian dari jalur URL.

Contoh permintaan:

curl --user {UNITY_PROJECT_ID}:${API_KEY} https://analytics.cloud.unity3d.com/api/v2/projects/{UNITY_PROJECT_ID}/rawdataexports/${ID}

Respon adalah Ekspor Data Baku dalam format JSON. Hal ini sama dengan respons dalam Membuat Ekspor Data Baku.

Contoh respons:

{  
   "id":"6601f70e-6a0b-48ed-909f-26711af82b49",
   "status":"completed",
   "createdAt":"2016-05-21T04:41:54.000+0000",
   "duration":8631714000,
   "request":{  
      "startDate":"2016-02-11T00:00:00.000+0000",
      "endDate":"2016-03-11T00:00:00.000+0000",
      "format":"tsv",
      "dataset":"custom"
   },
   "result":{  
      "size":78355,
      "eventCount":17473,
      "fileList":[  
         {  
            "name":"headers.gz",
            "url":"https://uca-export.s3.amazonaws.com/staging/devTest/custom/appid%3DUNITY_PROJECT_ID/jid%3D6601f70e-6a0b-48ed-909f-26711af82b49/headers.gz?AWSAccessKeyId=AKIAJUXGNF66F4XPWSWA&Expires=1463872651&Signature=PnzIeeI%2FNxSOlKkLVpLcfK%2FxVpU%3D",
            "size":105
         },
         {  
            "name":"part-4b0cf376-3478-4bc8-845e-f73aff5c0be4.gz",
            "url":"https://uca-export.s3.amazonaws.com/staging/devTest/custom/appid%3DUNITY_PROJECT_ID/jid%3D6601f70e-6a0b-48ed-909f-26711af82b49/part-4b0cf376-3478-4bc8-845e-f73aff5c0be4.gz?AWSAccessKeyId=AKIAJUXGNF66F4XPWSWA&Expires=1463872651&Signature=xZk3%2BzQNTQ6yjK2Mh%2FaH338ABn8%3D",
            "size":78250,
            "date":"2016-02-13T00:00:00.000+0000"
         }
      ],
      "intraDay":false
   }
}

Daftar semua Ekspor Data Baku

Gunakan metode HTTP ini untuk mendapatkan daftar semua Ekspor Data Baku untuk proyek tertentu:

GET api/v2/projects/{UNITY_PROJECT_ID}/rawdataexports

Semua argumen yang diperlukan adalah bagian dari jalur URL.

Contoh permintaan:

curl --user {UNITY_PROJECT_ID}:${API_KEY} https://analytics.cloud.unity3d.com/api/v2/projects/${UNITY_PROJECT_ID}/rawdataexports/

Respon adalah daftar Ekspor Data Baku dalam format JSON. Lihat Tanggapan Ekspor Data Mentah Atribut untuk definisi setiap elemen daftar ekspor.

Contoh respons:

[
{  
   "id":"6601f70e-6a0b-48ed-909f-26711af82b49",
   "status":"completed",
   "createdAt":"2016-05-21T04:41:54.000+0000",
   "duration":8631714000,
   "request":{  
      "startDate":"2016-02-11T00:00:00.000+0000",
      "endDate":"2016-03-11T00:00:00.000+0000",
      "format":"tsv",
      "dataset":"custom"
   },
   "result":{  
      "size":78355,
      "eventCount":17473,
      "fileList":[  
         {  
            "name":"headers.gz",
            "url":"https://uca-export.s3.amazonaws.com/staging/devTest/custom/appid%3DUNITY_PROJECT_ID/jid%3D6601f70e-6a0b-48ed-909f-26711af82b49/headers.gz?AWSAccessKeyId=AKIAJUXGNF66F4XPWSWA&Expires=1463872651&Signature=PnzIeeI%2FNxSOlKkLVpLcfK%2FxVpU%3D",
            "size":105
         },
         {  
            "name":"part-4b0cf376-3478-4bc8-845e-f73aff5c0be4.gz",
            "url":"https://uca-export.s3.amazonaws.com/staging/devTest/custom/appid%3DUNITY_PROJECT_ID/jid%3D6601f70e-6a0b-48ed-909f-26711af82b49/part-4b0cf376-3478-4bc8-845e-f73aff5c0be4.gz?AWSAccessKeyId=AKIAJUXGNF66F4XPWSWA&Expires=1463872651&Signature=xZk3%2BzQNTQ6yjK2Mh%2FaH338ABn8%3D",
            "size":78250,
            "date":"2016-02-13T00:00:00.000+0000"
         }
      ],
      "intraDay":false
   }
},
{  
   "id":"6601f70e-6a0b-48ed-909f-26711af82b48",
   "status":"completed",
   "createdAt":"2016-05-21T04:41:54.000+0000",
   "duration":8631714000,
   "request":{  
      "startDate":"2016-02-11T00:00:00.000+0000",
      "endDate":"2016-03-11T00:00:00.000+0000",
      "format":"tsv",
      "dataset":"custom"
   },
   "result":{  
      "size":78355,
      "eventCount":17473,
      "fileList":[  
         {  
            "name":"headers.gz",
            "url":"https://uca-export.s3.amazonaws.com/staging/devTest/custom/appid%3DUNITY_PROJECT_ID/jid%3D6601f70e-6a0b-48ed-909f-26711af82b48/headers.gz?AWSAccessKeyId=AKIAJUXGNF66F4XPWSWA&Expires=1463872651&Signature=PnzIeeI%2FNxSOlKkLVpLcfK%2FxVpU%3D",
            "size":105
         },
         {  
            "name":"part-4b0cf376-3478-4bc8-845e-f73aff5c0be4.gz",
            "url":"https://uca-export.s3.amazonaws.com/staging/devTest/custom/appid%3DUNITY_PROJECT_ID/jid%3D6601f70e-6a0b-48ed-909f-26711af82b48/part-4b0cf376-3478-4bc8-845e-f73aff5c0be4.gz?AWSAccessKeyId=AKIAJUXGNF66F4XPWSWA&Expires=1463872651&Signature=xZk3%2BzQNTQ6yjK2Mh%2FaH338ABn8%3D",
            "size":78250,
            "date":"2016-02-13T00:00:00.000+0000"
         }
      ],
      "intraDay":false
   }
}
]

TSV format

Jika Anda memilih untuk mengekspor dalam format TSV, header disediakan dalam file terpisah di headers.gz. File data tidak termasuk header.

Contoh berkas header:

ts  appid   type    userid  sessionid   platform    sdk_ver debug_device    user_agent  submit_time name    custom_params

Dataset

Setiap enam jenis data (tipe acara) berbeda. Lihat di bawah ini untuk definisi skema mereka.