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

3단계: Google Analytics를 사용하여 기기 내 전환 측정 시작

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

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 anemlluserolzs@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 디버그 로그로 확인(선택 사항)

디버그 모드를 활성화한 경우 측정 시작 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_ios 2단계 : Google Analytics 통합 4단계 : 일반적인 문제 해결 및 처리 arrow_forward_ios