Руководство: Измерение конверсий рекламы в iOS

Шаг 3: Запустите измерение конверсий на устройстве с помощью Google Analytics

Теперь, когда вы можете собирать адреса электронной почты и номера телефонов пользователей, а в вашем приложении установлен SDK Google Analytics для Firebase, вы можете использовать эти данные для измерения конверсий.

Вызовите API

Вызовите API для измерения конверсий, используя адрес электронной почты или номер телефона, предоставленные на шаге 1 (они используются для измерения конверсий в рекламе), при этом не допуская утечки какой-либо личной информации с устройства пользователя.

Существует два способа начать измерение:

• Использование учетных данных
• Использование хешированных учетных данных

Используйте адрес электронной почты или номер телефона.

import FirebaseAnalytics

// ...
// If you're using an email address....
Analytics.initiateOnDeviceConversionMeasurement(emailAddress: "example@gmail.com")
// If you're using a phone number....
Analytics.initiateOnDeviceConversionMeasurement(phoneNumber: "+15555555555")

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithEmailAddress:@"example@gmail.com"];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithPhoneNumber:@"+15555555555"];

using Firebase.Analytics;

// ...
// If you're using an email address....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithEmailAddress("example@gmail.com");
// If you're using a phone number....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithPhoneNumber("+15555555555");

Используйте хешированный адрес электронной почты или номер телефона.

API принимает адреса электронной почты и номера телефонов, хешированные с помощью SHA256. Вы можете сохранить контроль над данными пользователей, выполняя хеширование в своем коде перед вызовами SDK.

Для использования хешированных учетных данных нормализуйте адреса и числа, хешируйте их с помощью SHA256, а затем вызовите API.

Стандартизировать адреса электронной почты и номера телефонов.

Для адресов электронной почты API Google Analytics предполагает, что перед применением алгоритма SHA256 выполняется определенная нормализация, поэтому выполните следующие шаги для нормализации ваших данных:

1. Преобразуйте весь адрес электронной почты в нижний регистр.

2. Если адрес электронной почты заканчивается на домен @googlemail.com , замените домен @googlemail.com на @gmail.com .

3. Для адресов, заканчивающихся на домен @gmail.com (включая те, которые были изменены на предыдущем шаге):

   1. Удалите все точки из части имени пользователя.

   2. Внесите следующие изменения в поле имени пользователя:

      • Вместо букв I или i, или цифры 1, используйте букву l.
      • Вместо цифры 0 подставьте букву o.
      • Вместо цифры 2 используйте букву «z».
      • Вместо цифры 5 используйте букву s.

Например, после нормализации:

• an.email.user0125@googlemail.com становится anemalluserolzs@gmail.com
• CAPSUSER0125@provider.net становится capsuser0125@provider.net

Для телефонных номеров необходимо, чтобы они уже были в формате E.164 (то есть, с префиксом +, 1-3 цифрами для кода страны, максимум 12 цифрами для номера абонента) до хеширования с помощью SHA256.

Обратите внимание, что хешированные по SHA256 адреса электронной почты или номера телефонов должны иметь длину 32 байта и не являться шестнадцатеричной строкой.

Вызовите API, используя хешированные учетные данные.

import FirebaseAnalytics

// ...
// If you're using an email address....
Analytics.initiateOnDeviceConversionMeasurement(hashedEmailAddress: hashedEmailAddress)
// If you're using a phone number....
Analytics.initiateOnDeviceConversionMeasurement(hashedPhoneNumber: hashedPhoneNumber)

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedEmailAddress:hashedEmailAddress];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedPhoneNumber:hashedPhoneNumber];

using Firebase.Analytics;

// ...
// If you're using an email address....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedEmailAddress(hashedEmailAddress);
// If you're using a phone number....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber(hashedPhoneNumber);

Проверьте интеграцию

Включите режим отладки. После вызова API инициализации измерения убедитесь, что в консоли отладки Xcode появилось сообщение, подобное следующему:

[FirebaseAnalytics][I-ACS023225] Initiated on-device conversion measurement

Если вы включили режим отладки и указали аргумент запуска -DebugOnDeviceConversionMeasurement , то вызов API initiateOnDeviceConversionMeasurement() будет имитировать совпадение.

[FirebaseAnalytics][I-ACS023229] On-device conversion measurement found a match

arrow_back_ios Шаг 2 : Интеграция Google Analytics Шаг 4 : Устранение неполадок и решение распространенных проблем arrow_forward_ios