RAPPOR implementation

components/rappor/proto/rappor_metric.proto

+// Copyright 2014 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+//
+// Contains information collected by the RAPPOR (Randomized Aggregatable
+// Privacy-Preserving Ordinal Responses) system.
+//
+// For a full description of the rappor metrics, see
+// http://www.chromium.org/developers/design-documents/rappor
+
+syntax = "proto2";
+
+option optimize_for = LITE_RUNTIME;
+
+package rappor;
+
+message RapporReports {

[Alexei Svitkine (slow), 2014/02/11 16:59:06]

Add a comment, including a "Next tag: 4" line.

[Steven Holte, 2014/02/11 22:08:14]

Done.

+  // Which version of the Rappor scheme generated these reports.
+  optional int32 version = 1;
+
+  // Which cohort these reports belong to.  The RAPPOR participants are
+  // partioned into cohorts in different ways, to allow better statistics and
+  // increased coverage.  In particular, the cohort will serve to choose the
+  // hash functions used for Bloom-filter-based reports.
+  optional int32 cohort = 2;
+
+  message Report {

[Alexei Svitkine (slow), 2014/02/11 16:59:06]

Probably a short comment explaining what each "report" is - i.e. that it's for
one metric?

[Steven Holte, 2014/02/11 22:08:14]

Done.

+    // The name of the metric, hashed.
+    optional fixed64 name_hash = 1;
+
+    // The sequence of bits produced by random coin flips in
+    // RapporMetric::GetReport().  For a complete description of RAPPOR
+    // metrics, refer to the design document at:
+    // http://www.chromium.org/developers/design-documents/rappor
+    optional bytes bits = 2;
+  }
+  repeated Report report = 3;
+}