Руководство: Измерение конверсий рекламы в 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 замените букву о.
      • Вместо цифры 2 замените букву z.
      • Вместо цифры 5 замените букву s.

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

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

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

Вызов 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);

Проверьте журналы отладки Xcode (необязательно).

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

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

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

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

arrow_back_ios Шаг 2. Интеграция Google Analytics Шаг 4. Устранение и устранение распространенных arrow_forward_ios