Cycle Tracking - Format Ekspor JSON

Dokumentasi struktur Cycle Tracking dalam ekspor JSON

Last updated: March 31, 2026

Di halaman ini

Cycle Tracking

Data Cycle Tracking mencakup seluruh informasi terkait siklus menstruasi yang dicatat di Apple Health, seperti aliran menstruasi, kualitas lendir serviks, suhu basal, hasil tes ovulasi, dan data lainnya. Dalam ekspor JSON, data tersebut berada di array cycleTracking.

Struktur

Setiap entri cycle tracking memiliki struktur konsisten:

{
  "start": "2024-02-01 00:00:00 -0800",
  "end": "2024-02-05 23:59:59 -0800",
  "name": "Menstrual Flow",
  "value": "Medium",
  "isCycleStart": true
}

Field

Field Wajib

  • start (String): Waktu mulai entri (yyyy-MM-dd HH:mm:ss Z)
  • end (String): Waktu berakhir entri (yyyy-MM-dd HH:mm:ss Z)
  • name (String): Jenis data cycle tracking (lihat daftar di bawah)
  • value (String): Nilai untuk entri tersebut (berbeda tiap jenis)

Field Opsional

  • isCycleStart (Boolean): Menandakan awal siklus menstruasi baru. Hanya muncul pada entri Menstrual Flow jika bernilai true.

Jenis Cycle Tracking

Menstrual Flow

Melacak perdarahan menstruasi beserta tingkat alirannya.

{
  "start": "2024-02-01 00:00:00 -0800",
  "end": "2024-02-05 23:59:59 -0800",
  "name": "Menstrual Flow",
  "value": "Medium",
  "isCycleStart": true
}

Nilai yang mungkin:

  • "None"
  • "Light"
  • "Medium"
  • "Heavy"
  • "Unspecified"

Catatan: isCycleStart hanya muncul ketika true untuk menandai awal siklus.

Cervical Mucus Quality

Melacak kualitas lendir serviks yang dapat menunjukkan status kesuburan.

{
  "start": "2024-02-10 00:00:00 -0800",
  "end": "2024-02-10 23:59:59 -0800",
  "name": "Cervical Mucus Quality",
  "value": "Egg White"
}

Nilai yang mungkin:

  • "Egg White" - bening dan elastis (paling subur)
  • "Watery" - tipis dan berair
  • "Creamy" - kental seperti krim
  • "Sticky" - lengket
  • "Dry" - sangat sedikit lendir

Basal Body Temperature

Pengukuran suhu basal diekspor sebagai health metric, bukan entri cycle tracking. Cari "Basal Body Temperature" di array metrics.

Ovulation Test Result

Mencatat hasil tes ovulasi.

{
  "start": "2024-02-12 08:00:00 -0800",
  "end": "2024-02-12 08:00:00 -0800",
  "name": "Ovulation Test Result",
  "value": "Positive/Peak"
}

Nilai yang mungkin:

  • "Positive/Peak" - puncak kesuburan
  • "High" - tingkat kesuburan tinggi
  • "Negative/Low" - kesuburan rendah
  • "Indeterminate" - hasil tidak jelas

Progesterone Test Result

{
  "start": "2024-02-15 08:00:00 -0800",
  "end": "2024-02-15 08:00:00 -0800",
  "name": "Progesterone Test Result",
  "value": "Positive"
}

Pregnancy Test Result

{
  "start": "2024-02-20 08:00:00 -0800",
  "end": "2024-02-20 08:00:00 -0800",
  "name": "Pregnancy Test Result",
  "value": "Positive"
}

Sexual Activity

Melacak aktivitas seksual dalam konteks siklus.

{
  "start": "2024-02-14 20:00:00 -0800",
  "end": "2024-02-14 20:00:00 -0800",
  "name": "Sexual Activity",
  "value": ""
}

Catatan: Aktivitas seksual juga muncul di health metrics lengkap dengan informasi proteksi.

Pregnancy

Melacak periode kehamilan.

{
  "start": "2024-03-01 00:00:00 -0800",
  "end": "2024-11-15 23:59:59 -0800",
  "name": "Pregnancy",
  "value": ""
}

Lactation

Melacak periode menyusui.

{
  "start": "2024-11-20 00:00:00 -0800",
  "end": "2025-02-20 23:59:59 -0800",
  "name": "Lactation",
  "value": ""
}

Contraceptive

Melacak penggunaan kontrasepsi.

{
  "start": "2024-01-01 00:00:00 -0800",
  "end": null,
  "name": "Contraceptive",
  "value": ""
}

Ketidakaturan Siklus

Infrequent Menstrual Cycle

{
  "start": "2024-02-01 00:00:00 -0800",
  "end": "2024-02-01 23:59:59 -0800",
  "name": "Infrequent Menstrual Cycle",
  "value": ""
}

Irregular Menstrual Cycle

{
  "start": "2024-02-01 00:00:00 -0800",
  "end": "2024-02-01 23:59:59 -0800",
  "name": "Irregular Menstrual Cycle",
  "value": ""
}

Intermenstrual Bleeding

Perdarahan di luar jadwal menstruasi.

{
  "start": "2024-02-15 00:00:00 -0800",
  "end": "2024-02-15 23:59:59 -0800",
  "name": "Intermenstrual Bleeding",
  "value": ""
}

Persistent Menstrual Bleeding

Perdarahan yang berlangsung lama.

{
  "start": "2024-02-01 00:00:00 -0800",
  "end": "2024-02-10 23:59:59 -0800",
  "name": "Persistent Menstrual Bleeding",
  "value": ""
}

Prolonged Menstrual Period

Menstruasi dengan durasi lebih panjang dari biasanya.

{
  "start": "2024-02-01 00:00:00 -0800",
  "end": "2024-02-08 23:59:59 -0800",
  "name": "Prolonged Menstrual Period",
  "value": ""
}

Contoh Entri Lengkap

[
  {
    "start": "2024-02-01 00:00:00 -0800",
    "end": "2024-02-05 23:59:59 -0800",
    "name": "Menstrual Flow",
    "value": "Medium",
    "isCycleStart": true
  },
  {
    "start": "2024-02-10 00:00:00 -0800",
    "end": "2024-02-10 23:59:59 -0800",
    "name": "Cervical Mucus Quality",
    "value": "Egg White"
  },
  {
    "start": "2024-02-12 08:00:00 -0800",
    "end": "2024-02-12 08:00:00 -0800",
    "name": "Ovulation Test Result",
    "value": "Positive/Peak"
  },
  {
    "start": "2024-02-14 20:00:00 -0800",
    "end": "2024-02-14 20:00:00 -0800",
    "name": "Sexual Activity",
    "value": ""
  }
]

Use Case

Data cycle tracking berguna untuk:

  • Pelacakan kesuburan: Memantau ovulasi dan jendela subur
  • Analisis siklus: Melihat panjang siklus, keteraturan, dan pola
  • Monitoring kesehatan: Mengidentifikasi ketidaknormalan atau perubahan pola
  • Perencanaan kehamilan: Mendukung rencana konsepsi
  • Berbagi dengan tenaga medis: Membagikan data ke ginekolog atau spesialis fertilitas
  • Korelasi gejala: Menghubungkan data siklus dengan metrik kesehatan lain

Data Terkait

Sebagian data siklus berada di bagian lain:

  • Basal Body Temperature: Tersedia di array metrics
  • Sexual Activity: Juga tersedia di health metrics beserta detail proteksi

Tips

  • Pencatatan konsisten: Log yang konsisten membuat prediksi siklus lebih akurat
  • Gabungkan beberapa tipe data: Kombinasi flow, lendir, suhu, dan tes memberikan gambaran komprehensif
  • Penanda awal siklus: Gunakan isCycleStart untuk menandai awal tiap siklus selama analisis

Dokumentasi Terkait