튜토리얼: iOS 광고 전환 측정

3단계: Google Analytics를 사용하여 온디바이스 전환 측정 시작

이제 사용자의 이메일 주소와 전화번호를 수집할 수 있고 앱에 Firebase SDK용 Google Analytics가 있으므로 이 두 가지를 사용하여 전환 측정을 시작할 수 있습니다.

API 호출

개인 식별 정보가 사용자 기기에서 유출되지 않도록 하면서 1단계에서 동의한 이메일 주소 또는 전화번호(광고 전환 측정에 사용됨)를 사용하여 전환 측정 API를 호출합니다.

측정을 시작하는 방법에는 두 가지가 있습니다.

• 사용자 인증 정보 사용
• 해싱된 사용자 인증 정보 사용

이메일 주소 또는 전화번호 사용

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를 호출합니다.

이메일 주소 및 전화번호 정규화

이메일 주소의 경우 Google Analytics API는 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로 변경됩니다.

전화번호의 경우 SHA256으로 해싱하기 전에 이미 E.164 형식 (즉, 접두사 +, 국가 코드 1~3자리, 구독자 번호 최대 12자리)이어야 합니다.

해싱된 사용자 인증 정보로 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 디버그 로그로 확인 (선택사항)

디버그 모드를 사용 설정한 경우, initiate measurement API를 호출한 후 Xcode 디버그 콘솔에 다음과 같은 로그 메시지와 유사한 메시지가 표시되는지 확인합니다.

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

Firebase 9.6.0 이상에서 디버그 모드를 사용 설정하고 -DebugOnDeviceConversionMeasurement 실행 인수를 포함한 경우 initiateOnDeviceConversionMeasurement() API를 호출하면 일치가 시뮬레이션됩니다.

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

arrow_back_ios2단계: Google Analytics 통합 4단계: 일반적인 문제 해결 및 처리arrow_forward_ios