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 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 và xử lý các vấn đề thường gặp


Giờ đây, bạn có thể thu thập thông tin về người dùng địa chỉ email và số điện thoại, đồng thời ứng dụng của bạn có Google Analytics cho Firebase SDK, bạn có thể sử dụng hai công cụ 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ủa người dùng đã đồng ý số từ Bước 1, được dùng để đo lường lượt chuyển đổi quảng cáo, mà không cho phép mọi thông tin nhận dạng cá nhân 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 Objective-C Unity

Nhập mô-đun FirebaseAnalytics và nhập địa chỉ email hoặc số điện thoại cho 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")

Nhập mô-đun FirebaseAnalytics và chuyển địa chỉ email vào API initiateOnDeviceConversionMeasurementWithEmailAddress: hoặc điện thoại cho 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"];

Nhập không gian tên Firebase.Analytics rồi chuyển địa chỉ email vào API InitiateOnDeviceConversionMeasurementWithEmailAddress() hoặc điện thoại cho 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");

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 băm mã trong mã của bạn 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á địa chỉ và số, băm chúng bằng SHA256, sau đó gọi API.

Bình thường hoá địa chỉ email và số điện thoại

Đối với địa chỉ email, API Google Analytics giả định rằng 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 để 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 với @gmail.com.

  3. Đối với các địa chỉ có đuôi @gmail.com (bao gồm cả những địa chỉ được sửa đổi trong 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 các chữ cái I hoặc i hay chữ số 1, hãy thay thế chữ l
      • Cho chữ số 0, hãy thay chữ o
      • Cho chữ số 2, hãy thay chữ z
      • Cho chữ số 5, chữ cái thay thế 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ố phải ở định dạng E.164 (tức là thêm tiền tố +, 1 đến 3 chữ số cho mã quốc gia, tối đa 12 chữ số cho số thuê bao) trước băm bằng SHA256.

Gọi API bằng thông tin xác thực đã băm
Swift Objective-C Unity

Nhập mô-đun FirebaseAnalytics và nhập địa chỉ email hoặc số điện thoại cho 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)

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

@import FirebaseAnalytics;

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

Nhập không gian tên Firebase.Analytics rồi chuyển địa chỉ email vào API InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() hoặc số điện thoại đến 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 bằng nhật ký gỡ lỗi của Xcode (không bắt buộc)

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

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à thêm -DebugOnDeviceConversionMeasurement chạy đối số, sau đó gọi phương thức 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 và xử lý các vấn đề thường gặp