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