Trang này được dịch bởi Cloud Translation API.

Gắn thẻ phía máy chủ cho ứng dụng di động

Bạn có thể định cấu hình ứng dụng di động bằng SDK Google Analytics cho Firebase để hoạt động với tính năng gắn thẻ phía máy chủ trong Trình quản lý thẻ của Google.

Tính năng gắn thẻ phía máy chủ cho phép bạn sắp xếp, loại bỏ và tăng cường dữ liệu trước khi gửi dữ liệu đó đến các sản phẩm đích như Google Analytics. Tìm hiểu thêm về tính năng Gắn thẻ phía máy chủ.

Cách thiết lập tính năng gắn thẻ phía máy chủ cho ứng dụng di động:

Chuẩn bị để ứng dụng của bạn sẵn sàng cho tính năng gắn thẻ phía máy chủ
Định cấu hình vùng chứa máy chủ để hỗ trợ lưu lượng truy cập trên thiết bị di động
Bật tính năng gắn thẻ phía máy chủ trong tài sản GA4

Điều kiện tiên quyết

Bạn cần đưa SDK Google Analytics cho Firebase vào ứng dụng và kết nối SDK đó với tài sản Google Analytics 4. Tìm hiểu thêm về SDK Google Analytics cho Firebase.
Bạn cần có tài khoản Trình quản lý thẻ của Google và vùng chứa phía máy chủ. Nếu bạn chưa có, hãy tạo tài khoản và vùng chứa Trình quản lý thẻ mới.
Bạn cần thiết lập máy chủ gắn thẻ.

Bước 1: Chuẩn bị ứng dụng để gắn thẻ phía máy chủ

iOS

Bật tính năng tải lên gắn thẻ phía máy chủ và thiết lập giao thức URL tuỳ chỉnh cho chế độ gỡ lỗi gắn thẻ phía máy chủ trong tệp Info.plist. Thay thế BUNDLE_ID trên phần sau bằng giá trị nhận dạng gói của ứng dụng.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
...
        <key>CFBundleURLTypes</key>
        <array>
                <dict>
                        <key>CFBundleTypeRole</key>
                        <string>None</string>
                        <key>CFBundleURLName</key>
                        <string>BUNDLE_ID</string>
                        <key>CFBundleURLSchemes</key>
                        <array>
                                <string>tagmanager.sgtm.c.BUNDLE_ID</string>
                        </array>
                </dict>
        </array>
        <key>GOOGLE_ANALYTICS_SGTM_UPLOAD_ENABLED</key>
        <true/>
</dict>
</plist>

Để bật chế độ gỡ lỗi hoặc xem trước, hãy thêm lệnh gọi đến Analytics.handleOpen(_:) trong một phương thức vòng đời để truyền URL khởi chạy.

SwiftUI

@main
struct MyApplication: App {
  var body: some Scene {
    WindowGroup {
      ContentView()
        .onOpenURL { url in
          Analytics.handleOpen(url)
        }
    }
  }
}

UIScene

class SceneDelegate: UIResponder, UIWindowSceneDelegate {
func scene(_ scene: UIScene, willConnectTo session: UISceneSession,
        options connectionOptions: UIScene.ConnectionOptions) {
...
    if let urlContext = connectionOptions.urlContexts.first {
        let url = urlContext.url
        Analytics.handleOpen(url)
    }
  }
}

Đối với các ứng dụng không sử dụng SwiftUI hoặc UIScene, bạn không cần làm gì cả. SDK nhận URL khởi chạy từ ApplicationDidFinishLaunchingNotification.

Android

Cài đặt bản phát hành mới nhất của SDK Google Analytics cho Firebase.

Bật sGTM bằng cách thêm nội dung sau vào tệp AndroidManifest.xml của ứng dụng.

<!-- Preview Activity to enable preview mode –->
  <activity
      android:name="com.google.firebase.analytics.GoogleAnalyticsServerPreviewActivity"
      android:exported="true"
      android:noHistory="true" >
    <intent-filter>
      <action android:name="android.intent.action.VIEW" />
      <category android:name="android.intent.category.DEFAULT" />
      <category android:name="android.intent.category.BROWSABLE" />
      <data android:scheme="tagmanager.sgtm.c.<APP_PACKAGE_ID>" />
    </intent-filter>
  </activity>

<!-- Meta-data that enables uploads to sGTM –->
  <meta-data android:name="google_analytics_sgtm_upload_enabled" android:value="true" />

Bước 2: Định cấu hình vùng chứa máy chủ để hỗ trợ lưu lượng truy cập trên thiết bị di động

Phần sau giả định rằng bạn đã triển khai tính năng gắn thẻ phía máy chủ và bạn đã quen thuộc với các khái niệm của mô hình đó. Nếu mới làm quen với tính năng gắn thẻ phía máy chủ, bạn có thể tham gia khoá học cơ bản về tính năng gắn thẻ phía máy chủ.

Thiết lập ứng dụng Google Analytics: GA4 (Ứng dụng)

Ứng dụng là một loại tài nguyên Trình quản lý thẻ chặn một số loại yêu cầu đến và tạo các sự kiện có thể được chuyển đến một đích đến, chẳng hạn như Google Analytics 4. Trong trường hợp này, yêu cầu HTTP là sự kiện Google Analytics 4, vì vậy, bạn cần định cấu hình ứng dụng (Ứng dụng) GA4 tích hợp sẵn trong Google Analytics. Bạn chỉ cần một ứng dụng GA4 cho mỗi nguồn dữ liệu, chẳng hạn như SDK GA và trang web. Tìm hiểu thêm về Cách hoạt động của ứng dụng.

Trong vùng chứa máy chủ, hãy chuyển đến Clients (Ứng dụng) rồi nhấp vào New (Mới).
Nhấp vào Cấu hình ứng dụng, rồi chọn Google Analytics: GA4 (Ứng dụng).
Nhập tên cho khách hàng rồi nhấp vào Lưu.

Định cấu hình thẻ Google Analytics: GA4

Để gửi dữ liệu đến Google Analytics, bạn cần tạo một thẻ Google Analytics: GA4 trong vùng chứa phía máy chủ. Ứng dụng phân tích cú pháp yêu cầu HTTP đến thành một đối tượng dữ liệu sự kiện. Thẻ này sẽ lấy đối tượng dữ liệu sự kiện này, liên kết đối tượng đó với định dạng chính xác, sau đó gửi đối tượng đó đến Google Analytics 4.

Trong vùng chứa máy chủ, hãy chuyển đến Thẻ rồi nhấp vào Mới.
Nhấp vào Cấu hình thẻ, sau đó chọn Google Analytics: GA4.

Theo mặc định, thẻ sẽ kế thừa tất cả các trường và thông số liên quan từ đối tượng dữ liệu sự kiện do ứng dụng tạo:

Nếu yêu cầu Google Analytics 4 sắp tới đi qua ứng dụng Google Analytics: GA4 (Ứng dụng), thì thẻ sẽ kế thừa mã ứng dụng và các tham số sự kiện.
Nếu các yêu cầu Google Analytics 4 sắp tới đi qua ứng dụng Google Analytics: GA4 (Web), thì thẻ sẽ kế thừa Mã đo lường và các thông số sự kiện.

Thiết lập trình kích hoạt cho lưu lượng truy cập trên thiết bị di động

Sau đó, bạn nên thiết lập thời điểm kích hoạt thẻ GA4. Google Analytics: Ứng dụng GA4 (Ứng dụng) phân tích cú pháp yêu cầu đến thành một đối tượng dữ liệu sự kiện và thẻ sẽ kế thừa các giá trị của thẻ đó. Do đó, bạn thường muốn thẻ kích hoạt bất cứ khi nào ứng dụng GA4 xác nhận yêu cầu.

Cách thiết lập trình kích hoạt:

Trong phần cài đặt thẻ, hãy nhấp vào Kích hoạt.
Để tạo điều kiện kích hoạt mới, hãy nhấp vào biểu tượng + ở góc trên cùng bên phải.
Nhấp vào Cấu hình điều kiện kích hoạt để chọn loại điều kiện kích hoạt.
Chọn Tuỳ chỉnh hoặc Sự kiện tuỳ chỉnh trong danh sách.
- Theo mặc định, loại Trình kích hoạt tuỳ chỉnh sẽ kích hoạt thẻ khi bất kỳ sự kiện nào được máy khách phía máy chủ tạo.
- Bạn có thể sử dụng loại điều kiện kích hoạt Sự kiện tuỳ chỉnh để kích hoạt thẻ theo tên sự kiện cụ thể hoặc sự kiện khớp với mẫu biểu thức chính quy.
Để bật danh sách điều kiện kích hoạt cho điều kiện kích hoạt này, chẳng hạn như chỉ kích hoạt trên dữ liệu sự kiện trên thiết bị di động hoặc web, hãy chọn Một số sự kiện.
1. Bạn sẽ thấy Tên sự kiện được chọn sẵn. Nhấp vào bộ chọn đó rồi chọn Chọn biến tích hợp trong danh sách.
2. Để tự động trả về tên của ứng dụng đã tạo sự kiện, hãy chọn Tên ứng dụng.
3. Sử dụng tên của ứng dụng mà bạn đã định cấu hình trước đó để đặt điều kiện cho phù hợp. Điều kiện kích hoạt của bạn sẽ có dạng như sau:
  
  Lưu ý: Tên của ứng dụng là tên bạn đã chỉ định ở bước trước. Loại ứng dụng khách là Google Analytics: GA4 (Ứng dụng). Biến Tên ứng dụng trả về tên chứ không phải loại ứng dụng.
Lưu điều kiện kích hoạt và nhập tên mô tả. Ví dụ: bạn có thể sử dụng "Tất cả sự kiện trong ứng dụng GA4".
Bây giờ, bạn sẽ quay lại phần cài đặt thẻ với điều kiện kích hoạt mới. Lưu thẻ và nhập tên mô tả, ví dụ: "GA4". Thẻ của bạn sẽ có dạng như sau:

Xem trước vùng chứa

Bạn có thể sử dụng Trình quản lý thẻ của Google để xem trước và gỡ lỗi vùng chứa phía máy chủ trước khi phát hành các thay đổi. Xin lưu ý rằng tính năng xem trước sẽ không hoạt động cho đến khi bạn bật tính năng gắn thẻ phía máy chủ trong tài sản GA4.

Để yêu cầu ứng dụng của bạn kích hoạt cấu hình xem trước, bạn cần:

Chọn Xem trước trong vùng chứa máy chủ của Trình quản lý thẻ của Google.
Nhấp vào biểu tượng Thao tác khác ⋮ ở trên cùng bên phải rồi chọn Gửi yêu cầu từ một ứng dụng.
Nhập mã ứng dụng của bạn rồi nhấp vào Tạo mã QR.
Quét mã QR này bằng ứng dụng máy ảnh trên điện thoại, rồi tiếp tục tương tác với ứng dụng của bạn như cách bạn thường làm để tạo các sự kiện xem trước.
Nhấp vào OK để đóng hộp thoại này.

Xuất bản vùng chứa

Sau khi bạn xác minh các thay đổi, hãy xuất bản vùng chứa để các thay đổi đó hiển thị trực tiếp cho tất cả lưu lượng truy cập. Tìm hiểu thêm về Hoạt động xuất bản, phiên bản và quy trình phê duyệt.

Bước 3: Bật tính năng gắn thẻ phía máy chủ trong tài sản GA4

Trong tài sản Google Analytics 4, hãy chuyển đến mục Quản trị.
Mở mục Luồng dữ liệu.
Chọn cấu hình luồng của ứng dụng từ thẻ iOS hoặc Android.
Nhấp vào Định cấu hình chế độ cài đặt SDK, rồi nhấp vào Định cấu hình Trình quản lý thẻ phía máy chủ.
Cách cho phép SDK gửi dữ liệu đo lường đến URL vùng chứa phía máy chủ:
1. Bật/tắt mục Gửi dữ liệu đến vùng chứa Trình quản lý thẻ phía máy chủ.
2. Sao chép URL vùng chứa máy chủ. Bạn có thể tìm thấy thông tin này trong Trình quản lý thẻ của Google bằng cách chuyển đến phần Quản trị > Cài đặt vùng chứa > URL vùng chứa máy chủ.
3. Chọn tỷ lệ phần trăm lưu lượng truy cập mà bạn muốn định tuyến đến vùng chứa máy chủ. Bạn có thể chọn một tuỳ chọn dưới 100% để xác thực chế độ thiết lập và cấu hình máy chủ trước khi sử dụng tính năng gắn thẻ phía máy chủ cho tất cả lưu lượng truy cập.
  
  Lưu ý: Chỉ sử dụng tuỳ chọn Chỉ thiết bị gỡ lỗi để chỉ cho phép những ứng dụng đang mở bằng Chế độ xem trước để gửi dữ liệu đến máy chủ.
Nhấp vào Lưu. SDK sẽ truy xuất URL vùng chứa máy chủ đã cập nhật và chuyển trực tiếp dữ liệu đo lường đến URL đó.

Các hạn chế đã biết

Đối với các ứng dụng Android:
- Để tránh các lỗ hổng bảo mật tiềm ẩn liên quan đến vùng chứa máy chủ và dịch vụ Google Play, các sự kiện sẽ đi qua một máy chủ proxy không có trạng thái giữa SDK và vùng chứa máy chủ của bạn. Proxy này sẽ xác thực nguồn và điểm cuối của yêu cầu, nhưng sẽ không kiểm tra hoặc lưu trữ bất kỳ dữ liệu nào về các sự kiện. Theo cách GA4 thu thập dữ liệu từ các thiết bị ở Liên minh Châu Âu, proxy sẽ nằm ở Liên minh Châu Âu đối với lưu lượng truy cập ở Liên minh Châu Âu.
- Giao dịch mua hàng trong ứng dụng được ghi lại tự động dựa vào quá trình tích hợp với phần phụ trợ của Google Play và sẽ không được gửi đến vùng chứa phía máy chủ.
- Sự kiện app_remove sẽ không được báo cáo trên Android.
Bạn vẫn cần kết nối các luồng dữ liệu ứng dụng trong Google Analytics với tài khoản Google Ads để đảm bảo rằng dữ liệu SDK và lượt chuyển đổi được nhập vào Google Ads. Tính năng gắn thẻ phía máy chủ không cung cấp bất kỳ tính năng tích hợp nào giữa SDK và Google Ads.

API

Bạn có thể sử dụng API REST của Trình quản lý thẻ để truy cập vào dữ liệu cấu hình của Trình quản lý thẻ. Để biết thêm thông tin về API này, hãy làm như sau:

Hãy tham khảo Hướng dẫn dành cho nhà phát triển để tìm hiểu cách làm việc với API này.
Xem lại Tài liệu tham khảo về API Trình quản lý thẻ để làm quen với các tài nguyên và thao tác có sẵn trong Trình quản lý thẻ.