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 và ứng dụng của bạn có Google Analytics cho Firebase SDK. Bạn có thể sử dụng cả hai để 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ười dùng đồ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ó 2 cách để bắt đầu đo lường:
Sử dụng địa chỉ email hoặc số điện thoại
Swift
Nhập mô-đun FirebaseAnalytics và truyền địa chỉ email hoặc số điện thoại vào API initiateOnDeviceConversionMeasurement().
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
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:.
@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
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():
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");
Các phương pháp hay nhất để gọi API
Để đảm bảo đo lường lượt chuyển đổi trên thiết bị một cách chính xác và liên tục, hãy làm một trong những việc sau:
Gọi trên mọi bản cập nhật ứng dụng (Nên dùng)
Google Analytics cho Firebase SDK phiên bản 12.1.0 trở lên có
các điểm cải tiến về tính năng đo lường lượt chuyển đổi trên thiết bị. Để đảm bảo những điểm cải tiến này áp dụng cho tất cả người dùng (kể cả những người đã đăng nhập trước khi ứng dụng của bạn được cập nhật), bạn cần phải gọi lại API initiateOnDeviceConversionMeasurement sau khi ứng dụng cập nhật.
Cụ thể, những người dùng đã đăng nhập trước khi ứng dụng của bạn cập nhật lên SDK phiên bản 12.1.0 sẽ không được đưa vào phạm vi đo lường nâng cao cho đến khi API initiateOnDeviceConversionMeasurement được gọi lại cho họ. Nếu không kiểm tra bản cập nhật ứng dụng, điều này sẽ chỉ xảy ra nếu họ đăng xuất rồi đăng nhập lại.
Phương pháp hay nhất là gọi API cho người dùng đã đăng nhập ít nhất một lần cho mỗi phiên bản ứng dụng. Bạn có thể triển khai một quy trình kiểm tra khi khởi chạy ứng dụng để chỉ gọi API khi phiên bản ứng dụng đã thay đổi kể từ lần gọi gần nhất.
Swift
// On app launch if the app version has changed, call the API with the first-party data // (for example: email address, phone number, hashed email address, hashed phone number). let cachedAppVersion = UserDefaults.standard.string(forKey: "cachedAppVersion") let currentAppVersion = Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String if cachedAppVersion != currentAppVersion { let hashedEmailAddress = ... Analytics.initiateOnDeviceConversionMeasurement(hashedEmailAddress: hashedEmailAddress) UserDefaults.standard.set(currentAppVersion, forKey: "cachedAppVersion") }
Objective-C
// On app launch if the app version has changed, call the API with the first-party data // (for example: email address, phone number, hashed email address, hashed phone number). NSString *cachedAppVersion = [[NSUserDefaults standardUserDefaults] stringForKey:@"cachedAppVersion"]; NSString *currentAppVersion = [[NSBundle mainBundle] objectForInfoDictionaryKey:@"CFBundleShortVersionString"]; if (![cachedAppVersion isEqualToString:currentAppVersion]) { NSString *hashedEmailAddress = ... [FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedEmailAddress:hashedEmailAddress]; [[NSUserDefaults standardUserDefaults] setObject:currentAppVersion forKey:@"cachedAppVersion"]; }
Unity
// On app launch if the app version has changed, call the API with the first-party data // (for example: email address, phone number, hashed email address, hashed phone number). string cachedAppVersion = PlayerPrefs.GetString("cached_app_version", ""); string currentAppVersion = Application.version; if (cachedAppVersion != currentAppVersion) { byte[] hashedEmailAddress = ... FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedEmailAddress( hashedEmailAddress); PlayerPrefs.SetString("cached_app_version", currentAppVersion); PlayerPrefs.Save(); }
Gọi ngay sau khi đăng nhập
Luôn gọi API initiateOnDeviceConversionMeasurement ngay sau khi người dùng đăng nhập thành công hoặc đăng ký email hoặc số điện thoại của họ.
Cân nhắc về thời gian đối với lượt đăng ký mới
Nếu một sự kiện chuyển đổi quan trọng xảy ra ngay sau khi người dùng đăng ký (và bạn gọi API), hãy cân nhắc việc triển khai một khoảng thời gian trễ nhỏ (ví dụ: 5 giây) giữa lệnh gọi API và việc ghi lại sự kiện quan trọng. Điều này giúp đảm bảo quá trình đo lường trên thiết bị được khởi chạy đầy đủ trước khi sự kiện được ghi lại.
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 quá trình băm trong mã của mình trước khi gọi SDK.
Để sử dụng thông tin đăng nhập đã băm, hãy chuẩn hoá địa chỉ và số, băm chúng bằng thuật toán 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 thuật toán SHA256. Vì vậy, hãy làm theo các bước sau để chuẩn hoá dữ liệu của bạn:
Chuyển đổi toàn bộ địa chỉ email thành chữ thường.
Nếu địa chỉ email kết thúc bằng miền @googlemail.com, hãy thay thế @googlemail.com miền bằng @gmail.com.
Đối với các địa chỉ kết thúc bằng miền @gmail.com (kể cả những địa chỉ đã sửa đổi ở bước trước):
Xoá tất cả dấu chấm khỏi phần tên người dùng.
Thực hiện các thay thế sau trong phần tên người dùng:
- Đối với các 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á:
an.email.user0125@googlemail.comtrở thànhanemalluserolzs@gmail.comCAPSUSER0125@provider.nettrở thànhcapsuser0125@provider.net
Đối với số điện thoại, các số phải ở định dạng E.164 (tức là bắt đầu bằng +, 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 thuật toán SHA256.
Xin lưu ý rằng email hoặc số điện thoại đã băm bằng thuật toán SHA256 phải 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
Swift
Nhập mô-đun FirebaseAnalytics và truyền địa chỉ email hoặc số điện thoại vào API initiateOnDeviceConversionMeasurement().
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:.
@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à truyền địa chỉ email vào API InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() hoặc số điện thoại vào API InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber():
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 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 kết quả phù hợp.
[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