Data Locker—streaming data untuk pengiklan

Sekilas: Data Locker mengalirkan data laporan Anda ke penyimpanan cloud untuk dimuat ke sistem BI pengiklan. Opsi penyimpanan berbeda memungkinkan Anda untuk memilih antara bucket milik AppsFlyer di AWS atau bucket milik pengiklan di AWS atau GCS. Data Locker adalah solusi multi-aplikasi. 

DataLockerBuckets.png

Bacaan terkait: Memilih alat pengiriman data lengkap yang tepat

Data Locker

Data Locker mengirimkan data AppsFlyer Anda secara terus-menerus (stream) ke penyimpanan cloud. Anda memilih aplikasi, sumber media, event, dan laporan yang diperlukan untuk disertakan dalam streaming. Muat data yang dikirimkan secara terprogram ke sistem BI Anda. 

Fitur

Fitur Deskripsi
Opsi penyimpanan (cloud)

Tersedia beberapa opsi penyimpanan. Anda dapat beralih antar opsi kapan saja. Perbedaan opsi terkait dengan penyedia layanan cloud dan kepemilikan bucket. Opsi yang tersedia: 

  • Penyimpanan milik AppsFlyer: AWS
  • Penyimpanan milik Anda:
    • AWS 
    • GCS
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. 

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. 
Kesegaran data

Kesegaran data tergantung dari jenis laporan 

  • Per Jam:Data dihasilkan secara terus-menerus; misalnya, penginstalan dan data in-app event di-streaming dalam beberapa jam setelah event tiba di AppsFlyer. 
  • Harian: Beberapa laporan, misalnya, uninstall, dibuat setiap hari dan siap pada hari berikutnya. 
Laporan unik untuk Data Locker
  • Data yang belum dikonversi: Data klik dan tayangan serta kampanye penargetan ulang. Tentang klik dan tayangan
  • Data lengkap SKAdNetwork tersedia di penyimpanan milik Anda tanpa harus berlangganan Data Locker. 
Contoh file data

Klik, Penginstalan, In-app event 

Laporan tersedia di Data Locker

Laporan pengukuran data inti
ketegori Jenis laporan (topik) Penyegaran data* Organik/Non-organik Unik untuk Data Locker
Akuisisi User Klik  Jeda 6 jam N/A
Retargeting Klik Jeda 6 jam N/A
Akuisisi User Tayangan  Jeda 6 jam N/A
Retargeting Tayangan  Jeda 6 jam N/A
Akuisisi User Install Jeda 6 jam Keduanya  
Akuisisi User In-App Event  Jeda 6 jam Keduanya  
Akuisisi User Pendapatan iklan teratribusi Harian+2 Non-organik  
Akuisisi User Pendapatan iklan organik Harian+2 Organik  
Retargeting Penargetan ulang pendapatan iklan Harian+2 Non-organik  
Retargeting Konversi Jeda 6 jam Non-organik  
Retargeting In-App Event Jeda 6 jam Non-organik  
Retargeting Sesi Jeda 6 jam Keduanya
Akuisisi User Sesi Jeda 6 jam Keduanya
Akuisisi User mencopot pemasangan Uninstall-Harian Non-organik  
Akuisisi User Pencopotan pemasangan organik Uninstall-Harian Organik  
Instalasi ulang Instalasi ulang Jeda 6 jam Non-organik  
Instalasi ulang Penginstalan ulang organik Jeda 6 jam Organik  
Laporan Protect360
Jenis laporan (topik) Penyegaran data*
Instalasi yang diblokir Jeda 6 jam
In-app event yang diblokir  Jeda 6 jam
Klik terblokir Jeda 6 jam
[AG*] Penginstalan pasca-atribusi Harian
SKAdNetwork [Tidak memerlukan langganan Data Locker jika Anda mengirimnya ke keranjang Anda sendiri]
Kesegaran data: Setiap hari 
Jenis laporan (topik)
[FF*] Postback
[FF*] Penginstalan
[FF*] Pengunduhan ulang
[FF*] In-app event
Laporan Atribusi Berbasis Orang/People-Based Attribution
Kesegaran data: Harian
Jenis laporan (topik)
[FF*] Kunjungan situs web
[FF*] website_events
[FF*] Penginstalan berbantuan situs web
[FF*] Jalur Konversi
 * Daftar singkatan

[FF] Bidang laporan ditetapkan oleh Appsflyer. Bidang ini tidak terkait dengan bidang yang dipilih untuk disertakan dalam laporan.

[AG] Transparansi agensi tidak didukung.

Jeda 6 jam:

  • Data dipisahkan ke dalam folder jam kedatangan.
  • Jam kedatangan adalah jam saat event tersedia untuk Data Locker untuk streaming.
  • Jeda waktu tidak terkait dengan zona waktu khusus aplikasi.

Harian:

  • Laporan di-streaming ke folder h=23.
  • Laporan ini biasanya tersedia pada pukul 10:00-12:00 UTC di folder h=23 pada hari sebelumnya.
  • Misalnya, laporan untuk data yang dihasilkan selama hari Senin ada di folder Monday h=23. Data tersedia setelah pukul 10:00 UTC pada hari Selasa. 

Uninstall-harian:

  • Data uninstall disiapkan setiap hari. 
  • Biasanya tersedia pada pukul 10:00-12:00 UTC.
  • Paling sering di-streaming ke folder h=2 folder. Artinya folder h=2 berisi uninstall yang dilaporkan pada hari sebelumnya. Namun, data dapat di-streaming ke folder berikutnya; oleh karena itu proses impor harus membaca data semua folder yang ada di folder uninstall. Artinya h=1–24 dan h=late/telat. Misalnya, laporan untuk data yang dihasilkan selama hari Senin ada di folder Selasa h=2. Data tersedia setelah pukul 10:00 UTC pada hari Selasa. 

Harian+2: Data pendapatan iklan tersedia setelah 2 hari, artinya data yang dihasilkan selama hari Senin, akan tersedia di folder Senin H=23 setelah 06:00 UTC pada hari Rabu.

Arsitektur penyimpanan data

Overview

Data di-streaming ke opsi penyimpanan yang Anda pilih. Penyimpanan milik AppsFlyer di AWS atau milik Anda di AWS atau GCS. Anda dapat beralih dari satu opsi penyimpanan ke opsi penyimpanan lainnya kapan saja. Perubahan terjadi dalam beberapa jam. 

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 kesegaran data laporan (per jam atau harian).
  • File data terdiri dari file terkompresi GZ yang berisi file CSV.
  • File CSV terdiri dari kolom-kolom.
  • Struktur kolom laporan pengukuran data inti identik. Ini berarti Anda dapat memiliki prosedur pemuatan data yang serupa untuk jenis laporan lainnya. Bidang (kolom) aktual yang ada di dalam laporan dipilih oleh Anda. 
  • Laporan dengan indikasi FF memiliki struktur kolomnya sendiri. 

Struktur folder

Folder Deskripsi 
data-locker-hourly

DLHourly.png

  • Folder tingkat atas di dalam bucket bergantung pada pemilik dan penyedia penyimpanan.
  • 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 folder name>/<data-locker-hourly>
  • Bucket GCS Anda: <data-locker-hourly>
t (topik) Jenis laporan berkaitan dengan perihal laporan. 
dt (tanggal/date)

Ini adalah tanggal data terkait. Pada sebagian besar kasus, tanggal ini berarti tanggal terjadinya event. 

h (jam/hour)

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

Karakteristik folder:

  • 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 di-streaming ke folder telat hari Senin. 
  • Data yang tiba setelah pukul 02:00 UTC di-streaming 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.

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 filenya adalah: part-nnnnn.gz di mana: 

  • nnnnn adalah nomor bagian dalam rentang 0000–99999. Misalnya, bagian-00000, bagian-00001, bagian-00002, dan seterusnya.
  • Nomor bagian tidak harus berurutan.
  • Dalam proses penggunaan data Anda, pastikan bahwa:
    • Data digunakan hanya setelah flag _SUCCESS disetel.
    • Semua file dalam folder berekstensi .gz digunakan.
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.

DLSegregateByApp.png

Di setiap folder aplikasi, konvensi penamaan filenya adalah: part-nnnnn-string.csv.gz: 

  • nnnnn adalah nomor bagian dalam rentang 0000–99999. Misalnya, bagian-00000, bagian-00001, bagian-00002, dan seterusnya.
  • Nomor bagian tidak harus berurutan.
  • Dalam proses penggunaan data Anda, pastikan bahwa:
    • Anda mulai menggunakan data hanya setelah flag _SUCCESS ditetapkan. Perhatikan! Flag ditetapkan pada level h dan bukan pada level app_id. 
    • Anda menggunakan semua file dalam folder berekstensi .gz extension.

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

File data

Konten Terpadu  Dipisahkan berdasarkan aplikasi 
Flag penyelesaian

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

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

  • Flag _SUCCESS disetel bahkan dalam hal tidak ada data yang di-streaming 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. 
 

File bagian dikompresi (zipped) menggunakan GZ. Setelah diekstrak (unzipping):

  • File tidak memiliki ekstensi.
  • Setiap file memiliki baris header yang berisi nama kolom (bidang). 

File bagian dikompresi (zipped) menggunakan GZ. Setelah diekstrak (unzipping):

  • Berekstensi CSV.
  • Setiap file memiliki baris header yang berisi nama kolom (bidang).
Urutan kolom

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 UA dan laporan penargetan ulang identik. Ini berarti Anda dapat memiliki prosedur pemuatan data yang serupa untuk jenis laporan lainnya. Anda memilih bidang untuk streaming. 
  • Laporan yang memiliki indikasi FF di bagian ketersediaan laporan tidak mematuhi struktur kolom yang umum. 
  • Arti bidang diperinci di kamus data lengkap
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. 

Zona Waktu dan Mata Uang

Pengaturan zona waktu dan mata uang khusus aplikasi tidak memengaruhi data yang di-streaming 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 pengiklan: 

  • Pastikan Anda mematuhi peraturan data privasi seperti GDPR dan kebijakan penyimpanan data jaringan iklan/SRN.
  • Jangan gunakan solusi penyimpanan milik pengiklan untuk mengirimkan 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. 
    • Mengubah bucket: Jika Anda mengubah penyimpanan, data dikirim ke kedua bucket untuk periode transisi 7 hari, memungkinkan Anda untuk menyelaraskan proses penggunaan data. 
  Penyimpanan milik AppsFlyer (AWS)  Penyimpanan milik pengiklan (AWS)
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 Pemasang iklan
Platform penyimpanan AWS AWS atau GCS
Kredensial agar Anda dapat mengakses data Tersedia di antarmuka pengguna Data Locker untuk Admin Tidak dikenal oleh AppsFlyer. Gunakan kredensial yang disediakan oleh penyedia penyimpanan.
Retensi data Data dihapus setelah 30 hari Tanggung jawab pengiklan
Permintaan penghapusan data Tanggung jawab AppsFlyer Tanggung jawab pengiklan
Keamanan AppsFlyer mengontrol penyimpanan. Pelanggan memiliki akses baca.

Pengiklan 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 pengiklan
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. 
Laporan SKAdNetwork Harus berlangganan Data Locker Tersedia jika Anda berlangganan data lengkap. Artinya, tidak perlu berlangganan Data Locker.

Pemberitahuan kepada petugas keamanan dalam hal penyimpanan yang dikontrol pelanggan

Sekilas, ini tampak seperti kami meminta banyak izin, tetapi kami meminta Anda mempertimbangkan sebagai berikut:

  • Bucket ini hanya untuk penggunaan AppsFlyer. Seharusnya tidak ada entitas lain yang men-streaming (menulis) ke bucket.
  • Anda dapat menghapus data di ember 25 jam setelah kami menulis data.
  • Data yang di-streaming ke bucket 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 men-streaming ulang data. Untuk alasan ini, kami perlu izin menghapus dan menulis data. Kedua izin ini tidak menimbulkan risiko keamanan bagi Anda. Dalam hal menulis data, kami satu-satunya entitas yang men-streaming ke bucket. Dalam hal menghapus, kami dapat membuat ulang data. 
  • Untuk informasi tambahan, Anda dapat menghubungi tim keamanan kami melalui  hello@appsflyer.com  atau manajer kesuksesan pelanggan/customer success manager. 

Prosedur

Pengaturan Data Locker

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

Prasyarat untuk mengatur penyimpanan milik pengiklan:

Jika Anda mengatur Data Locker menggunakan penyimpanan milik pengiklan, yang berarti bucket milik Anda, selesaikan salah satu prosedur penyimpanan milik pengiklan berikut:

Perhatikan! Jika Anda tidak berlangganan Data Locker dan hanya mengakses data SKAdNetwork data, Anda harus menyelesaikan prosedur penyimpanan milik pengiklan. 

AppsFlyerAdmin_us-en.png Untuk mengatur Data Locker:

  1. Admin perlu melakukan pengaturan. 
  2. Di Appsflyer, bukaIntegrasi > Data Locker. 
  3. Pilih metode integrasi. Lakukan salah satu dari berikut ini:
    • Pilih Bucket AWS AppsFlyer. 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). 
  4. Pilih struktur folder (pemisahan data):
    • [Default] Terpadu
    • Dipisahkan berdasarkan aplikasi.
  5. Pilih aplikasi yang diperlukan. Pilih semua untuk secara otomatis menyertakan aplikasi yang ditambahkan di kemudian hari. 
  6. Klik Terapkan
  7. [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.
  8. Pilih jenis laporanyang diperlukan. Anda harus memilih setidaknya 1 jenis laporan. 
  9. [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.
  10. Klik Terapkan
  11. [Opsional] Bidang: Pilih bidang yang akan disertakan dalam laporan. Catatan: Terkadang kami menyediakan bidang tambahan. Pertimbangkan hal ini dalam proses impor data Anda.
  12. 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 di-streaming ke bucket Anda dalam waktu 3 jam.

Pengaturan Data Locker—Bucket S3 AWS Anda

Prosedur di bagian ini harus dilakukan oleh admin AWS Anda.

Anda dapat menghapus file dari Data Locker 25 jam atau lebih setelah ditulis. Mohon jangan hapus sebelum periode waktu tersebut. 

Informasi latar belakang untuk admin AWS: 

AppsFlyer men-streaming data Anda ke bucket milik pengiklan AWS. Untuk melakukannya, diperlukan hal-hal berikut:

  • Buat bucket dengan nama af-datalocker-mybucket. Awalan af-datalocker- wajib diisi . Akhirannya adalah teks bebas (free text).
  • Kami menyarankan af-datalocker-yyyy-mm-dd-hh-mm-free-text. Di mana yyyy-mm-dd-hh-mm adalah tanggal dan waktu saat ini, dan Anda menambahkan teks lain yang Anda inginkan seperti yang ditunjukkan dalam gambar berikut.

Antarmuka pengguna dalam konsol AWS

MyBucket.jpg

Setelah membuat bucket, beri izin kepada AppsFlyer untuk menggunakan prosedur berikut. 

Untuk membuat bucket dan memberikan izin kepada AppsFlyer: 

  1. Login ke konsol AWS.
  2. Buka layanan S3.
  3. Untuk membuat bucket:
    1. Klik Buat bucket.
    2. Lengkapi Nama bucket sebagai berikut: Mulai dari af-datalocker- lalu kemudian tambahkan teks lain seperti yang dijelaskan sebelumnya.
    3. Klik Create bucket (Buat bucket).
  4. Untuk memberikan izin kepada AppsFlyer:
    1. Pilih bucket. 
    2. Buka tab Permission (Izin)
    3. Di bagian Bucket policy (Kebijakan bucket), klik Edit. 
      Jendela kebijakan Bucket terbuka.
    4. Rekatkan potongan kode berikut ke jendela.
      {
        "Version": "2012-10-17",
       "Statement": [
        {
        "Sid": "AF_DataLocker_Direct",
         "Effect": "Allow",
         "Principal": {
              "AWS": "arn:aws:iam::195229424603:user/product=datalocker__envtype=prod__ns=default"
            },
          "Action": [
            "s3:GetObject",
            "s3:ListBucket",
            "s3:DeleteObject",
            "s3:PutObject"
           ],
           "Resource": [
             "arn:aws:s3:::af-datalocker-my-bucket",
             "arn:aws:s3:::af-datalocker-my-bucket/*"
         ]
        }
        ]
      }
      
  5. Di potongan kode tersebut, ganti af-data-locker-my-bucket dengan nama bucket yang Anda buat.

  6. Klik Save changes (Simpan perubahan).

  7. Selesaikan Prosedur Pengaturan Data Locker.

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.png Untuk mereset kredensial:

  1. Di Appsflyer, bukaIntegrasi > Data Locker. 
  2. Di bagian Credential (Kredensial), klik Reset credentials (Reset kredensial).
    Muncul jendela konfirmasi.
  3. Klik Reset.
  4. 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. Terlepas dari zona waktu aplikasi Anda, jeda waktu dari terjadinya event hingga direkam di dalam Data locker itu tetap sama; yaitu 6 jam. 
Mata uang khusus aplikasi  Tidak didukung
Keterbatasan ukuran Tak dapat diterapkan
Kesegaran data File diperbarui setiap jam dengan jeda enam jam dari waktu event.
Data historis Tidak didukung. Data event dikirim setelah mengonfigurasi Data Locker. Jika Anda membutuhkan data historis, gunakan Pull API. 
Akses anggota tim Anggota tim tidak 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
  • Penyebab:  Kredensial AWS yang digunakan bukan kredensial yang benar untuk bucket AppsFlyer. Ini dapat disebabkan oleh memiliki beberapa kredensial atau tidak berlaku di mesin 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

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 kolom pertama, (ditandai [1] pada tangkapan layar yang mengikuti,) 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. Tutup jendela, untuk melakukannya, gunakan 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. 
Apakah artikel ini membantu?