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

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

소개: iOS 광고 전환 측정

1단계: 로그인 환경 구현

2단계: Google Analytics 통합

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

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

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

API 호출

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

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

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

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

Swift

FirebaseAnalytics 모듈을 가져와 이메일 주소 또는 전화번호를 initiateOnDeviceConversionMeasurement() API에 전달합니다.

참고: initiateOnDeviceConversionMeasurement(emailAddress:) 및 initiateOnDeviceConversionMeasurement(phoneNumber:) 메서드는 순차적으로 호출될 수 있지만 사용자당 하나의 일치 항목만 보고할 수 있습니다. 두 API 중 하나와 일치하는 항목이 발견되면 후속 API 호출은 사실상 무시됩니다.

import FirebaseAnalytics

// ...
// If you're using an email address....
Analytics.initiateOnDeviceConversionMeasurement(emailAddress: "[e-mail]")
// If you're using a phone number....
Analytics.initiateOnDeviceConversionMeasurement(phoneNumber: "[phone]")

Objective-C

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

참고: initiateOnDeviceConversionMeasurementWithEmailAddress: 및 initiateOnDeviceConversionMeasurementWithPhoneNumber: 메서드는 순차적으로 호출될 수 있지만 사용자당 하나의 일치 항목만 보고할 수 있습니다. 두 API 중 하나와 일치하는 항목이 발견되면 후속 API 호출은 사실상 무시됩니다.

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithEmailAddress:@"[e-mail]"];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithPhoneNumber:@"[phone]"];

Unity

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

참고: InitiateOnDeviceConversionMeasurementWithEmailAddress() 및 InitiateOnDeviceConversionMeasurementWithPhoneNumber() 메서드는 순차적으로 호출될 수 있지만 사용자당 하나의 일치 항목만 보고할 수 있습니다. 두 API 중 하나와 일치하는 항목이 발견되면 후속 API 호출은 사실상 무시됩니다.

using Firebase.Analytics;

// ...
// If you're using an email address....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithEmailAddress("[e-mail]");
// If you're using a phone number....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithPhoneNumber("[phone]");

참고: 설치당 한 번, 로그인에 최대한 가깝게 API를 호출하는 것이 좋습니다.

중요: 사용자 이메일 또는 전화 등록 후 즉시 의도한 인앱 액션 또는 이벤트가 발생하는 경우 기기 내 전환 측정을 시작하는 것과 이벤트를 로깅하는 것 사이에 약간의 시간 지연을 구현하는 것이 좋습니다.

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

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로 대체

예를 들어 정규화 후에는 다음과 같습니다.

• [e-mail]이 [e-mail]이 됩니다.
• [e-mail]이 [e-mail]이 됩니다.

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

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

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

Swift

FirebaseAnalytics 모듈을 가져와 이메일 주소 또는 전화번호를 initiateOnDeviceConversionMeasurement() API에 전달합니다.

참고: initiateOnDeviceConversionMeasurement(hashedEmailAddress:) 및 initiateOnDeviceConversionMeasurement(hashedPhoneNumber:) 메서드는 순차적으로 호출될 수 있지만 사용자당 하나의 일치 항목만 보고할 수 있습니다. 두 API 중 하나에서 일치하는 항목이 발견되면 후속 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에 전달합니다.

참고: initiateOnDeviceConversionMeasurementWithHashedEmailAddress: 및 initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: 메서드는 순차적으로 호출될 수 있지만 사용자당 하나의 일치 항목만 보고할 수 있습니다. 두 API 중 하나에서 일치하는 항목이 발견되면 후속 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에 전화번호를 전달합니다.

참고: InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() 및 InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber() 메서드는 순차적으로 호출될 수 있지만 사용자당 하나의 일치 항목만 보고할 수 있습니다. 두 API 중 하나에서 일치하는 항목이 발견되면 후속 API 호출은 사실상 무시됩니다.

using Firebase.Analytics;

// ...
// If you're using an email address....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedEmailAddress(hashedEmailAddress);
// If you're using a phone number....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber(hashedPhoneNumber);

참고: 설치당 한 번, 로그인에 최대한 가깝게 API를 호출하는 것이 좋습니다.

중요: 사용자 이메일 또는 전화 등록 후 즉시 의도한 인앱 액션 또는 이벤트가 발생하는 경우 기기 내 전환 측정을 시작하는 것과 이벤트를 로깅하는 것 사이에 약간의 시간 지연을 구현하는 것이 좋습니다.

통합 확인

디버그 모드를 사용 설정합니다. 측정 시작 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단계: 일반적인 문제 해결 및 처리

---