| Index: components/payments/content/android/java/src/org/chromium/components/payments/JourneyLogger.java
|
| diff --git a/components/payments/content/android/java/src/org/chromium/components/payments/JourneyLogger.java b/components/payments/content/android/java/src/org/chromium/components/payments/JourneyLogger.java
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..d37ec86684e9186ab1803b235529d25081fca407
|
| --- /dev/null
|
| +++ b/components/payments/content/android/java/src/org/chromium/components/payments/JourneyLogger.java
|
| @@ -0,0 +1,144 @@
|
| +// Copyright 2016 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.
|
| +
|
| +package org.chromium.components.payments;
|
| +
|
| +import org.chromium.base.annotations.JNINamespace;
|
| +
|
| +/**
|
| + * A class used to record journey metrics for the Payment Request feature.
|
| + */
|
| +@JNINamespace("payments")
|
| +public class JourneyLogger {
|
| + // Note: The constants should always be in sync with those in the journey_logger.h file.
|
| + // The index of the different sections of a Payment Request. Used to record journey stats.
|
| + public static final int SECTION_CONTACT_INFO = 0;
|
| + public static final int SECTION_CREDIT_CARDS = 1;
|
| + public static final int SECTION_SHIPPING_ADDRESS = 2;
|
| + public static final int SECTION_MAX = 3;
|
| +
|
| + // For the CanMakePayment histograms.
|
| + public static final int CAN_MAKE_PAYMENT_USED = 0;
|
| + public static final int CAN_MAKE_PAYMENT_NOT_USED = 1;
|
| + public static final int CAN_MAKE_PAYMENT_USE_MAX = 2;
|
| +
|
| + // Used to log different parameters' effect on whether the transaction was completed.
|
| + public static final int COMPLETION_STATUS_COMPLETED = 0;
|
| + public static final int COMPLETION_STATUS_ABORTED = 1;
|
| + public static final int COMPLETION_STATUS_MAX = 2;
|
| +
|
| + // Used to mesure the impact of the CanMakePayment return value on whether the Payment Request
|
| + // is shown to the user.
|
| + public static final int CMP_SHOW_COULD_NOT_MAKE_PAYMENT_AND_DID_NOT_SHOW = 0;
|
| + public static final int CMP_SHOW_DID_SHOW = 1 << 0;
|
| + public static final int CMP_SHOW_COULD_MAKE_PAYMENT = 1 << 1;
|
| + public static final int CMP_SHOW_MAX = 4;
|
| +
|
| + // The minimum expected value of CustomCountHistograms is always set to 1. It is still possible
|
| + // to log the value 0 to that type of histogram.
|
| + private static final int MIN_EXPECTED_SAMPLE = 1;
|
| + private static final int MAX_EXPECTED_SAMPLE = 49;
|
| + private static final int NUMBER_BUCKETS = 50;
|
| +
|
| + /**
|
| + * Pointer to the native implementation.
|
| + */
|
| + private long mJourneyLoggerAndroid;
|
| +
|
| + public JourneyLogger() {
|
| + // Note that this pointer could leak the native object. The called must call destroy() to
|
| + // ensure that the native object is destroyed.
|
| + mJourneyLoggerAndroid = nativeInitJourneyLoggerAndroid();
|
| + }
|
| +
|
| + /** Will destroy the native object. This class shouldn't be used afterwards. */
|
| + public void destroy() {
|
| + if (mJourneyLoggerAndroid != 0) {
|
| + nativeDestroy(mJourneyLoggerAndroid);
|
| + mJourneyLoggerAndroid = 0;
|
| + }
|
| + }
|
| +
|
| + /**
|
| + * Sets the number of suggestions shown for the specified section.
|
| + *
|
| + * @param section The section for which to log.
|
| + * @param number The number of suggestions.
|
| + */
|
| + public void setNumberOfSuggestionsShown(int section, int number) {
|
| + assert section < SECTION_MAX;
|
| + nativeSetNumberOfSuggestionsShown(mJourneyLoggerAndroid, section, number);
|
| + }
|
| +
|
| + /**
|
| + * Increments the number of selection changes for the specified section.
|
| + *
|
| + * @param section The section for which to log.
|
| + */
|
| + public void incrementSelectionChanges(int section) {
|
| + assert section < SECTION_MAX;
|
| + nativeIncrementSelectionChanges(mJourneyLoggerAndroid, section);
|
| + }
|
| +
|
| + /**
|
| + * Increments the number of selection edits for the specified section.
|
| + *
|
| + * @param section The section for which to log.
|
| + */
|
| + public void incrementSelectionEdits(int section) {
|
| + assert section < SECTION_MAX;
|
| + nativeIncrementSelectionEdits(mJourneyLoggerAndroid, section);
|
| + }
|
| +
|
| + /**
|
| + * Increments the number of selection adds for the specified section.
|
| + *
|
| + * @param section The section for which to log.
|
| + */
|
| + public void incrementSelectionAdds(int section) {
|
| + assert section < SECTION_MAX;
|
| + nativeIncrementSelectionAdds(mJourneyLoggerAndroid, section);
|
| + }
|
| +
|
| + /**
|
| + * Records the fact that the merchant called CanMakePayment and records it's return value.
|
| + *
|
| + * @param value The return value of the CanMakePayment call.
|
| + */
|
| + public void setCanMakePaymentValue(boolean value) {
|
| + nativeSetCanMakePaymentValue(mJourneyLoggerAndroid, value);
|
| + }
|
| +
|
| + /**
|
| + * Records the fact that the Payment Request was shown to the user.
|
| + */
|
| + public void setShowCalled() {
|
| + nativeSetShowCalled(mJourneyLoggerAndroid);
|
| + }
|
| +
|
| + /*
|
| + * Records the histograms for all the sections that were requested by the merchant and for the
|
| + * usage of the CanMakePayment method and its effect on the transaction. This method should be
|
| + * called when the payment request has either been completed or aborted.
|
| + *
|
| + * @param submissionType A string indicating the way the payment request was concluded.
|
| + */
|
| + public void recordJourneyStatsHistograms(String submissionType) {
|
| + nativeRecordJourneyStatsHistograms(mJourneyLoggerAndroid, submissionType);
|
| + }
|
| +
|
| + private native long nativeInitJourneyLoggerAndroid();
|
| + private native void nativeDestroy(long nativeJourneyLoggerAndroid);
|
| + private native void nativeSetNumberOfSuggestionsShown(
|
| + long nativeJourneyLoggerAndroid, int section, int number);
|
| + private native void nativeIncrementSelectionChanges(
|
| + long nativeJourneyLoggerAndroid, int section);
|
| + private native void nativeIncrementSelectionEdits(long nativeJourneyLoggerAndroid, int section);
|
| + private native void nativeIncrementSelectionAdds(long nativeJourneyLoggerAndroid, int section);
|
| + private native void nativeSetCanMakePaymentValue(
|
| + long nativeJourneyLoggerAndroid, boolean value);
|
| + private native void nativeSetShowCalled(long nativeJourneyLoggerAndroid);
|
| + private native void nativeRecordJourneyStatsHistograms(
|
| + long nativeJourneyLoggerAndroid, String submissionType);
|
| +}
|
|
|