Bài viết liên tục được cập nhật, và những phần được cập nhật rất có thể chưa được dịch sang ngôn ngữ của bạn. Để xem thông tin mới nhất, vui lòng chọn ngôn ngữ Tiếng Anh.

Cài đặt Google Analytics 4

Google Analytics 4 là đối tác phân tích (analytics partner) có tích hợp với Adjust. Tích hợp cho phép Google Analytics 4 nhận được dữ liệu do Adjust đo lường thông qua callback tự động. Bạn có thể sử dụng dữ liệu này cùng công cụ của đối tác để phân tích dữ liệu.

Dưới đây là hướng dẫn cài đặt tính năng đo lường Google Analytics 4. Hướng dẫn gồm các bước kích hoạt tích hợp và xác định loại dữ liệu mà Adjust có thể chia sẻ cho Google Analytics 4.

Trước khi bắt đầu

Yêu cầu

iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona

Thông tin tài khoản

Firebase App ID (for mobile apps), Measurement ID (for web apps), API Secret

  • Để được hỗ trợ tìm thông tin tài khoản, vui lòng liên hệ với đại diện Google Analytics 4.

Trên Google Analytics 4 dashboard:

Để lấy Firebase App ID:

  1. Truy cập Firebase Console
  2. Click vào project của bạn
  3. Click vào biểu tượng bánh răng > "Project settings" nằm cạnh "Project Overview" tại thanh điều hướng trái
  4. Tại mục "Your apps", chọn ứng dụng của bạn, sau đó lấy Firebase App ID bên dưới trường "App ID"

Để lấy API secret:

  1. Truy cập Google Analytics dashboard
  2. Chọn Admin > Data collection and modification > Data streams
  3. Chọn luồng dữ liệu của ứng dụng, sau đó chọn Measurement Protocol API secrets > Secret value để lấy API secret
  4. Nếu không tìm thấy API secret, chọn Create ngay dưới mục Measurement Protocol API secrets, nhập tên, sau đó chọn Create

Chọn Google Analytics 4 và ứng dụng trên Campaign Lab

  1. Tại mục Campaign Lab , chọn Đối tác.
  2. Chọn Đối tác mới > Google Analytics 4. Chọn Tiếp theo để chuyển sang màn hình kế tiếp.
  3. Trên màn hình Lựa chọn ứng dụng , chọn ứng dụng mà bạn muốn tạo liên kết, sau đó kích hoạt tích hợp để chia sẻ dữ liệu cho Google Analytics 4.
  4. Chọn Tiếp theo.

Kích hoạt tính năng chia sẻ dữ liệu

Kích hoạt tính năng chia sẻ dữ liệu để kích hoạt tích hợp giữa Adjust và Google Analytics 4. Để kích hoạt tính năng chia sẻ dữ liệu:

  1. Nhập Firebase App ID (for mobile apps), Measurement ID (for web apps), API Secret.

Sau khi bạn kích hoạt tính năng chia sẻ dữ liệu cho Google Analytics 4, Adjust sẽ mặc định gửi các dữ liệu sau cho Google Analytics 4:

  • lượt cài đặt
  • tái phân bổ

Cài đặt tính năng chia sẻ dữ liệu

Nếu ứng dụng của bạn là đa nền tảng (multi-platform app), và tính năng chia sẻ dữ liệu đã được kích hoạt cho các nền tảng này, thì bạn có thể thực hiện các thao tác sau:

  1. Chọn Sử dụng cài đặt riêng của nền tảng nếu bạn muốn cài đặt tính năng chia sẻ dữ liệu khác nhau cho mỗi nền tảng.
  2. Chọn Sử dụng cài đặt chung nếu bạn muốn cài đặt tính năng giống nhau cho tất cả nền tảng.

Tại mục Dữ liệu nào sẽ được chia sẻ mặc định? , kiểm tra lại các dữ liệu mà Adjust mặc định chia sẻ cho Google Analytics 4:

  • lượt cài đặt
  • tái phân bổ

Gửi dữ liệu bổ sung

Chọn số lượng và loại dữ liệu mà bạn muốn chia sẻ cho Google Analytics 4 qua callback. Google Analytics 4 có thể sử dụng dữ liệu bạn chia sẻ để cải thiện dịch vụ.

Để gửi thêm dữ liệu khác, bạn có thể kiểm tra lại các mục sau và thực hiện các thay đổi cần thiết:

Doanh thu in-app (từ giao dịch in-app)

Nếu bạn chọn chia sẻ dữ liệu doanh thu in-app, Google Analytics 4 sẽ nhận được dữ liệu số tiền và sự kiện doanh thu. Bạn cần liên kết sự kiện để có thể chia sẻ dữ liệu này; lưu ý, sự kiện phải tạo doanh thu.

Liên kết event

Liên kết sự kiện mà bạn muốn chia sẻ, với giá trị mà Google Analytics 4 có thể nhận được. Đối với sự kiện không được liên kết, dữ liệu liên quan đến sự kiện sẽ không được chia sẻ cho Google Analytics 4.

Liên kết các sự kiện riêng lẻ

Nếu bạn sở hữu ứng dụng đa nền tảng (multi-platform app), thì có thể chia sẻ cho Google Analytics 4 các sự kiện khác nhau tùy theo từng nền tảng. Tức bạn có thể:

  • Cài đặt sự kiện riêng lẻ để quản lý chiến dịch theo từng nền tảng.
  • Điều chỉnh tính năng chia sẻ dữ liệu của từng nền tảng.

Để chọn sự kiện in-app mà muốn bạn muốn gửi trực tiếp cho Google Analytics 4, thực hiện các bước sau tại mục Liên kết sự kiện .

  1. Chọn Liên kết sự kiện.

  2. Mở danh sách Sự kiện của Adjust , chọn sự kiện mà bạn muốn chia sẻ cho Google Analytics 4.

  3. Tại mục Sự kiện đối tác , chọn sự kiện của Google Analytics 4, đảm bảo sự kiện đó tương ứng với sự kiện của Adjust.

    1. Đối với ứng dụng đơn nền tảng và ứng dụng đa nền tảng nhưng chỉ bật tính năng chia sẻ dữ liệu cho một nền tảng, thì bạn chỉ cần liên kết sự kiện cho nền tảng đó. Còn đối với ứng dụng đa nền tảng nhưng bật tính năng chia sẻ dữ liệu cho nhiều nền tảng, thì bạn có các lựa chọn sau:

      • Chọn Sử dụng biểu đồ liên kết riêng của nền tảng để liên kết sự kiện theo từng nền tảng một, hoặc để không liên kết sự kiện cho một số nền tảng nhất định.
      • Chọn Sử dụng biểu đồ liên kết chung để liên kết chung sự kiện cho tất cả nền tảng.

    2. Trong danh sách Sự kiện của đối tác , chọn sự kiện có sẵn hoặc nhập sự kiện do bạn đặt tên - sự kiện này sẽ liên kết với sự kiện của Adjust.

  4. Chọn Áp dụng .

Giờ đây, Google Analytics 4 sẽ nhận được dữ liệu về sự kiện in-app của từng sự kiện được liên kết.

Liên kết tất cả sự kiện

Nếu Google Analytics 4 cho phép liên kết tự động tất cả sự kiện, thì tại mục Liên kết sự kiện , chọn Liên kết tất cả sự kiện. Như vậy bạn đỡ mất thời gian liên kết từng sự kiện một.

Sau bước trên, Google Analytics 4 sẽ nhận được dữ liệu sự kiện in-app của tất cả sự kiện được liên kết.

Liên kết tham số

Bạn cần liên kết tham số để gửi dữ liệu tùy chỉnh cho Google Analytics 4.

Với tham số đối tác (khả dụng trên Adjust SDK phiên bản 4.0 trở lên), Adjust có thể thu thập và trực tiếp gửi các điểm dữ liệu tùy chỉnh từ ứng dụng đến Google Analytics 4. Như vậy, Google Analytics 4 có thể nhận được dữ liệu chi tiết cho từng sự kiện được liên kết.

Trước khi thêm tham số đối tác mới vào SDK, vui lòng đảm bảo rằng, các tham số đối tác hiện có không đáp ứng được yêu cầu.

Để chia sẻ tham số đối tác cho Google Analytics 4, thực hiện các bước sau.

  1. Cài đặt tham số đối tác trong Adjust SDK.

  2. Tại mục Cài đặt tính năng chia sẻ dữ liệu , chọn Tham số.

  3. Đến mục Liên kết tham số , chọn tham số mà bạn muốn gửi đến mạng quảng cáo:

    1. Chọn Liên kết tham số.
    2. Tại trường Tham số SDK , nhập tên tham số SDK mà bạn muốn chia sẻ cho mạng quảng cáo.
    3. Tại trường Tham số đối tác , nhập tham số mạng quảng cáo tương ứng với tham số SDK.
Lưu ý:

Nếu bạn cài đặt tham số đối tác trong Adjust SDK nhưng không cài đặt tính năng liên kết tham số đối tác, thì Adjust sẽ chuyển tiếp tham số theo tên được ghi trong Adjust SDK.

Kích hoạt Google Analytics 4 cho ứng dụng

Trên màn hình Kiểm tra lại cài đặt , kiểm tra lại các thao tác đã thực hiện. Bạn có thể quay lại để thực hiện thay đổi nếu cần:

  • Ứng dụng đã chọn
  • Cách chia sẻ dữ liệu

Chọn Kích hoạt đối tác để kích hoạt Google Analytics 4 cho ứng dụng. Đối tác phân tích không dùng link cho chiến dịch. Sau khi kích hoạt tích hợp, chúng tôi sẽ gửi dữ liệu phân bổ và dữ liệu in-app event cho đối tác qua callback tự động, để bạn có thể sử dụng dữ liệu trong công cụ của đối tác.

Hướng dẫn cài đặt đối tác

Adjust sử dụng tích hợp Google Analytics 4 (GA4) để gửi dữ liệu phân bổ đa mạng (cross-network attribution data) cho Google Analytics. Bạn cần kích hoạt tích hợp nếu bạn đang sử dụng Google Analytics for Firebase SDK hoặc Google Analytics 4 for web để ghi lại (logging) lượt chuyển đổi. Adjust sử dụng sự kiện campaign_details của Measurement Protocol API để gửi đồng thời dữ liệu lượt chuyển đổi và phân bổ.

Yêu cầu

Tích hợp này hỗ trợ cả ứng dụng di động và ứng dụng web :

  • Ứng dụng di động:

    • Cần tích hợp Firebase SDK vào ứng dụng.
    • Cần cung cấp Firebase App ID .
    • Cần triển khai các tham số đối tác phiên truy cập (session partner parameter) của Adjust SDK để thu thập và gửi app_instance_id của Google Analytics 4.
    • Cần cài đặt app_instance_id trước khi khởi chạy Adjust SDK.

  • Ứng dụng chạy trên web

    • Cần cung cấp Measurement ID của GA4 web property.
    • Cần triển khai các tham số đối tác phiên truy cập của Adjust SDK để thu thập và gửi client_id của Google Analytics 4.
    • Cần cài đặt client_id trước khi khởi chạy Adjust SDK.

Các mã định danh trên (app_instance_id đối với ứng dụng di động và client_id đối với ứng dụng web) rất quan trọng vì Google Analytics 4 sử dụng chúng để nhận diện người dùng hoặc phiên bản ứng dụng. Nếu các giá trị này không được ghi nhận và gửi đi, Adjust sẽ không thể gửi callback đến Google Analytics.

Vui lòng thực hiện theo các hướng dẫn sau để sử dụng tính năng:

iOS / Android / Unity / Flutter / React Native

Sự kiện in-app được hỗ trợ

Tích hợp Google Analytics 4 hỗ trợ các sự kiện in-app sau:

  • Add to cart
  • View cart
  • Begin checkout
  • Login
  • Purchase
  • Add to wishlist
  • Sign up

Đối với một số sự kiện, bạn cần gửi thêm giá trị dưới dạng Tham số đối tác SDK :

**Add to cart** item_id hoặc item_name (cần cung cấp ít nhất một tham số)
**Add to wishlist** item_id hoặc item_name (cần cung cấp ít nhất một tham số)
**Begin checkout** item_id hoặc item_name (cần cung cấp ít nhất một tham số)
**View cart** item_id hoặc item_name (cần cung cấp ít nhất một tham số)
**Purchase** item_id hoặc item_name (cần cung cấp ít nhất một tham số) và transaction_id
**Login** Không yêu cầu cung cấp thêm Tham số đối tác SDK
**Sign up** Không yêu cầu cung cấp thêm Tham số đối tác SDK

Khi kích hoạt các sự kiện này, hãy đảm bảo gửi đầy đủ các Tham số đối tác SDK bắt buộc. Nếu bạn gửi thiếu tham số, Adjust sẽ không thể gửi sự kiện đến Google Analytics 4 cùng với các thông tin mà tích hợp này yêu cầu.

Một số lưu ý thêm

  • Chúng tôi không chia sẻ dữ liệu truy cập tự nhiên (organic traffic) qua tích hợp này.
  • Google Analytics áp dụng phương pháp phân bổ khác Adjust, theo đó không chấp nhận lượt chuyển đổi xảy ra cách đây hơn 3 ngày .
  • Tùy thuộc khung thời gian phân bổ bạn cài đặt cho liên kết của Adjust , dữ liệu của Adjust và Google Analytics có thể khác nhau, vì một số lượt chuyển đổi có thể không được ghi nhận trong GA4.

Session ID

Bạn có thể gửi Firebase Session ID thông qua tham số đối tác ga4_session_id .

User ID

Bạn có thể gửi Firebase User ID thông qua tham số đối tác ga4_user_id .

Danh sách tất cả tham số được chuyển tiếp đến Google Analytics 4

Google Analytics 4 yêu cầu Adjust gửi các tham số (điểm dữ liệu) sau trong callback:

Trường dữ liệuThông tin
{currency}Mã tiền tệ gốc theo ISO 4217, do Adjust SDK gửi đến
{revenue_float}Doanh thu được gửi từ Adjust SDK, đã được làm tròn theo quy ước của đơn vị tiền tệ
{adgroup_name}Tên adgroup, được lấy từ trình theo dõi
{campaign_name}Tên campaign, được lấy từ trình theo dõi
{creative_name}Tên creative, được lấy từ trình theo dõi
{engagement_time}Dấu thời gian của lượt tương tác
{network_name}Tên network, được lấy từ trình theo dõi