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

• Quyền truy cập Admin, Editor hoặc Custom Editor.
• Adjust SDK phiên bản 4.0.0 trở lên, để liên kết tham số SDK với tham số của Google Analytics 4. Chọn hướng dẫn phù hợp với nền tảng đang sử dụng.

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:

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

Our Google Analytics 4 (GA4) integration allows Adjust to send cross-network attribution data to Google Analytics. You should enable this integration if you are already logging conversions with the Google Analytics for Firebase SDK or using Google Analytics 4 for web. Adjust leverages the campaign_details event of the Measurement Protocol API to send conversions along with attribution details.

Requirements

This integration supports both mobile apps and web-based apps:

• For mobile apps:
  • The Firebase SDK must be integrated into your app.
  • A Firebase App ID is required.
  • You must implement session partner parameters within the Adjust SDK to capture and send Google Analytics 4’s app_instance_id.
  • You should set app_instance_idbefore initializing the Adjust SDK.
• For web-based apps:
  • A Measurement ID from your GA4 web property is required.
  • You must implement session partner parameters within the Adjust SDK to capture and send Google Analytics 4’s client_id.
  • You should set client_idbefore initializing the Adjust SDK.

These identifiers (app_instance_id for mobile, client_id for web) are essential because Google Analytics 4 uses them to uniquely identify each user or app instance. If these values are not properly tracked and passed, Adjust will not be able to fire callbacks to Google Analytics.

Follow the guides linked below to use this feature:

iOS / Android / Unity / Flutter / React Native

Additional Notes

• Organic traffic is not shared via this integration.
• Due to differences in attribution methodology, Google Analytics does not accept conversions older than 3 days.
• Depending on your Adjust Link attribution windows, you might see discrepancies because some conversions may not be reported in GA4.

About Session ID

You can send the Firebase Session ID through the session partner parameter ga4_session_id

About User ID

You can send the Firebase User ID through the session partner parameter 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: