Hướng dẫn: Đo lường lượt chuyển đổi Quảng cáo trên iOS

Bước 3: Bắt đầu đo lường lượt chuyển đổi trên thiết bị bằng Google Analytics

Giờ đây, bạn có thể thu thập địa chỉ email và số điện thoại của người dùng và ứng dụng của bạn có SDK Google Analytics cho Firebase, bạn có thể sử dụng cả hai để bắt đầu đo lường chuyển đổi.

Gọi API

Gọi API đo lường chuyển đổi bằng địa chỉ email hoặc số điện thoại đã được đồng ý từ Bước 1, được sử dụng để đo lường chuyển đổi quảng cáo mà không cho phép bất kỳ thông tin nhận dạng cá nhân nào rời khỏi thiết bị người dùng.

Có hai cách để bắt đầu đo:

• Sử dụng thông tin đăng nhập
• Sử dụng thông tin xác thực băm

Sử dụng địa chỉ email hoặc số điện thoại

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");

Sử dụng địa chỉ email hoặc số điện thoại được băm

API sẽ chấp nhận địa chỉ email và số điện thoại được băm bằng SHA256. Bạn có thể duy trì quyền kiểm soát dữ liệu của người dùng bằng cách thực hiện băm mã trước khi thực hiện lệnh gọi tới SDK.

Để sử dụng thông tin xác thực đã băm, hãy chuẩn hóa địa chỉ và số, băm chúng bằng SHA256, sau đó gọi API.

Chuẩn hóa địa chỉ email và số điện thoại

Đối với địa chỉ email , API Google Analytics giả định rằng việc chuẩn hóa cụ thể được thực hiện trước khi áp dụng SHA256, vì vậy hãy làm theo các bước sau để chuẩn hóa dữ liệu của bạn:

1. Chuyển đổi toàn bộ địa chỉ email thành chữ thường.

2. Nếu địa chỉ email kết thúc bằng miền @googlemail.com , hãy thay thế miền @googlemail.com bằng @gmail.com .

3. Đối với các địa chỉ có đuôi miền @gmail.com (bao gồm cả những địa chỉ đã sửa đổi ở bước trước):

   1. Xóa tất cả các dấu chấm khỏi phần tên người dùng.

   2. Thực hiện các thay thế sau trong phần tên người dùng:

      • Đối với chữ cái I hoặc i, hoặc chữ số 1, thay thế chữ l
      • Đối với chữ số 0, thay chữ o
      • Đối với chữ số 2, thay chữ z
      • Đối với chữ số 5, thay chữ s

Ví dụ: sau khi chuẩn hóa:

• an.email.user0125@googlemail.com trở thành anemlluserolzs@gmail.com
• CAPSUSER0125@provider.net trở thành capsuser0125@provider.net

Đối với số điện thoại , số phải có sẵn định dạng E.164 (nghĩa là có tiền tố +, 1-3 chữ số đối với mã quốc gia, tối đa 12 chữ số đối với số thuê bao) trước khi băm bằng SHA256.

Gọi API bằng thông tin xác thực được băm

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);

Xác minh bằng nhật ký gỡ lỗi Xcode (tùy chọn)

Nếu bạn đã bật chế độ gỡ lỗi, sau khi gọi API đo lường bắt đầu, hãy đảm bảo rằng thông báo như thông báo nhật ký sau xuất hiện trong bảng điều khiển gỡ lỗi Xcode:

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

Trong Firebase 9.6.0 trở lên, nếu bạn đã bật chế độ gỡ lỗi và bao gồm đối số khởi chạy -DebugOnDeviceConversionMeasurement thì việc gọi API initiateOnDeviceConversionMeasurement() sẽ mô phỏng kết quả khớp.

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

arrow_back_ios Bước 2 : Tích hợp Google Analytics Bước 4 : Khắc phục sự cố và xử lý các sự cố thường gặp arrow_forward_ios