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ó Google Analytics cho Firebase SDK, 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 đã được đồng ý ở Bước 1, được dùng để đo lường lượt chuyển đổi từ 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 đăng nhập
• Sử dụng thông tin đăng nhập đã 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 đã băm

API 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 băm trong mã trước khi gọi đến SDK.

Để sử dụng thông tin đăng nhập đã băm, hãy chuẩn hoá địa chỉ và số điện thoại, băm chúng 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 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 có đuôi là miền @googlemail.com, hãy thay thế miền @googlemail.com bằng @gmail.com.

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

   1. Xoá tất cả dấu chấm trong 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, hãy thay thế bằng chữ cái l
      • Đối với chữ số 0, hãy thay thế bằng chữ 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á:

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

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

Xin lưu ý rằng email hoặc số điện thoại đã băm bằng SHA256 phải có độ dài 32 byte và không phải là chuỗi thập lục phân.

Gọi API bằng thông tin đăng nhập đã 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 quá trình tích hợp

Bật chế độ gỡ lỗi. Sau khi gọi API bắt đầu đo lường, 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:

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

Nếu bạn bật chế độ gỡ lỗi và thêm đối số khởi chạy -DebugOnDeviceConversionMeasurement, thì việc gọi API initiateOnDeviceConversionMeasurement() sẽ mô phỏng một lượt khớp.

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

arrow_back_iosBướ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ặparrow_forward_ios