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

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


소개: iOS 광고 전환 측정

1단계: 로그인 환경 구현

2단계: 통합하기Google Analytics

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

4단계: 일반적인 문제 해결 및 처리


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

API 호출

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

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

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

Swift

FirebaseAnalytics 모듈을 가져오고 이메일 주소 또는 전화번호를 initiateOnDeviceConversionMeasurement() 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")

Objective-C

FirebaseAnalytics 모듈을 가져오고 이메일 주소를 initiateOnDeviceConversionMeasurementWithEmailAddress: API에 전달하거나 전화번호를 initiateOnDeviceConversionMeasurementWithPhoneNumber: API에 전달합니다.

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithEmailAddress:@"example@gmail.com"];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithPhoneNumber:@"+15555555555"];

Unity

Firebase.Analytics 네임스페이스를 가져오고 이메일 주소를 InitiateOnDeviceConversionMeasurementWithEmailAddress() API에 전달하거나 전화번호를 InitiateOnDeviceConversionMeasurementWithPhoneNumber() API에 전달합니다.

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자리)이어야 합니다.

해싱된 SHA256 이메일 또는 전화번호는 16진수 문자열이 아닌 32바이트 길이여야 합니다.

해싱된 사용자 인증 정보로 API 호출

Swift

FirebaseAnalytics 모듈을 가져오고 이메일 주소 또는 전화번호를 initiateOnDeviceConversionMeasurement() 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)

Objective-C

FirebaseAnalytics 모듈을 가져오고 이메일 주소를 initiateOnDeviceConversionMeasurementWithHashedEmailAddress: API에 전달하거나 전화번호를 initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: API에 전달합니다.

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedEmailAddress:hashedEmailAddress];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedPhoneNumber:hashedPhoneNumber];

Unity

Firebase.Analytics 네임스페이스를 가져오고 이메일 주소를 InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() API에 전달하거나 전화번호를 InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber() API에 전달합니다.

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 디버그 콘솔에 다음과 같은 로그 메시지와 유사한 메시지가 표시되는지 확인합니다.

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

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

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



2단계: Google Analytics 통합하기 4단계: 일반적인 문제 해결 및 처리하기