Руководство: Измерение конверсий рекламы в 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);

Проверьте с помощью журналов отладки Xcode (необязательно)

Если вы включили режим отладки, после вызова 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