components/rappor/proto/rappor_metric.proto

   1 // Copyright 2014 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4 //
   5 // Contains information collected by the RAPPOR (Randomized Aggregatable
   6 // Privacy-Preserving Ordinal Responses) system.
   7 //
   8 // For a full description of the rappor metrics, see
   9 // http://www.chromium.org/developers/design-documents/rappor
  10
  11 syntax = "proto2";
  12
  13 option optimize_for = LITE_RUNTIME;
  14
  15 package rappor;
  16
  17 // Next tag: 3
  18 message RapporReports {
  19   // Which cohort these reports belong to.  The RAPPOR participants are
  20   // partioned into cohorts in different ways, to allow better statistics and
  21   // increased coverage.  In particular, the cohort will serve to choose the
  22   // hash functions used for Bloom-filter-based reports.  The cohort is
  23   // generated randomly by the client and is currently in the range [0,32).
  24   optional int32 cohort = 1;
  25
  26   // Each Report contains the values generated by the RAPPOR process for one
  27   // metric.
  28   message Report {
  29     // The name of the metric, hashed (first 8 bytes of MD5 hash).
  30     optional fixed64 name_hash = 1;
  31
  32     // The sequence of bits produced by random coin flips in
  33     // RapporMetric::GetReport().  For a complete description of RAPPOR
  34     // metrics, refer to the design document at:
  35     // http://www.chromium.org/developers/design-documents/rappor
  36     optional bytes bits = 2;
  37   }
  38   repeated Report report = 2;
  39 }