Add support for on-device conversions using hashed email address and phone number.

analytics/integration_test/src/integration_test.cc

@@ -220,6 +220,26 @@ TEST_F(FirebaseAnalyticsTest, TestSetProperties) {
       "[email protected]");
   firebase::analytics::InitiateOnDeviceConversionMeasurementWithPhoneNumber(
       "+15551234567");
+
+  std::vector<unsigned char> hashed_email = {
+      // SHA256-encoded "[email protected]"
+      0x31, 0xc5, 0x54, 0x3c, 0x17, 0x34, 0xd2, 0x5c, 0x72, 0x06, 0xf5,
+      0xfd, 0x59, 0x15, 0x25, 0xd0, 0x29, 0x5b, 0xec, 0x6f, 0xe8, 0x4f,
+      0xf8, 0x2f, 0x94, 0x6a, 0x34, 0xfe, 0x97, 0x0a, 0x1e, 0x66,
+  };
+
+  firebase::analytics::
+      InitiateOnDeviceConversionMeasurementWithHashedEmailAddress(hashed_email);
+
+  std::vector<unsigned char> hashed_phone = {
+      // SHA256-encoded "+12345556789"
+      0x12, 0x8c, 0x64, 0xfe, 0x24, 0x0f, 0x08, 0x75, 0xf5, 0x98, 0xc3,
+      0x48, 0x0e, 0xb0, 0x38, 0xd2, 0xe6, 0xb0, 0x05, 0xd1, 0xa0, 0x57,
+      0xb6, 0x21, 0x4a, 0xc2, 0x09, 0xf6, 0xe5, 0xc0, 0x68, 0x41,
+  };
+
+  firebase::analytics::
+      InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber(hashed_phone);
 }
 
 TEST_F(FirebaseAnalyticsTest, TestLogEvents) {

analytics/src/analytics_stub.cc

@@ -106,6 +106,11 @@ void InitiateOnDeviceConversionMeasurementWithEmailAddress(
   FIREBASE_ASSERT_RETURN_VOID(internal::IsInitialized());
 }
 
+void InitiateOnDeviceConversionMeasurementWithHashedEmailAddress(
+    std::vector<unsigned char> email_address) {
+  FIREBASE_ASSERT_RETURN_VOID(internal::IsInitialized());
+}
+
 /// Initiates on-device conversion measurement given a phone number on iOS
 /// (no-op on Android). On iOS, requires dependency
 /// GoogleAppMeasurementOnDeviceConversion to be linked in, otherwise it is a
@@ -115,6 +120,11 @@ void InitiateOnDeviceConversionMeasurementWithPhoneNumber(
   FIREBASE_ASSERT_RETURN_VOID(internal::IsInitialized());
 }
 
+void InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber(
+    std::vector<unsigned char> phone_number_hash) {
+  FIREBASE_ASSERT_RETURN_VOID(internal::IsInitialized());
+}
+
 // Set a user property to the given value.
 void SetUserProperty(const char* /*name*/, const char* /*value*/) {
   FIREBASE_ASSERT_RETURN_VOID(internal::IsInitialized());

analytics/src/include/firebase/analytics.h

@@ -21,6 +21,7 @@
 #include <cstdint>
 #include <map>
 #include <string>
+#include <vector>
 
 #include "firebase/app.h"
 #include "firebase/future.h"
@@ -503,6 +504,25 @@ void InitiateOnDeviceConversionMeasurementWithEmailAddress(
 void InitiateOnDeviceConversionMeasurementWithPhoneNumber(
     const char* phone_number);
 
+/// Initiates on-device conversion measurement given a sha256-hashed user email
+/// address. Requires dependency GoogleAppMeasurementOnDeviceConversion to be
+/// linked in, otherwise it is a no-op.
+/// @param hashedEmailAddress User email address as a UTF8-encoded string
+/// normalized and hashed according to the instructions at
+/// https://firebase.google.com/docs/tutorials/ads-ios-on-device-measurement/step-3.
+void InitiateOnDeviceConversionMeasurementWithHashedEmailAddress(
+    std::vector<unsigned char> hashed_email_address);
+
+/// Initiates on-device conversion measurement given a sha256-hashed phone
+/// number in E.164 format. Requires dependency
+/// GoogleAppMeasurementOnDeviceConversion to be linked in, otherwise it is a
+/// no-op.
+/// @param hashedPhoneNumber UTF8-encoded user phone number in E.164 format and
+/// then hashed according to the instructions at
+/// https://firebase.google.com/docs/tutorials/ads-ios-on-device-measurement/step-3.
+void InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber(
+    std::vector<unsigned char> hashed_phone_number);
+
 /// @brief Set a user property to the given value.
 ///
 /// Properties associated with a user allow a developer to segment users