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. Adjust sử dụng tích hợp để 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 cả hai dữ liệu lượt chuyển đổi và phân bổ.

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

Tìm thông tin tài khoản

Để lấy Firebase App ID:

1. Truy cập Firebase Console.
2. Chọn project của bạn.
3. Chọn Settings (biểu tượng bánh răng), chọn tiếp Project settings nằm ở thanh bên tay trái.
4. Đến mục Your apps , chọn ứng dụng của bạn, sau đó đến trường thông tin chứa App ID .
5. Sao chép Firebase 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 .
4. Sao chép API secret .
   1. Nếu bạn chưa có API secret, đến mục Measurement Protocol API secrets , sau đó chọn Create .
   2. Nhập tên, sau đó chọn Create .

Tích hợp Firebase SDK

Để 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.

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:

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.

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.

   • Xem mục Trước khi bắt đầu của tất cả liên kết nền tảng phát triển 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.

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.

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: