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ới thiệu: Đo lường lượt chuyển đổi từ quảng cáo trên iOS

Bước 1: Triển khai trải nghiệm đăng nhập

Bước 2: Tích hợp Google Analytics

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

Bước 4: Khắc phục sự cố và xử lý các vấn đề thường gặp

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

Gọi API

Gọi API đo lường lượt chuyển đổi bằng địa chỉ email hoặc số điện thoại mà người dùng đã đồng ý ở Bước 1. API này được dùng để đo lường lượt 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ị của người dùng.

Có hai cách để bắt đầu đo lường:

• Sử dụng thông tin xác thực
• 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

Swift

Nhập mô-đun FirebaseAnalytics và chuyển địa chỉ email hoặc số điện thoại vào API initiateOnDeviceConversionMeasurement().

Lưu ý: Bạn có thể gọi các phương thức initiateOnDeviceConversionMeasurement(emailAddress:) và initiateOnDeviceConversionMeasurement(phoneNumber:) theo tuần tự, nhưng mỗi người dùng chỉ có thể báo cáo một kết quả trùng khớp. Nếu tìm thấy kết quả trùng khớp với một trong hai API, thì lệnh gọi API tiếp theo sẽ bị bỏ qua một cách hiệu quả.

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

Nhập mô-đun FirebaseAnalytics và truyền địa chỉ email vào API initiateOnDeviceConversionMeasurementWithEmailAddress: hoặc số điện thoại vào API initiateOnDeviceConversionMeasurementWithPhoneNumber:.

Lưu ý: Bạn có thể gọi các phương thức initiateOnDeviceConversionMeasurementWithEmailAddress: và initiateOnDeviceConversionMeasurementWithPhoneNumber: theo tuần tự, nhưng mỗi người dùng chỉ có thể báo cáo một kết quả trùng khớp. Nếu tìm thấy kết quả trùng khớp với một trong hai API, thì lệnh gọi API tiếp theo sẽ bị bỏ qua một cách hiệu quả.

@import FirebaseAnalytics;

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

Unity

Nhập không gian tên Firebase.Analytics và truyền địa chỉ email vào API InitiateOnDeviceConversionMeasurementWithEmailAddress() hoặc số điện thoại vào API InitiateOnDeviceConversionMeasurementWithPhoneNumber():

Lưu ý: Bạn có thể gọi các phương thức InitiateOnDeviceConversionMeasurementWithEmailAddress() và InitiateOnDeviceConversionMeasurementWithPhoneNumber() theo tuần tự, nhưng mỗi người dùng chỉ có thể báo cáo một kết quả trùng khớp. Nếu tìm thấy kết quả trùng khớp với một trong hai API, thì lệnh gọi API tiếp theo sẽ bị bỏ qua một cách hiệu quả.

using Firebase.Analytics;

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

Lưu ý: Việc so khớp email và số điện thoại chỉ cần xảy ra một lần cho mỗi lượt cài đặt trên thiết bị và tốt nhất là việc so khớp phải diễn ra gần nhất có thể với thời điểm đăng nhập.

Lưu ý quan trọng: Hãy lưu ý rằng nếu một hành động hoặc sự kiện dự kiến trong ứng dụng xảy ra ngay lập tức sau khi người dùng đăng ký bằng email hoặc số điện thoại, hãy cân nhắc việc triển khai một độ trễ nhỏ giữa thời điểm bắt đầu đo lường lượt chuyển đổi trên thiết bị và thời điểm ghi lại sự kiện.

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

API này sẽ chấp nhận địa chỉ email và số điện thoại được băm bằng thuật toán 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 việc băm trong mã trước khi thực hiện lệnh gọi đến SDK.

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

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

Đối với địa chỉ email, API Google Analytics giả định rằng một quy trình chuẩn hoá 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 hoá dữ liệu:

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 đị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. Xoá tất cả dấu chấm khỏi phần tên người dùng.

   2. Thay thế các phần sau trong tên người dùng:

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

Ví dụ: sau khi chuẩn hoá:

• [e-mail] trở thành [e-mail]
• [e-mail] trở thành [e-mail]

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

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

Swift

Nhập mô-đun FirebaseAnalytics và truyền địa chỉ email hoặc số điện thoại vào API initiateOnDeviceConversionMeasurement().

Lưu ý: Bạn có thể gọi các phương thức initiateOnDeviceConversionMeasurement(hashedEmailAddress:) và initiateOnDeviceConversionMeasurement(hashedPhoneNumber:) theo tuần tự, nhưng mỗi người dùng chỉ có thể báo cáo một kết quả trùng khớp. Nếu tìm thấy kết quả trùng khớp với một trong hai API, thì lệnh gọi API tiếp theo sẽ bị bỏ qua một cách hiệu quả.

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

Nhập mô-đun FirebaseAnalytics và truyền địa chỉ email vào API initiateOnDeviceConversionMeasurementWithHashedEmailAddress: hoặc số điện thoại vào API initiateOnDeviceConversionMeasurementWithHashedPhoneNumber:.

Lưu ý: Các phương thức initiateOnDeviceConversionMeasurementWithHashedEmailAddress: và initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: có thể được gọi tuần tự, nhưng chỉ có thể báo cáo một kết quả trùng khớp cho mỗi người dùng. Nếu tìm thấy kết quả trùng khớp với một trong hai API, thì lệnh gọi API tiếp theo sẽ bị bỏ qua một cách hiệu quả.

@import FirebaseAnalytics;

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

Unity

Nhập không gian tên Firebase.Analytics và chuyển địa chỉ email vào API InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() hoặc số điện thoại vào API InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber():

Lưu ý: Bạn có thể gọi các phương thức InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() và InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber() theo tuần tự, nhưng mỗi người dùng chỉ có thể báo cáo một kết quả trùng khớp. Nếu tìm thấy kết quả trùng khớp với một trong hai API, thì lệnh gọi API tiếp theo sẽ bị bỏ qua một cách hiệu quả.

using Firebase.Analytics;

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

Lưu ý: Việc so khớp email và số điện thoại chỉ cần xảy ra một lần cho mỗi lượt cài đặt trên thiết bị và tốt nhất là việc so khớp xảy ra càng gần thời điểm đăng nhập càng tốt.

Lưu ý quan trọng: Hãy lưu ý rằng nếu một hành động hoặc sự kiện dự kiến trong ứng dụng xảy ra ngay lập tức sau khi người dùng đăng ký bằng email hoặc số điện thoại, hãy cân nhắc việc triển khai một độ trễ nhỏ giữa thời điểm bắt đầu đo lường lượt chuyển đổi trên thiết bị và thời điểm ghi lại sự kiện.

Xác minh bằng nhật ký gỡ lỗi Xcode (không bắt buộc)

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 một thông báo như thông báo nhật ký sau đây 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à đưa đối số khởi chạy -DebugOnDeviceConversionMeasurement vào, thì việc gọi API initiateOnDeviceConversionMeasurement() sẽ mô phỏng một kết quả trùng khớp.

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

---

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

---