questionnaire docs
Ads

Time-Specific KVs

Hour-based KV overrides using Dubai timezone.

Time-Specific KVs

Override static KV values based on the current hour in Dubai timezone (Asia/Dubai).

Entry: lib/utils/timeSpecificKvs.js, lib/utils/adConfig.js

Resolution flow

Key files

FilePurpose
lib/utils/timeSpecificKvs.jsHour helpers, set picking
lib/utils/adConfig.jsTime-aware getters
lib/utils/kvEncoding.jsencodeTimeSpecificKvs
models/timeSpecificKvSchema.jsMongoose sub-schema

Rules

  • Dubai timezone only (Asia/Dubai)
  • Field-level resolution — each KV field resolved independently
  • URL time set takes priority over tenant time set
  • Falls back to static hierarchy if no active time set matches
  • Tenant display uses displayKv1ValuesCategory / displayKv1ValuesArticle in time sets
  • AdSense paths unchanged (no KV waterfalls)

Example time set

timeSpecificKvs: [
  {
    startHour: 9,
    endHour: 17,
    displayKv1ValuesCategory: ["20", "15", "10"],
    rewardedKv1Values: ["25", "20"]
  }
]

On this page