Data Locker—untuk pemasar

Premium

Sekilas: Data Locker mengirimkan data laporan Anda ke penyimpanan cloud untuk dimuat ke sistem BI Anda. Anda dapat memilih antara berbagai tujuan penyimpanan dari bucket milik AppsFlyer di AWS, penyimpanan milik Anda di AWS dan GCS, serta Snowflake. Data Locker mendukung banyak tujuan. Itu berarti Anda dapat mengirim semua data ke beberapa tujuan, memisahkan data berdasarkan tujuan, atau kombinasi keduanya. Untuk setiap tujuan pilih format Parquet atau CSV. 

Data Locker

6133DataLockerForAdvertisers.png

Bacaan terkait:

Di Data Locker, pilih aplikasi, sumber media, event, dan laporan Anda untuk disertakan dalam data yang dikirimkan AppsFlyer ke opsi penyimpanan cloud yang Anda pilih. Kemudian, muat data secara terprogram dari penyimpanan ke dalam sistem Anda. 

Data Locker—fitur

Fitur Deskripsi
Opsi penyimpanan (cloud)

Data Locker dapat mengirim data Anda ke salah satu penyedia layanan cloud berikut:

Anda dapat mengatur lebih dari 1 tujuan di Data Locker. Ini berarti Anda dapat mengirim semua atau sebagian data Anda ke beberapa tujuan.

Contoh

  • Pisahkan data menurut jenis laporan. Kirim data lengkap ke GCS dan data gabungan ke Snowflake.
  • Pisahkan data menurut aplikasi dan kirim data per grup aplikasi ke bucket yang berbeda. 
Multi-aplikasi 

Streaming data dari 1, lebih, atau semua aplikasi di akun Anda. Saat Anda menambahkan aplikasi ke akun, aplikasi tersebut dapat ditambahkan secara otomatis. 

Jendela ketersediaan

14 hari

Pemisahan data

Opsi pemisahan data yang tersedia

  • [Default] Terpadu: Gabungan data dari semua aplikasi. Bidang ID aplikasi tingkat baris digunakan untuk mengidentifikasi aplikasi dalam file data. 
  • Dipisahkan berdasarkan aplikasi: Data dari masing-masing aplikasi ada di folder terpisah. Nama folder terdiri dari ID aplikasi. 
Opsi format data
  • CSV
  • Parquet
Kesegaran data

Kesegaran data tergantung dari jenis laporan 

  • Setiap Jam: Data yang dihasilkan terus menerus; misalnya, data instal dan in-app event ditulis dalam beberapa jam setelah event tiba di AppsFlyer. 
  • Harian: Laporan seperti uninstall, dibuat setiap hari dan siap pada hari berikutnya. 
  • Versioned (Berversi): Jika laporan yang sama dibuat beberapa kali untuk periode waktu yang sama, mekanisme pembuatan versi akan diterapkan.
Biq query dan Google Data Studio

Jika Anda menulis data ke penyimpanan GCS, Big Query dapat langsung memuat file Data Locker Anda tanpa pemrosesan perantara. Anda dapat menggunakan alat lain melalui Big Query, seperti Google Data Studio, untuk memvisualisasikan data Anda. 

Laporan tersedia melalui Data Locker

Arsitektur penyimpanan data

Overview

Struktur data Anda di penyimpanan tergantung apakah data dikirim ke penyimpanan cloud atau gudang data. Struktur folder yang dijelaskan di sini berlaku untuk penyimpanan (bucket). Dalam hal penyimpanan data warehouse (Snowflake) pertimbangkan bahwa referensi ke folder berlaku untuk tampilan. Lihat Snowflake

Data ditulis ke opsi penyimpanan yang Anda pilih. Dalam hal penyimpanan cloud, penyimpanan tersebut dimiliki oleh AppsFlyer di AWS atau dimiliki oleh Anda di AWS atau GCS. Anda dapat mengganti opsi penyimpanan kapan saja atau mengirim sebagian atau semua data Anda ke beberapa opsi penyimpanan. 

Data dalam penyimpanan diatur dalam struktur folder hierarkis, berdasarkan jenis laporan, tanggal, dan waktu. Gambar barikut berisi contoh dari struktur ini:

DLFolderOVerview.png

Data laporan tertentu ada di dalam folder hour (h) yang terkait dengan laporan tersebut:

  • Jumlah folder jam bergantung pada keaktualan data laporan (per jam, harian, atau versioned (berversi)).
  • Data disediakan dalam file terkompresi GZ yang memiliki format Parquet atau CSV.
  • File data terdiri dari kolom (bidang). 
  • Struktur skema laporan perjalanan pengguna identik dan bergantung pada bidang yang Anda pilih. Laporan lain masing-masing memiliki bidang eksplisitnya sendiri, laporan tanpa skema AKA. Lihat Laporan pengiklan Data Locker untuk laporan yang tersedia dan tautan ke spesifikasi laporan. 

Struktur folder

Folder Deskripsi 
ID Berlangganan

DataLockerFolders.png

  • Folder tingkat atas di dalam bucket bergantung pada pemilik dan penyedia penyimpanan. Secara umum, folder tingkat atas adalah ID Langganan Anda, tetapi dalam beberapa kasus, misalnya, jika Anda menggunakan Cyberduck, ID diatur di bookmark dan tidak ditampilkan dalam struktur folder. 
  • Folder data-locker-hourly berisi topik laporan. Folder di atas level ini bergantung pada kepemilikan bucket dan penyedia layanan cloud.

 Contoh struktur folder berdasarkan pemilik bucket dan penyedia layanan cloud

  • AppsFlyer bucket: <af-ext-reports>/<unique_identifier>/<data-locker-hourly>
  • Bucket AWS Anda : <af-datalocker-your bucket prefix>/<generated-home-folder><subscription-id>
  • Bucket GCS Anda: <nama bucket Anda>/<generated-home-folder>/<subscription-id>
Topik (t) Jenis laporan berkaitan dengan perihal laporan. 
Tanggal (dt)

Ini adalah tanggal data terkait. Dalam kasus data lengkap, itu berarti tanggal terjadinya event. Dalam hal data agregat, tanggal pelaporan itu sendiri. 

Waktu (h/jam atau versi)

Folder tanggal dibagi menjadi folder per jam (h) atau versi tergantung pada jenis laporan.

Folder per jam

Folder h berkaitan dengan waktu data diterima oleh AppsFlyer. Misalnya, event penginstalan diterima antara pukul 14:00-15:00 UTC ditulis ke file h=14. Perhatikan! Ada jeda sekitar 1-3 jam antara waktu data tiba di AppsFlyer hingga folder h ditulis ke Data Locker. Misalnya, folder h=14 ditulis 1 jam kemudian pada pukul 15:00 UTC. 

Karakteristik folder per jam:

  • Ada folder 24 h (jam) bernomor 0–23. Misalnya, h=0, h=1, dan seterusnya. 
  • Folder telat, h=late, berisi event hari sebelumnya yang tiba setelah tengah malam. Artinya event yang tiba pukul 00:00–02:00 UTC pada hari berikutnya. Misalnya, jika pengguna menginstal aplikasi pada hari Senin 08:00 UTC dan event tiba pada hari Selasa pukul 01:00 UTC, event tersebut ditulis ke folder telat hari Senin. 
  • Data yang tiba setelah pukul 02:00 UTC ditulis ke folder tanggal dan waktu kedatangan aktual. 
  • Pastikan bahwa data di folder h=late (telat) digunakan. Data ini tidak ada di folder lainnya. 
  • _temporary folder: Pada beberapa kasus, kami membuat folder sementara di dalam folder h. Abaikan folder dan sub-folder sementara. Misalnya: /t=impressions/dt=2021-04-11/h=18/_temporary.
  • Catatan:
    • Laporan data lengkap yang memiliki kesegaran data harian disimpan di folder h=23. Laporan uninstall biasanya ada di folder h=2 tapi bisa di folder mana saja.
    • Laporan Kohort dan Inkrementalitas disimpan langsung di folder dt. 
    • Laporan versioned (berversi) mematuhi konvensi berbeda yang dijelaskan di bagian ini. 

Pertimbangan laporan per jam untuk aplikasi yang tidak menggunakan waktu UTC.

Untuk memastikan bahwa Anda mendapatkan semua data untuk hari kalender tertentu, Anda harus menggunakan folder sesuai dengan hari yang ditentukan oleh zona waktu aplikasi seperti yang dirinci: 

  • Zona waktu belahan bumi timur : Untuk mendapatkan semua data dari tanggal kalender tertentu, Anda harus menggunakan folder menurut waktu dan tanggal UTC. Contoh: Zona waktu aplikasi Anda adalah UTC+10 (Sydney, Australia). Untuk mendapatkan semua data per jam yang terkait dengan selasa (Sydney), Anda harus menggunakan folder berikut: Senin h=14–23 dan akhir, Selasa h=0–13 dan 14-15 Mengapa Anda harus memakai Selasa h=14-15? Beberapa data bisa datang terlambat. Jadi folder h=14–15 dapat berisi event yang datang terlambat. Anda harus memfilter event_time untuk menyelaraskan dengan hari kalender aplikasi relatif terhadap UTC.
  • Zona waktu belahan bumi barat : Untuk mendapatkan semua data dari tanggal kalender tertentu, Anda harus menggunakan folder menurut waktu dan tanggal UTC. Contoh: Zona waktu aplikasi Anda adalah UTC-7 (Los Angeles). Untuk mendapatkan semua data per jam yang terkait dengan hari Selasa (Los Angeles), Anda harus menggunakan folder berikut: Selasa h=7–23 dan akhir, Rabu h=0–6 dan 7-8 Mengapa Anda harus menggunakan hari Rabu h=7-8? Ada data bisa datang terlambat. Jadi folder h=7–8 dapat berisi event yang datang terlambat. Anda harus memfilter event_time untuk menyelaraskan dengan hari kalender aplikasi relatif terhadap UTC.

folder versi

Beberapa laporan memiliki opsi versioned (berversi). Ini berarti bahwa data terbaru untuk hari tertentu diberikan beberapa kali. Karena data dapat terus diperbarui karena data yang datang terlambat atau data yang lebih akurat, laporan yang sama memiliki beberapa versi di mana versi terbaru adalah yang paling akurat. 

Laporan untuk hari tertentu terdapat dalam folder versi hari itu. Setiap versi terdapat dalam folder terpisah yang namanya diatur menggunakan stempel waktu Epoch yang mengidentifikasi laporan secara unik. 

Proses impor data Anda harus mempertimbangkan bahwa data dapat ditulis secara surut. Misalnya, pada 14 Januari, data dapat ditulis ke folder 1 Januari. Jika bucket adalah milik Anda, pertimbangkan untuk menggunakan pemberitahuan layanan cloud untuk memicu proses impor Anda (AWS  | GCS)

Pemisahan aplikasi

Data yang tersedia di file data terpadu berisi data dari semua aplikasi yang dipilih atau dipisahkan ke dalam folder berdasarkan aplikasi. Pemisahan ada di dalam folder h seperti dijelaskan dalam tabel berikut.
Jenis pemisahan Deskripsi 
[Default] Terpadu

Data untuk semua aplikasi tersedia di file data terpadu. Saat menggunakan data ini, gunakan bidang app_id tingkat baris untuk membedakan diantara aplikasi.

Contoh file data ada di folder h=2

UnifiedByApp.png

Konvensi penamaan file data adalah unique_id.gz.

  • Proses pemuatan data Anda harus: 
    • Memuat data setelah _SUCCESS flag disetel.
    • Memuat semua file di folder yang memiliki ekstensi .gz. Jangan melakukan proses impor Anda menggunakan logika penomoran bagian. 
Dipisahkan berdasarkan aplikasi

Folder tersebut berisi sub-folder per aplikasi. File data untuk aplikasi tertentu ada di dalam folder aplikasi. Pada gambar berikut, folder h=19 berisi folder aplikasi. Setiap folder aplikasi berisi file data terkait. Perhatikan! File data tidak berisi app_id Anda harus menentukan app_id menggunakan folder. 

DLSegregateByApp.png

Di setiap folder aplikasi, konvensi penamaannya adalah unique_id.gz: 

  • Proses pemuatan data Anda harus: 
    • Memuat data setelah _SUCCESS flag disetel.
    • Memuat semua file di folder yang memiliki ekstensi .gz. Jangan melakukan proses impor Anda menggunakan logika penomoran bagian. 

Batasan: Opsi ini tidak tersedia untuk laporan Atribusi Berbasis Orang (Peopled-Based Attribution/PBA).

File data

Konten Detail
Flag penyelesaian

Flag (penyelesaian) file terakhir ditetapkan saat semua data untuk folder h tertentu telah ditulis. 

  • Jangan membaca data dalam folder sebelum memastikan bahwa flag _SUCCESS ada.

  • Flag _SUCCESS diatur bahkan dalam hal tidak ada data yang ditulis ke folder tertentu dan folder tersebut kosong. 

  • Perhatikan! Dalam opsi pemisahan berdasarkan aplikasi, flag disetel di folder h dan bukan folder aplikasi individual. Lihat gambar di bagian sebelumnya. 
Jenis file
  • File bagian dikompresi (zipped) menggunakan GZ.
  • Setelah mengekstrak file, file data dalam format Parquet atau CSV sesuai dengan pengaturan Anda.
Urutan kolom (file CSV) 

Dalam hal file CSV, urutan kolom dalam laporan selalu sama. Saat kita menambahkan kolom baru, kolom ini ditambahkan di sebelah kanan dari kolom yang ada. 

Dalam hal ini: 

  • Struktur kolom laporan perjalanan pengguna identik. Ini berarti Anda dapat memiliki prosedur pemuatan data yang serupa untuk jenis laporan lainnya. Anda memilih bidang yang ada dalam laporan. Penjelasan bidang diperinci di kamus data lengkap
  • Laporan yang memiliki notasi FF di bagian ketersediaan laporan tidak mengikuti struktur kolom umum. 
Pertimbangan dalam pengisian bidang

Bidang kosong: Beberapa bidang diisi dengan null atau kosong. Artinya bahwa dalam konteks laporan tertentu tidak ada data untuk dilaporkan. Biasanya null berarti bahwa bidang ini tidak diisi dalam konteks laporan dan jenis aplikasi tertentu. Blank (Kosong) "" artinya bidang ini relevan dengan konteksnya tetapi tidak ada data yang ditemukan untuk diisi. 

Dalam hal sumber media terbatas, konten bidang terbatas disetel ke null. 

Secara keseluruhan, anggap null dan kosong sebagai satu kesatuan dan hal yang sama; tidak ada data yang tersedia. 

Zona Waktu dan Mata Uang

Pengaturan zona waktu dan mata uang khusus aplikasi tidak memengaruhi data yang ditulis ke Data Locker. Berlaku hak berikut: 

  • Zona waktu: Data tanggal dan jam dalam UTC.
  • Mata uang : Bidang event_revenue_usd adalah dalam USD.

Nilai dengan koma: Koma ini berada di antara tanda petik dua `"`, misalnya, `"iPhone6,1"`.

File data bergantung pada jenis pemisahan

Opsi penyimpanan

 Perhatian!

Jika Anda menggunakan opsi penyimpanan milik pemasar: 

  • Pastikan Anda mematuhi peraturan data privasi seperti GDPR dan kebijakan penyimpanan data jaringan iklan/SRN.
  • Jangan gunakan solusi penyimpanan milik pemasar untuk mengirim data ke pihak ketiga. 
  • Data ditulis ke pemilik penyimpanan pilihan Anda sebagai berikut:
    • Penyimpanan AppsFlyer
    • Penyimpanan pelanggan—AWS atau GCS
  • Anda dapat mengubah opsi penyimpanan kapan saja.
  • Jika Anda mengubah penyimpanan, terjadi hal berikut:
    • Kami mulai menulis data ke penyimpanan yang baru dipilih dalam waktu 1 jam.
    • Kami terus menulis ke bucket yang ada selama masa transisi 7 hari. Waktu kedaluwarsa periode transisi ditampilkan di antarmuka pengguna. Gunakan masa transisi untuk memperbarui proses pemuatan data Anda.  Anda dapat memulai kembali periode transisi atau kembali ke bucket AppsFlyer jika diperlukan. 
    • Mengubah penyimpanan : Anda dapat bermigrasi dari satu opsi penyimpanan ke opsi penyimpanan lainnya dengan menggunakan opsi multi-penyimpanan dan mengirim data ke beberapa tujuan secara bersamaan. Setelah Anda menyelesaikan migrasi dan pengujian, hapus opsi penyimpanan yang tidak lagi Anda perlukan. 
  Penyimpanan milik AppsFlyer (AWS)  Penyimpanan milik pemasar (GCS, AWS, Snowflake)
Nama bucket Ditetapkan oleh AppsFlyer
  • GCS: Tidak ada batasan
  • AWS: Ditetapkan oleh Anda. Harus memiliki awalan af-datalocker-.

Misalnya: af-datalocker-your-bucket-name

Kepemilikan penyimpanan AppsFlyer Pemasar
Platform penyimpanan AWS AWS, GCS, Snowflake
Kredensial agar Anda dapat mengakses data Tersedia di antarmuka pengguna Data Locker untuk admin akun AppsFlyer Anda Tidak dikenal oleh AppsFlyer. Gunakan kredensial yang disediakan oleh penyedia cloud.
Retensi data Data dihapus setelah 14 hari Tanggung jawab pemasar
Permintaan penghapusan data Tanggung jawab AppsFlyer Tanggung jawab pemasar
Keamanan AppsFlyer mengontrol penyimpanan. Pelanggan memiliki akses baca.

Pemasar mengontrol penyimpanan.

  • AWS: AppsFlyer memerlukan izin GetObject, ListBucket, DeleteObject, PutObject ke bucket. Bucket harus ditujukan khusus untuk penggunaan AppsFlyer. Jangan gunakan bucket untuk tujuan lain.
  • GCS: Lihat Artikel konfigurasi GCS.
Kapasitas penyimpanan Dikelola oleh AppsFlyer Dikelola oleh pemasar
Akses kontrol menggunakan titik akhir VPC dengan kebijakan bucket Tidak Berlaku [Opsional] Di AWS, jika Anda menerapkan keamanan titik akhir pada tingkat bucket, Anda harus mengizinkan server AppsFlyer. 

Pemberitahuan kepada petugas keamanan dalam hal penyimpanan yang dikontrol pelanggan

Pertimbangkan:

  • Bucket atau tujuan khusus untuk penggunaan AppsFlyer. Tidak ada entitas lain yang menulis ke tujuan tertentu.
  • Anda dapat menghapus data di tempat tujuan 25 jam setelah kami menulis data.
  • Data yang ditulis ke tujuan adalah salinan data yang sudah ada di server kami. Data tetap berada di server kami sesuai dengan kebijakan penyimpanan data kami. 
  • Untuk alasan teknis, terkadang kami menghapus dan menulis ulang data. Untuk alasan ini, kami memerlukan izin hapus dan daftar. Tidak ada izin yang merupakan risiko keamanan bagi Anda. Dalam hal daftar, kami adalah satu-satunya entitas yang menulis ke bucket. Dalam hal penghapusan, kami dapat membuat ulang data.
  • Untuk informasi tambahan, Anda dapat menghubungi tim keamanan kami melalui hello@appsflyer.com atau CSM Anda.  

Prinsip multi-koneksi (lebih dari satu tujuan)

Di Data Locker Anda dapat mengirim sebagian atau semua data Anda ke lebih dari satu tujuan (ditentukan dalam pengaturan koneksi). Misalnya, Anda dapat mengirim data Aplikasi A ke AWS, dan data Aplikasi B ke GCS.

Setiap koneksi terdiri dari satu set lengkap pengaturan Data Locker, termasuk tujuan. Pengaturan koneksi tidak tergantung satu sama lain.

Dalam mengelola koneksi Anda, pertimbangkan:

  • Dalam pengaturan Data Locker, koneksi ditampilkan di tab. Setiap koneksi memiliki tab pengaturan sendiri dari mana Anda dapat mengelola koneksi. Tab default adalah "Data Locker."
  • Untuk membuat koneksi baru:
    1. Klik Add connection .
    2. Berikan nama untuk koneksi dan pilih jenis penyimpanan.
    3. Klik Save.
      Setelah disimpan, koneksi ditampilkan di sebelah tab "Data Locker" default. Ikon setiap tab mewakili jenis penyimpanan.
  • Untuk melihat detail koneksi, menggandakan koneksi, atau menghapus koneksi, klik (options).

Prosedur

Pengaturan Data Locker

Gunakan prosedur ini untuk mengatur Data Locker. Perubahan pada pengaturan Data Locker membutuhkan waktu 3 jam untuk diterapkan. 

Prasyarat

Untuk mengatur penyimpanan milik pemasar:

Jika Anda mengatur Data Locker menggunakan penyimpanan milik pemasar, artinya bucket milik Anda, selesaikan salah satu atau beberapa prosedur berikut sekarang. 

Perhatikan! Jika Anda tidak berlangganan Data Locker dan Anda mengakses analisis Kohort atau data SKAN, Anda harus menyelesaikan prosedur penyimpanan milik pemasar. 

AppsFlyerAdmin_us-en.png Untuk mengatur Data Locker:

  1. Admin perlu melakukan pengaturan. 
  2. Di Appsflyer, bukaIntegrasi > Data Locker. 
  3. [Opsional] Jika Anda sudah memiliki tujuan Data Locker yang aktif dan ingin menambahkan tujuan, klik +. 
  4. Pilih tujuan data layanan cloud . Lakukan salah satu dari hal berikut:
    • Pilih Bucket AppsFlyer AWS (opsi hanya tersedia untuk pelanggan Data Locker.) Lanjutkan ke langkah 4. 
    • Pilih WS bucket Anda.
      1. Masukkan nama bucket AWS Anda. Jangan memasukkan awalan af-datalocker-.
      2. Klik Pengujian.
      3. Pastikan bahwa tidak ada pesan kesalahan yang menunjukkan bahwa bucket path tidak valid.
    • Pilih Bucket GCS Anda, lalu masukkan Nama bucket GCS Anda, dan terakhir klik test (tes). 
  5. Pilih struktur folder (pemisahan data):
    • [Default] Terpadu
    • Dipisahkan berdasarkan aplikasi
  6. Pilih format file:
    • [Default] Parquet.
    • CSV
  7. Pilih aplikasi yang diperlukan. Pilih semua untuk secara otomatis menyertakan aplikasi yang ditambahkan di kemudian hari. 
  8. Klik Terapkan
  9. [opsional] Sumber Media: Pilih salah satu atau lebih Sumber Media untuk disertakan dalam laporan.
    • Default=Semua. Ini artinya sumber media yang ditambahkan di masa mendatang ditambahkan secara otomatis.
  10. Pilih jenis laporanyang diperlukan. Anda harus memilih setidaknya 1 jenis laporan. 
  11. [opsional] In-app event: Pilih in-app event untuk disertakan. Jika Anda memiliki lebih dari 100 jenis in-app event, Anda tidak dapat mencarinya. Masukkan nama mereka dengan tepat untuk memilihnya. 
    • Default=Semua. Ini artinya in-app event yang ditambahkan di masa mendatang ditambahkan secara otomatis.
  12. Klik Terapkan
  13. [Opsional] Bidang: Pilih bidang yang akan disertakan dalam laporan. Catatan: Terkadang kami menyediakan bidang tambahan. Pertimbangkan hal ini dalam proses impor data Anda.
  14. Klik Simpan Konfigurasi. Terjadi salah satu yang berikut:
    • Jika Anda memilih bucket AppsFlyer AWS:
      • Bucket AWS khusus dibuat. Kredensial bucket ditampilkan.
      • Bucket dapat diakses menggunakan kredensial. Kredensial memberi Anda akses hanya-baca ke bucket.
    • Jika Anda memilih bucket Pelanggan: Data akan ditulis ke bucket Anda dalam waktu 3 jam. 

Reset kredensial

Admin dapat mereset kredensial bucket AppsFlyer kapan saja. Perhatikan! Jika Anda mereset kredensial, Anda harus memperbarui skrip impor data dengan kredensial yang diperbarui.

AppsFlyerAdmin_us-en.pngUntuk mereset kredensial penyimpanan yang dimiliki AppsFlyer:

  1. Di Appsflyer, bukaIntegrasi > Data Locker. 
  2. Pilih tujuan yang dimiliki AppsFlyer.
  3. Di bagian Credential (Kredensial), klik Reset credentials (Reset kredensial).
    Muncul jendela konfirmasi.
  4. Klik Reset.
  5. Tunggu (sekitar 20 detik) hingga muncul pesan Credentials successfully reset (Kredensial berhasil direset).
    Tersedia pembaruan kredensial.

Informasi Tambahan

Karakteristik dan Batasan

Sifat-sifat
Sifat Catatan 
Jaringan iklan Tidak untuk digunakan oleh jaringan iklan
Agensi Tidak untuk digunakan oleh agensi
Zona waktu khusus aplikasi Tidak Berlaku. Folder Data Locker dibagi-bagi berdasarkan jam menggunakan UTC. Event aktual berisi waktu dalam UTC. Konversi waktu ke zona waktu lainnya sesuai kebutuhan. Apa pun zona waktu aplikasi Anda, penundaan dari terjadinya event hingga direkam di Data Locker tetap sama.
Mata uang khusus aplikasi  Tidak didukung
Keterbatasan ukuran Tak dapat diterapkan
Kesegaran data Data diperbarui sesuai pembaruan data laporan spesifik yang dirinci dalam artikel ini
Data historis Tidak didukung. Jika Anda memerlukan data historis, beberapa laporan, tetapi tidak semua, tersedia melalui Pull API.
Akses pengguna Hanya pengguna akun dengan izin yang diperlukan yang dapat mengonfigurasi Data Locker. 
Aplikasi tunggal/multi aplikasi Dukungan multi-aplikasi. Data locker ada di tingkat akun

Pemecahan Masalah

  • Tanda-tanda: Tidak dapat mengambil data menggunakan AWS CLI
  • Pesan kesalahan: Terjadi kesalahan (AccessDenied) saat memanggil operasi ListObjectsV2: Akses Ditolak
  • Alasan: Kredensial AWS yang digunakan bukan kredensial yang benar untuk bucket AppsFlyer. Ini dapat disebabkan karena memiliki beberapa kredensial atau tidak valid di perangkat Anda. 
  • Solusi:
    1. Gunakan metode yang berbeda, seperti Cyberduck untuk mengakses bucket, artinya bukan CLI. Lakukan ini untuk memverifikasi bahwa kredensial yang Anda gunakan berfungsi. Jika Anda dapat terhubung menggunakan Cyberduck, ini menunjukkan masalah dengan cache kredensial. 
    2. Segarkan cache kredensial AWS.
      Tangkapan layar dari AWS

      mceclip0.png

Pengambilan data AWS

Gunakan alat pengambil data S3 pilihan Anda, AWS CLI, atau salah satu alat yang dijelaskan di bagian berikut. Perhatikan! Instruksi yang tepat cocok untuk bucket milik AppsFlyer. Sesuaikan instruksi sesuai kebutuhan jika Anda terhubung ke bucket. 

AWS CLI

Sebelum Anda mulai:

  • Instal AWS CLI di komputer Anda.
  • Di AppsFlyer, buka Data Locker, ambil informasi yang tersedia di panel kredensial.

Untuk menggunakan AWS CLI:

  1. Buka terminal. Untuk melakukannya di Windows, <Windows> + <R> , klik OK.
    Jendela baris perintah terbuka.
  2. Masukkan konfigurasi aws
  3. Masukkan AWS Access Key seperti yang muncul di panel kredensial.
  4. Masukkan Kunci Rahasia AWS Anda seperti yang muncul di panel kredensial.
  5. Masukkan eu-west-1
  6. Tekan Enter (Tidak Ada)

Gunakan perintah CLI yang mengikuti sesuai kebutuhan.

Dalam perintah berikut, nilai {home-folder} dapat ditemukan

Untuk membuat daftar folder di bucket Anda:


aws s3 ls s3://af-ext-reports/{home-folder}/data-locker-hourly/

Mendaftar file dan folder

Ada tiga jenis folder di keranjang Data Locker Anda:

  • Jenis Laporan t=
  • Tanggal dt=
  • Waktu h=

Untuk membuat daftar semua laporan dari jenis laporan tertentu:

aws s3 ls s3://af-ext-reports/{home-folder}/data-locker-hourly/ t=installs /

Untuk membuat daftar semua laporan dari jenis laporan tertentu untuk hari tertentu:

aws s3 ls s3://af-ext-reports/{home-folder}/data-locker-hourly/t=installs/dt=2019-01-17

Untuk membuat daftar semua laporan dari laporan tertentu, dalam jam tertentu dari hari tertentu:

aws s3 ls s3://af-ext-reports/{home-folder}/data-locker-hourly/t=installs/dt=2019-01-17/h=23

Untuk mengunduh file untuk tanggal tertentu:


aws s3 cp s3://af-ext-reports/<home-folder>/data-locker-hourly/t=installs/dt=2020-08-01/h=9/part-00000.gz ~/Downloads/

Cyberduck

Sebelum Anda mulai:

  • Instal klien Cyberduck.
  • Di AppsFlyer, buka Data Locker dan ambil informasi yang tersedia di panel kredensial.

Untuk mengonfigurasi Cyberduck:

  1. Di Cyberduck, klik Tindakan.
  2. Pilih Bookmark Baru. Jendela terbuka.
  3. Di bidang pertama (ditandai [1] pada tangkapan layar di bawah) pilih Amazon S3.

    DataDuckSmall2.png

  4. Isi bidang-bidang sebagai berikut:
    • Nama Panggilan:Teks bebas
    • Server:  s3.amazonaws.com
    • ID Kode Akses:Salin Kode Akses AWS seperti yang muncul di panel kredensial di AppsFlyer
    • Kode Akses Rahasia: Salin kode Rahasia Bucket seperti yang muncul di panel kredensial di AppsFlyer.
    • Jalur : {Bucket Name}/{Home Folder} Misalnya: af-ext-report / 1234-abc-ffffffff
  5. Menutup jendela. Untuk melakukannya, klik X di sudut kanan atas jendela.
  6. Pilih koneksi.
    Direktori data ditampilkan.

Browser Amazon S3

Sebelum Anda mulai:

  • Pasang Browser Amazon S3.
  • Di AppsFlyer, buka Data Locker dan ambil informasi yang tersedia di panel kredensial.

Untuk mengonfigurasi Browser Amazon S3 :

  1. Di browser S3, Klik Akun Tambahkan   Akun Baru .
    Jendela Tambah Akun Baru terbuka.

    mceclip0.png

  2. Isi bidang-bidang sebagai berikut:
    • Nama Akun : teks bebas. 
    • ID Kunci Akses: salin Kunci Akses AWS seperti yang muncul di panel kredensial. 
    • Kunci Akses Rahasia: salin kunci Rahasia Bucket seperti yang muncul di panel kredensial.
    • Pilih Enkripsi Kunci Akses dengan kata sandi dan masukkan kata sandi. Catat kata sandi ini.
    • Pilih Gunakan transfer aman. 
  3.  Klik Simpan perubahan.
  4. Klik Bucket > Tambahkan Eksternal Bucket .
    Jendela Tambah Bucket Eksternal terbuka.

    mceclip2.png

  5. Masukkan Nama bucket.Nama Bucket memiliki format berikut: {Bucket Name}/{Home Folder}. Nilai yang diperlukan untuk nama bucket dan folder beranda muncul di jendela kredensial. 
  6. Klik Tambahkan bucket eksternal.
    Bucket dibuat dan ditampilkan di panel kiri jendela.
    Anda sekarang dapat mengakses file Data Locker.