From a469218d0730f870bb10702933ac8e11b2ad5d02 Mon Sep 17 00:00:00 2001
From: Paul Miller <paulmiller@google.com>
Date: Thu, 7 Jan 2016 11:32:15 -0800
Subject: [PATCH] Document WebView Metrics opt out API

BUG:22665268
Change-Id: Ib2f7b2a340e27d7d3faf5bfbf6c2216d3c1549e4
---
 core/java/android/webkit/WebView.java | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/core/java/android/webkit/WebView.java b/core/java/android/webkit/WebView.java
index 7443bce5e4d0..0f58ba3c002c 100644
--- a/core/java/android/webkit/WebView.java
+++ b/core/java/android/webkit/WebView.java
@@ -280,6 +280,23 @@ import java.util.Map;
  * instead.
  * </p>
  *
+ * <h3>Metrics</h3>
+ *
+ * <p>
+ * WebView may upload anonymous diagnostic data to Google when the user has consented. This data
+ * helps Google improve WebView. Data is collected on a per-app basis for each app which has
+ * instantiated a WebView. An individual app can opt out of this feature by putting the following
+ * tag in its manifest:
+ * </p>
+ * <pre>
+ * <meta-data android:name="android.webkit.WebView.MetricsOptOut"
+ *            android:value="true" />
+ * </pre>
+ * <p>
+ * Data will only be uploaded for a given app if the user has consented AND the app has not opted
+ * out.
+ * </p>
+ *
  */
 // Implementation notes.
 // The WebView is a thin API class that delegates its public API to a backend WebViewProvider
-- 
2.11.0