SEO & SERP排名监控数据

// Illustrative managed visibility record; brand mapping included
{
  "profile_id": "VIS-GB-MOB-01",
  "engine": "google",
  "query": "best trail running shoes",
  "location": "London, England, UK",
  "language": "en",
  "device": "mobile",
  "result_type": "organic",
  "organic_position": 4,
  "domain": "brand.example",
  "entity_state": "owned",
  "captured_at": "2026-07-14T07:30:00Z",
  "collection_state": "valid"
}

# Illustrative scheduled monitoring brief
goal: "competitor visibility by market"
queries:
  groups: ["brand", "category", "competitor"]
  total: "approved matrix"
profiles:
  markets: ["GB", "DE", "FR"]
  languages: ["en", "de", "fr"]
  devices: ["mobile", "desktop"]
result_types: ["organic", "paid", "local"]
cadence: "weekly collection window"
history: "snapshots + change states"
delivery: "JSONL to agreed destination"

// Illustrative visibility metric specification
metric: "weighted result presence"
universe:
  query_groups: "approved only"
  result_types: "organic + paid + local"
  valid_profiles_only: true
mapping:
  owned_domains: "customer supplied"
  competitor_domains: "customer approved"
  unknown_state: "review_required"
weighting:
  formula: "documented before calculation"
missingness:
  failed_request_counts_as_absent: false
history:
  compare_same_profile_only: true