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, 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, 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

Adjust sử dụng tích hợp Google Analytics 4 để gửi dữ liệu phân bổ 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 để ghi lại (logging) lượt chuyển đổi. Adjust sử dụng sự kiện campaign_details trong Measurement Protocol API để gửi đồng thời dữ liệu lượt chuyển đổi và phân bổ.

Để kích hoạt tích hợp , trước hết bạn cần tích hợp Firebase SDK vào ứng dụng, sau đó triển khai tham số đối tác phiên truy cập (session partner parameter) trong Adjust SDK. Bạn cần thực hiện các thao tác này là vì, Google Analytics 4 tạo một tham số app_instance_id cho từng instance của lượt cài đặt ứng dụng (với điều kiện ứng dụng đã tích hợp Firebase SDK). Nếu app_instance_id không được theo dấu và gửi đi, Adjust sẽ không 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

Thông qua tham số đối tác phiên truy cập, Adjust SDK có thể theo dấu tham số app_instance_id của Google Analytics 4, cũng như thêm tham số này vào dữ liệu được gửi đến Google Analytics 4. Bạn cần cài đặt app_instance_id trước khi khởi chạy****Adjust SDK.

Lưu ý: Chúng tôi không chia sẻ dữ liệu 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 của hơn 3 ngày trước đó. Tùy thuộc khung thời gian phân bổ bạn cài đặt cho liên kết, dữ liệu của Adjust và Google Analytics có thể bị chênh lệch, do Google Analytics 4 không ghi nhận một số lượt chuyển đổi.

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: